com.arangodb

Class ArangoDB

java.lang.Object

com.arangodb.internal.ArangoExecuteable<E,R,C>

com.arangodb.internal.InternalArangoDB<com.arangodb.internal.ArangoExecutorSync,Response,com.arangodb.internal.velocystream.internal.ConnectionSync>

com.arangodb.ArangoDB

public class ArangoDB
extends com.arangodb.internal.InternalArangoDB<com.arangodb.internal.ArangoExecutorSync,Response,com.arangodb.internal.velocystream.internal.ConnectionSync>

Author:

Mark Vollmary

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ArangoDB.Builder

Field Summary

Fields inherited from class com.arangodb.internal.InternalArangoDB

DEFAULT_PROPERTY_FILE

Fields inherited from class com.arangodb.internal.ArangoExecuteable

executor

Constructor Summary

Constructors

Constructor and Description
ArangoDB(com.arangodb.internal.velocystream.VstCommunicationSync.Builder vstBuilder, com.arangodb.internal.http.HttpCommunication.Builder httpBuilder, ArangoSerialization util, com.arangodb.internal.CollectionCache collectionCache, Protocol protocol, com.arangodb.internal.net.HostResolver hostResolver)

Method Summary

Modifier and Type	Method and Description
ArangoDB	_setCursorInitializer(ArangoCursorInitializer cursorInitializer)
Boolean	createDatabase(String name) Creates a new database
UserEntity	createUser(String user, String passwd) Create a new user.
UserEntity	createUser(String user, String passwd, UserCreateOptions options) Create a new user.
ArangoDatabase	db() Returns a handler of the system database
ArangoDatabase	db(String name) Returns a handler of the database by the given name
void	deleteUser(String user) Removes an existing user, identified by user.
Response	execute(Request request) Generic Execute.
Response	execute(Request request, com.arangodb.internal.net.HostHandle hostHandle) Generic Execute.
protected com.arangodb.internal.ArangoExecutorSync	executor()
Collection<String>	getAccessibleDatabases() Retrieves a list of all databases the current user can access
Collection<String>	getAccessibleDatabasesFor(String user) List available database to the specified user
Collection<String>	getDatabases() Retrieves a list of all existing databases
LogLevelEntity	getLogLevel() Returns the server's current loglevel settings.
LogEntity	getLogs(LogOptions options) Returns fatal, error, warning or info log messages from the server's global log.
ServerRole	getRole() Returns the server role.
UserEntity	getUser(String user) Fetches data about the specified user.
Collection<UserEntity>	getUsers() Fetches data about all users.
ArangoDBVersion	getVersion() Returns the server name and version number.
void	grantDefaultCollectionAccess(String user, Permissions permissions) Sets the default access level for collections for the user user.
void	grantDefaultDatabaseAccess(String user, Permissions permissions) Sets the default access level for databases for the user user.
UserEntity	replaceUser(String user, UserUpdateOptions options) Replaces the data of an existing user.
LogLevelEntity	setLogLevel(LogLevelEntity entity) Modifies and returns the server's current loglevel settings.
void	shutdown()
UserEntity	updateUser(String user, UserUpdateOptions options) Partially updates the data of an existing user.
void	updateUserDefaultCollectionAccess(String user, Permissions permissions) Deprecated. user grantDefaultCollectionAccess(String, Permissions) instead
void	updateUserDefaultDatabaseAccess(String user, Permissions permissions) Deprecated. use grantDefaultDatabaseAccess(String, Permissions) instead

Methods inherited from class com.arangodb.internal.InternalArangoDB

createDatabaseRequest, createDatabaseResponseDeserializer, createUserRequest, deleteUserRequest, getAccessibleDatabasesForRequest, getAccessibleDatabasesForResponseDeserializer, getDatabaseResponseDeserializer, getDatabasesRequest, getLogLevelRequest, getLogsRequest, getRoleRequest, getRoleResponseDeserializer, getUserRequest, getUsersRequest, getUsersResponseDeserializer, loadAcquireHostList, loadChunkSize, loadHost, loadHosts, loadLoadBalancingStrategy, loadMaxConnections, loadPassword, loadPort, loadProtocol, loadTimeout, loadUser, loadUseSsl, replaceUserRequest, setLogLevelRequest, updateUserDefaultCollectionAccessRequest, updateUserDefaultDatabaseAccessRequest, updateUserRequest

