Database (ElastosHiveSDK alpha-v2.0.32 API)

```
public interface Database
```

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`java.util.concurrent.CompletableFuture<java.lang.Long>`	`countDocuments(java.lang.String collection, com.fasterxml.jackson.databind.JsonNode query, CountOptions options)` Count documents
`java.util.concurrent.CompletableFuture<java.lang.Boolean>`	`createCollection(java.lang.String name, CreateCollectionOptions options)` Lets the vault owner create a collection on database.
`java.util.concurrent.CompletableFuture<java.lang.Boolean>`	`deleteCollection(java.lang.String name)` Lets the vault owner delete a collection on database according to collection name.
`java.util.concurrent.CompletableFuture<DeleteResult>`	`deleteMany(java.lang.String collection, com.fasterxml.jackson.databind.JsonNode filter, DeleteOptions options)` Delete many existing documents in a given collection
`java.util.concurrent.CompletableFuture<DeleteResult>`	`deleteOne(java.lang.String collection, com.fasterxml.jackson.databind.JsonNode filter, DeleteOptions options)` Delete an existing document in a given collection
`java.util.concurrent.CompletableFuture<java.util.List<com.fasterxml.jackson.databind.JsonNode>>`	`findMany(java.lang.String collection, com.fasterxml.jackson.databind.JsonNode query, FindOptions options)` Find many documents
`java.util.concurrent.CompletableFuture<com.fasterxml.jackson.databind.JsonNode>`	`findOne(java.lang.String collection, com.fasterxml.jackson.databind.JsonNode query, FindOptions options)` Find a specific document
`java.util.concurrent.CompletableFuture<InsertManyResult>`	`insertMany(java.lang.String collection, java.util.List<com.fasterxml.jackson.databind.JsonNode> docs, InsertOptions options)` Insert many new documents in a given collection
`java.util.concurrent.CompletableFuture<InsertOneResult>`	`insertOne(java.lang.String collection, com.fasterxml.jackson.databind.JsonNode doc, InsertOptions options)` Insert a new document in a given collection
`java.util.concurrent.CompletableFuture<UpdateResult>`	`updateMany(java.lang.String collection, com.fasterxml.jackson.databind.JsonNode filter, com.fasterxml.jackson.databind.JsonNode update, UpdateOptions options)` Update many existing documents in a given collection
`java.util.concurrent.CompletableFuture<UpdateResult>`	`updateOne(java.lang.String collection, com.fasterxml.jackson.databind.JsonNode filter, com.fasterxml.jackson.databind.JsonNode update, UpdateOptions options)` Update an existing document in a given collection

Method Detail

createCollection

java.util.concurrent.CompletableFuture<java.lang.Boolean> createCollection(java.lang.String name,
                                                                           CreateCollectionOptions options)

Lets the vault owner create a collection on database.

Parameters:: name - the collection name
Returns:: fail(false) or success(treu)

deleteCollection
```
java.util.concurrent.CompletableFuture<java.lang.Boolean> deleteCollection(java.lang.String name)
```
Lets the vault owner delete a collection on database according to collection name.

Parameters:

name - the collection name

Returns:

fail(false) or success(true)

insertOne
```
java.util.concurrent.CompletableFuture<InsertOneResult> insertOne(java.lang.String collection,
                                                                  com.fasterxml.jackson.databind.JsonNode doc,
                                                                  InsertOptions options)
```
Insert a new document in a given collection

Parameters:

collection - the collection name

doc - The document to insert. Must be a mutable mapping type. If the document does not have an _id field one will be added automatically

options - bypass_document_validation: (optional) If True, allows the write to opt-out of document level validation. Default is False.

Returns:

Results returned by InsertOneResult wrapper

insertMany
```
java.util.concurrent.CompletableFuture<InsertManyResult> insertMany(java.lang.String collection,
                                                                    java.util.List<com.fasterxml.jackson.databind.JsonNode> docs,
                                                                    InsertOptions options)
```
Insert many new documents in a given collection

