io.github.alleriawindrunner.sdk.v3.contract.precompiled.crud

类 TableCRUDService

java.lang.Object

io.github.alleriawindrunner.sdk.v3.contract.precompiled.crud.TableCRUDService

public class TableCRUDService
extends java.lang.Object

构造器概要

构造器

构造器和说明
TableCRUDService(Client client, CryptoKeyPair credential)

方法概要

限定符和类型	方法和说明
RetCode	appendColumns(java.lang.String tableName, java.util.List<java.lang.String> newColumns) append new columns to a specific table with table name, new value field names
void	asyncAppendColumns(java.lang.String tableName, java.util.List<java.lang.String> newColumns, PrecompiledCallback callback) async append new columns to a specific table with table name, new value field names
void	asyncCreateTable(java.lang.String tableName, Common.TableKeyOrder keyOrder, java.lang.String keyFieldName, java.util.List<java.lang.String> valueFields, PrecompiledCallback callback) async create a table with table name, key name, value field names
void	asyncCreateTable(java.lang.String tableName, java.lang.String keyFieldName, java.util.List<java.lang.String> valueFields, PrecompiledCallback callback) async create a table with table name, key name, value field names
void	asyncInsert(java.lang.String tableName, Entry entry, PrecompiledCallback callback) async insert data to a specific table with table name, data entry
void	asyncRemove(java.lang.String tableName, Condition condition, PrecompiledCallback callback) async remove data in a specific table with table name, key condition
void	asyncRemove(java.lang.String tableName, ConditionV320 condition, PrecompiledCallback callback) async remove data in a specific table with table name, key condition
void	asyncRemove(java.lang.String tableName, java.lang.String key, PrecompiledCallback callback) async remove data in a specific table with table name, single key
void	asyncUpdate(java.lang.String tableName, Condition condition, UpdateFields updateFields, PrecompiledCallback callback) async update data to a specific table with table name, condition, updateFields
void	asyncUpdate(java.lang.String tableName, ConditionV320 condition, UpdateFields updateFields, PrecompiledCallback callback) async update data to a specific table with table name, condition, updateFields
void	asyncUpdate(java.lang.String tableName, java.lang.String key, UpdateFields updateFields, PrecompiledCallback callback) async update data to a specific table with table name, single key, updateFields
RetCode	createTable(java.lang.String tableName, Common.TableKeyOrder keyOrder, java.lang.String keyFieldName, java.util.List<java.lang.String> valueFields) create a table with table name, key name, value field names
RetCode	createTable(java.lang.String tableName, java.lang.String keyFieldName, java.util.List<java.lang.String> valueFields) create a table with table name, key name, value field names
java.util.Map<java.lang.String,java.util.List<java.lang.String>>	desc(java.lang.String tableName) get a specific table key and value fields with table name
java.util.Map<java.lang.String,java.util.List<java.lang.String>>	descWithKeyOrder(java.lang.String tableName) get a specific table key and value fields with table name
long	getCurrentVersion()
RetCode	insert(java.lang.String tableName, Entry entry) insert data to a specific table with table name, data entry.
RetCode	insert(TablePrecompiled tablePrecompiled, Entry entry) insert data to a specific table with table precompiled, data entry. this method will reduce tableManager.openTable() overhead
RetCode	remove(java.lang.String tableName, Condition condition) remove data in a specific table with table name, key condition
RetCode	remove(java.lang.String tableName, ConditionV320 condition) remove data in a specific table with table name, key condition
RetCode	remove(java.lang.String tableName, java.lang.String key) remove data in a specific table with table name, single key
RetCode	remove(TablePrecompiled tablePrecompiled, Condition condition) remove data in a specific table with table name, key condition this method will reduce tableManager.openTable() overhead
RetCode	remove(TablePrecompiled tablePrecompiled, ConditionV320 condition) remove data in a specific table with table name, key condition this method will reduce tableManager.openTable() overhead
RetCode	remove(TablePrecompiled tablePrecompiled, java.lang.String key) remove data in a specific table with tablePrecompiled, single key this method will reduce tableManager.openTable() overhead
java.util.List<java.util.Map<java.lang.String,java.lang.String>>	select(java.lang.String tableName, Condition condition) select data in a specific table with table name, condition
java.util.List<java.util.Map<java.lang.String,java.lang.String>>	select(java.lang.String tableName, ConditionV320 condition) select data in a specific table with table name, condition
java.util.List<java.util.Map<java.lang.String,java.lang.String>>	select(java.lang.String tableName, java.util.Map<java.lang.String,java.util.List<java.lang.String>> desc, Condition condition) select data in a specific table with table name, table desc info, condition. this method will reduce table.desc() overhead
java.util.List<java.util.Map<java.lang.String,java.lang.String>>	select(java.lang.String tableName, java.util.Map<java.lang.String,java.util.List<java.lang.String>> desc, ConditionV320 condition) select data in a specific table with table name, table desc info, condition. this method will reduce table.desc() overhead
java.util.Map<java.lang.String,java.lang.String>	select(java.lang.String tableName, java.util.Map<java.lang.String,java.util.List<java.lang.String>> desc, java.lang.String key) select data in a specific table with table name, table desc info, single key this method will reduce table.desc() overhead
java.util.Map<java.lang.String,java.lang.String>	select(java.lang.String tableName, java.lang.String key) select data in a specific table with table name, single key
RetCode	update(java.lang.String tableName, Condition condition, UpdateFields updateFields) update data to a specific table with table name, condition, updateFields
RetCode	update(java.lang.String tableName, ConditionV320 condition, UpdateFields updateFields) update data to a specific table with table name, condition, updateFields
RetCode	update(java.lang.String tableName, java.lang.String key, UpdateFields updateFields) update data to a specific table with table name, single key, updateFields
RetCode	update(TablePrecompiled tablePrecompiled, Condition condition, UpdateFields updateFields) update data to a specific table with tablePrecompiled, key condition, updateFields this method will reduce tableManager.openTable() overhead
RetCode	update(TablePrecompiled tablePrecompiled, ConditionV320 condition, UpdateFields updateFields) update data to a specific table with tablePrecompiled, key condition, updateFields this method will reduce tableManager.openTable() overhead
RetCode	update(TablePrecompiled tablePrecompiled, java.lang.String key, UpdateFields updateFields) update data to a specific table with tablePrecompiled, single key, updateFields this method will reduce tableManager.openTable() overhead

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

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

