使用axis在项目中开发WebService服务

 最近有个需求,要在现有的WEB服务器上提供一个WebService服务,找资料后确定有两种方法可行,一种是用axis,另一种是利用xfire,由于之前有同事用axis做过,并且比较简单,所以确定用axis进行开发.下面我就把用axis开发的过程简单的记录下来:

第一步:下载相关的jar包,axis要用到的jar包有:axis.jar,activation.jar,commons-discovery.jar,jaxrpc.jar,wsdl4j.jar,saaj.jar(这个包是在运行客户端是用到的),这些jar包在axis的安装包里的lib下应该有的,接下来就是要把这些jar包部署到web应用的classpath中,例如部署到/web-inf/lib下.

第二步:修改web应用的web.xml配置文件,加上一个sevlet

<!--  利用axis做WEBSERVICE服务 20080219加入 -->
   < servlet >
     < servlet - name > AxisServlet </ servlet - name >
     < display - name > Apache - Axis Servlet </ display - name >
     < servlet - class >
        org.apache.axis.transport.http.AxisServlet
     </ servlet - class >
   </ servlet >     

 

 <!-- 利用axis做WEBSERVICE服务 20080219加入-->

       <!-- 下面的*.jws映射配置在本次应用中没有用到,可以不加-->
 <servlet-mapping>
   <servlet-name>AxisServlet</servlet-name>
    <url-pattern>*.jws</url-pattern>
  </servlet-mapping>

<!-- 我们将用下面的映射地址调用service服务,例如你配置的service服务的名称是TestService那么调用这个service的路径为http://localhost/,webServices/TestService,如果你的调用路径不同修改影射地址即可-->
  <servlet-mapping>
    <servlet-name>AxisServlet</servlet-name>
    <url-pattern>/webServices/*</url-pattern>
  </servlet-mapping>

 

<!-- 在文件的最后加上下面这段-->

 <!-- 利用axis做WEBSERVICE服务 20080219加入-->
  <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>

 

到此web.xml配置文件修改完成.

第三步:开发提供服务的java程序

 

package com.test.webapp.webservice.server;



/**/ /**
 * 提供给PS商户校验用户密码的服务
 * 
 * @author 
 * @version 1.0, 
 * @since JDK 1.5.1
 */

public   class  PSCheckPsdService  {

    public PSCheckPsdService () {
    }

  /**
     * 
     * 验证结果一数组的形式返回给用户

     */
    public String[] checkPsd(String yourName,String password) {
        String result[] = new String[2];
        if("xiaoming".equals(telNum)&&"000000".equals(password)){
            result[0] = "0";
            result[1] = "ok";
        }else{
            result[0] = "1";
            result[1] = "密码不正确";
        }
        return result;
    }

}

 

 提供服务的java程序完成,是不是很简单呢,就是和普通的java程序一样,不用导入什么特殊的类文件.

第四步:开发webservice的配置文件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 " >
  < globalConfiguration >
   < parameter name = " adminPassword "  value = " admin " />
   < parameter name = " attachments.implementation "  value = " org.apache.axis.attachments.AttachmentsImpl " />
   < parameter name = " sendXsiTypes "  value = " true " />
   < parameter name = " sendMultiRefs "  value = " true " />
   < parameter name = " sendXMLDeclaration "  value = " true " />
   < parameter name = " axis.sendMinimizedElements "  value = " true " />
   < requestFlow >
    < handler type = " java:org.apache.axis.handlers.JWSHandler " >
     < parameter name = " scope "  value = " session " />
    </ handler >
    < handler type = " java:org.apache.axis.handlers.JWSHandler " >
     < parameter name = " scope "  value = " request " />
     < parameter name = " extension "  value = " .jwr " />
    </ handler >
   </ requestFlow >
  </ globalConfiguration >
  < handler name = " LocalResponder "  type = " java:org.apache.axis.transport.local.LocalResponder " />
  < handler name = " URLMapper "  type = " java:org.apache.axis.handlers.http.URLMapper " />
  < handler name = " Authenticate "  type = " java:org.apache.axis.handlers.SimpleAuthenticationHandler " />
  < service name = " AdminService "  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 "  provider = " java:RPC " >
   < parameter name = " allowedMethods "  value = " getVersion " />
   < parameter name = " className "  value = " org.apache.axis.Version " />
  </ service >

  <!--  定义webservice服务 20080219加入,这就是配置我们开发的service的地方,我们开发了新的service服务只要增加一个service节点即可 -->
  < service name = " TestService "  provider = " java:RPC " ><!--定义service的名称如:TestService-->
   < parameter name = " allowedMethods "  value = " * " /><!--允许提供服务的方法名称,有多个用逗号阁开,*表示所有方法-->
   < parameter name = " scope "  value = " Request " /><!--Request,Application,Session-->
   < parameter name = " className "  value = " com.test.webapp.webservice.server.PSCheckPsdService " />
  </ service >
 
  < transport name = " http " >
   < requestFlow >
    < handler type = " URLMapper " />
    < handler type = " java:org.apache.axis.handlers.http.HTTPAuthHandler " />
   </ requestFlow >
  </ transport >
  < transport name = " local " >
   < responseFlow >
    < handler type = " LocalResponder " />
   </ responseFlow >
  </ transport >
</ deployment >

配置文件server-config.wsdd开发完成.

第五步:部署类文件到/web-inf/classes/中,重启服务

第六步测试:在浏览器中输入地址:http://localhost/,webServices/TestService?wsdl 测试service是否部署成功,如果出现如下结果即表示成功:

   <? xml version = " 1.0 "  encoding = " UTF-8 "   ?>  
-   < wsdl:definitions targetNamespace = " http://localhost/webServices/TestService "  xmlns = " http://schemas.xmlsoap.org/wsdl/ "  xmlns:apachesoap = " http://xml.apache.org/xml-soap "  xmlns:impl = " http://localhost/webServices/TestService "  xmlns:intf = " http://localhost/webServices/TestService "  xmlns:soapenc = " http://schemas.xmlsoap.org/soap/encoding/ "  xmlns:wsdl = " http://schemas.xmlsoap.org/wsdl/ "  xmlns:wsdlsoap = " http://schemas.xmlsoap.org/wsdl/soap/ "  xmlns:xsd = " http://www.w3.org/2001/XMLSchema " >
-   < wsdl:types >
-   < schema targetNamespace = " http://localhost/webServices/TestService "  xmlns = " http://www.w3.org/2001/XMLSchema " >
   < import  namespace = " http://schemas.xmlsoap.org/soap/encoding/ "   />  
-   < complexType name = " ArrayOf_xsd_string " >
-   < complexContent >
-   < restriction  base = " soapenc:Array " >
   < attribute  ref = " soapenc:arrayType "  wsdl:arrayType = " xsd:string[] "   />  
   </ restriction >
   </ complexContent >
   </ complexType >
   </ schema >
   </ wsdl:types >
-   < wsdl:message name = " checkTelPsdResponse " >
   < wsdl:part name = " checkTelPsdReturn "  type = " intf:ArrayOf_xsd_string "   />  
   </ wsdl:message >
-   < wsdl:message name = " checkTelPsdRequest " >
   < wsdl:part name = " telNum "  type = " xsd:string "   />  
   < wsdl:part name = " password "  type = " xsd:string "   />  
   </ wsdl:message >
-   < wsdl:portType name = " PSCheckTelPsdService " >
-   < wsdl:operation name = " checkTelPsd "  parameterOrder = " telNum password " >
   < wsdl:input message = " intf:checkTelPsdRequest "  name = " checkTelPsdRequest "   />  
   < wsdl:output message = " intf:checkTelPsdResponse "  name = " checkTelPsdResponse "   />  
   </ wsdl:operation >
   </ wsdl:portType >
-   < wsdl:binding name = " TestServiceSoapBinding "  type = " intf:PSCheckPsdService " >
   < wsdlsoap:binding style = " rpc "  transport = " http://schemas.xmlsoap.org/soap/http "   />  
-   < wsdl:operation name = " checkTelPsd " >
   < wsdlsoap:operation soapAction = ""   />  
-   < wsdl:input name = " checkTelPsdRequest " >
   < wsdlsoap:body encodingStyle = " http://schemas.xmlsoap.org/soap/encoding/ "   namespace = " http://server.webservice.webapp.test.com "  use = " encoded "   />  
   </ wsdl:input >
-   < wsdl:output name = " checkTelPsdResponse " >
   < wsdlsoap:body encodingStyle = " http://schemas.xmlsoap.org/soap/encoding/ "   namespace = " http://localhost/webServices/TestService "  use = " encoded "   />  
   </ wsdl:output >
   </ wsdl:operation >
   </ wsdl:binding >
-   < wsdl:service name = " PSCheckPsdServiceService " >
-   < wsdl:port binding = " intf:PSCheckPsdSVSoapBinding "  name = " TestService " >
   < wsdlsoap:address location = " http://localhost/webServices/TestService "   />  
   </ wsdl:port >
   </ wsdl:service >
   </ wsdl:definitions >

第六步:用axis开发的客户测试是否可以调通

package com.sztelecom.webapp.webservice.test;

import org.apache.axis.client.Service;
import org.apache.axis.client.Call;
import javax.xml. namespace .QName;
public   class  Test  ... {
    public static void main(String[] args) ...{
        try ...{
        String name= "xiaoming";
        String password = "000000";
        String endpoint = "http://localhost/webServices/TestService";
        Service service = new Service();
        Call call = (Call)service.createCall();
        call.setTargetEndpointAddress(endpoint);
        call.setOperationName(new QName("urn:TestService", "checkPsd"));
        String[] result = (String[])call.invoke(new Object[]...{name,password});
        System.out.println("AXIS Server return: " + result[0]);
        } catch(Exception e) ...{
        e.printStackTrace();
        }
            
        }
}

运行该程序,看看打印出来的是不是AXIS Server return:  0

以上程序在weblogic6.1中测试通过,tomcat正在部署中,有结果将会帖出来的,欢迎讨论相关技术,QQ:271537491