schema约束文件说明
一、什么是WebService?
基于web的服务,它是一种跨语言、跨平台的规范。实际是多个跨平台、跨语言通信方案的整合
可以跨语言、远程调用、跨平台调用;基于xml格式文档通过其他具体的协议进行服务与服务之间的通信。
在java1.6版本之后开始支持
二、webService中的专业术语
WSDL:WebService Description Language 即web服务的描述语言,实际就是定义webservice服务并发布之后的xml格式的文档
1、说明服务在什么地方,也就是标明服务的地址
2、说明服务提供了那些方法,该如何调用
SOAP:Simple Object Access Protocol 即简单对象访问协议。可以理解为在Http基础上+xml格式数据;主要包含三个部分
1、Envelope 必须的部分,以xml的根元素出现
2、Headers 可选的
3、Body 必须的部分,在这一部分,包含要执行的服务器方法和发送给服务器的参数
SEI: WebService Endppint Interface webService的终端接口,就是服务器端用来处理请求的接口
CXF:Celtix+Xfire 。 一个apache的用于开发webService服务端和客户端的框架
webService文档结构(wsdl文档结构)
该xml文档的格式由上至下定义了一系列关于发布的接口的信息,引用关系是由下往上进行引用的
三、webService开发
1、使用jdk原生注解方式开发
mac使用wsimport命令生成客户端代码时如果报错 。 zsh: no matches found: http://127.0.0.1:8080/webservice/sayhello?wsdl
解决方案 在mac系统 文件 。 ~/.zshrc 文件中 加入如下代码 setopt no_nomatch 保存之后重新加载该文件 source ~/.zshrc 。 注意:默认系统中可能没有该文件 。 直接新建文件即可
在类上使用@WebService注解表明该类是用于发布webService服务的类或者接口
在要发布的方法上使用@WebMethod注解。针对命名空间及其他参数可以使用注解中的属性进行指定
2、cxf方式
cxf支持的数据类型:相对于jdk的方式 。 它支持map数据结构,支持的数据结构更加丰富
CXF的拦截器:主要作用就是动态的操作请求和响应的数据
服务端开发和jdk原生方式类似。
客户端可以采用cxf的wsdl2Java命令生成客户端接口(该方式需要在本地安装cxf),也可以使用csf代理工厂生产客户端接口进行实现
、、、
package cn.lyn.webservice.client;
import cn.lyn.webservice.interceptor.CxfInterceptor;
import cn.lyn.webservice.serviceone.WebServiceInterface;
import org.apache.cxf.interceptor.Interceptor;
import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;
import org.apache.cxf.message.Message;
import java.util.List;
/**
- @author LengYouNuan
- @create 2021-05-24 下午2:13
*/
public class CxfClient {
public static void main(String[] args) {
JaxWsProxyFactoryBean jaxWsProxyFactoryBean=new JaxWsProxyFactoryBean();
jaxWsProxyFactoryBean.setAddress("http://127.0.0.1:8080/soap/sayHello");
jaxWsProxyFactoryBean.setServiceClass(WebServiceInterface.class);
//客户端日志出拦截器
List<Interceptor<? extends Message>> outFaultInterceptors = jaxWsProxyFactoryBean.getOutFaultInterceptors();
outFaultInterceptors.add(new CxfInterceptor());
//客户端日志入拦截器
List<Interceptor<? extends Message>> inFaultInterceptors = jaxWsProxyFactoryBean.getInFaultInterceptors();
inFaultInterceptors.add(new CxfInterceptor());
WebServiceInterface webServiceInterface = (WebServiceInterface) jaxWsProxyFactoryBean.create();
String aha = webServiceInterface.sayHello("aha");
System.out.println(aha);
}
}
、、、
3、http方式
该方式是应用在客户端方的。采用http请求的方式封装相关的参数进行接口的访问。需要注意的是SOAP参数的拼接。可以采用SOAPUI客户端工具根据wsdl文档生成请求报文,也可以自己根据wsdl文档自行拼接soap请求报文信息。
得到的响应数据一般都是xml格式,一般需要有效响应数据都在<return></return>标签里,需要自行解析
、、、
package cn.lyn.webservice.client;
import org.apache.http.HttpEntity;
import org.apache.http.client.config.RequestConfig;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.util.EntityUtils;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
import java.nio.charset.Charset;
/**
http方式调用webservice接口
@author LengYouNuan
-
@create 2021-05-24 下午4:30
*/
public class HttpClientMethod {private static final Logger logger = LogManager.getLogger(HttpClientMethod.class);
public static void main(String[] args) {
String name="aaa"; //soap 参数 String s = "<soapenv:Envelope xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/' xmlns:ws='http://自己的接口服务地址/'>\n" + " <soapenv:Header/>\n" + " <soapenv:Body>\n" + " <ws:sayHello>\n" + " <arg0>" + name + "</arg0>\n" + " </ws:sayHello>\n" + " </soapenv:Body>\n" + "</soapenv:Envelope>"; String soapXml= s; //获取http构建器对象 HttpClientBuilder builder = HttpClientBuilder.create(); CloseableHttpClient httpClient = builder.build(); //封装httppost请求对象 HttpPost httpPost = new HttpPost("http://127.0.0.1:8080/soap/sayHello"); httpPost.setConfig(RequestConfig.custom().setSocketTimeout(30000).setConnectTimeout(30000).build()); try { httpPost.setHeader("Content-Type", "text/xml;charset=UTF-8"); httpPost.setHeader("SOAPAction", ""); StringEntity data = new StringEntity(soapXml, Charset.forName("UTF-8")); httpPost.setEntity(data); //设置post请求参数实体 //执行http请求 CloseableHttpResponse response = httpClient .execute(httpPost); HttpEntity httpEntity = response.getEntity(); if (httpEntity != null) { // 打印响应内容 String retStr = EntityUtils.toString(httpEntity, "UTF-8"); logger.info("=================================================================================="); logger.info("=================================================================================="); logger.info("response:=========》" + retStr); } // 释放资源 httpClient.close(); } catch (Exception e) { logger.error("exception in doPostSoap1_1", e); }
}
}
、、、