com.ibm.xsp.model.domino.wrapped
Class AbstractDominoViewEntry

java.lang.Object
  extended by com.ibm.xsp.model.domino.wrapped.AbstractDominoViewEntry
All Implemented Interfaces:
java.io.Externalizable, java.io.Serializable, lotus.domino.Base, lotus.domino.ViewEntry
Direct Known Subclasses:
DominoViewEntry

public abstract class AbstractDominoViewEntry
extends java.lang.Object
implements java.io.Externalizable, lotus.domino.ViewEntry

Extended ViewEntry with extra methods.

See Also:
Serialized Form

Field Summary
protected  lotus.domino.ViewEntry _wrappedObject
           
protected  java.util.Vector javaColumnValues
           
protected  java.util.Vector notesColumnValues
           
static int VC_NOT_PRESENT
           
 
Fields inherited from interface lotus.domino.ViewEntry
TYPE_CATEGORY, TYPE_DOCUMENT, TYPE_TOTAL
 
Constructor Summary
  AbstractDominoViewEntry()
          Default constructor - for Serialization only
protected AbstractDominoViewEntry(lotus.domino.ViewEntry _wrappedObject)
          Constructor that takes a ViewEntry to be wrapped
 
Method Summary
 void clearTransientValues()
          Clear the transient values (the Notes format one).
 void clearValues()
          Clear the cached values.
 int getChildCount()
          Return the number of immediate children belonging to the current view entry
 int getColumnIndentLevel()
          The indent level of a view entry within its column.
abstract  java.lang.Object getColumnValue(java.lang.String name)
          XPages extended API. Return the value for the specified column name from the View Entry
 java.util.Vector getColumnValues()
          Returns the value of each column in the view entry.
protected  lotus.domino.Database getDatabase()
          Return the Database contain the View this View Entry comes from.
 java.lang.String getDatabaseName()
          Return the name of Database contain the View this View Entry comes from.
 int getDescendantCount()
          The number of descendants belonging to the current view entry.
 lotus.domino.Document getDocument()
          The document associated with the view entry.
 int getFTSearchScore()
          The full-text search score of a view entry, if it was retrieved as part of a full-text search.
 java.lang.String getId()
          Deprecated.  
 int getIndentLevel()
          The indent level of a view entry within the view.
 java.util.Vector getJavaColumnValues()
          Returns the value of each column in the view entry using Java type.
 java.lang.String getNavigatorPosition()
          XPages extended API. Get the position of the ViewEntry using '.' as the character separator.
 java.lang.String getNoteID()
          The note ID of a view entry of type document.
 java.lang.String getOpenPageURL(java.lang.String pageName, boolean readOnly)
          XPages extended API. Get the URL of the page to open when a View Entry is selected
 java.lang.Object getParent()
          Return the parent ViewEntryCollection, ViewNavigator, or View object of a view entry.
 java.lang.String getPosition()
          XPages extended API. Get the position of the ViewEntry using '.' as the character separator.
 java.lang.String getPosition(char arg0)
          Returns the position of the entry in the view hierarchy, for example, "2.3" for the third document of the second category.
 boolean getRead()
          Returns true if the current entry has been read, otherwise false.
 boolean getRead(java.lang.String arg0)
          Returns true if the current entry has been read, otherwise false.
 int getResponseCount()
          Deprecated.  
 int getResponseLevel()
          Deprecated.  
 int getSiblingCount()
          The number of siblings belonging to the current view entry (Read Only).
protected  java.lang.String getTarget(boolean readOnly)
           
 java.lang.String getUniversalID()
          The universal ID of a document associated with a view entry.
protected  lotus.domino.View getView()
          Return the View this View Entry is part of.
