public interface ArangoCollection extends ArangoSerializationAccessor
| Modifier and Type | Method and Description |
|---|---|
CollectionPropertiesEntity |
changeProperties(CollectionPropertiesOptions options)
Changes the properties of the collection
|
CollectionPropertiesEntity |
count()
Counts the documents in a collection
|
CollectionEntity |
create()
Creates a collection for this collection's name, then returns collection information from the server.
|
CollectionEntity |
create(CollectionCreateOptions options)
Creates a collection with the given
options for this collection's name, then returns collection
information from the server. |
ArangoDatabase |
db()
The the handler of the database the collection is within
|
DocumentDeleteEntity<Void> |
deleteDocument(String key)
Deletes the document with the given
key from the collection. |
<T> DocumentDeleteEntity<T> |
deleteDocument(String key,
Class<T> type,
DocumentDeleteOptions options)
Deletes the document with the given
key from the collection. |
MultiDocumentEntity<DocumentDeleteEntity<Void>> |
deleteDocuments(Collection<?> values)
Deletes multiple documents from the collection.
|
<T> MultiDocumentEntity<DocumentDeleteEntity<T>> |
deleteDocuments(Collection<?> values,
Class<T> type,
DocumentDeleteOptions options)
Deletes multiple documents from the collection.
|
String |
deleteIndex(String id)
Deletes the index with the given
id from the collection. |
Boolean |
documentExists(String key)
Checks if the document exists by reading a single document head
|
Boolean |
documentExists(String key,
DocumentExistsOptions options)
Checks if the document exists by reading a single document head
|
void |
drop()
Deletes the collection from the database.
|
void |
drop(boolean isSystem)
Deletes the collection from the database.
|
IndexEntity |
ensureFulltextIndex(Iterable<String> fields,
FulltextIndexOptions options)
Creates a fulltext index for the collection, if it does not already exist.
|
IndexEntity |
ensureGeoIndex(Iterable<String> fields,
GeoIndexOptions options)
Creates a geo-spatial index for the collection, if it does not already exist.
|
IndexEntity |
ensureHashIndex(Iterable<String> fields,
HashIndexOptions options)
Creates a hash index for the collection if it does not already exist.
|
IndexEntity |
ensurePersistentIndex(Iterable<String> fields,
PersistentIndexOptions options)
Creates a persistent index for the collection, if it does not already exist.
|
IndexEntity |
ensureSkiplistIndex(Iterable<String> fields,
SkiplistIndexOptions options)
Creates a skip-list index for the collection, if it does not already exist.
|
boolean |
exists()
Checks whether the collection exists
|
<T> T |
getDocument(String key,
Class<T> type)
Retrieves the document with the given
key from the collection. |
<T> T |
getDocument(String key,
Class<T> type,
DocumentReadOptions options)
Retrieves the document with the given
key from the collection. |
<T> MultiDocumentEntity<T> |
getDocuments(Collection<String> keys,
Class<T> type)
Retrieves multiple documents with the given
_key from the collection. |
<T> MultiDocumentEntity<T> |
getDocuments(Collection<String> keys,
Class<T> type,
DocumentReadOptions options)
Retrieves multiple documents with the given
_key from the collection. |
IndexEntity |
getIndex(String id)
Fetches information about the index with the given
id and returns it. |
Collection<IndexEntity> |
getIndexes()
Fetches a list of all indexes on this collection.
|
CollectionEntity |
getInfo()
Returns information about the collection
|
Permissions |
getPermissions(String user)
Get the collection access level
|
CollectionPropertiesEntity |
getProperties()
Reads the properties of the specified collection
|
CollectionRevisionEntity |
getRevision()
Retrieve the collections revision
|
void |
grantAccess(String user,
Permissions permissions)
Grants or revoke access to the collection for user user.
|
DocumentImportEntity |
importDocuments(Collection<?> values)
Bulk imports the given values into the collection.
|
DocumentImportEntity |
importDocuments(Collection<?> values,
DocumentImportOptions options)
Bulk imports the given values into the collection.
|
DocumentImportEntity |
importDocuments(String values)
Bulk imports the given values into the collection.
|
DocumentImportEntity |
importDocuments(String values,
DocumentImportOptions options)
Bulk imports the given values into the collection.
|
<T> DocumentCreateEntity<T> |
insertDocument(T value)
Creates a new document from the given document, unless there is already a document with the _key given.
|
<T> DocumentCreateEntity<T> |
insertDocument(T value,
DocumentCreateOptions options)
Creates a new document from the given document, unless there is already a document with the _key given.
|
<T> MultiDocumentEntity<DocumentCreateEntity<T>> |
insertDocuments(Collection<T> values)
Creates new documents from the given documents, unless there is already a document with the _key given.
|
<T> MultiDocumentEntity<DocumentCreateEntity<T>> |
insertDocuments(Collection<T> values,
DocumentCreateOptions options)
Creates new documents from the given documents, unless there is already a document with the _key given.
|
CollectionEntity |
load()
Tells the server to load the collection into memory.
|
String |
name()
The name of the collection
|
CollectionEntity |
rename(String newName)
Renames the collection
|
<T> DocumentUpdateEntity<T> |
replaceDocument(String key,
T value)
Replaces the document with
key with the one in the body, provided there is such a document and no
precondition is violated |
<T> DocumentUpdateEntity<T> |
replaceDocument(String key,
T value,
DocumentReplaceOptions options)
Replaces the document with
key with the one in the body, provided there is such a document and no
precondition is violated |
<T> MultiDocumentEntity<DocumentUpdateEntity<T>> |
replaceDocuments(Collection<T> values)
Replaces multiple documents in the specified collection with the ones in the values, the replaced documents are
specified by the _key attributes in the documents in values.
|
<T> MultiDocumentEntity<DocumentUpdateEntity<T>> |
replaceDocuments(Collection<T> values,
DocumentReplaceOptions options)
Replaces multiple documents in the specified collection with the ones in the values, the replaced documents are
specified by the _key attributes in the documents in values.
|
void |
resetAccess(String user)
Clear the collection access level, revert back to the default access level.
|
void |
revokeAccess(String user)
Revokes access to the collection for user user.
|
CollectionEntity |
truncate()
Removes all documents from the collection, but leaves the indexes intact
|
CollectionEntity |
unload()
Tells the server to remove the collection from memory.
|
<T> DocumentUpdateEntity<T> |
updateDocument(String key,
T value)
Partially updates the document identified by document-key.
|
<T> DocumentUpdateEntity<T> |
updateDocument(String key,
T value,
DocumentUpdateOptions options)
Partially updates the document identified by document-key.
|
<T> MultiDocumentEntity<DocumentUpdateEntity<T>> |
updateDocuments(Collection<T> values)
Partially updates documents, the documents to update are specified by the _key attributes in the objects on
values.
|
<T> MultiDocumentEntity<DocumentUpdateEntity<T>> |
updateDocuments(Collection<T> values,
DocumentUpdateOptions options)
Partially updates documents, the documents to update are specified by the _key attributes in the objects on
values.
|
util, utilArangoDatabase db()
String name()
<T> DocumentCreateEntity<T> insertDocument(T value) throws ArangoDBException
value - A representation of a single document (POJO, VPackSlice or String for JSON)ArangoDBException<T> DocumentCreateEntity<T> insertDocument(T value, DocumentCreateOptions options) throws ArangoDBException
value - A representation of a single document (POJO, VPackSlice or String for JSON)options - Additional options, can be nullArangoDBException<T> MultiDocumentEntity<DocumentCreateEntity<T>> insertDocuments(Collection<T> values) throws ArangoDBException
values - A List of documents (POJO, VPackSlice or String for JSON)ArangoDBException<T> MultiDocumentEntity<DocumentCreateEntity<T>> insertDocuments(Collection<T> values, DocumentCreateOptions options) throws ArangoDBException
values - A List of documents (POJO, VPackSlice or String for JSON)options - Additional options, can be nullArangoDBExceptionDocumentImportEntity importDocuments(Collection<?> values) throws ArangoDBException
values - a list of Objects that will be stored as documentsArangoDBExceptionDocumentImportEntity importDocuments(Collection<?> values, DocumentImportOptions options) throws ArangoDBException
values - a list of Objects that will be stored as documentsoptions - Additional options, can be nullArangoDBExceptionDocumentImportEntity importDocuments(String values) throws ArangoDBException
values - JSON-encoded array of objects that will be stored as documentsArangoDBExceptionDocumentImportEntity importDocuments(String values, DocumentImportOptions options) throws ArangoDBException
values - JSON-encoded array of objects that will be stored as documentsoptions - Additional options, can be nullArangoDBException<T> T getDocument(String key, Class<T> type) throws ArangoDBException
key from the collection.key - The key of the documenttype - The type of the document (POJO class, VPackSlice or String for JSON)ArangoDBException<T> T getDocument(String key, Class<T> type, DocumentReadOptions options) throws ArangoDBException
key from the collection.key - The key of the documenttype - The type of the document (POJO class, VPackSlice or String for JSON)options - Additional options, can be nullArangoDBException<T> MultiDocumentEntity<T> getDocuments(Collection<String> keys, Class<T> type) throws ArangoDBException
_key from the collection.keys - The keys of the documentstype - The type of the documents (POJO class, VPackSlice or String for JSON)ArangoDBException<T> MultiDocumentEntity<T> getDocuments(Collection<String> keys, Class<T> type, DocumentReadOptions options) throws ArangoDBException
_key from the collection.keys - The keys of the documentstype - The type of the documents (POJO class, VPackSlice or String for JSON)options - Additional options, can be nullArangoDBException<T> DocumentUpdateEntity<T> replaceDocument(String key, T value) throws ArangoDBException
key with the one in the body, provided there is such a document and no
precondition is violatedkey - The key of the documentvalue - A representation of a single document (POJO, VPackSlice or String for JSON)ArangoDBException<T> DocumentUpdateEntity<T> replaceDocument(String key, T value, DocumentReplaceOptions options) throws ArangoDBException
key with the one in the body, provided there is such a document and no
precondition is violatedkey - The key of the documentvalue - A representation of a single document (POJO, VPackSlice or String for JSON)options - Additional options, can be nullArangoDBException<T> MultiDocumentEntity<DocumentUpdateEntity<T>> replaceDocuments(Collection<T> values) throws ArangoDBException
values - A List of documents (POJO, VPackSlice or String for JSON)ArangoDBException<T> MultiDocumentEntity<DocumentUpdateEntity<T>> replaceDocuments(Collection<T> values, DocumentReplaceOptions options) throws ArangoDBException
values - A List of documents (POJO, VPackSlice or String for JSON)options - Additional options, can be nullArangoDBException<T> DocumentUpdateEntity<T> updateDocument(String key, T value) throws ArangoDBException
key - The key of the documentvalue - A representation of a single document (POJO, VPackSlice or String for JSON)ArangoDBException<T> DocumentUpdateEntity<T> updateDocument(String key, T value, DocumentUpdateOptions options) throws ArangoDBException
key - The key of the documentvalue - A representation of a single document (POJO, VPackSlice or String for JSON)options - Additional options, can be nullArangoDBException<T> MultiDocumentEntity<DocumentUpdateEntity<T>> updateDocuments(Collection<T> values) throws ArangoDBException
values - A list of documents (POJO, VPackSlice or String for JSON)ArangoDBException<T> MultiDocumentEntity<DocumentUpdateEntity<T>> updateDocuments(Collection<T> values, DocumentUpdateOptions options) throws ArangoDBException
values - A list of documents (POJO, VPackSlice or String for JSON)options - Additional options, can be nullArangoDBExceptionDocumentDeleteEntity<Void> deleteDocument(String key) throws ArangoDBException
key from the collection.key - The key of the documentArangoDBException<T> DocumentDeleteEntity<T> deleteDocument(String key, Class<T> type, DocumentDeleteOptions options) throws ArangoDBException
key from the collection.key - The key of the documenttype - The type of the document (POJO class, VPackSlice or String for JSON). Only necessary if
options.returnOld is set to true, otherwise can be null.options - Additional options, can be nullArangoDBExceptionMultiDocumentEntity<DocumentDeleteEntity<Void>> deleteDocuments(Collection<?> values) throws ArangoDBException
values - The keys of the documents or the documents themselvesArangoDBException<T> MultiDocumentEntity<DocumentDeleteEntity<T>> deleteDocuments(Collection<?> values, Class<T> type, DocumentDeleteOptions options) throws ArangoDBException
values - The keys of the documents or the documents themselvestype - The type of the documents (POJO class, VPackSlice or String for JSON). Only necessary if
options.returnOld is set to true, otherwise can be null.options - Additional options, can be nullArangoDBExceptionBoolean documentExists(String key)
key - The key of the documentBoolean documentExists(String key, DocumentExistsOptions options) throws ArangoDBException
key - The key of the documentoptions - Additional options, can be nullArangoDBException - only thrown when DocumentExistsOptions.isCatchException() == falseIndexEntity getIndex(String id) throws ArangoDBException
id and returns it.id - The index-handleArangoDBExceptionString deleteIndex(String id) throws ArangoDBException
id from the collection.id - The index-handleArangoDBExceptionIndexEntity ensureHashIndex(Iterable<String> fields, HashIndexOptions options) throws ArangoDBException
fields - A list of attribute pathsoptions - Additional options, can be nullArangoDBExceptionIndexEntity ensureSkiplistIndex(Iterable<String> fields, SkiplistIndexOptions options) throws ArangoDBException
fields - A list of attribute pathsoptions - Additional options, can be nullArangoDBExceptionIndexEntity ensurePersistentIndex(Iterable<String> fields, PersistentIndexOptions options) throws ArangoDBException
fields - A list of attribute pathsoptions - Additional options, can be nullArangoDBExceptionIndexEntity ensureGeoIndex(Iterable<String> fields, GeoIndexOptions options) throws ArangoDBException
fields - A list of attribute pathsoptions - Additional options, can be nullArangoDBExceptionIndexEntity ensureFulltextIndex(Iterable<String> fields, FulltextIndexOptions options) throws ArangoDBException
fields - A list of attribute pathsoptions - Additional options, can be nullArangoDBExceptionCollection<IndexEntity> getIndexes() throws ArangoDBException
ArangoDBExceptionboolean exists()
throws ArangoDBException
ArangoDBExceptionCollectionEntity truncate() throws ArangoDBException
ArangoDBExceptionCollectionPropertiesEntity count() throws ArangoDBException
ArangoDBExceptionCollectionEntity create() throws ArangoDBException
ArangoDBExceptionCollectionEntity create(CollectionCreateOptions options) throws ArangoDBException
options for this collection's name, then returns collection
information from the server.options - Additional options, can be nullArangoDBExceptionvoid drop() throws ArangoDBException
ArangoDBExceptionvoid drop(boolean isSystem) throws ArangoDBException
isSystem - Whether or not the collection to drop is a system collection. This parameter must be set to true in
order to drop a system collection.ArangoDBExceptionCollectionEntity load() throws ArangoDBException
ArangoDBExceptionCollectionEntity unload() throws ArangoDBException
ArangoDBExceptionCollectionEntity getInfo() throws ArangoDBException
ArangoDBExceptionCollectionPropertiesEntity getProperties() throws ArangoDBException
ArangoDBExceptionCollectionPropertiesEntity changeProperties(CollectionPropertiesOptions options) throws ArangoDBException
options - Additional options, can be nullArangoDBExceptionCollectionEntity rename(String newName) throws ArangoDBException
newName - The new nameArangoDBExceptionCollectionRevisionEntity getRevision() throws ArangoDBException
ArangoDBExceptionvoid grantAccess(String user, Permissions permissions) throws ArangoDBException
user - The name of the userpermissions - The permissions the user grantArangoDBExceptionvoid revokeAccess(String user) throws ArangoDBException
user - The name of the userArangoDBExceptionvoid resetAccess(String user) throws ArangoDBException
user - The name of the userArangoDBExceptionPermissions getPermissions(String user) throws ArangoDBException
user - The name of the userArangoDBExceptionCopyright © 2016–2019 ArangoDB GmbH. All rights reserved.