CXF的WebService客户端超时
在使用WebService时,我们通常都会在客户端中设置请求超时的限制,以避免长时间的去连接不可用的服务器。在CXF的环境下,客户端可通过两个属性配置超时限制:
ConnectionTimeout - WebService以TCP连接为基础,这个属性可以理解为TCP握手时的时间设置,超过设置的时间就认为是连接超时.以毫秒为单位,默认是30000毫秒,即30秒。
ReceiveTimeout - 这个属性是发送WebService的请求后等待响应的时间,超过设置的时长就认为是响应超时.以毫秒为单位,默认是60000毫秒,即60秒.
?? 这里可通过两种方式对客户端进行配置:
?? 一、在spring的配置文件中进行设置。
<? xml?? version = "1.0"?? encoding = "UTF-8" ?>??????
??? < beans?? xmlns = "http://www.springframework.org/schema/beans"??????
???????? xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"??????
???????? xmlns:jee = "http://www.springframework.org/schema/jee"??????
???????? xmlns:jaxws = "http://cxf.apache.org/jaxws"??????
???????? xmlns:http-conf = "http://cxf.apache.org/transports/http/configuration"???????
???????? xsi:schemaLocation ="http://www.springframework.org/schema/beans????
???????????? http://www.springframework.org/schema/beans/spring-beans-2.0.xsd?????
???????????? http://www.springframework.org/schema/jee????
???????????? http://www.springframework.org/schema/jee/spring-jee-2.0.xsd?????
???????????? http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd?????
???????????? http://cxf.apache.org/transports/http/configuration????
???????????? http://cxf.apache.org/schemas/configuration/http-conf.xsd " >??????
??????? < http-conf:conduit?? name = "{WSDL Namespace}portName.http-conduit" >???????
?????????? < http-conf:client?? ConnectionTimeout = "10000"?? ReceiveTimeout = "20000" />??????
??????? </ http-conf:conduit >???????
??? </ beans >???
这里需要注意的有几个地方:?
?? 1、需要指定http-conf名称空间:xmlns:http-conf=http://cxf.apache.org/transports/http/configuration。
?? 2、指定模式位置: http://cxf.apache.org/transports/http/configuration http://cxf.apache.org/schemas/configuration/http-conf.xsd。
?? 3、http-conf:conduit中的name属性,指定设置生效的服务。name属性由service的namespace、WSDL中的 port name和".http-conduit"组成,如{http://apache.org/hello_world}HelloWorld.http- conduit。如果将name属性设置为“*.http-conduit”,则会对所有服务生效。
?
?? 二、通过java代码进行设置(对端口有效,即此端口对应的所有WEBSERIVCE服务有效)。
Client client = ClientProxy.getClient(port);???
HTTPConduit http = (HTTPConduit) client.getConduit();???
HTTPClientPolicy httpClientPolicy =? new? HTTPClientPolicy();???
httpClientPolicy.setConnectionTimeout( 36000 );???
httpClientPolicy.setAllowChunking( false );???
httpClientPolicy.setReceiveTimeout( 32000 );???
http.setClient(httpClientPolicy);
另:也可以对服务器端进行设置spring代码如下:??? <!-- 在服务器端设置响应超时限制,现在使用的是默认值30秒 -->
??? <http-conf:destination name="*.http-conduit">
??????? <http-conf:server ReceiveTimeout="30000" />
??? </http-conf:destination>
★更详细的配置请参考CXF官方文档:???
http://cwiki.apache.org/CXF20DOC/client-http-transport-including-ssl-support.html?
二、通过java代码进行设置(对单个有效服务有效)
public class CXFClientUtil {?
?????
??? public static final int CXF_CLIENT_CONNECT_TIMEOUT = 3 * 1000;?
??? public static final int CXF_CLIENT_RECEIVE_TIMEOUT = 5 * 1000;?
?
??? public static void configTimeout(Object service) {?
??????? Client proxy = ClientProxy.getClient(service);?
??????? HTTPConduit conduit = (HTTPConduit) proxy.getConduit();?
??????? HTTPClientPolicy policy = new HTTPClientPolicy();?
??????? policy.setConnectionTimeout(CXF_CLIENT_CONNECT_TIMEOUT);?
??????? policy.setReceiveTimeout(CXF_CLIENT_RECEIVE_TIMEOUT);?
??????? conduit.setClient(policy);?
??? }???????
}?
CXF_CLIENT_CONNECT_TIMEOUT 为与获取服务端连接的超时时间,单位为毫秒
CXF_CLIENT_RECEIVE_TIMEOUT 为获取连接后接收数据的超时时间,单位为毫秒
?
在“代码片段一”的最后加入 CXFClientUtil.setTimeout(service); 就可以了,完整代码如下:
代码片段二:
JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean();?
factory.setAddress(SERVICE_ADDRESS);?
factory.setServiceClass(DemoService.class);?
DemoService service = (DemoService) factory.create();?
CXFClientUtil.setTimeout(service);?
?
超时可能出现以下错误 cxf的webservice的Could not send Message Interceptor for {http://10.66.100.66/SPSFORMES/}IOSpsForMes#{http://10.66.100.66/SPSFORMES/}SetBomNeed has thrown exception,unwinding now org.apache.cxf.interceptor.Fault: Could not send Message. at org.apache.cxf.interceptor.MessageSenderInterceptor$MessageSenderEndingInterceptor.handleMessage(MessageSenderInterceptor.java:64)