Methods inherited from class com.arangodb.internal.ArangoExecuteable

util

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ArangoDB

public ArangoDB(com.arangodb.internal.velocystream.VstCommunicationSync.Builder vstBuilder,
                com.arangodb.internal.http.HttpCommunication.Builder httpBuilder,
                ArangoSerialization util,
                com.arangodb.internal.CollectionCache collectionCache,
                Protocol protocol,
                com.arangodb.internal.net.HostResolver hostResolver)

Method Detail

executor

protected com.arangodb.internal.ArangoExecutorSync executor()

Overrides:

executor in class com.arangodb.internal.ArangoExecuteable<com.arangodb.internal.ArangoExecutorSync,Response,com.arangodb.internal.velocystream.internal.ConnectionSync>

shutdown

public void shutdown()
              throws ArangoDBException

Throws:

ArangoDBException

db

public ArangoDatabase db()

Returns a handler of the system database

Returns:

database handler

db

public ArangoDatabase db(String name)

Returns a handler of the database by the given name

Parameters:

name - Name of the database

Returns:

database handler

createDatabase

public Boolean createDatabase(String name)
                       throws ArangoDBException

Creates a new database

Parameters:

name - Has to contain a valid database name

Returns:

true if the database was created successfully.

Throws:

ArangoDBException

See Also:

API Documentation

getDatabases

public Collection<String> getDatabases()
                                throws ArangoDBException

Retrieves a list of all existing databases

Returns:

a list of all existing databases

Throws:

ArangoDBException

See Also:

API Documentation

getAccessibleDatabases

public Collection<String> getAccessibleDatabases()
                                          throws ArangoDBException

Retrieves a list of all databases the current user can access

Returns:

a list of all databases the current user can access

Throws:

ArangoDBException

See Also:

API Documentation

getAccessibleDatabasesFor

public Collection<String> getAccessibleDatabasesFor(String user)
                                             throws ArangoDBException

List available database to the specified user

Parameters:

user - The name of the user for which you want to query the databases

Returns:

Throws:

ArangoDBException

See Also:

API Documentation

getVersion

public ArangoDBVersion getVersion()
                           throws ArangoDBException

Returns the server name and version number.

Returns:

the server version, number

Throws:

ArangoDBException

See Also:

API Documentation

getRole

public ServerRole getRole()
                   throws ArangoDBException

Returns the server role.

Returns:

the server role

Throws:

ArangoDBException

createUser

public UserEntity createUser(String user,
                             String passwd)
                      throws ArangoDBException

Create a new user. This user will not have access to any database. You need permission to the _system database in order to execute this call.

Parameters:

user - The name of the user

passwd - The user password

Returns:

information about the user

Throws:

ArangoDBException

See Also:

API Documentation

createUser

public UserEntity createUser(String user,
                             String passwd,
                             UserCreateOptions options)
                      throws ArangoDBException

Create a new user. This user will not have access to any database. You need permission to the _system database in order to execute this call.

Parameters:

user - The name of the user

passwd - The user password

options - Additional options, can be null

Returns:

information about the user

Throws:

ArangoDBException

See Also:

API Documentation

deleteUser

public void deleteUser(String user)
                throws ArangoDBException

Removes an existing user, identified by user. You need access to the _system database.

Parameters:

user - The name of the user

Throws:

ArangoDBException

See Also:

API Documentation

getUser

public UserEntity getUser(String user)
                   throws ArangoDBException

Fetches data about the specified user. You can fetch information about yourself or you need permission to the _system database in order to execute this call.

Parameters:

user - The name of the user

Returns:

information about the user

Throws:

ArangoDBException

See Also:

API Documentation

getUsers

public Collection<UserEntity> getUsers()
                                throws ArangoDBException

Fetches data about all users. You can only execute this call if you have access to the _system database.

