javax.jcr.query
Interface Row


public interface Row

A row in the query result table.


Method Summary
 Node getNode()
          Returns the Node corresponding to this Row.
 Node getNode(java.lang.String selectorName)
          Returns the Node corresponding to this Row and the specified selector.
 java.lang.String getPath()
          Equivalent to Row.getNode().getPath().
 java.lang.String getPath(java.lang.String selectorName)
          Equivalent to Row.getNode(selectorName).getPath().
 double getScore()
          Returns the full text search score for this row associated with the default selector.
 double getScore(java.lang.String selectorName)
          Returns the full text search score for this row associated with the specified selector.
 Value getValue(java.lang.String columnName)
          Returns the value of the indicated column in this Row.
 Value[] getValues()
          Returns an array of all the values in the same order as the column names returned by QueryResult.getColumnNames().
 

Method Detail

getValues

Value[] getValues()
                  throws RepositoryException
Returns an array of all the values in the same order as the column names returned by QueryResult.getColumnNames().

Returns:
a Value array.
Throws:
RepositoryException - if an error occurs

getValue

Value getValue(java.lang.String columnName)
               throws ItemNotFoundException,
                      RepositoryException
Returns the value of the indicated column in this Row.

Parameters:
columnName - name of query result table column
Returns:
a Value
Throws:
ItemNotFoundException - if columnName is not among the column names of the query result table.
RepositoryException - if another error occurs.

getNode

Node getNode()
             throws RepositoryException
Returns the Node corresponding to this Row.

Returns:
a Node
Throws:
RepositoryException - if this query has more than one selector (and therefore, this Row corresponds to more than one Node) or if another error occurs.
Since:
JCR 2.0

getNode

Node getNode(java.lang.String selectorName)
             throws RepositoryException
Returns the Node corresponding to this Row and the specified selector. If this Row is from a result involving outer joins, it may have no Node corresponding to the specified selector. In such a case this method returns null.

Parameters:
selectorName - a String
Returns:
a Node
Throws:
RepositoryException - if selectorName is not the alias of a selector in this query or if another error occurs.
Since:
JCR 2.0

getPath

java.lang.String getPath()
                         throws RepositoryException
Equivalent to Row.getNode().getPath(). However, some implementations may be able gain efficiency by not resolving the actual Node.

Returns:
a String
Throws:
RepositoryException - if this query has more than one selector (and therefore, this Row corresponds to more than one Node) or if another error occurs.
Since:
JCR 2.0

getPath

java.lang.String getPath(java.lang.String selectorName)
                         throws RepositoryException
Equivalent to Row.getNode(selectorName).getPath(). However, some implementations may be able gain efficiency by not resolving the actual Node. If this Row is from a result involving outer joins, it may have no Node corresponding to the specified selector. In such a case this method returns null.

Parameters:
selectorName - a String
Returns:
a String
Throws:
RepositoryException - if selectorName is not the alias of a selector in this query or if another error occurs.
Since:
JCR 2.0

getScore

double getScore()
                throws RepositoryException
Returns the full text search score for this row associated with the default selector. This corresponds to the score of a particular node.

If no FullTextSearchScore AQM object is associated with the default selector this method will still return a value. However, in that case the returned value may not be meaningful or may simply reflect the minimum possible relevance level (for example, in some systems this might be a score of 0).

Note, in JCR-SQL2 a FullTextSearchScore AQM object is represented by a SCORE() function. In JCR-JQOM it is represented by a Java object of type javax.jcr.query.qom.FullTextSearchScore.

Returns:
a double
Throws:
RepositoryException - if this query has more than one selector (and therefore, this Row corresponds to more than one Node) or if another error occurs.
Since:
JCR 2.0

getScore

double getScore(java.lang.String selectorName)
                throws RepositoryException
Returns the full text search score for this row associated with the specified selector. This corresponds to the score of a particular node.

If no FullTextSearchScore AQM object is associated with the selector selectorName this method will still return a value. However, in that case the returned value may not be meaningful or may simply reflect the minimum possible relevance level (for example, in some systems this might be a score of 0).

Note, in JCR-SQL2 a FullTextSearchScore AQM object is represented by a SCORE() function. In JCR-JQOM it is represented by a Java object of type javax.jcr.query.qom.FullTextSearchScore.

If this Row is from a result involving outer joins, it may have no Node corresponding to the specified selector. In such a case this method returns an implementation selected value, as it would if there were no FullTextSearchScore associated with the selector.

Parameters:
selectorName - a String
Returns:
a double
Throws:
RepositoryException - if selectorName is not the alias of a selector in this query or if another error occurs.
Since:
JCR 2.0