protected  lotus.domino.ViewEntry getViewEntry()
          Returned the wrapped ViewEntry
 boolean isCategory()
          Indicates whether a view entry is a category.
 boolean isConflict()
          Indicates whether a view entry is for a document on which a replication or save conflict occurred.
 boolean isDocument()
          Indicates whether a view entry is a document.
 boolean isExpanded()
          XPages extended API. Return true if the ViewEntry is expanded Returns false.
 boolean isPreferJavaDates()
          Return whether the View Entry will return Java Dates.
 boolean isSelected()
          XPages extended API. Simply return false.
 boolean isTotal()
          Indicates whether a view entry is a total.
 boolean isValid()
          Indicates whether a view entry is a valid entry and not a deletion stub.
 void readExternal(java.io.ObjectInput in)
           
 void recycle()
          The recycle method unconditionally destroys an object and returns its memory to the system.
 void recycle(java.util.Vector arg0)
          The recycle method unconditionally destroys an object and returns its memory to the system.
 void setExpanded(boolean expanded)
          XPages extended API. Set the state of whether the ViewEntry is expanded or not Empty method that should be overridden
 void setPreferJavaDates(boolean javaDate)
          Set whether the View Entry will return Java Dates.
 void setSelected(boolean selected)
          XPages extended API. Empty method.
 void toggleExpanded()
          XPages extended API. Empty methoid that should be overridden
 java.lang.String toString()
          XPages extended API. Return the list of Java Column Values as a String
 void writeExternal(java.io.ObjectOutput out)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

VC_NOT_PRESENT

public static final int VC_NOT_PRESENT
See Also:
Constant Field Values

_wrappedObject

protected transient lotus.domino.ViewEntry _wrappedObject

notesColumnValues

protected transient java.util.Vector notesColumnValues

javaColumnValues

protected java.util.Vector javaColumnValues
Constructor Detail

AbstractDominoViewEntry

public AbstractDominoViewEntry()
Default constructor - for Serialization only


AbstractDominoViewEntry

protected AbstractDominoViewEntry(lotus.domino.ViewEntry _wrappedObject)
                           throws lotus.domino.NotesException
Constructor that takes a ViewEntry to be wrapped

Parameters:
_wrappedObject -
Throws:
lotus.domino.NotesException
Method Detail

writeExternal

public void writeExternal(java.io.ObjectOutput out)
                   throws java.io.IOException
Specified by:
writeExternal in interface java.io.Externalizable
Throws:
java.io.IOException

readExternal

public void readExternal(java.io.ObjectInput in)
                  throws java.io.IOException,
                         java.lang.ClassNotFoundException
Specified by:
readExternal in interface java.io.Externalizable
Throws:
java.io.IOException
java.lang.ClassNotFoundException

getView

protected lotus.domino.View getView()
                             throws lotus.domino.NotesException
Return the View this View Entry is part of. View Entry -> View or -> View Navigator -> View

Returns:
Return the View this View Entry is part of.
Throws:
lotus.domino.NotesException

getDatabase

protected lotus.domino.Database getDatabase()
                                     throws lotus.domino.NotesException
Return the Database contain the View this View Entry comes from.

Returns:
Return the Database contain the View this View Entry comes from.
Throws:
lotus.domino.NotesException

getDatabaseName

public java.lang.String getDatabaseName()
                                 throws lotus.domino.NotesException
Return the name of Database contain the View this View Entry comes from. If Database is remote - then name is !!

Returns:
Return the name of Database contain the View this View Entry comes from.
Throws:
lotus.domino.NotesException

getViewEntry

protected lotus.domino.ViewEntry getViewEntry()
Returned the wrapped ViewEntry

Returns:
Returned the wrapped ViewEntry

clearValues

public void clearValues()
Clear the cached values. All the values are removed, including the transient and non transient one.


clearTransientValues

public void clearTransientValues()
Clear the transient values (the Notes format one). In most of the cases, this Vector is null. It has a value only if a user tries to get all the values explicitly from custom code.


getChildCount

public int getChildCount()
                  throws lotus.domino.NotesException
Return the number of immediate children belonging to the current view entry

Specified by:
getChildCount in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException

getColumnIndentLevel

public int getColumnIndentLevel()
                         throws lotus.domino.NotesException
The indent level of a view entry within its column. This property is useful for determining the response level of a document. Main documents are always at indent level 0, response documents at indent level 1, and so on.

Specified by:
getColumnIndentLevel in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException

getColumnValues

public java.util.Vector getColumnValues()
                                 throws lotus.domino.NotesException
Returns the value of each column in the view entry. Type java.util.Vector; elements are Double, DateTime, or String

Specified by:
getColumnValues in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException

getJavaColumnValues

public java.util.Vector getJavaColumnValues()
                                     throws lotus.domino.NotesException
