com.baidu.driver4j.bns

类 BNSQueryAgentProxy

java.lang.Object

com.baidu.driver4j.bns.BNSQueryAgentProxy

所有已实现的接口:

com.baidu.driver4j.bns.InstanceQuery

public class BNSQueryAgentProxy
extends Object
implements com.baidu.driver4j.bns.InstanceQuery

BNS query proxy which query from BNS agent supports.

从以下版本开始:

1.0.0

作者:

xiemalin

方法概要

方法

限定符和类型	方法和说明
protected byte[]	doRequest(String host, int port, byte[] requestBodyBytes, short requestMsgType, short expectResponseType, int timeoutMs) Communicate with target host
protected byte[]	getBNSMsgBytes(byte[] requestBodyBytes, short requestMsgType)
com.baidu.driver4j.bns.BNSQueryProxy	getBnsQueryProxy() Gets the bns query proxy.
static String	getDefaultGateway()
List<com.baidu.driver4j.bns.Instance>	getInstanceByService(String serviceName) Get the instances list of given serviceName.
List<com.baidu.driver4j.bns.Instance>	getInstanceByService(String serviceName, int timeoutMs) Get the instances list of given serviceName.
com.baidu.driver4j.bns.Instance	getInstanceByService(String serviceName, com.baidu.driver4j.bns.SelectionStrategy strategy) Get only one instance by SelectionStrategy.
com.baidu.driver4j.bns.Instance	getInstanceByService(String serviceName, com.baidu.driver4j.bns.SelectionStrategy strategy, int timeout) Get only one instance by SelectionStrategy.
static String	getLocalNamedAddress()
com.baidu.driver4j.bns.Service	getService(String serviceName) Get the Service object by noah service name.
com.baidu.driver4j.bns.Service	getService(String serviceName, int timeoutMs) Get the Service object first it will query from local agent then try to query from remote agent, at last query from HTTP API
static BNSQueryAgentProxy	proxy()
static BNSQueryAgentProxy	proxy(com.baidu.driver4j.bns.BNSQueryProxy proxy)
static BNSQueryAgentProxy	proxy(String bnsServiceUrl)
List<com.baidu.driver4j.bns.Instance>	queryInstances(String serviceName)
protected byte[]	readBNSMsg(InputStream is, short expectResponseType)
protected com.baidu.driver4j.bns.Instance	selectOneByStrategy(List<com.baidu.driver4j.bns.Instance> instances, com.baidu.driver4j.bns.SelectionStrategy strategy) To select only one instance by SelectionStrategy. or return null if a empty instances list.
void	setConnectTimeout(int connectTimeout) setter method for property connectTimeout
void	setReadTimeout(int readTimeout) setter method for property readTimeout

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

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

方法详细资料

proxy

public static BNSQueryAgentProxy proxy()

proxy

public static BNSQueryAgentProxy proxy(String bnsServiceUrl)

proxy

public static BNSQueryAgentProxy proxy(com.baidu.driver4j.bns.BNSQueryProxy proxy)

setConnectTimeout

public void setConnectTimeout(int connectTimeout)

setter method for property connectTimeout

参数:

connectTimeout - the connectTimeout to set

setReadTimeout

public void setReadTimeout(int readTimeout)

setter method for property readTimeout

参数:

readTimeout - the readTimeout to set

getInstanceByService

public com.baidu.driver4j.bns.Instance getInstanceByService(String serviceName,
                                                   com.baidu.driver4j.bns.SelectionStrategy strategy)
                                                     throws com.baidu.driver4j.bns.BNSException

Get only one instance by SelectionStrategy.

参数:

serviceName - service name

strategy - SelectionStrategy.

返回:

Instance object

抛出:

BNSException - in case of access BNS server failed

getInstanceByService

public com.baidu.driver4j.bns.Instance getInstanceByService(String serviceName,
                                                   com.baidu.driver4j.bns.SelectionStrategy strategy,
                                                   int timeout)
                                                     throws com.baidu.driver4j.bns.BNSException