构造器详细资料

TableCRUDService

public TableCRUDService(Client client,
                        CryptoKeyPair credential)

方法详细资料

getCurrentVersion

public long getCurrentVersion()

createTable

public RetCode createTable(java.lang.String tableName,
                           java.lang.String keyFieldName,
                           java.util.List<java.lang.String> valueFields)
                    throws ContractException

create a table with table name, key name, value field names

参数:

tableName - table name, will add prefix /tables/ in blockchain, tableName length not longer than 50 with prefix

keyFieldName - key field name, which length should not be longer than 64

valueFields - value field names, which length in total should not be longer than 1024

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

asyncCreateTable

public void asyncCreateTable(java.lang.String tableName,
                             java.lang.String keyFieldName,
                             java.util.List<java.lang.String> valueFields,
                             PrecompiledCallback callback)

async create a table with table name, key name, value field names

参数:

tableName - table name, will add prefix /tables/ in blockchain, tableName length not longer than 50 with prefix

keyFieldName - key field name, which length should not be longer than 64

valueFields - value field names, which length in total should not be longer than 1024

callback - callback when get receipt

createTable

public RetCode createTable(java.lang.String tableName,
                           Common.TableKeyOrder keyOrder,
                           java.lang.String keyFieldName,
                           java.util.List<java.lang.String> valueFields)
                    throws ContractException

create a table with table name, key name, value field names

参数:

tableName - table name, will add prefix /tables/ in blockchain, tableName length not longer than 50 with prefix

keyFieldName - key field name, which length should not be longer than 64

