Package org.nuxeo.ecm.directory
Interface Session
- All Superinterfaces:
AutoCloseable
- All Known Implementing Classes:
BaseSession
,CoreDirectorySession
,LDAPSession
,MemoryDirectorySession
,MongoDBSession
,MultiDirectorySession
,SQLSession
A session used to access entries in a directory.
This class is used to create, obtain, modify and delete entries in a directory.
- Author:
- [email protected]
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionboolean
authenticate
(String username, String password) Checks that the credentials provided by the UserManager match those registered in the directory.void
close()
Closes the session and all open result sets obtained from this session.createEntry
(Map<String, Object> fieldMap) Creates an entry in a directory.createEntry
(DocumentModel entry) Creates an entry in a directory.void
deleteEntry
(String id) Deletes a directory entry by id.void
deleteEntry
(DocumentModel docModel) Deletes a directory entry.Retrieves a directory entry using its id.Retrieves a directory entry using its id.The Id field is the name of the field that is used a primary key: unique and not null value in the whole directory.getProjection
(Map<String, Serializable> filter, String columnName) Executes a query using filter and return only the column columnName.getProjection
(Map<String, Serializable> filter, Set<String> fulltext, String columnName) boolean
Returns true if session has an entry with given id.boolean
Tells whether the directory implementation can be used as an authenticating backend for the UserManager (based on login / password check).boolean
query
(Map<String, Serializable> filter) Executes a simple query.Executes a simple query.Executes a simple query.query
(Map<String, Serializable> filter, Set<String> fulltext, Map<String, String> orderBy, boolean fetchReferences) Executes a query with the possibility to fetch referencesquery
(Map<String, Serializable> filter, Set<String> fulltext, Map<String, String> orderBy, boolean fetchReferences, int limit, int offset) Executes a query with the possibility to fetch a subset of the results. org.nuxeo.ecm.directory.BaseSession provides a default implementation fetching all results to return the subset.query
(QueryBuilder queryBuilder, boolean fetchReferences) Executes a query with the possibility to fetch a subset of the results.queryIds
(QueryBuilder queryBuilder) Executes a query with the possibility to fetch a subset of the results.void
setReadAllColumns
(boolean readAllColumns) For test framework.void
updateEntry
(DocumentModel docModel) Updates a directory entry.
-
Method Details
-
getEntry
Retrieves a directory entry using its id.TODO what happens when the entry is not found? return null if not found?
- Parameters:
id
- the entry id- Returns:
- a DocumentModel representing the entry
-
getEntry
Retrieves a directory entry using its id.- Parameters:
id
- the entry idfetchReferences
- boolean stating if references have to be fetched- Returns:
- a DocumentModel representing the entry
-
createEntry
Creates an entry in a directory.- Parameters:
fieldMap
- A map with keys and values that should be stored in a directoryNote: The values in the map should be of type String
- Returns:
- The new entry created in the directory
- Throws:
UnsupportedOperationException
- if the directory does not allow the creation of new entries
-
updateEntry
Updates a directory entry.- Parameters:
docModel
- The entry to update- Throws:
UnsupportedOperationException
- if the directory does not support entry updating
-
deleteEntry
Deletes a directory entry.- Parameters:
docModel
- The entry to delete- Throws:
UnsupportedOperationException
- if the directory does not support entry deleting
-
deleteEntry
Deletes a directory entry by id.- Parameters:
id
- the id of the entry to delete- Throws:
UnsupportedOperationException
- if the directory does not support entry deleting
-
query
Executes a simple query. The conditions will be 'AND'-ed. Search is done with exact match.Does not fetch reference fields.
If the remote server issues a size limit exceeded error while sending partial results up to that limit, the methodDocumentModelList#totalsize
on the returned list will return -2 as a special marker for truncated results.- Parameters:
filter
- a filter to apply to entries in directory- Returns:
- a list of document models containing the entries matched by the query
- Throws:
SizeLimitExceededException
- if the number of results is larger than the limit configured for the directory and the server does not send partial results.
-
query
Executes a simple query. The conditions will be 'AND'-ed.fieldNames present in the fulltext set are treated as a fulltext match. Does not fetch reference fields.
If the remote server issues a size limit exceeded error while sending partial results up to that limit, the methodDocumentModelList#totalsize
on the returned list will return -2 as a special marker for truncated results.- Parameters:
filter
- a filter to apply to entries in directoryfulltext
- a set of field that should be treated as a fulltext search- Returns:
- a list of document models containing the entries matched by the query
- Throws:
SizeLimitExceededException
- if the number of results is larger than the limit configured for the directory and the server does not send partial results.
-
query
DocumentModelList query(Map<String, Serializable> filter, Set<String> fulltext, Map<String, String> orderBy) Executes a simple query. The conditions will be 'AND'-ed and the result will be sorted by the orderBy criteria list.fieldNames present in the fulltext set are treated as a fulltext match. Does not fetch reference fields.
If the remote server issues a size limit exceeded error while sending partial results up to that limit, the methodDocumentModelList#totalsize
on the returned list will return -2 as a special marker for truncated results.- Parameters:
filter
- a filter to apply to entries in directoryorderBy
- a LinkedHashMap with the 'order by' criterias.The key of an entry of this map represents the column name and the value of the same entry represent the column order,which may be 'asc' or 'desc'.fulltext
- a set of field that should be treated as a fulltext search- Returns:
- a list of document models containing the entries matched by the query
- Throws:
SizeLimitExceededException
- if the number of results is larger than the limit configured for the directory and the server does not send partial results.
-
query
DocumentModelList query(Map<String, Serializable> filter, Set<String> fulltext, Map<String, String> orderBy, boolean fetchReferences) Executes a query with the possibility to fetch references- See Also:
-
query
DocumentModelList query(Map<String, Serializable> filter, Set<String> fulltext, Map<String, String> orderBy, boolean fetchReferences, int limit, int offset) Executes a query with the possibility to fetch a subset of the results. org.nuxeo.ecm.directory.BaseSession provides a default implementation fetching all results to return the subset. Not recommended.- Parameters:
limit
- maximum number of results ignored if less than 1offset
- number of rows skipped before starting, will be 0 if less than 0.- Since:
- 5.7
- See Also:
-
query
Executes a query with the possibility to fetch a subset of the results.- Parameters:
queryBuilder
- the query to use, including limit, offset, ordering and countTotalfetchReferences
- boolean stating if references have to be fetched- Returns:
- the list of documents, where the total size may be present if countTotal was true
- Since:
- 10.3
-
queryIds
Executes a query with the possibility to fetch a subset of the results. Returns the matching ids.- Parameters:
queryBuilder
- the query to use, including limit, offset and ordering- Returns:
- the list of document ids
- Since:
- 10.3
-
close
void close()Closes the session and all open result sets obtained from this session.Releases this Connection object's resources immediately instead of waiting for them to be automatically released.
TODO: should this operation auto-commit pending changes?
- Specified by:
close
in interfaceAutoCloseable
-
getProjection
Executes a query using filter and return only the column columnName.- Parameters:
filter
- the filter for the querycolumnName
- the column whose content should be returned- Returns:
- the list with the values of columnName for the entries matching filter
- Throws:
SizeLimitExceededException
- if the number of results is larger than the limit configured for the directory
-
getProjection
-
isAuthenticating
boolean isAuthenticating()Tells whether the directory implementation can be used as an authenticating backend for the UserManager (based on login / password check).- Returns:
- true is the directory is authentication aware
-
authenticate
Checks that the credentials provided by the UserManager match those registered in the directory. If username is not in the directory, this should return false instead of throrwing an exception.- Returns:
- true is the credentials match those stored in the directory
-
getIdField
String getIdField()The Id field is the name of the field that is used a primary key: unique and not null value in the whole directory. This field is also used as login field if the directory is authenticating.- Returns:
- the name of the id field
-
getPasswordField
String getPasswordField()- Returns:
- the name of the field to store the password if the directory is authenticating (can be null)
-
isReadOnly
boolean isReadOnly() -
hasEntry
Returns true if session has an entry with given id.- Since:
- 5.2M4
-
createEntry
Creates an entry in a directory.- Parameters:
entry
- the document model representing the entry to create- Returns:
- The new entry created in the directory
- Throws:
UnsupportedOperationException
- if the directory does not allow the creation of new entries- Since:
- 5.2M4
-
setReadAllColumns
void setReadAllColumns(boolean readAllColumns) For test framework. Changes the read/query methods to return all of the entries, including the password field.- Parameters:
readAllColumns
- whether to read all columns- Since:
- 9.1
-