Axis通過wsdd部署Web Service

axis網上的教程很多，不過搜來搜去，總是只有那么幾篇。仔細看了一下那幾篇文章，都感覺到不是自己想要的，所以自己整理了一篇分享一下。

?

本文介紹axis應用的一個小例子，沒有麻煩的命令行操作，只需照下面的步驟做就可以了。以下是詳細的操作步驟。(注：本實例用的是axis，非axis2)

?

1. 1.???????環境準備

l??MyEclipse 6.5

l??Tomcat 6

l??JDK 1.5

l??axis(非axis2)

?

1. 2.???????新建web工程

新建一web工程，工程名稱為axistest。新建完成后，導入下圖所示的axis相關的jar包。

?

?

1. 3.???????在web.xml中添加axis相關的配置信息

?

<servlet>??
????<display-name>Apache-Axis?Servlet</display-name>??
????<servlet-name>AxisServlet</servlet-name>??
????<servlet-class>org.apache.axis.transport.http.AxisServlet</servlet-class>??
</servlet>??
??
<servlet>??
????<display-name>Axis?Admin?Servlet</display-name>??
????<servlet-name>AdminServlet</servlet-name>??
????<servlet-class>org.apache.axis.transport.http.AdminServlet</servlet-class>??
????<load-on-startup>100</load-on-startup>??
</servlet>??
<servlet-mapping>??
????<servlet-name>AxisServlet</servlet-name>??
????<url-pattern>/servlet/AxisServlet</url-pattern>??
</servlet-mapping>??
<servlet-mapping>??
????<servlet-name>AxisServlet</servlet-name>??
????<url-pattern>*.jws</url-pattern>??
</servlet-mapping>??
<servlet-mapping>??
????<servlet-name>AxisServlet</servlet-name>??
????<url-pattern>/services/*</url-pattern>??
</servlet-mapping>??
???<servlet-mapping>??
????<servlet-name>AdminServlet</servlet-name>??
????<url-pattern>/servlet/AdminServlet</url-pattern>??
</servlet-mapping>??

?

?

1. 4.???????新建提供服務的Java類

在src下新建com包，在com包下新建HelloWorld類，HelloWorld的內容如下：

?

package?com;??
??
public?class?HelloWorld?{??
??
????public?String?sayHello(String?msg){??
????????if(null==msg?||?"".equals(msg)){??
????????????return?"您好!";??
????????}else{??
????????????return?"您好"?+?msg?+?"!";??
????????}??
????}??
??????
????public?int?sayAge(){??
????????return?28;??
????}??
??
}??

??

?

1. 5.???????配置server-config.wsdd

在WEB-INF下新建server-config.wsdd文件，內容如下：

?

<deployment?xmlns="http://xml.apache.org/axis/wsdd/"??
????xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">??
??
????<!--?處理器?-->??
????<handler?name="URLMapper"?type="java:org.apache.axis.handlers.http.URLMapper"?/>??
??????????
????<!--?一個服務?-->??
????<!--?provider="java:RPC"??webservice是以javabean的形式提供的-->??
????<service?name="helloWorldService"?provider="java:RPC">??
????????<!--?指定類名?-->??
????????<parameter?name="className"?value="com.HelloWorld"?/>??
????????<!--?類中允許訪問的方法?-->??
????????<parameter?name="allowedMethod"?value="*"></parameter>??
????</service>??
??????
????<!--?指定處理器?-->??
????<transport?name="http">??
????????<requestFlow>??
????????????<handler?type="URLMapper"/><!--?引用上邊的?-->??
????????</requestFlow>??
????</transport>??
??????
</deployment>??

?

wsdd文件標簽節點說明：

deployment：表明這是一個axis部署描述文件；

service：axis提供的一個web service服務。service標簽中parameter allowedMethod用于指定一個以空格分隔的方法名，只有這些方法可以通過web service訪問。也可以將這個值指定為“*”表示所有的方法都可以訪問。

provider：服務類型，共有四種，分別是RPC,Document,Wrapped和Message。詳見org.apache.axis.providers包的API文檔；

parameter：用來設置Axis的各種屬性；

requestFlow：局的請求Handlers，在調用實際的服務之前調用；

transport：定義了服務器端的傳輸方式

?

至此web service相關的東西已經配置好，此時工程的目錄結構如下

?

?

?

?

1. 6.???????部署到Tomcat測試

將工程發布到Tomcat,在瀏覽器里訪問http://127.0.0.1:9999/axistest/services，如果出現如下頁面，則表示web service部署成功

?

?

點擊上面的wsdl鏈接，進入下圖所示頁面

?

注意上面的紅圈的namespace，下面測試QName有用到。

?

1. 7.???????客戶端測試

在com包下新建測試類，名稱為ClientTest,內容如下：

?

package?com;??
??
import?java.NET.MalformedURLException;??
import?java.rmi.RemoteException;??
??
import?javax.xml.namespace.QName;??
import?javax.xml.rpc.ServiceException;??
??
import?org.apache.axis.client.Call;??
import?org.apache.axis.client.Service;??
??
/**?
?*?@author?花非花霧非霧?
?*?@date?2010-12-24?
?*/??
public?class?ClientTest?{??
??
????public?static?void?main(String[]?args)?throws?MalformedURLException,?RemoteException?{??
??????????
????????Service?service?=?new?Service();??
????????try?{??
??????????????
????????????Call?call?=?(Call)?service.createCall();??
????????????//設置地址??
????????????call.setTargetEndpointAddress(new?java.Net.URL("http://127.0.0.1:9999/axistest/services/helloWorldService?wsdl"));??
????????????//設置要執行的方法??
????????????call.setOperationName(new?QName("http://com","sayHello"));??
????????????//設置要傳入參數,如果沒有要傳入的參數，則不要寫這個??
????????????call.addParameter("msg",?org.apache.axis.Constants.XSD_STRING,javax.xml.rpc.ParameterMode.IN);??
????????????//設置返回的類型??
????????????call.setReturnType(org.apache.axis.Constants.XSD_STRING);??
??????????????
????????????String?name?=?"花非花霧非霧";??
????????????//執行，調用webservice??
????????????String?result?=?(String)?call.invoke(new?Object[]{name});??
????????????System.out.println("返回的結果是："+result);??
??????????????
????????}?catch?(ServiceException?e)?{??
????????????e.printStackTrace();??
????????}??
????}??
??
}??

??

?

如果一切正常，運行結果如下：

返回的結果是：您好花非花霧非霧!

?

?

參考資料:

1. axis?的官方資料