valueFields - value field names, which length in total should not be longer than 1024

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

asyncCreateTable

public void asyncCreateTable(java.lang.String tableName,
                             Common.TableKeyOrder keyOrder,
                             java.lang.String keyFieldName,
                             java.util.List<java.lang.String> valueFields,
                             PrecompiledCallback callback)
                      throws ContractException

async create a table with table name, key name, value field names

参数:

tableName - table name, will add prefix /tables/ in blockchain, tableName length not longer than 50 with prefix

keyFieldName - key field name, which length should not be longer than 64

valueFields - value field names, which length in total should not be longer than 1024

callback - callback when get receipt

抛出:

ContractException

appendColumns

public RetCode appendColumns(java.lang.String tableName,
                             java.util.List<java.lang.String> newColumns)
                      throws ContractException

append new columns to a specific table with table name, new value field names

参数:

tableName - specific table name, table should exist

newColumns - new value field names, which length in total should not be longer than 1024, and should not be duplicate

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

asyncAppendColumns

public void asyncAppendColumns(java.lang.String tableName,
                               java.util.List<java.lang.String> newColumns,
                               PrecompiledCallback callback)

async append new columns to a specific table with table name, new value field names

参数:

tableName - specific table name, table should exist

newColumns - new value field names, which length in total should not be longer than 1024, and should not be duplicate

callback - callback when get receipt

select

public java.util.List<java.util.Map<java.lang.String,java.lang.String>> select(java.lang.String tableName,
                                                                               Condition condition)
                                                                        throws ContractException

select data in a specific table with table name, condition

参数:

tableName - specific table name, table should exist

condition - condition about key

返回:

return a list of select result which match condition

抛出:

ContractException - throw when contract exec exception

select

public java.util.List<java.util.Map<java.lang.String,java.lang.String>> select(java.lang.String tableName,
                                                                               java.util.Map<java.lang.String,java.util.List<java.lang.String>> desc,
                                                                               Condition condition)
                                                                        throws ContractException

select data in a specific table with table name, table desc info, condition. this method will reduce table.desc() overhead

参数:

tableName - specific table name, table should exist

desc - table key field and value fields info, [(key_field: [""]),(value_fields: [""])]

condition - condition about key

返回:

return a list of select result which match condition

抛出:

ContractException - throw when contract exec exception

select

public java.util.List<java.util.Map<java.lang.String,java.lang.String>> select(java.lang.String tableName,
                                                                               ConditionV320 condition)
                                                                        throws ContractException

select data in a specific table with table name, condition

参数:

tableName - specific table name, table should exist

condition - condition about key

返回:

return a list of select result which match condition

抛出:

ContractException - throw when contract exec exception

select

public java.util.List<java.util.Map<java.lang.String,java.lang.String>> select(java.lang.String tableName,
                                                                               java.util.Map<java.lang.String,java.util.List<java.lang.String>> desc,
                                                                               ConditionV320 condition)
                                                                        throws ContractException

select data in a specific table with table name, table desc info, condition. this method will reduce table.desc() overhead

参数:

tableName - specific table name, table should exist

desc - table key field and value fields info, [(key_field: [""]),(value_fields: [""])]

condition - condition about key

返回:

return a list of select result which match condition

抛出:

ContractException - throw when contract exec exception

select

public java.util.Map<java.lang.String,java.lang.String> select(java.lang.String tableName,
                                                               java.lang.String key)
                                                        throws ContractException

select data in a specific table with table name, single key

参数:

tableName - specific table name, table should exist

key - specific key

返回:

return select result which key in table matches the key given

抛出:

ContractException - throw when contract exec exception

select

public java.util.Map<java.lang.String,java.lang.String> select(java.lang.String tableName,
                                                               java.util.Map<java.lang.String,java.util.List<java.lang.String>> desc,
                                                               java.lang.String key)
                                                        throws ContractException

select data in a specific table with table name, table desc info, single key this method will reduce table.desc() overhead

参数:

tableName - specific table name, table should exist

