myeclipse10上基於JAX-WS開發Webservice

總結:服務器端
1 新建webservice工程 JAX-WS框架 J2EE6.0
2 創建服務類 要發佈的執行方法
new->package com.webservice.ws等
new->class

3 創建一個web service
New Web Service ->Strategy(Bottom-up scenario)->JavaBean(選擇生成的類)->Generate WSDL in project
(Myeclipse會自動生成CalculatorDelegate代理類，還有一些必須的JAX-WS描述符，而且會自動在服務器目錄下的web.xml中配置WebService的一些mappings)

4 部署websercice
不用myeclipse自帶的tomcat,使用外接的tomcat7.x.需要給工程導入兩個包(JAX-WS 2.1 Runtime Jax-ws 2.1 API libraries)
在調試框裏顯示servers
tomacat右擊選擇Add Deployment,給它裝載好需要發佈的工程

5 測試

1)運行tomcat服務器，
在工具欄中點擊launch WebService Explorer 
擊右上角的WSDL視圖 輸入http://localhost:8080/WebServiceProject(工程名)/CalculatorPort(類名+Port)?WSDL 

2)創建Webservice Client 來調用該方法
JAVA Project->工具條中點擊new Web Service Client ->JAX-WS->WSDL URL完成,寫一些測試方法即可.

---------------------------------------------------------------

WebService開發流程（AXIS、JAX-WS、XFire框架）
        導言：WebService存在於互聯網當中的組件，具有獨立性，跨平臺和技術，通過URL進行定位調用；優點是可以重複使用組件服務可以跨平臺和技術，實現不同程序之間的交互可以使用組件服務靈活組合，提高資源利用率，節省資源
   一、WebService開發流程
   --AXIS框架的使用(需要另外安裝組件)

預先建立一個WebService工程
   a.引入開發包
   b.配置web.xml，添加org.apache.axis.transport.http.AxisServlet映射和url-pattern.
   c.編寫WebService的接口和實現類
   d.在WEB-INF目錄下創建server-config.wsdd發佈文件,定義發佈的Service組件:

服務名-對應的類名-方法名
&&e定義返回類型：如果WebService服務的方法用到自定義類型,需要在發佈文件中定義<beanMapping>映射

  --JAX-WS框架的使用(默認使用該類,jdk1.6版本以上使用)

  a.在MyEclipse中建立一個webService工程（假設叫myJAXWS），使用JAX-WS框架。
  b.寫一個普通的JAVA類（假設叫myBean）
 c.在myJAXWS，中通過JAVA類myBean建立通過webService(由MyEclipse自動生成)
  d.可以通過http://localhost:8888/工程名/myBeanPort查看可用的webService;
 你可以http://localhost:8888/工程名/myBeanPort?wsdl查看wsdl文件（xml格式）
 e.如果webService中返回類型爲自定義對象，那麼可用考慮將對象轉化爲字符串傳送。
 注：對象與字符串相互轉化，可以考慮用JOX的BeanXMLMapping技術。

   --XFire框架的使用(jdk1.5以下版本使用,現在都顯示deprecated)
預先建立一個WebService工程。
   a.引入開發包(創建一個XFire工程) 
   b.配置web.xml，添加org.codehaus.xfire.transport.http.XFireConfigurableServlet映射


c.編寫WebService的接口和實現類 
   d.在services.xml中定義要發佈的Service組件
   e.如果WebService服務的方法用到自定義類型,需要在組件接口同級目錄下編寫(接口名.aegis.xml文件)，定義自定義類型


f.訪問service路徑
http://localhost:8888/XFireWebServiceDelete/services/XuliangXFire?wsdl
   使用webService
通過XFire自動生成：
見一個普通的JAVA工程，新建包，在包下右鍵other--->MyEclipse--->webservice--->ServiceClient--->自動wsdl的路徑，即可。

二、WebService基礎知識
1.什麼WebService
    存在於互聯網當中的組件，具有獨立性，
