WebService接口的生成和调用(WebService接口)
Table of Contents
4:利用apache的AXIS直接调用远程的web service
Web Service是构建互联网分布式系统的基本部件,它是一个应用程序,它向外界暴露出一个能够通过Web进行调用的API。这就是说,别人能够用编程的方法通过Web来调用这个应用程序。
它通过标准通信协议,在互联网上以服务的方式发布有用的程序模块,目前大部分是用SOAP作为通信协议。
它提供一份详细的接口说明书,来帮助用户构建应用程序,这个接口说明书叫WSDL(Web服务描述语言,Web Service Description Language)。
请求报文和返回报文都是XML格式的,XML(Extensible Markup Language)即可扩展标记语言,它与HTML一样,都是SGML(Standard Generalized MarkupLanguage,标准通用标记语言)。
一:WebService的服务端发布
1:发布web程序服务端发布
创建 service 接口
创建接口实现类,实现业务逻辑
配置 web.xml 中 中 Xfire
提供对 xfire 的拦截
配置 webservice 配置
在 class 目录下建立 META-INF 目录,如(META-INF>xfire->services.xml),在
services.xml 文件中进行 webservice 服务的发布.
然后启动服务,在浏览器中输入http://ip/项目名称/services就可以看到发布的接口了
2:本地发布
import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.xml.ws.Endpoint;
/**
* Title: ServiceHello
* Description: 基于jdk1.6以上的javax.jws 发布webservice接口
@WebService - 它是一个注解,用在类上指定将此类发布成一个ws。
Endpoint – 此类为端点服务类,它的方法publish用于将一个已经添加了@WebService注解
对象绑定到一个地址的端口上。
* Version:1.0.0
* @author panchengming
*/
@WebService
public class JwsServiceHello {
/** 供客户端调用方法 该方法是非静态的,会被发布
* @param name 传入参数
* @return String 返回结果
* */
public String getValue(String name){
return "欢迎你! "+name;
}
/**
* 方法上加@WebMentod(exclude=true)后,此方法不被发布;
* @param name
* @return
*/
@WebMethod(exclude=true)
public String getHello(String name){
return "你好! "+name;
}
/** 静态方法不会被发布
* @param name
* @return
*/
public static String getString(String name){
return "再见!"+name;
}
//通过EndPoint(端点服务)发布一个WebService
public static void main(String[] args) {
/*参数:1,本地的服务地址;
2,提供服务的类;
*/
Endpoint.publish("http://192.168.1.105:8080/Service/ServiceHello", new JwsServiceHello());
System.out.println("发布成功!");
//发布成功后 在浏览器输入 http://192.168.1.105:8080/Service/ServiceHello?wsdl
}
}
二:Webservice客户端调用:
1:本地生成代码,直接调用:
1:新建一个class类,用于调用webservice。右键src,找到Web Service Client,并输入wsdl地址,选择下载代码的路径;
(url: http://192.168.1.105:8080/Service/ServiceHello?wsdl)
2.将地址上的文件下载下来(注意和发布JDK一致);
3.写调用方法调用下载下来的WebService中的java类中的方法;
示例:
import com.pcm.ws.jws.JwsServiceHello;
import com.pcm.ws.jws.JwsServiceHelloService;
/**
*
* Title: JwsClientHello
* Description: webService 客户端调用
* Version:1.0.0
* @author panchengming
*/
public class JwsClientHello {
public static void main(String[] args) {
//调用webservice
JwsServiceHello hello=new JwsServiceHelloService().getJwsServiceHelloPort();
String name=hello.getValue("panchengming");
System.out.println(name);
}
}
2、利用dos命令生成代码,和第一种基本一致
A、在工作空间创建用于存放使用wsimport命令生成的客户端代码的java工程
● wsimport命令是jdk提供的,作用是根据使用说明书生成客户端代码,wsimport只支持SOAP1.1客户端的生成
-d:默认参数,用于生成.class文件
-s:生成.java文件
-p:指定生成java文件的包名,不指定则为WSDL说明书中namespace值得倒写
C、在doc窗口进入java工程项目的src目录,执行wsimport命令
D、在Eclipse中刷新java项目,将生成的客户端代码copy到客户端工程中
E、创建服务视图,类名从<service>标签的name属性获取
F、获取服务实现类,视图实例调用getProt()方法,实现类的类名从portType的name属性获取
G、调用查询方法,方法名从portType下的operation标签的name属性获取
package com.webservice.client;
import com.webservice.jaxws.WeatherServiceImpl;
import com.webservice.jaxws.WeatherServiceImplService;
public class Client {
public static void main(String[] args) {
//创建视图
WeatherServiceImplService wsis = new WeatherServiceImplService();
//获取服务实现类
WeatherServiceImpl wsi = wsis.getPort(WeatherServiceImpl.class);
//调用查询方法
String weather = wsi.queryWeather("北京");
System.out.println(weather);
}
}
● <service> 服务视图,webservice的服务结点,它包括了服务端点
● <binding> 为每个服务端点定义消息格式和协议细节
● <portType> 服务端点,描述 web service可被执行的操作方法,以及相关的消息,通过binding指向portType
● <message> 定义一个操作(方法)的数据参数(可有多个参数)
● <types> 定义 web service 使用的全部数据类型
3:service编程实现调用
注意:
(1)该种方式可以自定义关键元素,方便以后维护,是一种标准的开发方式;
(2)这种方式同样需要wsimport生成客户端代码,只不过仅需要将服务接口类引入即可,例如如果需要<wsdl:port name="MobileCodeWSSoap" binding="tns:MobileCodeWSSoap">
端口服务,则需要将生成的MobileCodeWSSoap.class类引入;
A、wisimport生成客户端代码
B、使用serivce类创建服务视图
C、获取服务实现类
D、调用查询方法
import java.io.IOException;
import java.net.MalformedURLException;
import java.net.URL;
import javax.xml.namespace.QName;
import javax.xml.ws.Service;
import cn.itcast.mobile.MobileCodeWSSoap;
/**
*
* Title: ServiceClient.java
* Description:Service编程实现服务端调用
* 这种方式同样需要wsimport生成客户端代码,只不过仅需要将服务接口类引入即可,例如如果需要
* <wsdl:port name="MobileCodeWSSoap" binding="tns:MobileCodeWSSoap">
* 端口服务,则需要将生成的MobileCodeWSSoap.class类引入
*/
public class ServiceClient {
public static void main(String[] args) throws IOException {
//创建WSDL地址,不是服务地址
URL url = new URL("http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl");
//创建服务名称
//1.namespaceURI - 命名空间地址 (wsdl文档中的targetNamespace)
//2.localPart - 服务视图名 (wsdl文档中服务名称,例如<wsdl:service name="MobileCodeWS">)
QName qname = new QName("http://WebXml.com.cn/", "MobileCodeWS");
//Service创建视图
//参数:
//1.wsdlDocumentLocation - 使用说明书地址
//2.serviceName - 服务名称
Service service = Service.create(url, qname);
//获取服务实现类
//参数解释:serviceEndpointInterface - 服务端口(wsdl文档中服务端口的name属性,例如<wsdl:port name="MobileCodeWSSoap" binding="tns:MobileCodeWSSoap">)
MobileCodeWSSoap mobileCodeWSSoap = service.getPort(MobileCodeWSSoap.class);
//调用查询方法
String result = mobileCodeWSSoap.getMobileCodeInfo("188888888", "");
System.out.println(result);
}
}
4:利用apache的AXIS直接调用远程的web service
public static void axis() {
Service service = new Service();
try {
Call call = (Call) service.createCall();
//设置地址
call.setTargetEndpointAddress("http://www.webxml.com.cn/WebServices/ValidateEmailWebService.asmx?wsdl");
call.setUseSOAPAction(true);
//域名加方法,//上面有写着targetNamespace="http://x.x.x/",这个就是你的命名空间值了;加方法名
call.setSOAPActionURI("http://WebXml.com.cn/" + "ValidateEmailAddress");
// 设置要调用哪个方法
call.setOperationName(new QName("http://WebXml.com.cn/", "ValidateEmailAddress")); // 设置要调用哪个方法
//设置参数名 :参数名 ,参数类型:String, 参数模式:'IN' or 'OUT'
call.addParameter(new QName("http://WebXml.com.cn/", "theEmail"), // 设置要传递的参数
org.apache.axis.encoding.XMLType.XSD_STRING, javax.xml.rpc.ParameterMode.IN);
call.setEncodingStyle("UTF-8");
//返回类型
call.setReturnType(org.apache.axis.encoding.XMLType.XSD_STRING);// (标准的类型)
// 调用方法并传递参数
String res = String.valueOf(call.invoke(new Object[]{"wangkanglu1024@163.com"}));
System.out.println(res);
} catch (Exception ex) {
ex.printStackTrace();
}
public static void axis2() throws MalformedURLException, SOAPException, ServiceException, RemoteException {
String endpoint = "http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl";
String res = null;
// 查询电话号码的接口方法名
String operationName = "getMobileCodeInfo";
// 定义service对象
Service service = new Service();
// 创建一个call对象
Call call = (Call) service.createCall();
// 设置目标地址,即webservice路径
call.setTargetEndpointAddress(endpoint);
// 设置操作名称,即方法名称 targetNamespace="http://WebXml.com.cn/"
call.setOperationName(new QName("http://WebXml.com.cn/", operationName));
// 设置方法参数
call.addParameter(new QName("http://WebXml.com.cn/", "mobileCode"),
org.apache.axis.encoding.XMLType.XSD_STRING,
javax.xml.rpc.ParameterMode.IN);
call.addParameter(new QName("http://WebXml.com.cn/", "userID"),
org.apache.axis.encoding.XMLType.XSD_STRING,
javax.xml.rpc.ParameterMode.IN);
// 设置返回值类型
//对于返回是字符串数组的返回类型只有这两种可行
//call.setReturnType(org.apache.axis.encoding.XMLType.SOAP_VECTOR);
call.setReturnClass(java.lang.String.class);
call.setUseSOAPAction(true);
call.setSOAPActionURI("http://WebXml.com.cn/" + "getMobileCodeInfo");
res = (String) call.invoke(new Object[]{"15611111111", "0"});
// 如果返回类型是org.apache.axis.encoding.XMLType.SOAP_VECTOR时用下面的转型接收
//Vector v=(Vector) call.invoke(new Object[]{cityCode,userId});
System.out.println(res);
}
5:HttpURLConnection调用方式
A、创建服务地址
B、打开服务地址的一个连接
C、设置连接参数
● 注意
- a、POST必须大写,如果小写会出如下异常:
- b、如果不设置输入输出,会报异常
D、组织SOAP协议数据,发送给服务器
E、接收服务端的响应
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;
/**
*
* @ClassName: HttpURLConectionMode
* @Description: TODO(通过HttpURLConnection发送http请求)
* sope协议,比较麻烦的是需要拼接xml格式的请求数据
* @author
* @date 2017年11月8日 上午9:18:24
*
*/
public class HttpClient {
public static void main(String[] args) throws IOException {
//第一步:创建服务地址,不是WSDL地址
URL url = new URL("http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx");
//2:打开到服务地址的一个连接
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
//3:设置连接参数
//3.1设置发送方式:POST必须大写
connection.setRequestMethod("POST");
//3.2设置数据格式:Content-type
connection.setRequestProperty("content-type", "text/xml;charset=utf-8");
//3.3设置输入输出,新创建的connection默认是没有读写权限的,
connection.setDoInput(true);
connection.setDoOutput(true);
//4:组织SOAP协议数据,发送给服务端
String soapXML = getXML("1866666666");
OutputStream os = connection.getOutputStream();
os.write(soapXML.getBytes());
//5:接收服务端的响应
int responseCode = connection.getResponseCode();
if(200 == responseCode){//表示服务端响应成功
InputStream is = connection.getInputStream();
InputStreamReader isr = new InputStreamReader(is);
BufferedReader br = new BufferedReader(isr);
StringBuilder sb = new StringBuilder();
String temp = null;
while(null != (temp = br.readLine())){
sb.append(temp);
}
System.out.println(sb.toString());
is.close();
isr.close();
br.close();
}
os.close();
}
/**
* <?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<getMobileCodeInfo xmlns="http://WebXml.com.cn/">
<mobileCode>string</mobileCode>
<userID>string</userID>
</getMobileCodeInfo>
</soap:Body>
</soap:Envelope>
* @param phoneNum
* @return
*/
public static String getXML(String phoneNum){
String soapXML = "<?xml version=\"1.0\" encoding=\"utf-8\"?>"
+"<soap:Envelope xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">"
+"<soap:Body>"
+"<getMobileCodeInfo xmlns=\"http://WebXml.com.cn/\">"
+"<mobileCode>"+phoneNum+"</mobileCode>"
+"<userID></userID>"
+"</getMobileCodeInfo>"
+" </soap:Body>"
+"</soap:Envelope>";
return soapXML;
}
}
提供一个比较完善一点的工具类
public Map<String, Object> webServiceRequestUtil(String requesturl, String soapXML) throws IOException, ZycxException {
HttpURLConnection connection = null;
OutputStream os = null;
Map<String, Object> reslut = new HashMap<>();
try {
//1:创建服务地址
URL url = new URL(requesturl);
//2:打开到服务地址的一个连接
connection = (HttpURLConnection) url.openConnection();
//3:设置连接参数
//3.1设置发送方式:POST必须大写
connection.setRequestMethod("POST");
//3.2设置数据格式:Content-type
connection.setRequestProperty("content-type", "text/xml;charset=utf-8");
//3.3设置输入输出,新创建的connection默认是没有读写权限的,
connection.setDoInput(true);
connection.setDoOutput(true);
//4:组织SOAP协议数据,发送给服务端
os = connection.getOutputStream();
os.write(soapXML.getBytes());
} catch (IOException e) {
throw new myException("链接webservice出错!url为:" + requesturl + ";exception:" + e);
}
StringBuilder sb = new StringBuilder();
InputStream is = null;
InputStreamReader isr = null;
BufferedReader br = null;
try {
String temp = null;
//5:接收服务端的响应
int responseCode = connection.getResponseCode();
if (200 == responseCode) {//表示服务端响应成功
is = connection.getInputStream();
isr = new InputStreamReader(is);
br = new BufferedReader(isr);
while ((temp = br.readLine()) != null) {
sb.append(temp);
}
//这是我自己封装了一个map的返回格式,封装了headr和body
reslut = ReturnUtil.returnjSON(BackStatus.BACK_STATUS_OK, "success", sb.toString());
} else {
is = connection.getInputStream();
isr = new InputStreamReader(is);
br = new BufferedReader(isr);
while ((temp = br.readLine()) != null) {
sb.append(temp);
}
reslut = ReturnUtil.returnjSON(BackStatus.BACK_STATUS_EXCEPTION + "", "请求出错,http响应为:"+responseCode, sb.toString());
}
} catch (IOException e) {
throw new myException("返回结果解析出错" + e);
} finally {
if(!Objects.isNull(br)){
br.close();
}
if(!Objects.isNull(isr)){
isr.close();
}
if(!Objects.isNull(is)){
is.close();
}
if(!Objects.isNull(os)){
os.close();
}
}
return reslut;
}
6.Ajax调用方式
<!doctype html>
<html lang="en">
<head>
<title>Ajax调用方式</title>
<script type="text/javascript">
function queryMobile(){
//创建XMLHttpRequest对象
var xhr = new XMLHttpRequest();
//打开链接
xhr.open("post","http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx",true);
//设置content-type
xhr.setRequestHeader("content-type","text/xml;charset=utf-8");
//设置回调函数
xhr.onreadystatechange=function(){
//判断客户端发送成功&&服务端响应成功
if(4 == xhr.readyState && 200 == xhr.status){
alert(xhr.responseText);
}
}
//组织SOAP协议数据
var soapXML = "<?xml version=\"1.0\" encoding=\"utf-8\"?>"
+"<soap:Envelope xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">"
+"<soap:Body>"
+"<getMobileCodeInfo xmlns=\"http://WebXml.com.cn/\">"
+"<mobileCode>"+document.getElementById("phoneNum").value+"</mobileCode>"
+"<userID></userID>"
+"</getMobileCodeInfo>"
+" </soap:Body>"
+"</soap:Envelope>";
alert(soapXML);
//发送请求
xhr.send(soapXML);
}
</script>
</head>
<body>
手机号归属地查询:<input type="text" id="phoneNum" /><input type="button" value="查询" onclick="javascript:queryMobile();"/>
</body>
</html>
参考文章:java调用webservice接口 几种方法_yesIcando-bupt的博客-CSDN博客_java 调webservice接口
整理至此,希望对大家有帮助
更多推荐
所有评论(0)