desc - table key field and value fields info, [(key_field: [""]),(value_fields: [""])]

key - specific key

返回:

return select result which key in table matches the key given

抛出:

ContractException - throw when contract exec exception

insert

public RetCode insert(java.lang.String tableName,
                      Entry entry)
               throws ContractException

insert data to a specific table with table name, data entry.

参数:

tableName - specific table name, table should exist

entry - data entry, which contains key and values map, values size should match the table value field size

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

insert

public RetCode insert(TablePrecompiled tablePrecompiled,
                      Entry entry)
               throws ContractException

insert data to a specific table with table precompiled, data entry. this method will reduce tableManager.openTable() overhead

参数:

tablePrecompiled - specific tablePrecompiled, already load a specific contract address

entry - data entry, which contains key and values map, values size should match the table value field size

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

asyncInsert

public void asyncInsert(java.lang.String tableName,
                        Entry entry,
                        PrecompiledCallback callback)
                 throws ContractException

async insert data to a specific table with table name, data entry

参数:

tableName - specific table name, table should exist

entry - data entry, which contains key and values map, values size should match the table value field size

callback - callback when get receipt

抛出:

ContractException - throw when contract exec exception

update

public RetCode update(java.lang.String tableName,
                      java.lang.String key,
                      UpdateFields updateFields)
               throws ContractException

update data to a specific table with table name, single key, updateFields

参数:

tableName - specific table name, table should exist

key - specific key, key should exist

updateFields - update specific fields' data

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

update

public RetCode update(TablePrecompiled tablePrecompiled,
                      java.lang.String key,
                      UpdateFields updateFields)
               throws ContractException

update data to a specific table with tablePrecompiled, single key, updateFields this method will reduce tableManager.openTable() overhead

参数:

tablePrecompiled - specific tablePrecompiled, already load a specific contract address

key - specific key, key should exist

updateFields - update specific fields' data

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

update

public RetCode update(java.lang.String tableName,
                      Condition condition,
                      UpdateFields updateFields)
               throws ContractException

update data to a specific table with table name, condition, updateFields

参数:

tableName - specific table name, table should exist

condition - key condition

updateFields - update specific fields' data

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

update

public RetCode update(TablePrecompiled tablePrecompiled,
                      Condition condition,
                      UpdateFields updateFields)
               throws ContractException

update data to a specific table with tablePrecompiled, key condition, updateFields this method will reduce tableManager.openTable() overhead

参数:

tablePrecompiled - specific tablePrecompiled, already load a specific contract address

condition - key condition

updateFields - update specific fields' data

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

update

public RetCode update(java.lang.String tableName,
                      ConditionV320 condition,
                      UpdateFields updateFields)
               throws ContractException

update data to a specific table with table name, condition, updateFields

参数:

tableName - specific table name, table should exist

condition - key condition

updateFields - update specific fields' data

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

update

public RetCode update(TablePrecompiled tablePrecompiled,
                      ConditionV320 condition,
                      UpdateFields updateFields)
               throws ContractException

update data to a specific table with tablePrecompiled, key condition, updateFields this method will reduce tableManager.openTable() overhead

参数:

tablePrecompiled - specific tablePrecompiled, already load a specific contract address

condition - key condition

updateFields - update specific fields' data

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

asyncUpdate

public void asyncUpdate(java.lang.String tableName,
                        java.lang.String key,
                        UpdateFields updateFields,
                        PrecompiledCallback callback)
                 throws ContractException

async update data to a specific table with table name, single key, updateFields

参数:

tableName - specific table name, table should exist

key - specific key, key should exist

updateFields - update specific fields' data

callback - callback when get receipt

抛出:

ContractException - throw when contract exec exception

asyncUpdate

public void asyncUpdate(java.lang.String tableName,
                        Condition condition,
                        UpdateFields updateFields,
                        PrecompiledCallback callback)
                 throws ContractException

async update data to a specific table with table name, condition, updateFields

参数:

tableName - specific table name, table should exist

condition - key condition

updateFields - update specific fields' data

