Connection (jbcc 3.0.0.TD2 API)

java.lang.Object
- cn.tdchain.jbcc.Connection

```
public class Connection
extends Object
```
function：description datetime：2019-03-27 13:07 author：warne

字段概要

字段
限定符和类型	字段和说明
`protected String`	`account`
`protected Cipher`	`cipher`
`protected String`	`connectionId`
`protected Key`	`key`
`protected Net`	`net`
`protected String`	`role`
`protected static ScheduledExecutorService`	`scheduledService`
`protected long`	`timeout`

构造器概要

构造器
限定符	构造器和说明
`protected`	`Connection(String[] ipTable, int port, Key key, String token, Cipher cipher)`
`protected`	`Connection(String[] ipTable, int port, Key key, String token, Cipher cipher, long timeout)`
`protected`	`Connection(String[] ipArr, int port, String token, long timeout, String ksPath, String ksPasswd, Cipher cipher)` DEFAULT_TIMEOUT
`protected`	`Connection(String[] ipArr, int port, String token, String ksPath, String ksPasswd, Cipher cipher)` Description: 客户端构造器，默认超时为 DEFAULT_TIMEOUT

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`Result<BatchTrans<TransHead>>`	`addBatchTrans(BatchTrans<Trans> batch)` Description: 批量交易
`Result<TransHead>`	`addPermissionTrans(Permission permission)` Description: 添加一笔系统权限交(只有管理员证书才能使用)
`Result<TransHead>`	`addTrans(Trans trans)` Description: 添加一笔交易
`protected void`	`asynAskNodes(long timeout)` Description:异步同步节点信息
`String`	`getAccount()`
`Result<Block<Trans>>`	`getBlock(long height)` Description: 根据块高度查询块信息
`List<Node>`	`getBlockChainNodeList()` Description: 获取当前系统全部节点的node对象集合
`Result<Long>`	`getBlockChainTransCount()` Description:查询区块链交易总数
`Result<BlockHead>`	`getBlockHead(long height)` Description: 根据height查询block header
`Result<List<BlockHead>>`	`getBlockHeadList(long startHeight, long endHeight)` Description: 根据块高度查询块信息
`Result<Integer>`	`getConnectionCount()` Description:获取当前区块链的连接数
`String`	`getId()`
`Result<Block<Trans>>`	`getMaxBlock()` Description: 查询最大块信息
`Result<BlockHead>`	`getMaxBlockHead()` Description: 查询最大的块header,不包含交易
`Result<Trans>`	`getNewSystemTransByKey(String key)` Description: 根据key获取系统交易(只有管理员才能使用该方法,使用该方法只能查询系统交易,查询普通交易请使用getNewTransByKey)
`Result<Trans>`	`getNewTransByAccountAndKey(String account, String key)` Description:根据account和key获取最新交易
`Result<BQLResult>`	`getNewTransByBQL(BQL bql)` Description: 根据BlockChain Query Langage 区块链面向对象查询语言的查询条件获取对应key上的最新版本交易
`Result<Trans>`	`getNewTransByKey(String key)` Description: 根据key维度查询交易
`Result<Integer>`	`getNewTransCount()` Description:查询当前账户下的交易总数
`Result<Integer>`	`getNewTransCountByAccount(String account)` Description:查询账户account下的交易总数
`Result<List<Trans>>`	`getNewTransList(int limit, int offset)` Description:查询当前账户下的交易集合
`Result<List<TransHead>>`	`getNewTransListByAccount(String account)` Description: 获取account的最新交易
`Result<List<Trans>>`	`getNewTransListByAccount(String account, int limit, int offset)` Description:查询账户account下的交易集合
`Result<List<Trans>>`	`getNewTransListByAccountAndKeys(String account, List<String> keys)` Description: 根据account和key集合获取交易
`Result<List<Trans>>`	`getNewTransListByKeys(List<String> keys)` Description: 根据key集合获取交易查询自己的交易
`Result<Trans>`	`getPermissionTrans()` Description:查询系统权限交易(管理员才能读取)
`String`	`getRole()`
`Result<Trans>`	`getTransByAccountAndHash(String account, String hash)` Description: 根据hash和账户查询交易信息
`Result<Trans>`	`getTransByHash(String hash)` Description: 根据hash查询交易信息
`Result<Integer>`	`getTransCountByAccountAndType(String account, String type)` 根据交易类type和account查询交易数量
`Result<List<Trans>>`	`getTransHistoryByAccountAndKey(String account, String key, int startIndex, int endIndex)` 根据account 和key查询历史
`Result<List<Trans>>`	`getTransHistoryByKey(String key, int startIndex, int endIndex)` Description:根据key维度查询交易历史
`Result<List<Trans>>`	`getTransListByAccountAndType(String account, String type, int limit, int offset)` 根据交易类type和account查询交易
`Result<List<Trans>>`	`getTransListByHashList(List<String> hashList)` Description: 根据hashlist查询交易
`Result<List<Trans>>`	`getTransListByType(String type)` 根据交易类type查询交易
`protected void`	`openNet(String[] ipArr, int port, String token)` Description:开启网络连接
`protected void`	`openNet(String[] ipArr, int port, String token, Cipher cipher)`
`protected void`	`readyCert(String ksPath, String ksPasswd)` Description:准备证书
`boolean`	`startTransaction(String[] keys)` Description:开启事务
`void`	`stopTransaction(String[] keys)` Description:关闭事务

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

