WEBSERVICE之JDK开发webservice
轉(zhuǎn)自:https://www.cnblogs.com/w-essay/p/7357262.html
一、開(kāi)發(fā)工具與環(huán)境
1、?jdk1.6版本以上(jdk1.6.0_21及以上版本)
2 、eclipse4.5版本
3、與Web服務(wù)相關(guān)的類(lèi),都位于Javax.jws.*包中
??????? @WebService——此注解用在類(lèi)上指定將此類(lèi)發(fā)布成一個(gè)WebService;
? ? ? ? @WebMethod——此注解用在類(lèi)中所定義的方法上,將方法發(fā)布成一個(gè)WebService服務(wù);可省略,但要將發(fā)布服務(wù)的方法設(shè)置為public;
??????? EndPoint——此類(lèi)為端點(diǎn)服務(wù)類(lèi),其中publish()方法用于將一個(gè)已經(jīng)添加了@WebService注解對(duì)象綁定到一個(gè)地址的端口上,用于發(fā)布。
4、使用jdk的EndPoint發(fā)布web服務(wù)要點(diǎn)
4.1.在要發(fā)布服務(wù)的類(lèi)上添加@WebService注解。將要發(fā)布服務(wù)的方法設(shè)置為public。
4.2.調(diào)用EndPoint.publish(,)發(fā)布服務(wù)
其他注意事項(xiàng):
1.給類(lèi)添加上@WebService注解后,類(lèi)中所有的非靜態(tài)方法都將會(huì)對(duì)外公布。
2.不支持靜態(tài)方法,final方法。
3.如果希望某個(gè)方法(非static,非final)不對(duì)外公開(kāi),可以在方法上添加@WebMethod(exclude=true),阻止對(duì)外公開(kāi)。
4.被添加了@WebService注解的類(lèi)至少要有一個(gè)可以公開(kāi)的方法,否則將會(huì)啟動(dòng)失敗。
二、JDK開(kāi)發(fā)webservice
1、定義一個(gè)interface,使用@WebService注解標(biāo)注接口,使用@WebMethod注解標(biāo)注接口中定義的所有方法,如下所示:
package com.me.ws;
import javax.jws.WebMethod;
import javax.jws.WebService;
/**
*?
* @author Administrator
* 使用@WebService注解將接口注解為一個(gè)webservice服務(wù)
*/
@WebService
public interface WebServiceInterface {
/*
* 使用@WebMethod注解標(biāo)注WebServiceInterface接口中的方法
*/
@WebMethod
public String sayHello(String name);
@WebMethod
public String save( String name);
}
2、定義一個(gè)實(shí)現(xiàn)類(lèi)實(shí)現(xiàn)接口中所有方法,并用@WebService注解將實(shí)現(xiàn)類(lèi)也注解成一個(gè)webservice服務(wù),如下所示:
package com.me.ws;
import javax.jws.WebService;
/**
*?
* @author Administrator
* 使用@WebService注解標(biāo)注實(shí)現(xiàn)類(lèi),將實(shí)現(xiàn)類(lèi)注解成為一個(gè)webservice服務(wù)
*/
//
@WebService
public class WebServiceImpl implements WebServiceInterface {
@Override
public String sayHello(String name) {
System.out.println("hello world "+name);
return "hello world "+name;
}
@Override
public String save(String name) {
System.out.println("save "+name);
return "save "+name;
}
}
3、發(fā)布服務(wù)
3.1 、使用Endpoint(終端)類(lèi)發(fā)布webservice,如下所示:
package com.me.ws;
import javax.xml.ws.Endpoint;
/**
*?
* @author Administrator?
* 發(fā)布webservice服務(wù)(JDK是使用Endpoint(終端)類(lèi)發(fā)布webservice服務(wù)的)
*/
public class WebServicePublish {
public static void main(String[] args) {
/**
*1、先提供一個(gè)給別人訪問(wèn)的url地址
*/
String address = "http://192.168.1.72:8089/ws_service/hello";
// 2、使用Endpoint的publish方法來(lái)發(fā)布這個(gè)服務(wù)
//Endpoint.publish(address, 接口實(shí)現(xiàn)類(lèi))
Endpoint.publish(address, new WebServiceImpl());
System.out.println("發(fā)布webservice成功!");
}
}
?運(yùn)行WebServicePublish 類(lèi)?后,就可以將編寫(xiě)好的WebService發(fā)布好了,它的WSDL訪問(wèn)地址是http://192.168.1.72:8089/ws_service/hello?wsdl。
以上是java工程的webservice發(fā)布,如果是web項(xiàng)目,則我們可以使用監(jiān)聽(tīng)器或者Servlet來(lái)發(fā)布WebService(在這里就需要注意一點(diǎn),項(xiàng)目中引用的servlet包必須是3.0及以上版本才行),
3.2 、使用監(jiān)聽(tīng)器發(fā)布webservice,代碼如下:
package ?com.me.ws;import javax.servlet.ServletContextEvent;import javax.servlet.ServletContextListener;import javax.servlet.annotation.WebListener;import javax.xml.ws.Endpoint;import me.gacl.ws.WebServiceImpl;/*** @author gacl* 用于發(fā)布WebService的監(jiān)聽(tīng)器*///使用Servlet3.0提供的@WebListener注解將實(shí)現(xiàn)了ServletContextListener接口的WebServicePublishListener類(lèi)標(biāo)注為一個(gè)Listener@WebListenerpublic class WebServicePublishListener implements ServletContextListener {@Overridepublic void contextDestroyed(ServletContextEvent sce) {}@Overridepublic void contextInitialized(ServletContextEvent sce) {//WebService的發(fā)布地址String address = "http://192.168.1.72:8089/ws_service/hello";//發(fā)布WebService,WebServiceImpl類(lèi)是WebServie接口的具體實(shí)現(xiàn)類(lèi)Endpoint.publish(address , new WebServiceImpl());System.out.println("使用WebServicePublishListener發(fā)布webservice成功!");}}在web.xml上進(jìn)行配置:
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
? ? ? <display-name>ws_service</display-name>?
? ? ? <!-- 加載自定義監(jiān)聽(tīng)器 -->
<listener>
<listener-class>?com.me.ws.webServicePublishLinster</listener-class>
</listener>?
</web-app>
接著我們可以使用發(fā)布的URL地址訪問(wèn)WebService
3.3、使用servlet發(fā)布webservice,代碼如下:
package com.me.ws;import javax.servlet.ServletException;import javax.servlet.annotation.WebServlet;import javax.servlet.http.HttpServlet;import javax.xml.ws.Endpoint;import me.gacl.ws.WebServiceImpl;/*** @author gacl* 用于發(fā)布WebService的Servlet*///使用Servlet3.0提供的@WebServlet注解將繼承HttpServlet類(lèi)的普通Java類(lèi)標(biāo)注為一個(gè)Servlet//將value屬性設(shè)置為空字符串,這樣WebServicePublishServlet就不提供對(duì)外訪問(wèn)的路徑//loadOnStartup屬性設(shè)置WebServicePublishServlet的初始化時(shí)機(jī)@WebServlet(value="",loadOnStartup=0)public class WebServicePublishServlet extends HttpServlet {/* (non-Javadoc)* @see javax.servlet.GenericServlet#init()* 在WebServicePublishServlet初始化時(shí)發(fā)布WebService*/public void init() throws ServletException {//WebService的發(fā)布地址String address = "http://192.168.1.72:8089/ws_service/hello";//發(fā)布WebService,WebServiceImpl類(lèi)是WebServie接口的具體實(shí)現(xiàn)類(lèi)Endpoint.publish(address , new WebServiceImpl());System.out.println("使用WebServicePublishServlet發(fā)布webservice成功!");}}在web.xml上不再需要對(duì)servlet進(jìn)行配置,如下(因?yàn)閟ervlet3.0中的@WebServlet注解已經(jīng)將該類(lèi)注解為了servlet類(lèi),所以不需要另外在web.xml中定義):
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
<display-name>ws_service</display-name>
</web-app>
將Web應(yīng)用部署到服務(wù)器運(yùn)行時(shí),在初始化WebServicePublishServlet時(shí),就會(huì)發(fā)布WebService了。如下圖所示:
接著我們可以使用發(fā)布的URL地址訪問(wèn)WebService
以上是webservice服務(wù)開(kāi)發(fā),下面講它的客戶端的開(kāi)發(fā)
三、開(kāi)發(fā)WebService客戶端
1、借助jdk的wsimport.exe工具生成客戶端代碼,wsimport.exe工具位于Jdk的bin目錄下,如下圖所示:
執(zhí)行命令:wsimport -keep url(url為wsdl文件的路徑)生成客戶端代碼。
創(chuàng)建一個(gè)WebService客戶端測(cè)試項(xiàng)目,如下圖所示:
打開(kāi)命令行窗口,切換到src目錄,執(zhí)行"wsimport -keep?http://192.168.1.72:8089/ws_service/hello?wsdl"生成客戶端代碼,如下圖所示:
?
執(zhí)行命令的過(guò)程中沒(méi)有出現(xiàn)任何錯(cuò)誤,那么代碼就生成成功了,刷新一下src目錄,就可以看到生成的代碼了,如下圖所示:
2、?借助生成的代碼編寫(xiě)調(diào)用WebService對(duì)外提供的方法
wsimport工具幫我們生成了好幾個(gè)java類(lèi),但我們只需要關(guān)心WebServiceImplService類(lèi)和WebServiceImpl接口的使用即可,如下所示:
1 package me.gacl.ws.client;2 3 import me.gacl.ws.WebServiceImpl;4 import me.gacl.ws.WebServiceImplService;5 6 /**7 * @author gacl8 * 調(diào)用WebService的客戶端9 */ 10 public class WSClient { 11 12 public static void main(String[] args) { 13 //創(chuàng)建一個(gè)用于產(chǎn)生WebServiceImpl實(shí)例的工廠,WebServiceImplService類(lèi)是wsimport工具生成的 14 WebServiceImplService factory = new WebServiceImplService(); 15 //通過(guò)工廠生成一個(gè)WebServiceImpl實(shí)例,WebServiceImpl是wsimport工具生成的 16 WebServiceImpl wsImpl = factory.getWebServiceImplPort(); 17 //調(diào)用WebService的sayHello方法 18 String resResult = wsImpl.sayHello("孤傲蒼狼"); 19 System.out.println("調(diào)用WebService的sayHello方法返回的結(jié)果是:"+resResult); 20 System.out.println("---------------------------------------------------"); 21 //調(diào)用WebService的save方法 22 resResult = wsImpl.save("孤傲蒼狼","123"); 23 System.out.println("調(diào)用WebService的save方法返回的結(jié)果是:"+resResult); 24 } 25 }客戶端調(diào)用服務(wù)器端的WebService方法運(yùn)行結(jié)果如下:
從調(diào)用返回的結(jié)果顯示,借助wsimport工具生成的客戶端代碼已經(jīng)成功調(diào)用到了WebService中的方法。以上就是使用JDK開(kāi)發(fā)WebService的相關(guān)內(nèi)容。
總結(jié)
以上是生活随笔為你收集整理的WEBSERVICE之JDK开发webservice的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇: 关于Mysql5.7高版本group b
- 下一篇: 离散数学及其应用 (Kenneth H·