org.apache.jackrabbit.spi.commons.query.jsr283.qom
Interface SameNodeJoinCondition

All Superinterfaces:

JoinCondition

All Known Implementing Classes:

SameNodeJoinConditionImpl

public interface SameNodeJoinCondition
extends JoinCondition

Tests whether two nodes are "the same" according to the isSame method of javax.jcr.Item.

If selector2Path is omitted:

• Tests whether the selector1 node is the same as the selector2 node. A node-tuple satisfies the constraint only if:

    selector1Node.isSame(selector2Node)

  would return true, where selector1Node is the node for selector1 and selector2Node is the node for selector2.

Otherwise, if selector2Path is specified:

• Tests whether the selector1 node is the same as a node identified by relative path from the selector2 node. A node-tuple satisfies the constraint only if:

    selector1Node.isSame(selector2Node.getNode(selector2Path))

  would return true, where selector1Node is the node for selector1 and selector2Node is the node for selector2.

The query is invalid if:

• selector1 is not the name of a selector in the query, or
• selector2 is not the name of a selector in the query, or
• selector1 is the same as selector2, or
• selector2Path is not a syntactically valid relative path. Note, however, that if the path is syntactically valid but does not identify a node in the repository (or the node is not visible to this session, because of access control constraints), the query is valid but the constraint is not satisfied.

Since:

JCR 2.0

Method Summary

String	getSelector1Name() Gets the name of the first selector.
String	getSelector2Name() Gets the name of the second selector.
String	getSelector2Path() Gets the path relative to the second selector.

Method Detail

getSelector1Name

String getSelector1Name()

Gets the name of the first selector.

Returns:

the selector name; non-null

getSelector2Name

String getSelector2Name()

Gets the name of the second selector.

Returns:

the selector name; non-null

getSelector2Path

String getSelector2Path()

Gets the path relative to the second selector.

Returns:

the relative path, or null for none