今天在对接的客户用到了webservice,最终采用wsimport生成本地代理方式以SDK的形式对接,但是想的完整的总结一下ws的几种调用方式。
发布服务的IP地址是:192.168.125.116
客户端访问ws服务的IP是:192.168.125.115
1.发布ws服务:
参考:https://www.cnblogs.com/qlqwjy/p/9644078.html
applicationContext.xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:jaxws="http://cxf.apache.org/jaxws"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
http://cxf.apache.org/jaxws http://cxf.apache.org/jaxws http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.0.xsd"> <jaxws:endpoint id="userServiceWS"
implementor="cn.xm.exam.service.impl.webservice.UserWebServiceImpl" address="/userServiceWS">
</jaxws:endpoint> </beans>
web.xml如下:
<servlet>
<servlet-name>CXFServlet</servlet-name>
<servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>CXFServlet</servlet-name>
<url-pattern>/WS/*</url-pattern>
</servlet-mapping>
package cn.xm.exam.service.webservice; import java.util.Set; import javax.jws.WebService; import cn.xm.exam.bean.system.User; @WebService
public interface UserWebService { /**
* 根据用户身份证号码查询用户信息及其角色信息及其权限信息
*
* @param useridcard
* @return user
*/
public User getUserByUseridcard(String useridcard) throws Exception; /**
* 根据用户编号查询角色code的集合
*
* @param userid
* @return 角色集合
*/
public Set<String> getRoleByUserid(String userid) throws Exception; }
package cn.xm.exam.service.impl.webservice; import java.util.Set; import javax.annotation.Resource;
import javax.jws.WebService; import org.springframework.stereotype.Service; import cn.xm.exam.bean.system.User;
import cn.xm.exam.mapper.system.UserMapper;
import cn.xm.exam.service.webservice.UserWebService;
import cn.xm.exam.utils.ValidateCheck; @Service
@WebService(targetNamespace = "http://webservice.service.exam.xm.cn")
public class UserWebServiceImpl implements UserWebService {
@Resource
private UserMapper userMapper; @Override
public User getUserByUseridcard(String useridcard) {
if (ValidateCheck.isNull(useridcard)) {
return null;
}
User user = null;
try {
user = userMapper.getUserByUseridcard(useridcard);
} catch (Exception e) {
e.printStackTrace();
}
return user;
} @Override
public Set<String> getRoleByUserid(String userid) {
if (ValidateCheck.isNull(userid)) {
return null;
}
Set<String> role = null;
try {
role = userMapper.getRoleByUserid(userid);
} catch (Exception e) {
e.printStackTrace();
}
return role;
} }
启动之后查看ws服务:
查看wsdl:
2.访问ws的几种方式
1.wsimport生成本地代理的方式(简单--类似于SDK访问)
生成本地代码(如果需要下载源码,加上 -keep 参数即可)
wsimport http://192.168.125.116:85/Exam/WS/userServiceWS?wsdl
发现虽然我们只是发布了一个webservice,但是下载的时候会将接口中依赖的bean等信息也一起发布。
打包
jar cvf ./test.jar ./
放入eclipse进行测试
import java.net.MalformedURLException;
import java.net.URL; import javax.xml.namespace.QName; import cn.xm.exam.service.webservice.Exception_Exception;
import cn.xm.exam.service.webservice.User;
import cn.xm.exam.service.webservice.UserWebService;
import cn.xm.exam.service.webservice.UserWebServiceImplService; public class Test {
public static void main(String[] args) throws Exception_Exception,
MalformedURLException {
// 创建的时候用URL指定WSDL的地址;用QName指定targetNamespace和name。当然可以不指定,不指定使用的是默认值
// UserWebServiceImplService userWebServiceImplService = new UserWebServiceImplService();
UserWebServiceImplService userWebServiceImplService = new UserWebServiceImplService(
new URL("http://192.168.125.116:85/Exam/WS/userServiceWS?wsdl"),
new QName("http://webservice.service.exam.xm.cn",
"UserWebServiceImplService"));
UserWebService userWebServiceImplPort = userWebServiceImplService
.getUserWebServiceImplPort();
User userByUseridcard = userWebServiceImplPort
.getUserByUseridcard("140581197705070518");
System.out.println(userByUseridcard.getUsername());
}
}
结果:
返回从192.168.125.116返回数据库查询的信息。 也就是说我们调用ws接口的时候实际底层是http+xml,因此我们可以通过ws接口调用到服务器的信息。
2. CXF动态调用:(推荐这种)
依赖的包:
测试代码如下:
import javax.xml.namespace.QName; import org.apache.cxf.jaxws.endpoint.dynamic.JaxWsDynamicClientFactory; public class Test2 {
public static void main(String[] args) {
JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance(); org.apache.cxf.endpoint.Client client = dcf.createClient("http://localhost:85/Exam/WS/userServiceWS?wsdl"); // url为调用webService的wsdl地址 QName name = new QName("http://webservice.service.exam.xm.cn/", "getUserByUseridcard");// namespace是命名空间,methodName是方法名 Object[] objects;
try {
objects = client.invoke(name, "140581197705070518");// 第一个参数是上面的QName,第二个开始为参数,可变数组
System.out.println(objects);
} catch (Exception e) {
e.printStackTrace();
}
}
}
注意:
(1)QName的第一个参数必须带斜杠,也就是必须写为http://webservice.service.exam.xm.cn/,否则会报下面异常:
org.apache.cxf.common.i18n.UncheckedException: No operation was found with the name {http://webservice.service.exam.xm.cn}getUserByUseridcard.
at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:331)
at Test2.main(Test2.java:15)
(2)发布的webservice的接口和实现类要在同一个包,或者在实现类用注解声明发布的webservice地址。
CXF发布用的是业务类(xxxServiceImpl.java),那么默认的命名空间就会是业务类所在包(路径),而对外界暴露的则是接口类(XXXService.java),那么对于客户端(第三方)调用访问时,需要按照接口类所在包(路径)进行命名空间的定义。所以需要接口与实现在同一个包或者在实现类指定接口地址。
如下:(最好以/结尾---下面没有以斜杠结尾)
@Service
@WebService(targetNamespace = "http://webservice.service.exam.xm.cn")
public class UserWebServiceImpl implements UserWebService {
。。。
(3)查看namespace相关信息:(两两相同是因为上面发布的时候没有以/结尾,最好以/结尾四个namespace就会相同)
3.通过axis包访问(简单)
所需5个jar包 axis-1.4.jar axis-jaxrpc-1.4.jar commons-logging-1.2.jar commons-discovery-0.2.jar wsdl4j-1.6.3.jar
这个在测试的时候直接返回bean报错(解决办法就是加类型转换器),因此我返回的是String数据。接口和实现类修改如下:
package cn.xm.exam.service.webservice; import java.util.Set; import javax.jws.WebResult;
import javax.jws.WebService; import cn.xm.exam.bean.system.User; @WebService
public interface UserWebService { /**
* 根据用户身份证号码查询用户信息及其角色信息及其权限信息
*
* @param useridcard
* @return user
*/
public String getUsernameByUseridcard(String useridcard) throws Exception; /**
* 根据用户编号查询角色code的集合
*
* @param userid
* @return 角色集合
*/
public Set<String> getRoleByUserid(String userid) throws Exception; }
package cn.xm.exam.service.impl.webservice; import java.util.Set; import javax.annotation.Resource;
import javax.jws.WebService;
import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter; import org.springframework.stereotype.Service; import cn.xm.exam.bean.system.User;
import cn.xm.exam.mapper.system.UserMapper;
import cn.xm.exam.service.webservice.UserWebService;
import cn.xm.exam.utils.ValidateCheck; @Service
@WebService(targetNamespace = "http://webservice.service.exam.xm.cn")
public class UserWebServiceImpl implements UserWebService {
@Resource
private UserMapper userMapper; @Override
public String getUsernameByUseridcard(String useridcard) {
if (ValidateCheck.isNull(useridcard)) {
return null;
}
User user = null;
try {
user = userMapper.getUserByUseridcard(useridcard);
} catch (Exception e) {
e.printStackTrace();
}
return user == null ? "" : user.getUsername();
} @Override
public Set<String> getRoleByUserid(String userid) {
if (ValidateCheck.isNull(userid)) {
return null;
}
Set<String> role = null;
try {
role = userMapper.getRoleByUserid(userid);
} catch (Exception e) {
e.printStackTrace();
}
return role;
} }
测试代码:
代码一:
package zd.dms.wbws; import java.net.MalformedURLException;
import java.net.URL;
import java.rmi.RemoteException;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map; import javax.xml.namespace.QName;
import javax.xml.rpc.ParameterMode;
import javax.xml.rpc.ServiceException; import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.XMLType; public class AxisClient {
public static void main(String[] args) {
String webServiceURL = "http://localhost:85/Exam/WS/userServiceWS?wsdl";
String namespaceURI = "http://webservice.service.exam.xm.cn/";
String method = "getUsernameByUseridcard";
List<Map<String, Object>> params = new ArrayList<Map<String, Object>>();
Map<String, Object> map = new HashMap<String, Object>();
map.put("paramName", "arg0");
map.put("paramType", XMLType.XSD_STRING);
map.put("paramValue", "140581197705070518");
params.add(map);
String result = (String) AxisClient.getResult(webServiceURL, namespaceURI, method, null, params,
XMLType.XSD_STRING);
System.out.println(result);
} /**
* Axis方式访问WebService接口
*
* @param webServiceURL
* webService地址,末尾为?wsdl时不需要写
* @param namespaceURI
* 命名空间
* @param method
* 方法名称
* @param soapAction
* soapAction
* @param params
* 参数
* @param returnType
* 返回值类型
* @return
*/
public static Object getResult(String webServiceURL, String namespaceURI, String method, String soapAction,
List<Map<String, Object>> params, QName returnType) {
if (null == params || params.size() == 0)
return null;
// 创建客户端
Service service = new Service();
Call call = null;
try {
call = (Call) service.createCall();
// 设置访问地址
call.setTargetEndpointAddress(new URL(webServiceURL));
// 是否使用SOAPAction
if (null == soapAction || "".equals(soapAction)) {
call.setUseSOAPAction(false);
} else {
call.setUseSOAPAction(true);
// 设置SOAPAction地址
call.setSOAPActionURI(soapAction);
}
// 设置访问方法名称
call.setOperationName(new QName(namespaceURI, method));
// 添加解析类型的地址
call.setEncodingStyle(namespaceURI);
// 设置返回值类型
call.setReturnType(returnType);
// 添加参数名称
Object[] obj = new Object[params.size()];
for (int i = 0; i < params.size(); i++) {
Map<String, Object> map = params.get(i);
call.addParameter(new QName((String) map.get("paramName")), (QName) map.get("paramType"),
ParameterMode.IN);
obj[i] = map.get("paramValue");
}
return call.invoke(obj);
} catch (ServiceException e) {
e.printStackTrace();
return null;
} catch (MalformedURLException e) {
e.printStackTrace();
return null;
} catch (RemoteException e) {
e.printStackTrace();
return null;
}
}
}
代码二:
package zd.dms.wbws; import javax.xml.namespace.QName;
import javax.xml.rpc.ParameterMode; import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.XMLType; public class TestUseWebservice2 {
public static void main(String[] args) {
Object ticket = testWS();
System.out.println(ticket);
} public static Object testWS() {
try {
// wsdl的地址
String endpoint = "http://localhost:85/Exam/WS/userServiceWS?wsdl";
// 直接引用远程的wsdl文件
// 以下都是固定格式
Service service = new Service();
Call call = (Call) service.createCall();
call.setTargetEndpointAddress(endpoint); // WSDL里面描述的方法名称 填写方法名是需加上命名空间,否则会找不到对应的方法
call.setOperationName(new QName("http://webservice.service.exam.xm.cn/", "getUsernameByUseridcard"));
// 添加解析类型的地址
call.setEncodingStyle("webservice.service.exam.xm.cn"); // 给方法传递参数,并且调用方法
call.addParameter("arg0", XMLType.XSD_STRING, ParameterMode.IN);
call.setReturnType(XMLType.XSD_ENTITY);// 设置返回类型
return call.invoke(new Object[] { "140581197705070518" });
} catch (Exception e) {
e.printStackTrace();
return null;
}
}
}
由于webservice采用SOAP协议,相当于http+xml,因此我们访问的时候可以获取到服务器的数据。
而RPC相当于接口和实现分离,我们获取到接口,然后实现类可以从RPC的注册中心进行获取。当然RPC也可以获取远程的数据。其实webservice和RPC可以通过生成代理对象获取远程的数据。我们用RPC以本地方式调用服务,实则会向服务器的具体实现类发送请求并获取数据。(当然这中间有对方法、请求参数的包装以及解码等工作)