跨平臺和技術，通過URL進行定位調用
2.有什麼好處，特點
    可以重複使用組件服務
　可以跨平臺和技術，實現不同程序之間的交互
　可以使用組件服務靈活組合，提高資源利用率，節省資源
3.相關關鍵詞及概念
　HTTP+XML　
　SOAP(Simple Object Access Protocol):簡單對象訪問協議
　WSDL(Web Service Description Language):WebService描述語言
　UDDI(Universal Description、Discovery、and Integration):用於提供WebService註冊、查找等功能

--------------------------------------------------------------------------------------------------------------------------------------------------------------------------

   這裏是一個JAX-WS的框架,服務器開放計算器的操作接口的實例,使用外接Tomcat發佈,兩種測試方法(web service explorer,建立客戶端)測試是否發佈成功.

環境要求,我的開發環境是myeclipse10+Tomcat7.0+jdk1.7

客戶端可以用eclipse  Juno Service Release 2

.新建一個工程 
開始我們新建一個Web Service Project工程File->New->Web Service Project(Optional Maven Support) 

Note:A JAX-WS web service can also be generated in any existing Java EE 5 web project. 

我們給這個工程取名爲WebServiceProject.注意JAX-WS支持只在javaEE5或更高版本的工程中是可行的。如果你需要使用低版本的工程類型(java1.4或者1.3)，那麼只能使用XFire Web Service代替JAX-WS。 

這裏我們使用上面的JAX—WS。 
4.創建服務類 
服務類就是一個普通的java類，負責提供我們想要發佈的執行方法。這裏我們寫一個簡單的計算器類，實現幾個典型的計算器應用方法，如加減乘除。 
首先我們先建一個包，WebServiceProject->src->new->package,取名com.myeclipseide.ws 

讓後我們在這個包下建一個類,Calculator.java. 

根據上面提到的，這個計算器類實現計算器的加減乘除算法，簡單實現： 

package com.myeclipseide.ws;

public class Calculator {
    public int add(int a, int b) {
        return (a + b);
    }

    public int subtract(int a, int b) {
        return (a - b);
    }

    public int multiply(int a, int b) {
        return (a * b);
    }

    public int divide(int a, int b) {
        return (a / b);
    }
}

可以看出，這個類中的方法是非常簡單的，沒有用到特殊的註釋還有接口，父類之類的東西。 
5.創建一個Web Service 
在上面的工具條中點擊新建Web Service 

Note：如果沒有的話可以File->New->others->Myeclipse->WebService->webService 
點擊之後出現的屏幕，在Strategy中選擇Bottom-up scenario，因爲我們已經建立好了Calculator類而且想根據它建立JAX-WS服務。 

下面是創建的最後一個屏幕，你需要選擇提供webService方法的javaBean，在我們這個例子中就是我們已經建立好的Calculator類。 

填好之後，Myeclipse會自動幫我們填滿其他的項，Select Generate WSDL in project and hit Finish. 

點擊完成之後，Myeclipse會自動生成CalculatorDelegate代理類，還有一些必須的JAX-WS描述符，而且會自動在服務器目錄下的web.xml中配置WebService的一些mappings，方便將webService部署到服務器中。 

到此web service已經建立好了，我們開始部署它然後進行測試。 
6.部署和測試webService。 
這裏我們不使用用Myeclipse自帶的tomcat服務器，使用自己應經在電腦中部署好的tomcat5.5。 
在server面板中右擊，選擇configure 

部署自己的tomcat注意選擇jdk要跟項目中的相同。 

現在要向工程中導入JAX-WS的jar包 
在項目名稱上右擊->properties->Add Library->Myeclipse Libraries->最後面的兩個。 

點擊完成，導入成功。 
Note：Myeclipse自帶的tomcat中有自帶的這兩個jar包，可以不用導入。 
6.1部署 
在部署好的tomcat服務器上右擊選擇Add Deployment 

點擊完成。 
6.2測試 
運行tomcat服務器，在工具欄中點擊launch WebService Explorer 

打開後，點擊右上角的WSDL視圖，可以看到下面的屏幕 

在WSDL URL中填寫路徑：http://localhost:8888/WebServiceProject/CalculatorPort?WSDL 
解釋下路徑組成： 
http://localhost:8888/是服務器的路徑，我的端口號是8888，可以根據自己的更改，一般都是8080。 
/WebServiceProject = We know by default the Web Context-root that is used to deploy(部署) web projects matches the name of the projects. (因爲我們沒有爲這個工程自定義我們的Web Context-root，所以他就是這個工程的名字) 
/CalculatorPort = As we saw from the last screenshot in Section #5, when our JAX-WS web service was generated, it was bound using a servlet-mapping in the web.xml file to the /CalculatorPort path. 

<servlet>
    <description>JAX-WS endpoint - CalculatorService</description>
    <display-name>CalculatorService</display-name>
    <servlet-name>CalculatorService</servlet-name>
    <servlet-class>
        com.sun.xml.ws.transport.http.servlet.WSServlet
    </servlet-class>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>CalculatorService</servlet-name>
    <url-pattern>/CalculatorPort</url-pattern>
  </servlet-mapping>

?WSDL = This is a universal query string argument that can be added to the end of any web service which will tell the web service to return it's full WSDL to the caller. In this case, the WSDL is returned to our Web Services Explorer tool which loads it up, and displays the web services exposed operations to us. 
弄清楚之後，我們開始測試，比如我們選擇add方法： 
填寫args，點擊go，在status中就會顯示結果。 

結果是正確的。 
7.創建Webservice Client 
現在我們已經部署好Webservice，而且應經測試過了，那我們新建一個Webservice client，來調用Webservice提供的方法。 
7.1新建一個java project，給他取個名字。比如我們叫它ClientofWebService 

在工具條中點擊new Web Service Client 

然後按照以下步驟操作： 

The last step of the web service client creation is to specify either a WSDL File or a WSDL URL for the wizard to retrieve the web service WSDL from. In our case we are using the URL and generate the client into the new package com.myeclipseide.ws.client: 

http://localhost:8888/WebServiceProject/CalculatorPort?WSDL 

點擊Next知道完成。 
可以看到在新建的java project ClientofWebService中，src文件夾下產生了許多的文件，根據名稱我們大體可以瞭解其意思，可以打開看一下源代碼，其實不難理解。比如add文件，就是Calculator類中add方法的兩個參數的get和set方法。其他類似。 
我們在文件夾下見一個類test.java寫一個main函數測試 

public static void main(String[] args) {
    /* Create the service instance */
    CalculatorService service = new CalculatorService();
    CalculatorDelegate delegate = service.getCalculatorPort();

    /* Using the web service, perform the 4 calculations */
    System.out.println("1. 3+7=" + delegate.add(3, 7));
    System.out.println("2. 12-2=" + delegate.subtract(12, 2));
    System.out.println("3. 9*9=" + delegate.multiply(9, 9));
    System.out.println("4. 40/2=" + delegate.divide(40, 2));
}

運行得到如下結果： 
1. 3+7=10 
2. 12-2=10 
3. 9*9=81 
4. 40/2=20 
測試完成。 
8. Resources 
In this section we want to provide you with additional links to resources that supplement the topics covered in this tutorial. While this is not an exhaustive list, we do make an effort to point to the more popular links that should provide you with diverse, high-quality information. 

Example Web Service Project & Web Service Client Project 
NOTE: The example projects provided are configured to run against WebSphere 6.1. You may need to adjust the Target Server and/or the runtime JRE libraries used to build the projects to more closely match your particular build and deployment environment. 

有些地方說的不是很好，但是大體應該能夠弄明白，限於能力問題，請大家體諒。 

有關web服務添加用戶認證的 博客http://blog.csdn.net/ytzyg/article/details/6859668