com.galaxybase.driver.v1

接口 Driver

所有超级接口:

AutoCloseable

public interface Driver
extends AutoCloseable

特定GalaxyBase图数据库的访问器。

driver实现通常是线程安全的，充当模板用于Session创建和托管连接池。 所有配置和身份验证设置均由driver保持不变。 如果需要不同的设置，则应创建新的driver实例。

driver为每个远程GalaxyBase服务器维护一个连接池。 因此，使用driver最有效的方法是在整个应用程序中使用相同的实例。

要构建一个新的driver，请使用 GraphDatabase.driver中的方法。 传入方法的 URI决定了创建的driver的类型。

URI Scheme	Driver
bolt	Direct driver: connects directly to the host and port specified in the URI.
bolt+routing	Routing driver: can automatically discover members of a Causal Cluster and route sessions based on AccessMode.

从以下版本开始:

1.0 (bolt+routing URIs since 1.1)

方法概要

限定符和类型	方法和说明
void	close() 关闭分配给此driver的所有资源，包括打开的连接和IO线程。
CompletionStage<Void>	closeAsync() 关闭分配给此driver的所有资源，包括打开的连接和IO线程。
boolean	isEncrypted() 返回一个标志，指示是否对此driver使用加密。
com.galaxybase.driver.v1.Session	session() 创建一个新的Session.
com.galaxybase.driver.v1.Session	session(com.galaxybase.driver.v1.AccessMode mode) 为特定类型的工作创建新的Session。
com.galaxybase.driver.v1.Session	session(com.galaxybase.driver.v1.AccessMode mode, Iterable<String> bookmarks) 用给定的初始bookmark创建一个新的 write Session 。
com.galaxybase.driver.v1.Session	session(com.galaxybase.driver.v1.AccessMode mode, String bookmark) 用给定的初始bookmark指定的工作类型创建一个新的 Session。
com.galaxybase.driver.v1.Session	session(Iterable<String> bookmarks) 用给定的初始bookmark创建一个新的 write Session。
com.galaxybase.driver.v1.Session	session(String bookmark) 用给定的初始bookmark创建一个新的 write Session。

方法详细资料

close

void close()

关闭分配给此driver的所有资源，包括打开的连接和IO线程。

此操作与 closeAsync()的工作方式相同，但会阻塞，直到所有资源都关闭。

指定者:

close 在接口中 AutoCloseable

closeAsync

CompletionStage<Void> closeAsync()

关闭分配给此driver的所有资源，包括打开的连接和IO线程。

此操作是异步的并返回一个 CompletionStage。 当所有资源被关闭，该阶段以 null 完成，若关闭失败，则完成异常。

返回:

完成阶段 表示异步关闭。

isEncrypted

boolean isEncrypted()

返回一个标志，指示是否对此driver使用加密。

返回:

true 如果driver要使用加密，否则 false。

session

com.galaxybase.driver.v1.Session session()

创建一个新的Session.

session(AccessMode.WRITE, null)的别名。

返回:

一个新的Session对象。

session

com.galaxybase.driver.v1.Session session(com.galaxybase.driver.v1.AccessMode mode)

为特定类型的工作创建新的Session。

session(mode, null)的别名。

参数:

mode - 在此会话中，工作单位所需的访问类型，如 e.g. read access或 write access。

返回:

一个新的Session对象。

session

com.galaxybase.driver.v1.Session session(com.galaxybase.driver.v1.AccessMode mode,
                                         Iterable<String> bookmarks)

用给定的初始bookmark创建一个新的 write Session 。 在创建的会话中的第一个事务将确保服务器托管至少和提供的可迭代的bookmark引用的事务一样是最新的。

session(AccessMode.WRITE, bookmarks)的别名。

参数:

mode - 在此会话中，工作单位所需的访问类型，如 e.g. read access 或 write access.

bookmarks - 对某些先前事务的初始引用。 null值和空的迭代是允许的，表明bookmark不存在或未知。

返回:

一个新的Session对象。

session

com.galaxybase.driver.v1.Session session(com.galaxybase.driver.v1.AccessMode mode,
                                         String bookmark)

用给定的初始bookmark指定的工作类型创建一个新的 Session。 在创建的会话中的第一个事务将确保服务器托管至少和提供的bookmark引用的事务一样是最新的。

参数:

mode - 在此会话中，工作单位所需的访问类型，如 read access 或 write access。

bookmark - 对某些先前事务的初始引用。一个null值是被允许的，表明bookmark不存在或未知。

返回:

一个新的Session对象。

session

com.galaxybase.driver.v1.Session session(Iterable<String> bookmarks)

用给定的初始bookmark创建一个新的 write Session。 在创建的会话中的第一个事务将确保服务器托管至少和提供的可迭代的bookmark引用的事务一样是最新的。

session(AccessMode.WRITE, bookmarks)的别名。

参数:

bookmarks - 对某些先前事务的初始引用。 null值和空的迭代是允许的，表明bookmark不存在或未知。

返回:

一个新的Session 对象。

session

com.galaxybase.driver.v1.Session session(String bookmark)

用给定的初始bookmark创建一个新的 write Session。 在创建的会话中的第一个事务将确保服务器托管至少和提供的bookmark引用的事务一样是最新的。 session(AccessMode.WRITE, bookmark)的别名。

参数:

bookmark - 对某些先前事务的初始引用。一个null值是被允许的，表明bookmark不存在或未知。

返回:

一个新的Session对象。