key
```
protected Key key
```

net
```
protected Net net
```

connectionId
```
protected String connectionId
```

cipher
```
protected Cipher cipher
```

account
```
protected String account
```

role
```
protected String role
```

timeout
```
protected long timeout
```

scheduledService

protected static final ScheduledExecutorService scheduledService

构造器详细资料

Connection

protected Connection(String[] ipArr,
                     int port,
                     String token,
                     String ksPath,
                     String ksPasswd,
                     Cipher cipher)

Description: 客户端构造器，默认超时为 DEFAULT_TIMEOUT

参数:: ipArr -; port -; token -; ksPath -; ksPasswd -; cipher -

Connection

protected Connection(String[] ipTable,
                     int port,
                     Key key,
                     String token,
                     Cipher cipher)

参数:: ipTable -; port -; key -; token -; cipher -

Connection

protected Connection(String[] ipTable,
                     int port,
                     Key key,
                     String token,
                     Cipher cipher,
                     long timeout)

参数:: ipTable -; port -; key -; token -; cipher -; timeout -

Connection

protected Connection(String[] ipArr,
                     int port,
                     String token,
                     long timeout,
                     String ksPath,
                     String ksPasswd,
                     Cipher cipher)

DEFAULT_TIMEOUT

参数:: ipArr -; port -; token -; timeout -; ksPath -; ksPasswd -

方法详细资料

addTrans
```
public Result<TransHead> addTrans(Trans trans)
```
Description: 添加一笔交易

参数:

trans -

返回:

TransHead

addPermissionTrans
```
public Result<TransHead> addPermissionTrans(Permission permission)
```
Description: 添加一笔系统权限交(只有管理员证书才能使用)

参数:

permission -

返回:

TransHead

getPermissionTrans
```
public Result<Trans> getPermissionTrans()
```
Description:查询系统权限交易(管理员才能读取)

返回:

getNewSystemTransByKey
```
public Result<Trans> getNewSystemTransByKey(String key)
```
Description: 根据key获取系统交易(只有管理员才能使用该方法,使用该方法只能查询系统交易,查询普通交易请使用getNewTransByKey)

参数:

key -

返回:

TransHead

getNewTransByBQL
```
public Result<BQLResult> getNewTransByBQL(BQL bql)
```
Description: 根据BlockChain Query Langage 区块链面向对象查询语言的查询条件获取对应key上的最新版本交易

参数:

bql - BQL

返回:

Result

addBatchTrans

public Result<BatchTrans<TransHead>> addBatchTrans(BatchTrans<Trans> batch)

Description: 批量交易

参数:: batch -
返回:: BatchTrans

getBlock
```
public Result<Block<Trans>> getBlock(long height)
```
Description: 根据块高度查询块信息

参数:

height -

返回:

Block

getBlockHead
```
public Result<BlockHead> getBlockHead(long height)
```
Description: 根据height查询block header

参数:

height -

返回:

Block

getBlockHeadList

public Result<List<BlockHead>> getBlockHeadList(long startHeight,
                                                long endHeight)

Description: 根据块高度查询块信息

返回:: Block

getMaxBlockHead
```
public Result<BlockHead> getMaxBlockHead()
```
Description: 查询最大的块header,不包含交易

返回:

Block

getMaxBlock
```
public Result<Block<Trans>> getMaxBlock()
```
Description: 查询最大块信息

返回:

Block

getTransByHash
```
public Result<Trans> getTransByHash(String hash)
```
Description: 根据hash查询交易信息

参数:

hash -

返回:

Trans

getTransByAccountAndHash

public Result<Trans> getTransByAccountAndHash(String account,
                                              String hash)

Description: 根据hash和账户查询交易信息

参数:: hash -; account -
返回:: Trans

getTransListByHashList
```
public Result<List<Trans>> getTransListByHashList(List<String> hashList)
```
Description: 根据hashlist查询交易

参数:

hashList -

返回:

List

getNewTransByKey
```
public Result<Trans> getNewTransByKey(String key)
```
Description: 根据key维度查询交易

参数:

key -

返回:

Trans

