Hprose for Java客户端(四)

蒋永宁
2023-12-01
[b][size=x-large]异常处理[/size][/b]

[b][size=large]同步调用异常处理[/size][/b]

同步调用下的发生的异常将被直接抛出,使用try...catch语句块即可捕获异常,通常服务器端调用返回的异常是HproseException类型。而如果通讯发生错误,一般为IOException类型。但是在调用过程中也可能抛出其它类型的异常,为了保险,您可以使用catch捕获Throwable类型来处理全部可能发生的异常。

另外,如果您采用代理接口方式调用,需要注意,您捕捉到的异常是被包装后的,使用getCause方法来获取真正包含出错信息的异常。

[b][size=large]异步调用异常处理[/size][/b]

异步调用时,如果调用过程中发生异常,异常将不会被抛出。

如果您希望能够处理这些异常,只需要给Hprose客户端对象指定合适的onError事件即可,onError事件的类型为hprose.common.HproseErrorEvent,它是一个接口类型,使用非常简单,例如:
        HproseHttpClient client = new HproseHttpClient();
client.onError = new HproseErrorEvent() {
public void handler(String name, Throwable ex) {
System.out.println(name + ":" + ex.toString());
}
};


该接口只有一个方法handler,第一个参数表示发生错误的远程方法名,第二个参数为抛出并被捕获的异常对象。

该事件只对异步调用有效,同步调用下的异常将被直接抛出,而不会被该事件捕获并处理。

[b][size=x-large]HTTP参数设置[/size][/b]

目前的版本只提供了http客户端实现,针对于http客户端,有一些特别的设置,例如代理服务器、持久连接、http标头等设置,下面我们来分别介绍。

[b][size=large]代理服务器[/size][/b]

默认情况下,代理服务器是被禁用的。可以通过setProxyHost、setProxyPort来设置http代理服务器的地址和端口。ProxyHost可以是IP或者域名,用字符串来表示,默认值为null,表示禁用代理服务器。ProxyPort为端口号,用整数表示,默认是80。

如果您所使用的代理服务器需要身份验证,可以通过setProxyUser和setProxyPass来设置用于代理服务器上验证的用户名和密码。这两个属性的默认值也为null,表示不需要身份验证。

[b][size=large]持久连接[/size][/b]

默认情况下,持久连接是关闭的。通常情况下,客户端在进行远程调用时,并不需要跟服务器保持持久连接,但如果您有连续的多次调用,可以通过开启这个特性来优化效率。

跟持久连接有关的属性有两个,它们分别是KeepAlive和KeepAliveTimeout,可以通过它们的set方法(setKeepAlive和setKeepAliveTimeout)来对它们进行设置。将KeepAlive属性设置为true时,表示开启持久连接特征。KeepAliveTimeout表示持久连接超时时间,单位是秒,默认值是300秒。

[b][size=large]HTTP标头[/size][/b]

有时候您可能需要设置特殊的http标头,例如当您的服务器需要Basic认证的时候,您就需要提供一个Authorization标头。设置标头很简单,只需要调用setHeader方法就可以啦,该方法的第一个参数为标头名,第二个参数为标头值,这两个参数都是字符串型。如果将第二个参数设置为null,则表示删除这个标头。

标头名不可以为以下值:
[list]
[*]Context-Type
[*]Context-Length
[*]Connection
[*]Keep-Alive
[*]Host
[/list]
因为这些标头有特别意义,客户端会自动设定这些值。

另外,Cookie这个标头不要轻易去设置它,因为设置它会影响Cookie的自动处理,如果您的通讯中用到了Session,通过setHeader方法来设置Cookie标头,将会影响Session的正常工作。
 类似资料: