public interface NodeQuerySession extends OsidSession
This session provides methods for searching among Node
objects. The search query is constructed using the NodeQuery.
This session defines views that offer differing behaviors for searching.
Nodes may have a query record indicated by their respective record
types. The query record is accessed via the NodeQuery.
Modifier and Type | Method and Description |
---|---|
boolean |
canSearchNodes()
Tests if this user can perform
Node lookups. |
Graph |
getGraph()
Gets the
Graph associated with this session. |
Id |
getGraphId()
Gets the
Graph Id associated with this
session. |
NodeQuery |
getNodeQuery()
Gets a node query.
|
NodeList |
getNodesByQuery(NodeQuery nodeQuery)
Gets a list of
Nodes matching the given node query. |
void |
useFederatedGraphView()
Federates the view for methods in this session.
|
void |
useIsolatedGraphView()
Isolates the view for methods in this session.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getGraphId()
Graph
Id
associated with this
session. Graph Id
associated with this sessionmandatory
- This method must be implemented. Graph getGraph() throws OperationFailedException, PermissionDeniedException
Graph
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canSearchNodes()
Node
lookups. A return
of true does not guarantee successful authorization. A return of false
indicates that it is known all methods in this session will result in
a PERMISSION_DENIED.
This is intended as a hint to an
application that may not offer lookup operations to unauthorized
users. false
if search methods are not authorized,
true
otherwisemandatory
- This method must be implemented. void useFederatedGraphView()
mandatory
- This method is must be implemented. void useIsolatedGraphView()
mandatory
- This method is must be implemented. NodeQuery getNodeQuery()
mandatory
- This method must be implemented. NodeList getNodesByQuery(NodeQuery nodeQuery) throws OperationFailedException, PermissionDeniedException
Nodes
matching the given node query.nodeQuery
- the node query NodeList
NullArgumentException
- nodeQuery
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- nodeQuery
is not
of this servicemandatory
- This method must be implemented.