WebService接口的生成和调用(WebService接口) |
您所在的位置:网站首页 › 如何对接api接口协议文件 › WebService接口的生成和调用(WebService接口) |
Table of Contents 一:WebService的服务端发布 1:发布web程序服务端发布 2:本地发布 二:Webservice客户端调用: 1:本地生成代码,直接调用: 2、利用dos命令生成代码,和第一种基本一致 3:service编程实现调用 4:利用apache的AXIS直接调用远程的web service 5:HttpURLConnection调用方式 6.Ajax调用方式 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就可以看到发布的接口了 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工程 B、使用jdk提供的wsimport命令生成客户端代码 ● wsimport命令是jdk提供的,作用是根据使用说明书生成客户端代码,wsimport只支持SOAP1.1客户端的生成 ● wsimport常用参数 -d:默认参数,用于生成.class文件 -s:生成.java文件 -p:指定生成java文件的包名,不指定则为WSDL说明书中namespace值得倒写 C、在doc窗口进入java工程项目的src目录,执行wsimport命令 D、在Eclipse中刷新java项目,将生成的客户端代码copy到客户端工程中 E、创建服务视图,类名从标签的name属性获取 F、获取服务实现类,视图实例调用getProt()方法,实现类的类名从portType的name属性获取 G、调用查询方法,方法名从portType下的operation标签的name属性获取 ● 服务视图,webservice的服务结点,它包括了服务端点 ● 为每个服务端点定义消息格式和协议细节 ● 服务端点,描述 web service可被执行的操作方法,以及相关的消息,通过binding指向portType ● 定义一个操作(方法)的数据参数(可有多个参数) ● 定义 web service 使用的全部数据类型 3:service编程实现调用注意: (1)该种方式可以自定义关键元素,方便以后维护,是一种标准的开发方式; (2)这种方式同样需要wsimport生成客户端代码,只不过仅需要将服务接口类引入即可,例如如果需要端口服务,则需要将生成的MobileCodeWSSoap.class类引入; (1)、开发步骤 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生成客户端代码,只不过仅需要将服务接口类引入即可,例如如果需要 * * 端口服务,则需要将生成的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文档中服务名称,例如) QName qname = new QName("http://WebXml.com.cn/", "MobileCodeWS"); //Service创建视图 //参数: //1.wsdlDocumentLocation - 使用说明书地址 //2.serviceName - 服务名称 Service service = Service.create(url, qname); //获取服务实现类 //参数解释:serviceEndpointInterface - 服务端口(wsdl文档中服务端口的name属性,例如) 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[]{"[email protected]"})); 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调用方式(1)、开发步骤 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(); } /** * string string * @param phoneNum * @return */ public static String getXML(String phoneNum){ String soapXML = "" +"" +"" +"" +""+phoneNum+"" +"" +"" +" " +""; return soapXML; } }提供一个比较完善一点的工具类 public Map webServiceRequestUtil(String requesturl, String soapXML) throws IOException, ZycxException { HttpURLConnection connection = null; OutputStream os = null; Map 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调用方式 Ajax调用方式 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 = "" +"" +"" +"" +""+document.getElementById("phoneNum").value+"" +"" +"" +" " +""; alert(soapXML); //发送请求 xhr.send(soapXML); } 手机号归属地查询:参考文章:java调用webservice接口 几种方法_yesIcando-bupt的博客-CSDN博客_java 调webservice接口 整理至此,希望对大家有帮助 |
今日新闻 |
推荐新闻 |
CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |