用axis发布web services （一）

用axis发布web services （一）
2007-01-17 08:49 P.M.
首先到apache的网站下载axis的开发包，好久没看了，现在已经开始出2.0的啦，不过好像还不是很成熟，这里，我们还是用1.x的包。最新的是1.3的包（如果是用jbuilder的话是不需要再下载的，可以用其自带的工具发布的，做起来很简单，不过下面是以比较通用的方式来介绍）。
一、服务器端开发

      首先编写服务端程序，这时我们完全不用考虑他是不是当作webservcies来发布的，因为在写法上没有什么不同。比如我们写了一个很简单的java程序，代码如下：

package samples.userguide.example2;
public class Calculator {
  public int add(int i1, int i2)
  {
    return i1 + i2;
  }
  public int subtract(int i1, int i2)
  {
    return i1 - i2;
  }
}

如果我们要把他发布成为services，首先需要把axis-1_3下的lib文件复制到我们的web服务的web-inf 的lib下。 然后在web.xml里增加以下内容

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

第一个是制定AxisServlet的类是必须的，余下的是配置servlet mapping的，可根据需要进行修改，比如不需要对 *.jws做mapping的时候就可以去掉相应的部分。完成了上边的必须配置我们就有两种方式来发布了：

1、动态发布，直接把Calculator 的java文件复制到webroot下，把Calculator.java更名为Calculator.jws，然后通过http://localhost:8080/Calculator.jws 访问就可以 ，通过 http://localhost:8080/Calculator.jws?wsdl 就可以看到相应的wsdl。这种方式调试起来比较麻烦，而且我再测试的时候也不能带package的信息，而且一些高级的配置无法实施，不建议采用。

2、静态发布，就是通过配置文件发布，这时候我们类的编译和普通的web方式没有不同，只是在web-inf下多了一个配置文件，默认的名称为server-config.wsdd

<?xml version="1.0" encoding="UTF-8"?>
<deployment name="defaultClientConfig"
    xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"
    xmlns:handler="http://xml.apache.org/axis/wsdd/providers/handler" xmlns="http://xml.apache.org/axis/wsdd/">
    <globalConfiguration name="defaultClientConfig">
        <requestFlow name="RequestFlow1" type="">
            <handler name="Handler1" type="java:org.apache.axis.handlers.JWSHandler">
                <parameter name="scope" value="session"/>
            </handler>
            <handler name="Handler2" type="java:org.apache.axis.handlers.JWSHandler">
                <parameter name="scope" value="request"/>
                <parameter name="extension" value=".jwr"/>
            </handler>
        </requestFlow>
    </globalConfiguration>
    <handler name="URLMapper" type="java:org.apache.axis.handlers.http.URLMapper"/>
    <handler name="LocalResponder" type="java:org.apache.axis.transport.local.LocalResponder"/>
    <handler name="Authenticate" type="java:org.apache.axis.handlers.SimpleAuthenticationHandler"/>
    <transport name="http" type="">
        <requestFlow name="RequestFlow1" type="">
            <handler name="Handler1" type="URLMapper"/>
            <handler name="Handler2" type="java:org.apache.axis.handlers.http.HTTPAuthHandler"/>
        </requestFlow>
    </transport>
    <transport name="local" type="">
        <responseFlow name="ResponseFlow1" type="">
            <handler name="Handler1" type="LocalResponder"/>
        </responseFlow>
    </transport>
    <service name="AdminService" type="" provider="java:MSG">
        <parameter name="allowedMethods" value="AdminService"/>
        <parameter name="enableRemoteAdmin" value="false"/>
        <parameter name="className" value="org.apache.axis.utils.Admin"/>
        <namespace>http://xml.apache.org/axis/wsdd/</namespace>
    </service>
    <service name="Version" type="" provider="java:RPC">
        <parameter name="allowedMethods" value="getVersion"/>
        <parameter name="className" value="org.apache.axis.Version"/>
    </service>
    <service name="Calculator" type="" provider="java:RPC" style="rpc" use="encoded">
        <parameter name="scope" value="Request"/>
        <parameter name="className" value="samples.userguide.example2.Calculator"/>
        <parameter name="allowedMethods" value="*"/>
        <namespace>http://example2.userguide.samples</namespace>
    </service>
    <service name="OrderProcessor" provider="java:RPC">
        <parameter name="className" value="samples.userguide.example5.BeanService"/>
        <parameter name="allowedMethods" value="*"/>
        <beanMapping qname="myNS:Order" xmlns:myNS="urn:BeanService" languageSpecificType="java:samples.userguide.example5.Order"/>
    </service>
</deployment>

其中要发布的每个service都需要加上一个service的节点描述，其他多余的servie节点可以删除的，这样重启tomcat后，我们就可以以http://localhost:8080/services/Calculator 来访问这个service了，同样以http://localhost:8080/services/Calculator?wsdl 访问到它的wsdl描述文件。

二、客户端开发

在开发工具中引进lib下的jar包；然后编写客户端程序

package samples.userguide.example2;

import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.XMLType;
import org.apache.axis.utils.Options;

import javax.xml.rpc.ParameterMode;

public class CalcClient
{
   public static void main(String [] args) throws Exception {
       try{
           String endpoint = "https://localhost:8440/services/Calculator";
           Integer i1 = new Integer(1);
           Integer i2 = new Integer(2);

           Service service = new Service();
           Call call = (Call) service.createCall();

           call.setTargetEndpointAddress(new java.net.URL(endpoint));
           call.setOperationName("add");
           call.addParameter("i1", XMLType.XSD_INT, ParameterMode.IN);
           call.addParameter("i2", XMLType.XSD_INT, ParameterMode.IN);
           call.setReturnType(XMLType.XSD_INT);

           Integer ret = (Integer) call.invoke(new Object[] {i1, i2});

           System.out.println("Got result : " + ret);
       }
       catch(Exception e){
           e.printStackTrace();
       }
   }
}

其中 setOperationName就是指定执行的方法，addParameter就是指定参数
运行一下吧



Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=662125