Hprose for Java客户端（四）

异常处理

同步调用异常处理

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

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

异步调用异常处理

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

如果您希望能够处理这些异常，只需要给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，第一个参数表示发生错误的远程方法名，第二个参数为抛出并被捕获的异常对象。

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

HTTP参数设置

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

代理服务器

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

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

持久连接

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

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

HTTP标头

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

标头名不可以为以下值：

• Context-Type
• Context-Length
• Connection
• Keep-Alive
• Host

因为这些标头有特别意义，客户端会自动设定这些值。

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