Parameters:

collection - the collection name

docs - The document to insert. Must be a mutable mapping type. If the document does not have an _id field one will be added automatically.

options - ordered (optional): If True (the default) documents will be inserted on the server serially, in the order provided. If an error occurs all remaining inserts are aborted. If False, documents will be inserted on the server in arbitrary order, possibly in parallel, and all document inserts will be attempted. bypass_document_validation: (optional) If True, allows the write to opt-out of document level validation. Default is False.

Returns:

Results returned by InsertManyResult wrapper

countDocuments
```
java.util.concurrent.CompletableFuture<java.lang.Long> countDocuments(java.lang.String collection,
                                                                      com.fasterxml.jackson.databind.JsonNode query,
                                                                      CountOptions options)
```
Count documents

Parameters:

collection - the collection name

query - The document of filter

options - skip (int): The number of matching documents to skip before returning results. limit (int): The maximum number of documents to count. Must be a positive integer. If not provided, no limit is imposed. maxTimeMS (int): The maximum amount of time to allow this operation to run, in milliseconds.

Returns:

count size

findOne

java.util.concurrent.CompletableFuture<com.fasterxml.jackson.databind.JsonNode> findOne(java.lang.String collection,
                                                                                        com.fasterxml.jackson.databind.JsonNode query,
                                                                                        FindOptions options)

Find a specific document

Parameters:: collection - the collection name; query - optional, a JSON object specifying elements which must be present for a document to be included in the result set; options - optional,refer to FindOptions
Returns:: a JSON object document result

findMany

java.util.concurrent.CompletableFuture<java.util.List<com.fasterxml.jackson.databind.JsonNode>> findMany(java.lang.String collection,
                                                                                                         com.fasterxml.jackson.databind.JsonNode query,
                                                                                                         FindOptions options)

Find many documents

Parameters:: collection - the collection name; query - optional, a JSON object specifying elements which must be present for a document to be included in the result set; options - optional,refer to FindOptions
Returns:: a JsonNode array result of document

updateOne

java.util.concurrent.CompletableFuture<UpdateResult> updateOne(java.lang.String collection,
                                                               com.fasterxml.jackson.databind.JsonNode filter,
                                                               com.fasterxml.jackson.databind.JsonNode update,
                                                               UpdateOptions options)

Update an existing document in a given collection

Parameters:: collection - the collection name; filter - A query that matches the document to update.; update - The modifications to apply.; options - optional, refer to UpdateOptions
Returns:: Results returned by UpdateResult wrapper

updateMany

java.util.concurrent.CompletableFuture<UpdateResult> updateMany(java.lang.String collection,
                                                                com.fasterxml.jackson.databind.JsonNode filter,
                                                                com.fasterxml.jackson.databind.JsonNode update,
                                                                UpdateOptions options)

Update many existing documents in a given collection

Parameters:: collection - the collection name; filter - A query that matches the document to update.; update - The modifications to apply.; options - optional, refer to UpdateOptions
Returns:: Results returned by UpdateResult wrapper

deleteOne

java.util.concurrent.CompletableFuture<DeleteResult> deleteOne(java.lang.String collection,
                                                               com.fasterxml.jackson.databind.JsonNode filter,
                                                               DeleteOptions options)

Delete an existing document in a given collection

Parameters:: collection - the collection name; filter - A query that matches the document to delete.; options -
Returns:

deleteMany

java.util.concurrent.CompletableFuture<DeleteResult> deleteMany(java.lang.String collection,
                                                                com.fasterxml.jackson.databind.JsonNode filter,
                                                                DeleteOptions options)

Delete many existing documents in a given collection

Parameters:: collection - the collection name; filter - A query that matches the document to delete.; options -
Returns:

Interface Database

Method Summary

Method Detail

createCollection

deleteCollection

insertOne