Get only one instance by SelectionStrategy.

参数:

serviceName - service name

strategy - SelectionStrategy.

timeout - time out on reading

返回:

Instance object

抛出:

BNSException - in case of access BNS server failed

selectOneByStrategy

protected com.baidu.driver4j.bns.Instance selectOneByStrategy(List<com.baidu.driver4j.bns.Instance> instances,
                                                  com.baidu.driver4j.bns.SelectionStrategy strategy)

To select only one instance by SelectionStrategy. or return null if a empty instances list.

参数:

instances - target instance list

strategy - SelectionStrategy instance

返回:

Instance object

getInstanceByService

public List<com.baidu.driver4j.bns.Instance> getInstanceByService(String serviceName)
                                                           throws com.baidu.driver4j.bns.BNSException

Get the instances list of given serviceName. This function will throws BNSException with several kind of error code. Check BNSException.errorToString for more information.
You shold take BNS_SERVICE_BEYOND_THRESHOLD exceptin seriously, In many times, just use the previous result.

参数:

serviceName -

返回:

List instances list of the given serviceName

抛出:

BNSException - in case of access BNS server failed

另请参阅:

getInstanceByService(String, int)

getInstanceByService

public List<com.baidu.driver4j.bns.Instance> getInstanceByService(String serviceName,
                                                         int timeoutMs)
                                                           throws com.baidu.driver4j.bns.BNSException

Get the instances list of given serviceName.
first it will query from local agent then try to query from remote agent, at last query from HTTP API This function will throws BNSException with several kind of error code. Check BNSException.errorToString for more information.
You should take BNS_SERVICE_BEYOND_THRESHOLD exception seriously, In many times, just use the previous result.

参数:

serviceName -

timeoutMs - minimum is 500ms

返回:

List instances list of the given serviceName

抛出:

BNSException - in case of access BNS server failed

getService

public com.baidu.driver4j.bns.Service getService(String serviceName)

Get the Service object by noah service name.

参数:

serviceName - serivce name

timeoutMs - minimum is 500ms

返回:

Service instance

另请参阅:

getService(String, int)

getService

public com.baidu.driver4j.bns.Service getService(String serviceName,
                                        int timeoutMs)

Get the Service object first it will query from local agent then try to query from remote agent, at last query from HTTP API

参数:

serviceName - serivce name

timeoutMs - minimum is 500ms

返回:

Service instance

doRequest

protected byte[] doRequest(String host,
               int port,
               byte[] requestBodyBytes,
               short requestMsgType,
               short expectResponseType,
               int timeoutMs)
                    throws com.baidu.driver4j.bns.BNSException

Communicate with target host

参数:

host - host name

port - port number

requestBodyBytes - request bytes

requestMsgType - request type

expectResponseType - response type

timeoutMs - read time out

返回:

byte[] response content

抛出:

BNSException - in case of access BNS service failed

getBNSMsgBytes

protected byte[] getBNSMsgBytes(byte[] requestBodyBytes,
                    short requestMsgType)
                         throws IOException

抛出:

IOException

readBNSMsg

protected byte[] readBNSMsg(InputStream is,
                short expectResponseType)
                     throws IOException

抛出:

IOException

getLocalNamedAddress

public static String getLocalNamedAddress()

getDefaultGateway

public static String getDefaultGateway()

queryInstances

public List<com.baidu.driver4j.bns.Instance> queryInstances(String serviceName)
                                                     throws com.baidu.driver4j.bns.BNSException

指定者:

queryInstances 在接口中 com.baidu.driver4j.bns.InstanceQuery

抛出:

com.baidu.driver4j.bns.BNSException

getBnsQueryProxy

public com.baidu.driver4j.bns.BNSQueryProxy getBnsQueryProxy()

Gets the bns query proxy.

返回:

the bns query proxy