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)