大家好,又见面了,我是你们的朋友全栈君。
前言
最近项目上需要对接WebService接口,之前从来没有用过,这次都遇见了。记录下基础的使用和我遇见的问题。 如果是报错找答案的,建议直接查看最后 “遇见的问题” 或搜索文章内容查看对应的问题。
正文
概述
WebService接口百度一搜,各个介绍的都非常详细,由于刚开始没接触,看的也不是很懂。首先记住一句话:WebService是一种跨编程语言和跨操作系统平台的远程调用技术。 跨编程语言和跨操作系统平台:也就是说Asp.net开发的WebService用java代码调用完全没问题,和操作系统也没有关系。 远程调用技术:也就是说网络是通的就能用。 那么这个WebService到底是干嘛用的?
作用
不同系统之间进行对接!比如现在需要使用第三方公司的短信服务,使用WebService来调用它的服务,只需要第三方公司提供一个接口调用文档和WebService地址,就能根据文档地址编程去调用它开放的短信服务,发送短信。为什么是WebService?
优缺点
回到那句话,WebService是一种跨编程语言和跨操作系统平台的远程调用技术。 优点: 1.跨语言和跨操作系统:因为WevService是通过Xml语言进行描述的,XML主要的优点在于它既与平台无关,又与厂商无关。 2.远程调用技术:不用担心防火墙的问题。。。 缺点: 1.服务端接口方为webservice则客户端也必须使用webservice。 2.因为webservice使用xml传输数据,因此性能上不能满足高并发。 3.有点笨重。。。 其实WebService并不是非常流行,往往RESTful就能够达到需要,但是遇到了笔记还是要做的。
使用
只介绍对接WebService接口,生成请自行百度。 这次对接了java的WebService接口和C#写的WebService接口。
CXF 调用java WebService
首先看看提供的WebService接口地址:http://127.0.0.1:8080/jjh/webService/smsXXX?wsdl 一般都是给到这种地址,访问地址可以看到这个接口的xml描述,可以通过这个描述来生成java代码到本地来方便使用,比如一些实体类,service方法。 准确的来说可以使用JDK自带的和CXF提供的命令,直接生成java代码,这里只建议使用Apach的CXF,直接去官网下载最新的cxf包,进入bin目录下,打开命令窗口,使用cxf命令生成java代码,这里提供一个最基础的:wsdl2java -encoding utf-8 http://127.0.0.1:8080/jjh/webService/smsXXX?wsdl 执行之后你的bin目录下面会生成java文件,有了java文件下面就可以根据java文件和第三方给的文档进行调用了。 比如,生成了IhalloWorld.java和IService.java文件,发现IhalloWorld接口里面声明了sendSms(args…)方法。
代码语言:javascript复制public static void main(String[] args) {
JaxWsProxyFactoryBean factoryBean = new JaxWsProxyFactoryBean();
//要得到的对象,是根据本地IService 接口取得的。
factoryBean.setServiceClass(IService .class);
//调用地址
factoryBean.setAddress("http://127.0.0.1:8080/jjh/webService/smsXXX");
//通过webservice取到IService的实现类,这个实现类才是你真正想要的,里面包括了你需要的东西。
IService service = (IService)factoryBean.create();
IhalloWorld hello = service.getHelloWorld("xxx");
System.out.println("Hello:" hello.sendSms("XXX你好..."));
}
参考链接: JAVA webservice之CXF WebService学习整理-JDK的wsimport命令和cxf的wsdl2java命令的区别和使用 java接口调用——webservice就是一个RPC而已 cxf的wsdl2java命令和JDK的wsimport命令的区别和使用
asmx
下面又对接了一个C#写的WebService接口,比如链接为:http://127.0.0.1:81/WebServiceCS/service.asmx ,在这个链接后面加上?wsdl,即: http://127.0.0.1:81/WebServiceCS/service.asmx?wsdl 也是可以使用cxf生成java代码的,但是注意一点,这接口是C#写的,xml只描述出实体信息,生成类似实体类的文件,没有现成的接口使用。一般其实也用不到cxf来生成,作用不大。参考例子:
代码语言:javascript复制public String sendMail(Object[] params) {
String soapaction = "http://tempuri.org/"; // 域名,这是在server定义的,在链接里面看得到,下面介绍。
String operationName = "Mail_Send";// 调用服务名
Service service = new Service();
String ret = "";
try {
Call call = (Call) service.createCall();
call.setTargetEndpointAddress(url);
call.setOperationName(new QName(soapaction, operationName)); // 设置要调用的方法
call.addParameter(new QName(soapaction, "vvvv"), // 需要传递的参数名
org.apache.axis.encoding.XMLType.XSD_STRING,
javax.xml.rpc.ParameterMode.IN);
call.addParameter(new QName(soapaction, "jjj"), // 需要传递的参数名
org.apache.axis.encoding.XMLType.XSD_STRING,
javax.xml.rpc.ParameterMode.IN);
call.setReturnType(org.apache.axis.encoding.XMLType.XSD_STRING);// (标准的返回类型)
call.setUseSOAPAction(true);
call.setSOAPActionURI(soapaction operationName);//url,域名加方法名
ret = (String) call.invoke(params);// 调用方法并传递参数,params包含参数
} catch (Exception ex) {
ex.printStackTrace();
}
return ret;
}
其中operationName服务名和soapaction域名都在你的链接中可以找到 http://127.0.0.1:81/WebServiceCS/service.asmx
其中参数params数组根据你服务需要的参数来传,比如需要一个规范的xml字符串作为参数,使用dom4j进行操作。
代码语言:javascript复制 Document doc = DocumentHelper.createDocument();
//增加根节点
Element books = doc.addElement("books");
//增加子元素
Element book1 = books.addElement("book");
Element title1 = book1.addElement("title");
Element author1 = book1.addElement("author");
Element book2 = books.addElement("book");
Element title2 = book2.addElement("title");
Element author2 = book2.addElement("author");
//为子节点添加属性
book1.addAttribute("id", "001");
//为元素添加内容
title1.setText("Harry Potter");
author1.setText("J K. Rowling");
book2.addAttribute("id", "002");
title2.setText("Learning XML");
author2.setText("Erik T. Ray");
OutputFormat format = OutputFormat.createCompactFormat();
format.setIndent(true); //设置是否缩进
format.setIndent(" "); //以四个空格方式实现缩进
format.setNewlines(true); //设置是否换行
//设置输出编码
format.setEncoding("gb2312");
StringWriter writer = new StringWriter();
XMLWriter output = new XMLWriter(writer, format);
try {
output.write(doc);
writer.close();
output.close();
System.out.println(writer.toString());//打印xml字符串
} catch (IOException e) {
e.printStackTrace();
}
打印结果
参考链接: Java调用webservice的.asmx后缀接口 java调用webservice接口(.asmx)
遇见的问题
说实话开发起来挺快的,毕竟人家提供接口,东西都是现成的,最要命的问题就是报错了。
导包
包没导好,错少不了,可以参考这个博主的包导一导试试java调用webservice接口(.asmx),遇见报错不要慌,参考一下这个解决:WebService几个常见的异常 我这里遇到的一个问题就是: java.lang.NoClassDefFoundError: Could not initialize class org.apache.axis.client.AxisClient 我是由于commons-logging.jar包依赖版本冲突导致的,commons-discovery.jar包里面依赖了commons-logging包,但是,我自己导了commons-logging包,我的解决是排查commons-discovery对commons-logging的依赖:
代码语言:javascript复制 <dependency>
<groupId>commons-discovery</groupId>
<artifactId>commons-discovery</artifactId>
<version>0.5</version>
<exclusions>
<exclusion>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
<version>1.2</version>
</dependency>
参考的java.lang.NoClassDefFoundError博客。 接下来我又遇见了新的问题,弄了很久:由于我上面用了CXF,引入了一些包和我现在调.asmx接口axis2引入包又版本冲突了,,,,这个真的没找到,项目一调用CXF的那个接口就报错: java.lang.RuntimeException: Cannot create a secure XMLInputFactory 网上找了找解决办法: 1.有说缺少包,导入woodstox-core-asl-4.4.1.jar和stax2-api-3.1.4.jar包。 2.woodstox-core-asl包需要优先被加载,修改tomcat下,这个包在lib文件夹的名字,因为tomcat是按顺序来加载的,woodstox-core-asl改名为awoodstox-core-asl,让它优先加载。 参考: 解决 调用报错: “Cannot create a secure XMLInputFactory” java.lang.RuntimeException: Cannot create a secure XMLInputFactory解决方案
但是,上面两个都没解决我的问题,我感觉原因还是版本冲突了,,, 最后我找到了一个解决方法: CXF报安全性错误 Cannot create a secure XMLInputFactory 大佬就是大佬,然后我就调用之前添加了这行代码:
代码语言:javascript复制 System.setProperty(StaxUtils.ALLOW_INSECURE_PARSER, "true");
完美,但是这个版本冲突估计是没救了,依赖太多了。 idea插件没解决掉,然后查看maven依赖树来解决: 我以为的maven依赖图是这样的(一览无余):
实际上是这样的:
对不起,一览无余,打扰了。。。能力有限,版本冲突我干不掉了。 之前组长是建议我添加一个简单的web项目,里面只部署CXF 对接的接口供我项目调用,这样两个接口依赖的包就不会在一块有版本冲突了,我觉得这个方法还是很赞的!!!
后续
后面项目部署到tomcat上面,发现jar包还是冲突啦!!! 大概错误就是这样
代码语言:javascript复制Caused by: java.lang.NoSuchFieldError: REFLECTION
at com.sun.xml.bind.v2.model.impl.RuntimeModelBuilder.<init>(RuntimeModelBuilder.java:43)
at com.sun.xml.bind.v2.runtime.JAXBContextImpl.getTypeInfoSet(JAXBContextImpl.java:344)
at com.sun.xml.bind.v2.runtime.JAXBContextImpl.<init>(JAXBContextImpl.java:216)
at com.sun.xml.bind.v2.ContextFactory.createContext(ContextFactory.java:76)
at com.sun.xml.bind.v2.ContextFactory.createContext(ContextFactory.java:55)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.lang.reflect.Method.invoke(Method.java:498)
at javax.xml.bind.ContextFinder.newInstance(ContextFinder.java:247)
at javax.xml.bind.ContextFinder.newInstance(ContextFinder.java:234)
at javax.xml.bind.ContextFinder.find(ContextFinder.java:441)
at javax.xml.bind.JAXBContext.newInstance(JAXBContext.java:641)
at javax.xml.bind.JAXBContext.newInstance(JAXBContext.java:584)
一番搜索后参照: stackoverflow java.lang.NoSuchFieldError: REFLECTION 发现是com.sun.xml.bind:jaxb-core和com.sun.xml.bind:jaxb-impl****两个包版本号不一致造成的冲突。首先查看jar包的依赖情况,使用idea查看依赖树,运行maven命令 mvn dependency:tree。
不使用idea也一样,在pom文件位置打开cmd面板,如下图,在路径处输入cmd回车,执行maven命令 mvn dependency:tree。
查看jar包依赖情况:
分别搜索jaxb-impl和jaxb-core,发现它们是jar包axis2-jaxws和cxf-rt-frontend-jaxws分别依赖的子包。版本号分别是2.1.7和2.2.11,我这里是取消了axis2-jaxws对jaxb-impl的依赖,单独配置jaxb-impl的依赖,指定版本号和jaxb-core一致2.2.11。
最后将打包后的jaxb相关包替换在tomcat的包,使得版本一致,到此版本冲突问题解决。
参考地址集合
JAVA webservice之CXF WebService学习整理-JDK的wsimport命令和cxf的wsdl2java命令的区别和使用 java接口调用——webservice就是一个RPC而已 cxf的wsdl2java命令和JDK的wsimport命令的区别和使用
Java调用webservice的.asmx后缀接口 java调用webservice接口(.asmx)
WebService几个常见的异常 java.lang.NoClassDefFoundError
解决 调用报错: “Cannot create a secure XMLInputFactory” java.lang.RuntimeException: Cannot create a secure XMLInputFactory解决方案
CXF报安全性错误 Cannot create a secure XMLInputFactory
stackoverflow java.lang.NoSuchFieldError: REFLECTION maven dependency:tree中反斜杠的含义 如何查看Maven项目中的jar包依赖树情况?
发布者:全栈程序员栈长,转载请注明出处:https://javaforall.cn/131154.html原文链接:https://javaforall.cn