com.jd.blockchain.sdk.proxy.HttpBlockchainQueryService Maven / Gradle / Ivy

Go to download
package com.jd.blockchain.sdk.proxy;

import com.jd.blockchain.crypto.HashDigest;
import com.jd.blockchain.ledger.BlockchainIdentity;
import com.jd.blockchain.ledger.ContractInfo;
import com.jd.blockchain.ledger.DataAccountInfo;
import com.jd.blockchain.ledger.Event;
import com.jd.blockchain.ledger.KVInfoVO;
import com.jd.blockchain.ledger.LedgerAdminInfo;
import com.jd.blockchain.ledger.LedgerBlock;
import com.jd.blockchain.ledger.LedgerInfo;
import com.jd.blockchain.ledger.LedgerMetadata;
import com.jd.blockchain.ledger.LedgerTransaction;
import com.jd.blockchain.ledger.ParticipantNode;
import com.jd.blockchain.ledger.PrivilegeSet;
import com.jd.blockchain.ledger.TransactionState;
import com.jd.blockchain.ledger.TypedKVEntry;
import com.jd.blockchain.ledger.UserInfo;
import com.jd.blockchain.ledger.UserPrivilegeSet;
import com.jd.blockchain.sdk.BlockchainExtendQueryService;
import com.jd.blockchain.sdk.converters.HashDigestToStringConverter;
import com.jd.blockchain.sdk.converters.HashDigestsResponseConverter;
import com.jd.httpservice.HttpAction;
import com.jd.httpservice.HttpMethod;
import com.jd.httpservice.HttpService;
import com.jd.httpservice.PathParam;
import com.jd.httpservice.RequestBody;
import com.jd.httpservice.RequestParam;
import com.jd.httpservice.utils.agent.WebResponseConverterFactory;

/**
 * 作为内部使用的适配接口，用于声明 HTTP 协议的服务请求；
 *
 * @author huanghaiquan
 *
 */
@HttpService(responseConverterFactory=WebResponseConverterFactory.class)
public interface HttpBlockchainQueryService extends BlockchainExtendQueryService {

	/**
	 * 返回所有的账本的 hash 列表；

	 *
	 * 注：账本的 hash 既是该账本的创世区块的 hash；
	 *
	 * @return Base64编码的账本 hash 的集合；
	 */
    @HttpAction(method=HttpMethod.GET, path="ledgers", responseConverter = HashDigestsResponseConverter.class)
	@Override
	HashDigest[] getLedgerHashs();