Returns the value of each column in the view entry using Java type.

Throws:
lotus.domino.NotesException

getDescendantCount

public int getDescendantCount()
                       throws lotus.domino.NotesException
The number of descendants belonging to the current view entry.

Specified by:
getDescendantCount in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException

getDocument

public lotus.domino.Document getDocument()
                                  throws lotus.domino.NotesException
The document associated with the view entry. Returns null if the view entry is not a document. Returns null if the document is deleted after the ViewEntry object is created.

Specified by:
getDocument in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException

getFTSearchScore

public int getFTSearchScore()
                     throws lotus.domino.NotesException
The full-text search score of a view entry, if it was retrieved as part of a full-text search. The score is determined by the number of target words that are found in the entry, the term weights assigned to the target words, and any proximity operators in the search query. If the entries are not retrieved as part of a full-text search, returns 0. If the entry is retrieved using an FTSearch method on a database without a full-text index, returns an unpredictable number.

Specified by:
getFTSearchScore in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException

getIndentLevel

public int getIndentLevel()
                   throws lotus.domino.NotesException
The indent level of a view entry within the view. The indent level corresponds to the number of levels in the position. Position 1 is indent level 0, position 1.1 is indent level 1, position 1.1.1 is indent level 2, and so on.

Specified by:
getIndentLevel in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException

getNoteID

public java.lang.String getNoteID()
                           throws lotus.domino.NotesException
The note ID of a view entry of type document. This property returns the empty string for entries of type category and total.

Specified by:
getNoteID in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException

getParent

public java.lang.Object getParent()
                           throws lotus.domino.NotesException
Return the parent ViewEntryCollection, ViewNavigator, or View object of a view entry.

Specified by:
getParent in interface lotus.domino.ViewEntry
Returns:
The parent ViewEntryCollection, ViewNavigator, or View object of a view entry.
Throws:
lotus.domino.NotesException

getPosition

public java.lang.String getPosition(char arg0)
                             throws lotus.domino.NotesException
Returns the position of the entry in the view hierarchy, for example, "2.3" for the third document of the second category.

Specified by:
getPosition in interface lotus.domino.ViewEntry
Returns:
A series of integers (in String format) and separators. The integers indicate the positions of the view entry at each level, where 1 is the first position. The first integer indicates the first level and so on.
Throws:
lotus.domino.NotesException

getRead

public boolean getRead()
                throws lotus.domino.NotesException
Returns true if the current entry has been read, otherwise false.

Specified by:
getRead in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException
See Also:
ViewEntry.getRead()

getRead

public boolean getRead(java.lang.String arg0)
                throws lotus.domino.NotesException
Returns true if the current entry has been read, otherwise false.

Specified by:
getRead in interface lotus.domino.ViewEntry
Parameters:
arg0 - If supplied, the username who has or has not read the entry. Otherwise, defaults to the name of the current user.
Returns:
True if the current entry has been read by username. False if it has not been read by username.
Throws:
lotus.domino.NotesException
See Also:
ViewEntry.getRead(java.lang.String)

getSiblingCount

public int getSiblingCount()
                    throws lotus.domino.NotesException
The number of siblings belonging to the current view entry (Read Only).

Specified by:
getSiblingCount in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException
See Also:
ViewEntry.getSiblingCount()

getUniversalID

public java.lang.String getUniversalID()
                                throws lotus.domino.NotesException
The universal ID of a document associated with a view entry. The ID is a 32-character combination of hexadecimal digits (0-9, A-F) that uniquely identifies a document across all replicas of a database.

Specified by:
getUniversalID in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException
See Also:
ViewEntry.getUniversalID()

isCategory

public boolean isCategory()
                   throws lotus.domino.NotesException
Indicates whether a view entry is a category.

Specified by:
isCategory in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException
See Also:
ViewEntry.isCategory()

isConflict

public boolean isConflict()
                   throws lotus.domino.NotesException
Indicates whether a view entry is for a document on which a replication or save conflict occurred.

Specified by:
isConflict in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException
See Also:
ViewEntry.isConflict()

isDocument

public boolean isDocument()
                   throws lotus.domino.NotesException
