使用Axis开发WebService

一、Axis安装
1.测试环境
    JDK 1.5Servlet Container: Tomcat 5.5
2.下载地址:http://ws.apache.org/axis/

3.解压缩安装包，将$AXIS_UNZIP_PATH/axis-version/webapps下的axis包拷贝到$TOMCAT_HOME/webapps/下，
以下约定$AXIS_HOME为该$TOMCAT_HOME/webapps/axis目录

4.启动tomcat,访问http://localhost:8080/axis 检查安装是否成功 

5.设置classpath编写setEnv.bat:

set AXIS_HOME=$AXIS_UNZIP_HOME
set CLASSPATH=.;%AXIS_HOME%/lib/axis.jar;%AXIS_HOME%/lib/axis-ant.jar;%AXIS_HOME%/lib/commons-discovery-0.2.jar;%AXIS_HOME%/lib/commons-logging-1.0.4.jar;%AXIS_HOME%/lib/jaxrpc.jar;%AXIS_HOME%/lib/saaj.jar;%AXIS_HOME%/lib/wsdl4j-1.5.1.jar;%AXIS_HOME%/lib/log4j-1.2.8.jar;E:/thirdparty/activation/activation.jar;E:/thirdparty/activation/mail.jar

 

 

 二.使用axis支持web service的部署和开发，最主要有两种方式：

(一)。Dynamic Invocation Interface ( DII)
1.编写服务端程序HelloClient

public class HelloClient  {
 ublic String getName(String name)
  
   return "hello "+name;
 
}

2.将源码拷贝到AXIS_HOME下，重命名为 HelloClient.jws
3.访问连接http://localhost:8080/axis/HelloClient.jws?wsdl，页面显示axis自动生成的wsdl
4.编写访问服务的客户端 TestHelloClient.java

import  org.apache.axis.client.Call;
import  org.apache.axis.client.Service;
import  javax.xml.namespace.QName;
import  javax.xml.rpc.ServiceException;
import  java.net.MalformedURLException;
import  java.rmi.RemoteException;

public class SayHelloClient2  {
public static void main(String[] args) {
try {
String endpoint = "http://localhost:8080/axis/HelloClient.jws";

Service service = new Service();
Call call = null;

call = (Call) service.createCall();

call.setOperationName(new QName(
"http://localhost:8080/axis/HelloClient.jws", "getName"));
call.setTargetEndpointAddress(new java.net.URL(endpoint));

String ret = (String) call.invoke(new Object[] {"zhangsan"});
System.out.println("return value is " + ret);
} catch (Exception ex) {
ex.printStackTrace();
}
}
}

5.运行TestHelloClient测试;

(二)。 Stubs方式
1.编写服务端程序server,SayHello.java，编译server.SayHello.java  

package  server;
public class SayHello  {
public String getName(String name)
{
return "hello "+name;
}
}

2.编写LogHandler.java

import  org.apache.axis.AxisFault;
import  org.apache.axis.Handler;
import  org.apache.axis.MessageContext;
import  org.apache.axis.handlers.BasicHandler;

import  java.util.Date;

public class LogHandler extends BasicHandler  {
public void invoke(MessageContext msgContext) throws AxisFault
{
/** *//** Log an access each time we get invoked.
*/
try {
Handler serviceHandler = msgContext.getService();

Integer numAccesses =
(Integer)serviceHandler.getOption("accesses");
if (numAccesses == null)
numAccesses = new Integer(0);

numAccesses = new Integer(numAccesses.intValue() + 1);

Date date = new Date();
String result = date + ": service " +
msgContext.getTargetService() +
" accessed " + numAccesses + " time.";
serviceHandler.setOption("accesses", numAccesses);

System.out.println(result);
} catch (Exception e) {
throw AxisFault.makeFault;
}
}
}

3..编写wsdd文件

deploy.wsdd
<deployment xmlns="http://xml.apache.org/axis/wsdd/"
xmlns:java ="http://xml.apache.org/axis/wsdd/providers/java">  
   
<handler name="print" type="java:LogHandler"/>  
<service name="sayhello" provider="java:RPC">
<requestFlow>
<handler type="print"/>
</requestFlow>
<parameter name="className" value="server.SayHello"/>
<parameter name="allowedMethods" value="*"/>  
</service>
</deployment>

4.将编译后的文件拷贝到AXIS_HOME/WEB-INF/classes下，如：D:/tomcat/webapps/axis/WEB-INF/classes

5.发布服务：
java org.apache.axis.client.AdminClient -h localhost -p 8080 -s /axis/servlet/AxisServlet deploy.wsdd

命令参数为:

The following Options are available:

        -l<url>          sets the AxisServlet URL
        -h< hostName     sets the AxisServlet host
        -p<portNumber>   sets the AxisServlet port
        -s<servletPath>  sets the path to the AxisServlet
        -f<fileName>     specifies that a simple file protocol should be used
        -u<username>     sets the username
        -w<password>     sets the password
        -d              sets the debug flag (for instance, - ddd would set it to
3 )
        -t<name>         sets the transport chain touse

Commands:

        list            will list the currently deployed services
        quit            will send a quit message to SimpleAxisServer
        passwd          value changes the admin password

Deployment Descriptor files:

<deployment-descriptor-files>  deploys or undeploys Axis components and
web services described in these files

If -l or -h -p - s are not set, the AdminClient will invoke
http://localhost:8080/axis/servlet/AxisServlet

6.生成client stub文件
a:方式1
将SayHello.java拷贝到AXIS_HOME/下，重命名为SayHello.jws，执行下面的命令生存client stub
java org.apache.axis.wsdl.WSDL2Java -p client http://localhost:8080/axis/services/SayHello.jws?wsdl
b:方式2
  执行如下命令生成SayHello.wsdl
java org.apache.axis.wsdl.Java2WSDL -oSayHello.wsdl -lhttp://localhost:8080/axis/services/SayHello -nsayhello server.SayHello
执行如下命令生成client stub
   java org.apache.axis.wsdl.WSDL2Java SayHello.wsdl -p client
生成的stub client文件列表为：
1。SayHello.java
2。SayHelloService.java。
3。SayHelloServiceLocator.java
4。SayHelloSoapBindingStub.java

7.编写客户端程序，编译并执行

public class SayHelloClient  {
public static void main(String[] args) {
try {

SayHelloService service = new client.
SayHelloServiceLocator();
client.SayHello_PortType client = service.getSayHello();
String retValue=client.getName("zhangsan");
System.out.println(retValue);


} catch (Exception e) {
System.err.println("Execution failed. Exception: " + e);
}
}
}  

8.开发自己的WEB应用程序的web service ,需要在描述文件WEB-INF/web.xml文件中添加:

<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>