	/**
	 * 获取账本信息；
	 *
	 * @param ledgerHash
	 * @return 账本对象；如果不存在，则返回 null；
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}")
	@Override
	LedgerInfo getLedger(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash);

	/**
	 * 获取最新区块
	 *
	 * @param ledgerHash
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/latest")
    @Override
	LedgerBlock getLatestBlock(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash);

//	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/settings/crypto")
//	@Override
//	CryptoSetting getCryptoSetting(HashDigest ledgerHash) ;
	
    /**
     * 获取指定区块高度中新增的交易总数（即该区块中交易集合的数量）
     * @param ledgerHash
     *         账本Hash
     * @param blockHeight
     *         区块高度
     * @return
     */
    @HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/height/{blockHeight}/txs/additional-count")
	@Override
	long getAdditionalTransactionCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                                       @PathParam(name="blockHeight") long blockHeight);

    /**
     * 获取指定区块Hash中新增的交易总数（即该区块中交易集合的数量）
     * @param ledgerHash
     *         账本Hash
     * @param blockHash
     *         区块Hash
     * @return
     */
    @HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/hash/{blockHash}/txs/additional-count")
	@Override
	long getAdditionalTransactionCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                                       @PathParam(name="blockHash", converter=HashDigestToStringConverter.class) HashDigest blockHash);

    /**
     * 获取指定账本最新区块新增的交易数量
     * @param ledgerHash
     *         账本Hash
     * @return
     */
    @HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/txs/additional-count")
	@Override
	long getAdditionalTransactionCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash);

    /**
     * 获取指定区块高度中新增的数据账户总数（即该区块中数据账户集合的数量）
     * @param ledgerHash
     *         账本Hash
     * @param blockHeight
     *         区块高度
     * @return
     */
    @HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/height/{blockHeight}/accounts/additional-count")
	@Override
	long getAdditionalDataAccountCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                                       @PathParam(name="blockHeight") long blockHeight);

    /**
     * 获取指定区块Hash中新增的数据账户总数（即该区块中数据账户集合的数量）
     * @param ledgerHash
     *         账本Hash
     * @param blockHash
     *         区块Hash
     * @return
     */
    @HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/hash/{blockHash}/accounts/additional-count")
	@Override
	long getAdditionalDataAccountCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                                       @PathParam(name="blockHash", converter=HashDigestToStringConverter.class) HashDigest blockHash);

    /**
     * 获取指定账本中附加的数据账户数量
     * @param ledgerHash
     *         账本Hash
     * @return
     */
    @HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/accounts/additional-count")
	@Override
	long getAdditionalDataAccountCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash);


    /**
     * 获取指定区块高度中新增的用户总数（即该区块中用户集合的数量）
     * @param ledgerHash
     *         账本Hash
     * @param blockHeight
     *         区块高度
     * @return
     */
    @HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/height/{blockHeight}/users/additional-count")
	@Override
	long getAdditionalUserCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                                @PathParam(name="blockHeight") long blockHeight);

    /**
     * 获取指定区块Hash中新增的用户总数（即该区块中用户集合的数量）
     * @param ledgerHash
     *         账本Hash
     * @param blockHash
     *         区块Hash
     * @return
     */
    @HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/hash/{blockHash}/users/additional-count")
	@Override
	long getAdditionalUserCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                                @PathParam(name="blockHash", converter=HashDigestToStringConverter.class) HashDigest blockHash);

    /**
     * 获取指定账本中新增的用户数量
     * @param ledgerHash
     *         账本Hash
     * @return
     */
    @HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/users/additional-count")
	@Override
	long getAdditionalUserCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash);

    /**
     * 获取指定区块高度中新增的合约总数（即该区块中合约集合的数量）
     * @param ledgerHash
     *         账本Hash
     * @param blockHeight
     *         区块高度
     * @return
     */
    @HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/height/{blockHeight}/contracts/additional-count")
	@Override
	long getAdditionalContractCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                                    @PathParam(name="blockHeight") long blockHeight);

    /**
     * 获取指定区块Hash中新增的合约总数（即该区块中合约集合的数量）
     * @param ledgerHash
     *         账本Hash
     * @param blockHash
     *         区块Hash
     * @return
     */
    @HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/hash/{blockHash}/contracts/additional-count")
	@Override
	long getAdditionalContractCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                                    @PathParam(name="blockHash", converter=HashDigestToStringConverter.class) HashDigest blockHash);

    /**
     * 获取指定账本中新增的合约数量
     * @param ledgerHash
     *         账本Hash
     * @return
     */
    @HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/contracts/additional-count")
	@Override
	long getAdditionalContractCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash);


	/**
	 * 获取账本信息；
	 *
	 * @param ledgerHash
	 * @return 账本对象；如果不存在，则返回 null；
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/admininfo")
	@Override
	LedgerAdminInfo getLedgerAdminInfo(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash);

	/**
	 * 返回指定账本的参与列表
	 *
	 * @param ledgerHash
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/participants")
	@Override
	ParticipantNode[] getConsensusParticipants(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash);

	/**
	 * 返回指定账本的元数据
	 *
	 * @param ledgerHash
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/metadata")
	@Override
	LedgerMetadata getLedgerMetadata(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash);

	/**
	 * 返回指定账本序号的区块；
	 *
	 * @param ledgerHash
	 *            账本hash；
	 * @param blockHeight
	 *            高度；
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/height/{blockHeight}")
	@Override
	LedgerBlock getBlock(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                         @PathParam(name="blockHeight") long blockHeight);

	/**
	 * 返回指定区块hash的区块；
	 *
	 * @param ledgerHash
	 *            账本hash；
	 * @param blockHash
	 *            区块hash；
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/hash/{blockHash}")
	@Override
	LedgerBlock getBlock(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                         @PathParam(name="blockHash", converter=HashDigestToStringConverter.class) HashDigest blockHash);

	/**
	 * 返回指定高度的区块中记录的交易总数；
	 *
	 * @param ledgerHash
	 * @param height
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/height/{blockHeight}/txs/count")
	@Override
	long getTransactionCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                             @PathParam(name="blockHeight") long height);

	/**
	 * 返回指定hash的区块中记录的交易总数；
	 *
	 * @param ledgerHash
	 * @param blockHash
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/hash/{blockHash}/txs/count")
	@Override
	long getTransactionCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                             @PathParam(name="blockHash", converter=HashDigestToStringConverter.class) HashDigest blockHash);

	/**
	 * 返回账本的交易总数
	 *
	 * @param ledgerHash
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/txs/count")
	@Override
	long getTransactionTotalCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash);

	/**
	 * 返回指定账本和区块的数据账户总数
	 *
	 * @param ledgerHash
	 * @param height
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/height/{blockHeight}/accounts/count")
	@Override
	long getDataAccountCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                             @PathParam(name="blockHeight") long height);

	/**
	 * 返回指定账本和区块的数据账户总数
	 *
	 * @param ledgerHash
	 * @param blockHash
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/hash/{blockHash}/accounts/count")
	@Override
	long getDataAccountCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                             @PathParam(name="blockHash", converter=HashDigestToStringConverter.class) HashDigest blockHash);

	/**
	 * 返回指定账本的数据账户总数
	 *
	 * @param ledgerHash
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/accounts/count")
	@Override
	long getDataAccountTotalCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash);

	/**
	 * 返回指定账本和区块的用户总数
	 *
	 * @param ledgerHash
	 * @param height
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/height/{blockHeight}/users/count")
	@Override
	long getUserCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                      @PathParam(name="blockHeight") long height);

	/**
	 * 返回指定账本和区块的用户总数
	 *
	 * @param ledgerHash
	 * @param blockHash
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/hash/{blockHash}/users/count")
	@Override
	long getUserCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                      @PathParam(name="blockHash", converter=HashDigestToStringConverter.class) HashDigest blockHash);

	/**
	 * 返回指定账本的用户总数
	 *
	 * @param ledgerHash
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/users/count")
	@Override
	long getUserTotalCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash);

	/**
	 * 返回指定账本和区块的合约总数
	 *
	 * @param ledgerHash
	 * @param height
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/height/{blockHeight}/contracts/count")
	@Override
	long getContractCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                          @PathParam(name="blockHeight") long height);

	/**
	 * 返回指定账本和区块的合约总数
	 *
	 * @param ledgerHash
	 * @param blockHash
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/hash/{blockHash}/contracts/count")
	@Override
	long getContractCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                          @PathParam(name="blockHash", converter=HashDigestToStringConverter.class) HashDigest blockHash);

	/**
	 * 返回指定账本的合约总数
	 *
	 * @param ledgerHash
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/contracts/count")
	@Override
	long getContractTotalCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash);

	/**
	 * 分页返回指定账本序号的区块中的交易列表；
	 *
	 * @param ledgerHash
	 *            账本hash；
	 * @param height
	 *            账本高度；
	 * @param fromIndex
	 *            开始的记录数；
	 * @param count
	 *            本次返回的记录数；

	 *            最小为1，最大值受到系统参数的限制；

	 *            注：通过 {@link #getBlock(String, long)} 方法获得的区块信息中可以得到区块的总交易数
	 *            {@link Block#getTxCount()}；
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/height/{blockHeight}/txs")
	@Override
	LedgerTransaction[] getTransactions(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                                        @PathParam(name="blockHeight") long height,
                                        @RequestParam(name="fromIndex", required = false) int fromIndex,
                                        @RequestParam(name="count", required = false) int count);

	/**
	 * 分页返回指定账本序号的区块中的交易列表；
	 *
	 * @param ledgerHash
	 *            账本hash；
	 * @param blockHash
	 *            账本高度；
	 * @param fromIndex
	 *            开始的记录数；
	 * @param count
	 *            本次返回的记录数；

	 *            如果参数值为 -1，则返回全部的记录；

	 *            注：通过 {@link #getBlock(String, String)} 方法获得的区块信息中可以得到区块的总交易数
	 *            {@link Block#getTxCount()}；
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/hash/{blockHash}/txs")
	@Override
	LedgerTransaction[] getTransactions(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                                        @PathParam(name="blockHash", converter=HashDigestToStringConverter.class) HashDigest blockHash,
                                        @RequestParam(name="fromIndex", required = false) int fromIndex,
                                        @RequestParam(name="count", required = false) int count);

	/**
	 * 分页返回指定账本序号的区块中的增量交易列表；
	 *
	 * @param ledgerHash
	 *            账本hash；
	 * @param height
	 *            账本高度；
	 * @param fromIndex
	 *            开始的记录数；
	 * @param count
	 *            本次返回的记录数；

	 *            最小为1，最大值受到系统参数的限制；

	 *            注：通过 {@link #getBlock(String, long)} 方法获得的区块信息中可以得到区块的总交易数
	 *            {@link Block#getTxCount()}；
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/height/{blockHeight}/txs/additional-txs")
	@Override
	LedgerTransaction[] getAdditionalTransactions(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
										@PathParam(name="blockHeight") long height,
										@RequestParam(name="fromIndex", required = false) int fromIndex,
										@RequestParam(name="count", required = false) int count);

	/**
	 * 分页返回指定账本序号的区块中的增量交易列表；
	 *
	 * @param ledgerHash
	 *            账本hash；
	 * @param blockHash
	 *            账本高度；
	 * @param fromIndex
	 *            开始的记录数；
	 * @param count
	 *            本次返回的记录数；

	 *            如果参数值为 -1，则返回全部的记录；

	 *            注：通过 {@link #getBlock(String, String)} 方法获得的区块信息中可以得到区块的总交易数
	 *            {@link Block#getTxCount()}；
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/blocks/hash/{blockHash}/txs/additional-txs")
	@Override
	LedgerTransaction[] getAdditionalTransactions(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
										@PathParam(name="blockHash", converter=HashDigestToStringConverter.class) HashDigest blockHash,
										@RequestParam(name="fromIndex", required = false) int fromIndex,
										@RequestParam(name="count", required = false) int count);

	/**
	 * 根据交易内容的哈希获取对应的交易记录；
	 *
	 * @param ledgerHash
	 *            账本hash；
	 * @param contentHash
	 *            交易内容的hash，即交易的 {@link Transaction#getContentHash()} 属性的值；
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/txs/hash/{contentHash}")
	@Override
	LedgerTransaction getTransactionByContentHash(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                                                  @PathParam(name="contentHash", converter=HashDigestToStringConverter.class) HashDigest contentHash);

	/**
	 *
	 * 返回交易状态
	 *
	 * @param ledgerHash
	 *            账本hash；
	 * @param contentHash
	 *            交易内容的hash，即交易的 {@link Transaction#getContentHash()} 属性的值；
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/txs/state/{contentHash}")
	@Override
	TransactionState getTransactionStateByContentHash(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                                                      @PathParam(name="contentHash", converter=HashDigestToStringConverter.class) HashDigest contentHash);

	/**
	 * 返回用户信息；
	 *
	 * @param ledgerHash
	 * @param address
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/users/address/{address}")
	@Override
	UserInfo getUser(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                     @PathParam(name="address") String address);

	/**
	 * 返回数据账户信息；
	 *
	 * @param ledgerHash
	 * @param address
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/accounts/address/{address}")
	@Override
	DataAccountInfo getDataAccount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
								   @PathParam(name="address") String address);

	/**
	 * 返回数据账户中指定的键的最新值； 

	 *
	 * 返回结果的顺序与指定的键的顺序是一致的；

	 *
	 * 如果某个键不存在，则返回版本为 -1 的数据项；
	 *
	 * @param ledgerHash
	 * @param address
	 * @param keys
	 * @return
	 */
	@HttpAction(method=HttpMethod.POST, path="ledgers/{ledgerHash}/accounts/{address}/entries")
	@Override
	TypedKVEntry[] getDataEntries(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                                 @PathParam(name="address") String address,
                                 @RequestParam(name="keys", array = true) String... keys);

	@HttpAction(method=HttpMethod.POST, path="ledgers/{ledgerHash}/accounts/{address}/entries-version")
	@Override
	TypedKVEntry[] getDataEntries(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
								 @PathParam(name="address") String address,
								 @RequestBody KVInfoVO kvInfoVO);

	/**
	 * 返回数据账户中指定序号的最新值；
	 * 返回结果的顺序与指定的序号的顺序是一致的；

	 *
	 * @param ledgerHash
	 *            账本hash；
	 * @param address
	 *            数据账户地址；
	 * @param fromIndex
	 *            开始的记录数；
	 * @param count
	 *            本次返回的记录数；

	 *            如果参数值为 -1，则返回全部的记录；

	 * @return
	 */
	@HttpAction(method = HttpMethod.POST, path = "ledgers/{ledgerHash}/accounts/address/{address}/entries")
	@Override
	TypedKVEntry[] getDataEntries(@PathParam(name = "ledgerHash") HashDigest ledgerHash,
										@PathParam(name = "address") String address,
										@RequestParam(name = "fromIndex", required = false) int fromIndex,
										@RequestParam(name = "count", required = false) int count);

	/**
	 * 返回指定数据账户中KV数据的总数;
	 * @param ledgerHash
	 * @param address
	 * @return
	 */
	@HttpAction(method = HttpMethod.GET, path = "ledgers/{ledgerHash}/accounts/address/{address}/entries/count")
	@Override
	long getDataEntriesTotalCount(@PathParam(name = "ledgerHash") HashDigest ledgerHash,
										 @PathParam(name = "address") String address);

	/**
	 * 返回合约账户信息；
	 *
	 * @param ledgerHash
	 * @param address
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/contracts/address/{address}")
	@Override
	ContractInfo getContract(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
                              @PathParam(name="address") String address);

	/**
	 * 返回系统事件列表；
	 *
	 *
	 * @param ledgerHash   账本哈希；
	 * @param eventName    事件名；
	 * @param fromSequence 开始的事件序列号；
	 * @param count     最大数量；
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/events/system/names/{eventName}")
	@Override
	Event[] getSystemEvents(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
							@PathParam(name="eventName") String eventName,
							@RequestParam(name = "fromSequence", required = false) long fromSequence,
							@RequestParam(name = "count", required = false) int count);

	/**
	 * 返回用户事件账户列表;
	 *
	 * @param ledgerHash
	 * @param fromIndex
	 * @param count
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path = "ledgers/{ledgerHash}/events/user/accounts")
	@Override
	BlockchainIdentity[] getUserEventAccounts(@PathParam(name="ledgerHash")  HashDigest ledgerHash,
													 @RequestParam(name = "fromIndex", required = false) int fromIndex,
													 @RequestParam(name = "count", required = false) int count);

	/**
	 * 返回用户事件列表；
	 *
	 * @param ledgerHash   账本哈希；
	 * @param address      事件账户地址；
	 * @param eventName    事件名；
	 * @param fromSequence 开始的事件序列号；
	 * @param count        最大数量；
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/events/user/accounts/{address}/names/{eventName}")
	@Override
	Event[] getUserEvents(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
						  @PathParam(name="address") String address,
						  @PathParam(name="eventName") String eventName,
						  @RequestParam(name = "fromSequence", required = false) long fromSequence,
						  @RequestParam(name = "count", required = false) int count);
	/**
	 * 返回合约账户信息；
	 *
	 * @param ledgerHash
	 * @param address
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/contracts/address/{address}/version/{version}")
	@Override
	ContractInfo getContract(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
							 @PathParam(name="address") String address, @PathParam(name="version") long version);


	/**
	 * get more users by fromIndex and count;
	 * @param ledgerHash
	 * @param fromIndex
	 * @param count
	 * @return
	 */
	@HttpAction(method = HttpMethod.GET, path = "ledgers/{ledgerHash}/users")
	@Override
	BlockchainIdentity[] getUsers(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
							 @RequestParam(name="fromIndex", required = false) int fromIndex,
							 @RequestParam(name="count", required = false) int count);

	/**
	 * get data accounts by ledgerHash and its range;
	 * @param ledgerHash
	 * @param fromIndex
	 * @param count
	 * @return
	 */
	@HttpAction(method = HttpMethod.GET, path = "ledgers/{ledgerHash}/accounts")
	@Override
	BlockchainIdentity[] getDataAccounts(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
							 @RequestParam(name="fromIndex", required = false) int fromIndex,
							 @RequestParam(name="count", required = false) int count);

	/**
	 * get contract accounts by ledgerHash and its range;
	 * @param ledgerHash
	 * @param fromIndex
	 * @param count
	 * @return
	 */
	@HttpAction(method = HttpMethod.GET, path = "ledgers/{ledgerHash}/contracts")
	@Override
	BlockchainIdentity[] getContractAccounts(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
									@RequestParam(name="fromIndex", required = false) int fromIndex,
									@RequestParam(name="count", required = false) int count);

	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/events/system/names/count")
	@Override
	long getSystemEventNameTotalCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash);

	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/events/system/names")
	@Override
	String[] getSystemEventNames(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
								@RequestParam(name = "fromIndex", required = false) int fromIndex,
								@RequestParam(name = "count", required = false) int count);

	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/events/system/names/{eventName}/count")
	@Override
	long getSystemEventsTotalCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
								   @PathParam(name="eventName") String eventName);

	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/events/user/accounts/{address}")
	@Override
	BlockchainIdentity getUserEventAccount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
										   @PathParam(name="address") String address);

	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/events/user/accounts/count")
	@Override
	long getUserEventAccountTotalCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash);

	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/events/user/accounts/{address}/names/count")
	@Override
	long getUserEventNameTotalCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
									@PathParam(name="address") String address);

	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/events/user/accounts/{address}/names")
	@Override
	String[] getUserEventNames(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
							  @PathParam(name="address") String address,
							  @RequestParam(name = "fromIndex", required = false) int fromIndex,
							  @RequestParam(name = "count", required = false) int count);

	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/events/user/accounts/{address}/names/{eventName}/count")
	@Override
	long getUserEventsTotalCount(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
								 @PathParam(name="address") String address,
								 @PathParam(name="eventName") String eventName);

	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/events/system/names/{eventName}/latest")
	@Override
	Event getLatestEvent(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
						 @PathParam(name="eventName") String eventName);

	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/events/user/accounts/{address}/names/{eventName}/latest")
	@Override
	Event getLatestEvent(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
						 @PathParam(name="address") String address,
						 @PathParam(name="eventName") String eventName);
	/**
	 * get role's privilege;
	 * @param ledgerHash
	 * @param roleName
	 * @return
	 */
	@HttpAction(method = HttpMethod.GET, path = "ledgers/{ledgerHash}/authorization/role/{roleName}")
	@Override
	PrivilegeSet getRolePrivileges(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
								   @PathParam(name="roleName") String roleName);

	/**
	 * get user's privilege;
	 *
	 * @param ledgerHash
	 * @param userAddress
	 * @return
	 */
	@HttpAction(method=HttpMethod.GET, path="ledgers/{ledgerHash}/authorization/user/{userAddress}")
	@Override
	UserPrivilegeSet getUserPrivileges(@PathParam(name="ledgerHash", converter=HashDigestToStringConverter.class) HashDigest ledgerHash,
									   @PathParam(name="userAddress") String userAddress);
}