Indicates whether a view entry is a document.

Specified by:
isDocument in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException
See Also:
ViewEntry.isDocument()

isTotal

public boolean isTotal()
                throws lotus.domino.NotesException
Indicates whether a view entry is a total.

Specified by:
isTotal in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException
See Also:
ViewEntry.isTotal()

isPreferJavaDates

public boolean isPreferJavaDates()
                          throws lotus.domino.NotesException
Return whether the View Entry will return Java Dates.

Specified by:
isPreferJavaDates in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException
See Also:
ViewEntry.isPreferJavaDates()

setPreferJavaDates

public void setPreferJavaDates(boolean javaDate)
                        throws lotus.domino.NotesException
Set whether the View Entry will return Java Dates.

Specified by:
setPreferJavaDates in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException
See Also:
ViewEntry.setPreferJavaDates(boolean)

isValid

public boolean isValid()
                throws lotus.domino.NotesException
Indicates whether a view entry is a valid entry and not a deletion stub.

Specified by:
isValid in interface lotus.domino.ViewEntry
Throws:
lotus.domino.NotesException
See Also:
ViewEntry.isValid()

recycle

public void recycle()
             throws lotus.domino.NotesException
The recycle method unconditionally destroys an object and returns its memory to the system. Java has no knowledge of the heavyweight back-end Domino Objects, only the lightweight Java objects representing them. Garbage collection has no effect on Domino Objects unless you first explicitly recycle them.

Specified by:
recycle in interface lotus.domino.Base
Throws:
lotus.domino.NotesException
See Also:
Base.recycle()

recycle

public void recycle(java.util.Vector arg0)
             throws lotus.domino.NotesException
The recycle method unconditionally destroys an object and returns its memory to the system. The vector contains the Domino Objects to be recycled. This method effectively batches recycle operations and is especially efficient for remote (IIOP) calls. Java has no knowledge of the heavyweight back-end Domino Objects, only the lightweight Java objects representing them. Garbage collection has no effect on Domino Objects unless you first explicitly recycle them.

Specified by:
recycle in interface lotus.domino.Base
Throws:
lotus.domino.NotesException
See Also:
Base.recycle(java.util.Vector)

getColumnValue

public abstract java.lang.Object getColumnValue(java.lang.String name)
XPages extended API. Return the value for the specified column name from the View Entry


getOpenPageURL

public java.lang.String getOpenPageURL(java.lang.String pageName,
                                       boolean readOnly)
XPages extended API. Get the URL of the page to open when a View Entry is selected


getTarget

protected java.lang.String getTarget(boolean readOnly)

toString

public java.lang.String toString()
XPages extended API. Return the list of Java Column Values as a String

Overrides:
toString in class java.lang.Object

getNavigatorPosition

public java.lang.String getNavigatorPosition()
                                      throws lotus.domino.NotesException
XPages extended API. Get the position of the ViewEntry using '.' as the character separator. See getPosition(char)

Throws:
lotus.domino.NotesException

getPosition

public java.lang.String getPosition()
                             throws lotus.domino.NotesException
XPages extended API. Get the position of the ViewEntry using '.' as the character separator. See getPosition(char)

Throws:
lotus.domino.NotesException

isSelected

public boolean isSelected()
XPages extended API. Simply return false. Should be overridden.


setSelected

public void setSelected(boolean selected)
XPages extended API. Empty method. Should be overridden.


isExpanded

public boolean isExpanded()
XPages extended API. Return true if the ViewEntry is expanded Returns false. Should be overridden.


setExpanded

public void setExpanded(boolean expanded)
XPages extended API. Set the state of whether the ViewEntry is expanded or not Empty method that should be overridden


toggleExpanded

public void toggleExpanded()
XPages extended API. Empty methoid that should be overridden


getResponseCount

public int getResponseCount()
                     throws lotus.domino.NotesException
Deprecated. 

The number of immediate children belonging to the current view entry.

Throws:
lotus.domino.NotesException

getResponseLevel

public int getResponseLevel()
                     throws lotus.domino.NotesException
Deprecated. 

The indent level of a view entry within its column.

Throws:
lotus.domino.NotesException

getId

public java.lang.String getId()
Deprecated. 

The note ID of a view entry of type document.