http://hanyexiaoxiao.iteye.com/blog/479094
工程應用當中的web service的參數和通回值通常都是一個數據Bean類,因此前面介紹的兩種發佈AXIS的web service方法在工程應用當中並不多見,下面介紹Stub發佈方法,開發步驟如下:
1,編寫服務端程序UserEndpoint.java
import org.apache.log4j.LogManager;
import
org.apache.log4j.Logger;
import
org.springframework.remoting.jaxrpc.ServletEndpointSupport;
import
com.miracle.dm.framework.organization.dao.hibernate.UserHibernateDAO;
import
com.miracle.dm.framework.organization.model.User;
public class UserEndpoint extends
ServletEndpointSupport{
protected Logger logger =
LogManager.getLogger(UserEndpoint.class);
private UserHibernateDAO
userHibernateDAO;
protected void onInit(){
userHibernateDAO =
(UserHibernateDAO)getWebApplicationContext()
.getBean("userHibernateDAO");
}
/**
*
增加User到數據庫
*
* @return
返回新增加的數據的ID,失敗返回字符串“FAILED”
*/
public String addUser(User user){
try{
String rev = userHibernateDAO.addUser(user);
return
rev;
}catch(Exception e){
logger.error("use web service to add user
failed , user Name is : " + user.getName_());
return "FAILED";
}
}
/**
* 從數據庫刪除User
*
* @return 刪除成功返回字符串“OK”
,失敗返回字符串“FAILED”
*/
public String delUser(String userId){
try{
userHibernateDAO.delUser(userId);
return "OK";
}catch(Exception e){
logger.error("use web service to delete user failed
, user Id is : " + userId);
return "FAILED";
}
}
/**
* 將參數中的數據更新到數據庫
*
* @return
成功返回字符串“OK”,失敗返回字符串“FAILED”
*/
public String updateUser(User user){
try{
userHibernateDAO.updateUser(user);
return "OK";
}catch(Exception e){
logger.error("use web service to update user failed
, user Id is : " + user.getID_());
return "FAILED";
}
}
}
2,將Axis集成到工程當中
在工程的web.xml配置文件中加入以下AXIS配置:此配置加在<web-app>節點下。
<!-- AXIS配置 -->
<listener>
<listener-class>org.apache.axis.transport.http.AxisHTTPSessionListener</listener-class>
</listener>
<servlet>
<servlet-name>AxisServlet</servlet-name>
<display-name>Apache-Axis Servlet</display-name>
<servlet-class>
org.apache.axis.transport.http.AxisServlet
</servlet-class>
</servlet>
<servlet>
<servlet-name>AdminServlet</servlet-name>
<display-name>Axis Admin Servlet</display-name>
<servlet-class>
org.apache.axis.transport.http.AdminServlet
</servlet-class>
<load-on-startup>100</load-on-startup>
</servlet>
<servlet>
<servlet-name>SOAPMonitorService</servlet-name>
<display-name>SOAPMonitorService</display-name>
<servlet-class>
org.apache.axis.monitor.SOAPMonitorService
</servlet-class>
<init-param>
<param-name>SOAPMonitorPort</param-name>
<param-value>5001</param-value>
</init-param>
<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>SOAPMonitorService</servlet-name>
<url-pattern>/SOAPMonitor</url-pattern>
</servlet-mapping>
<!-- uncomment this if you want the admin
servlet -->
<!--
<servlet-mapping>
<servlet-name>AdminServlet</servlet-name>
<url-pattern>/servlet/AdminServlet</url-pattern>
</servlet-mapping>
-->
<session-config>
<!--
Default to 5 minute session timeouts -->
<session-timeout>5</session-timeout>
</session-config>
<!-- currently the W3C havent settled on a
media type for WSDL;
http://www.w3.org/TR/2003/WD-wsdl12-20030303/#ietf-draft
for now we go with the basic 'it's XML'
response -->
<mime-mapping>
<extension>wsdl</extension>
<mime-type>text/xml</mime-type>
</mime-mapping>
<mime-mapping>
<extension>xsd</extension>
<mime-type>text/xml</mime-type>
</mime-mapping>
3,編寫wsdd文件
deploy.wsdd文件,此文件跟上面的類文件放在同一個包下,內容如下:
<deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
<service name="UserEndpoint"
provider="java:RPC">
<parameter name="className"
value="UserEndpoint"/>
<parameter name="allowedMethods"
value="*"/>
</service>
</deployment>
4、發佈服務:
在DOS下轉換目錄到上面的包目錄,執行以下命令:
java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient deploy.wsdd
你會發現目錄下多了一個server-config.wsdd文件,這就是AXIS的配置文件,以後所有的服務發佈描述都會在裏面找到。(當然你可以不用寫deploy.wsdd,而是直接創建並修改它,以後新加入的web service也可以在裏面添加而不用執行以上命令)。
server-config.wsdd文件的標準內容如下:
<?xml version="1.0" encoding="UTF-8"
?>
<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"/>
<service
name="Document" provider="java:RPC">
<parameter
name="className"
value="com.miracle.dm.service.DocumentEndpoint"/>
<parameter
name="allowedMethods"
value="*"/>
<beanMapping
qname="ns:DocumentInfo" xmlns:ns="urn:beanservice"
languageSpecificType="java:com.miracle.dm.doc.document.model.DocumentInfo"/>
<beanMapping qname="ns:DocExtpropInfo"
xmlns:ns="urn:beanservice"
languageSpecificType="java:com.miracle.dm.doc.document.model.DocExtpropInfo"/>
<beanMapping qname="ns:DocAttachmentInfo"
xmlns:ns="urn:beanservice"
languageSpecificType="java:com.miracle.dm.doc.document.model.DocAttachmentInfo"/>
<beanMapping qname="ns:DoccatRelatInfo"
xmlns:ns="urn:beanservice"
languageSpecificType="java:com.miracle.dm.doc.document.model.DoccatRelatInfo"/>
<typeMapping qname="ns:DataHandler"
xmlns:ns="urn:beanservice"
languageSpecificType="java:javax.activation.DataHandler"
serializer="org.apache.axis.encoding.ser.JAFDataHandlerSerializerFactory"
deserializer="org.apache.axis.encoding.ser.JAFDataHandlerDeserializerFactory"
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
</service>
<transport
name="http">
<requestFlow>
<handler
type="URLMapper"/>
</requestFlow>
</transport>
</deployment>
其中的beanmapping節點都是在此服務中應用到的Bean的配置。
此時你訪問http://localhost:8080/工程名/services就可以看到此工程發佈的所有的web service
5,生成客戶端client stub文件
在瀏覽器上訪問服務器端的服務,可以下載到User.wsdl文件,保存到E盤,通過Axis的相關工具,可以自動從WSDL文件中生成Web Service的客戶端代碼。
編寫一個WSDL2Java.bat文件,其內容如下:
set
Axis_Lib=D:\software\Axis\axis-bin-1_4\axis-1_4\lib
set Java_Cmd=java
-Djava.ext.dirs=%Axis_Lib%
set
Output_Path=D:\project\MiracleDataManager\src
set
Package=com.miracle.dm.service.client
%Java_Cmd%
org.apache.axis.wsdl.WSDL2Java -o%Output_Path% -p%Package%
User.wsdl
cmd
注意,.bat文件中的路徑不能有空格和中文字符,執行這個批處理文件就可以生成client stub.
生成的stub client文件列表爲:GenericValue.java,User.java,UserEndpoint.java,UserEndpointService.java,UserEndpointServiceLocator.java,UserSoapBindingStub.java
5,客戶端調用例子
這裏我使用Junit來測試:
package com.miracle.dm.service.test;
import
com.miracle.dm.service.client.User;
import
com.miracle.dm.service.client.UserEndpoint;
import
com.miracle.dm.service.client.UserEndpointService;
import
com.miracle.dm.service.client.UserEndpointServiceLocator;
import junit.framework.Test;
import
junit.framework.TestCase;
import junit.framework.TestSuite;
public class TestUserClient extends TestCase
{
public TestUserClient(String string) {
super(string);
}
public void addUser() throws Exception
{
UserEndpointService service = new
UserEndpointServiceLocator();
UserEndpoint client =
service.getUser();
User user = new User();
user.setClass_("U");
user.setName_("annlee");
user.setEmail_("[email protected]");
user.setSeq_(65546);
user.setPassword_("password");
user.setEnabled_("Y");
user.setDisplayname_("李飛虎");
user.setDomain("100");
user.setMobile("12345");
String retValue =
client.addUser(user);
System.out.println(retValue);
}
public void
updateUser() throws Exception{
UserEndpointService service = new
UserEndpointServiceLocator();
UserEndpoint client =
service.getUser();
User user = new User();
user.setID_("402880ea1b447d08011b447e3e880002");
user.setClass_("U");
user.setName_("annlee");
user.setEmail_("[email protected]");
user.setSeq_(65546);
user.setPassword_("password");
user.setEnabled_("Y");
user.setDisplayname_("李飛虎");
user.setDomain("100");
user.setMobile("12345");
String retValue =
client.updateUser(user);
System.out.println(retValue);
}
public void delUser() throws Exception{
UserEndpointService service = new UserEndpointServiceLocator();
UserEndpoint client = service.getUser();
String retValue =
client.delUser("402880ea1b447d08011b447e3e880002");
System.out.println(retValue);
}
public static Test suite() {
TestSuite suite = new TestSuite();
// suite.addTest(new
TestUserClient("addUser"));
// suite.addTest(new
TestUserClient("updateUser"));
suite.addTest(new
TestUserClient("delUser"));
return suite;
}
}
至此,整個服務器端和客戶端的Web Service框架代碼就完成了,剩下的就是在UserEndpoint.java文件裏面加入你的業務代碼了