Returns:

informations about all users

Throws:

ArangoDBException

See Also:

API Documentation

updateUser

public UserEntity updateUser(String user,
                             UserUpdateOptions options)
                      throws ArangoDBException

Partially updates the data of an existing user. The name of an existing user must be specified in user. You can only change the password of your self. You need access to the _system database to change the active flag.

Parameters:

user - The name of the user

options - Properties of the user to be changed

Returns:

information about the user

Throws:

ArangoDBException

See Also:

API Documentation

replaceUser

public UserEntity replaceUser(String user,
                              UserUpdateOptions options)
                       throws ArangoDBException

Replaces the data of an existing user. The name of an existing user must be specified in user. You can only change the password of your self. You need access to the _system database to change the active flag.

Parameters:

user - The name of the user

options - Additional properties of the user, can be null

Returns:

information about the user

Throws:

ArangoDBException

See Also:

API Documentation

updateUserDefaultDatabaseAccess

@Deprecated
public void updateUserDefaultDatabaseAccess(String user,
                                                         Permissions permissions)
                                                  throws ArangoDBException

Deprecated. use grantDefaultDatabaseAccess(String, Permissions) instead

Parameters:

user - The name of the user

permissions - The permissions the user grant

Throws:

ArangoDBException

Since:

ArangoDB 3.2.0

grantDefaultDatabaseAccess

public void grantDefaultDatabaseAccess(String user,
                                       Permissions permissions)
                                throws ArangoDBException

Sets the default access level for databases for the user user. You need permission to the _system database in order to execute this call.

Parameters:

user - The name of the user

permissions - The permissions the user grant

Throws:

ArangoDBException

Since:

ArangoDB 3.2.0

updateUserDefaultCollectionAccess

@Deprecated
public void updateUserDefaultCollectionAccess(String user,
                                                           Permissions permissions)
                                                    throws ArangoDBException

Deprecated. user grantDefaultCollectionAccess(String, Permissions) instead

Parameters:

user - The name of the user

permissions - The permissions the user grant

Throws:

ArangoDBException

Since:

ArangoDB 3.2.0

grantDefaultCollectionAccess

public void grantDefaultCollectionAccess(String user,
                                         Permissions permissions)
                                  throws ArangoDBException

Sets the default access level for collections for the user user. You need permission to the _system database in order to execute this call.

Parameters:

user - The name of the user

permissions - The permissions the user grant

Throws:

ArangoDBException

Since:

ArangoDB 3.2.0

execute

public Response execute(Request request)
                 throws ArangoDBException

Generic Execute. Use this method to execute custom FOXX services.

Parameters:

request - VelocyStream request

Returns:

VelocyStream response

Throws:

ArangoDBException

execute

public Response execute(Request request,
                        com.arangodb.internal.net.HostHandle hostHandle)
                 throws ArangoDBException

Generic Execute. Use this method to execute custom FOXX services.

Parameters:

request - VelocyStream request

hostHandle - Used to stick to a specific host when using LoadBalancingStrategy.ROUND_ROBIN

Returns:

VelocyStream response

Throws:

ArangoDBException

getLogs

public LogEntity getLogs(LogOptions options)
                  throws ArangoDBException

Returns fatal, error, warning or info log messages from the server's global log.

Parameters:

options - Additional options, can be null

Returns:

the log messages

Throws:

ArangoDBException

See Also:

API Documentation

getLogLevel

public LogLevelEntity getLogLevel()
                           throws ArangoDBException

Returns the server's current loglevel settings.

Returns:

the server's current loglevel settings

Throws:

ArangoDBException

Since:

ArangoDB 3.1.0

setLogLevel

public LogLevelEntity setLogLevel(LogLevelEntity entity)
                           throws ArangoDBException

Modifies and returns the server's current loglevel settings.

Parameters:

entity - loglevel settings

Returns:

the server's current loglevel settings

Throws:

ArangoDBException

Since:

ArangoDB 3.1.0

_setCursorInitializer

public ArangoDB _setCursorInitializer(ArangoCursorInitializer cursorInitializer)