getTransListByType
```
public Result<List<Trans>> getTransListByType(String type)
```
根据交易类type查询交易

参数:

type -

返回:

List

getTransListByAccountAndType

public Result<List<Trans>> getTransListByAccountAndType(String account,
                                                        String type,
                                                        int limit,
                                                        int offset)

根据交易类type和account查询交易

参数:: type -; account -
返回:: List

getTransCountByAccountAndType

public Result<Integer> getTransCountByAccountAndType(String account,
                                                     String type)

根据交易类type和account查询交易数量

参数:: type -; account -
返回:: int

getTransHistoryByAccountAndKey

public Result<List<Trans>> getTransHistoryByAccountAndKey(String account,
                                                          String key,
                                                          int startIndex,
                                                          int endIndex)

根据account 和key查询历史

参数:: account -; key -
返回:

getTransHistoryByKey

public Result<List<Trans>> getTransHistoryByKey(String key,
                                                int startIndex,
                                                int endIndex)

Description:根据key维度查询交易历史

参数:: key -; startIndex -; endIndex -
返回:: List

getConnectionCount
```
public Result<Integer> getConnectionCount()
```
Description:获取当前区块链的连接数

返回:

int

getNewTransCountByAccount
```
public Result<Integer> getNewTransCountByAccount(String account)
```
Description:查询账户account下的交易总数

返回:

int

getNewTransCount
```
public Result<Integer> getNewTransCount()
```
Description:查询当前账户下的交易总数

返回:

int

getNewTransListByAccount

public Result<List<Trans>> getNewTransListByAccount(String account,
                                                    int limit,
                                                    int offset)

Description:查询账户account下的交易集合

返回:: int

getNewTransList

public Result<List<Trans>> getNewTransList(int limit,
                                           int offset)

Description:查询当前账户下的交易集合

返回:: int

startTransaction
```
public boolean startTransaction(String[] keys)
```
Description:开启事务

参数:

keys -

返回:

boolean

stopTransaction
```
public void stopTransaction(String[] keys)
```
Description:关闭事务

参数:

keys -

getBlockChainTransCount
```
public Result<Long> getBlockChainTransCount()
```
Description:查询区块链交易总数

返回:

Long

getNewTransByAccountAndKey

public Result<Trans> getNewTransByAccountAndKey(String account,
                                                String key)

Description:根据account和key获取最新交易

返回:: Long

getBlockChainNodeList
```
public List<Node> getBlockChainNodeList()
```
Description: 获取当前系统全部节点的node对象集合

返回:

List

getNewTransListByAccount

public Result<List<TransHead>> getNewTransListByAccount(String account)

Description: 获取account的最新交易

返回:: List

getNewTransListByAccountAndKeys

public Result<List<Trans>> getNewTransListByAccountAndKeys(String account,
                                                           List<String> keys)

Description: 根据account和key集合获取交易

返回:: List

getNewTransListByKeys
```
public Result<List<Trans>> getNewTransListByKeys(List<String> keys)
```
Description: 根据key集合获取交易查询自己的交易

返回:

List

getId
```
public String getId()
```
返回:

String 获取当前connection对象的id

openNet

protected void openNet(String[] ipArr,
                       int port,
                       String token)

Description:开启网络连接

参数:: ipArr -; port -; token -

openNet

protected void openNet(String[] ipArr,
                       int port,
                       String token,
                       Cipher cipher)

asynAskNodes
```
protected void asynAskNodes(long timeout)
```
Description:异步同步节点信息

参数:

timeout -

readyCert

protected void readyCert(String ksPath,
                         String ksPasswd)

Description:准备证书

参数:: ksPath -; ksPasswd -

getAccount
```
public String getAccount()
```

getRole
```
public String getRole()
```

类 Connection

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

key

net

connectionId

cipher

account

role

timeout

scheduledService

构造器详细资料

Connection

Connection

Connection

Connection

方法详细资料

addTrans

addPermissionTrans

getPermissionTrans

getNewSystemTransByKey

getNewTransByBQL

addBatchTrans

getBlock

getBlockHead

getBlockHeadList

getMaxBlockHead

getMaxBlock

getTransByHash

getTransByAccountAndHash

getTransListByHashList

getNewTransByKey

getTransListByType

getTransListByAccountAndType

getTransCountByAccountAndType

getTransHistoryByAccountAndKey

getTransHistoryByKey

getConnectionCount

getNewTransCountByAccount

getNewTransCount

getNewTransListByAccount

getNewTransList

startTransaction

stopTransaction

getBlockChainTransCount

getNewTransByAccountAndKey

getBlockChainNodeList

getNewTransListByAccount

getNewTransListByAccountAndKeys

getNewTransListByKeys

getId

openNet

openNet

asynAskNodes

readyCert

getAccount

getRole