callback - callback when get receipt

抛出:

ContractException - throw when contract exec exception

asyncUpdate

public void asyncUpdate(java.lang.String tableName,
                        ConditionV320 condition,
                        UpdateFields updateFields,
                        PrecompiledCallback callback)
                 throws ContractException

async update data to a specific table with table name, condition, updateFields

参数:

tableName - specific table name, table should exist

condition - key condition

updateFields - update specific fields' data

callback - callback when get receipt

抛出:

ContractException - throw when contract exec exception

remove

public RetCode remove(java.lang.String tableName,
                      java.lang.String key)
               throws ContractException

remove data in a specific table with table name, single key

参数:

tableName - specific table name, table should exist

key - specific key, key should exist

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

remove

public RetCode remove(TablePrecompiled tablePrecompiled,
                      java.lang.String key)
               throws ContractException

remove data in a specific table with tablePrecompiled, single key this method will reduce tableManager.openTable() overhead

参数:

tablePrecompiled - specific tablePrecompiled, already load a specific contract address

key - specific key, key should exist

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

remove

public RetCode remove(java.lang.String tableName,
                      Condition condition)
               throws ContractException

remove data in a specific table with table name, key condition

参数:

tableName - specific table name, table should exist

condition - key condition

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

remove

public RetCode remove(TablePrecompiled tablePrecompiled,
                      Condition condition)
               throws ContractException

remove data in a specific table with table name, key condition this method will reduce tableManager.openTable() overhead

参数:

tablePrecompiled - specific tablePrecompiled, already load a specific contract address

condition - key condition

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

remove

public RetCode remove(java.lang.String tableName,
                      ConditionV320 condition)
               throws ContractException

remove data in a specific table with table name, key condition

参数:

tableName - specific table name, table should exist

condition - key condition

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

remove

public RetCode remove(TablePrecompiled tablePrecompiled,
                      ConditionV320 condition)
               throws ContractException

remove data in a specific table with table name, key condition this method will reduce tableManager.openTable() overhead

参数:

tablePrecompiled - specific tablePrecompiled, already load a specific contract address

condition - key condition

返回:

if success then return 0; otherwise is failed then see the retCode message

抛出:

ContractException - throw when contract exec exception

asyncRemove

public void asyncRemove(java.lang.String tableName,
                        java.lang.String key,
                        PrecompiledCallback callback)
                 throws ContractException

async remove data in a specific table with table name, single key

参数:

tableName - specific table name, table should exist

key - specific key, key should exist

callback - callback when get receipt

抛出:

ContractException - throw when contract exec exception

asyncRemove

public void asyncRemove(java.lang.String tableName,
                        Condition condition,
                        PrecompiledCallback callback)
                 throws ContractException

async remove data in a specific table with table name, key condition

参数:

tableName - specific table name, table should exist

condition - key condition

callback - callback when get receipt

抛出:

ContractException - throw when contract exec exception

asyncRemove

public void asyncRemove(java.lang.String tableName,
                        ConditionV320 condition,
                        PrecompiledCallback callback)
                 throws ContractException

async remove data in a specific table with table name, key condition

参数:

tableName - specific table name, table should exist

condition - key condition

callback - callback when get receipt

抛出:

ContractException - throw when contract exec exception

desc

public java.util.Map<java.lang.String,java.util.List<java.lang.String>> desc(java.lang.String tableName)
                                                                      throws ContractException

get a specific table key and value fields with table name

参数:

tableName - specific table name, it should exist

返回:

table key field and value fields info, [("key_field": [""]),("value_fields": [""])]

抛出:

ContractException - throw when contract exec exception

descWithKeyOrder

public java.util.Map<java.lang.String,java.util.List<java.lang.String>> descWithKeyOrder(java.lang.String tableName)
                                                                                  throws ContractException

get a specific table key and value fields with table name

参数:

tableName - specific table name, it should exist

返回:

table key field and value fields info, [("key_field": [""]),("value_fields": [""])]

抛出:

ContractException - throw when contract exec exception