Tomcat+Axis实现webservice

虎啸长沙,龙跃深圳. — Wed, 12 Nov 2008 16:33:00 GMT

�? 据网上搜索到的一些例子做的时候碰��C��挺多的问题，�l�过不懈的努力终于完成了�q�个webservice的例子，实际上axis的文档上也写了一个例子，�|? 上的例子也大多都是照他上面所写的那样�Q�只是有些讲的不��很详细�Q�所以��生了不少错误�Q�小弟知识浅薄，如有写的不清楚地地方�Q�还误��?/strong>

所需软�g
tomcat        �Q?a >http://tomcat.apache.org/index.html
axis          �Q?a >http://ws.apache.org/axis/
jdk           �Q?a >http://java.sun.com/javase/downloads/index.jsp
jaf           �Q?a >http://java.sun.com/products/javabeans/jaf/downloads/index.html
xmlrpc        �Q?a >http://ws.apache.org/xmlrpc

XML解析�?br /> Xalan         �Q?a >http://archive.apache.org/dist/xml/xalan-j/
Xerces        �Q?a >http://xml.apache.org/dist/xerces-j/

本例讲解axis定制发布

本实例采�?br /> j2sdk1.4.2_05�Q�tomcat5.0.28�Q�axis1.4�Q�jbuilder X / Eclipse3.2

首先��axis解压至相应目录，如d:\下，安装tomcat至c:\tomcat5�Q�安装jdk至c:\ j2sdk1.4.2_05
然后��d:\axis\webapp目录下的axis目录copy至c:\tomcat5\webapps目录�?

讄��a(ch��n)xis的环境变�?/strong>

AXIS_HOME=d:\axis

AXIS_LIB=%AXIS_HOME%\lib

AXISCLASSPATH=%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery-0.2.jar;%AXIS_LIB%\commons-logging-1.0.4.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j-1.2.8.jar;%AXIS_LIB%\xml-apis.jar;%AXIS_LIB%\xercesImpl.jar;%AXIS_LIB%\wsdl4j-1.5.1.jar;%AXIS_LIB%\activation.jar;%AXIS_LIB%\xmlrpc-2.0.jar

�Q�xml-apis.jar, xercesImpl.jar属于Xerces或Xalan, activation.jar属于jaf, xmlrpc-2.0.jar属于xmlrpc�Q?/p>
1�Q?配置完成后启动tomcat�Q�在��览器中键入http://localhost:8080/axis�Q�将昄��如下画面

2�Q�在C:\Tomcat5\webapps\axis\WEB-INF目录下徏立一个src目录�Q�用于存放源�E�序
接着�~�写服务端程序server.AxisReturn
package server;
public class AxisReturn {
    public String ReturnMsg(String servicesName) {
      return "Axis Return: "+ servicesName;
    }
}
�?/span>�? 此我们利用了Jbuilder X作�ؓ(f��)我们java�E�序的开发工��P��利用Jbuilder新徏工程中的Project for Existing Code��C:\Tomcat5\webapps\axis\WEB-INF下的�E�序�?qi��ng)目录导入作为Jbuilder的一个工�E�来操作

�~�译AxisReturn�E�序�Q�Jbuilder��会(x��)把编译后的class文�g自存攑֜�C:\Tomcat5\webapps\axis\WEB-INF\classes\server目录�?br />
3�Q�编写wsdd文�g�Q�此处命名�ؓ(f��)deploy.wsdd�Q�其内容�?/strong>

http://xml.apache.org/axis/wsdd/
              xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">




�?/span>每个service��׃��表服务端的一个程序，如有多个可��l�添加service�Q�相兛_��数请查阅axis文档
�?/span>此处的deployment代表发布服务�Q�如改�ؓ(f��)undeployment则�ؓ(f��)撤销服务

4�Q�发布服�?br /> 打开windows的命令窗口，转到wsdd文�g的存攄��录下�Q�此处�ؓ(f��)C:\Tomcat5\webapps\axis\WEB-INF\src\server
在命令窗口中键入
java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient deploy.wsdd

如果成功��显�C?lt;Admin>Done processing
�?/span>如失败，则检查AXISCLASSPATH是否讄��正确�Q�tomcat端口是否为默认的8080
�?/span>在这里有一个问题需注意�Q�不��是在axis目录下还是其他虚拟目录下�Q�如直接执行�q�条命��o(h��)�Q�都��在axis的目录下发布service�Q�如果想发布在其他的目录下，如pscsaxis�Q�则应执�?br /> java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient -lhttp://localhost:8080/pscsaxis/services/AdminService deploy.wsdd

-cp表示在AXISCLASSPATH环境变量中检索org.apache.axis.client.AdminClient�Ҏ(gu��)��

5�Q�生成client stub文�g
�?/span>在命令窗口中��目录�{至C:\Tomcat5\webapps\axis\WEB-INF\classes
然后执行
java -cp %AXISCLASSPATH% org.apache.axis.wsdl.Java2WSDL -oAxisReturn.wsdl -lhttp://localhost:8080/axis/services/AxisReturn -nAxisReturn server.AxisReturn

��会(x��)在C:\Tomcat5\webapps\pscsaxis\WEB-INF\classes下生成AxisReturn.wsdl文�g
接着在执�?br /> java -cp %AXISCLASSPATH% org.apache.axis.wsdl.WSDL2Java AxisReturn.wsdl -p client

��会(x��)在C:\Tomcat5\webapps\axis\WEB-INF\classes\client目录下生成四个java文�g
AxisReturn_PortType.java
AxisReturnService.java
AxisReturnServiceLocator.java
AxisReturnSoapBindingStub.java
��这四个文�g剪切至C:\Tomcat5\webapps\pscsaxis\WEB-INF\src\client目录下，�q�编�?

6�Q�编写客��L(f��ng)��
利用生成client stub文�g�~�写

package client;
public class ClientAxisReturn {
    public static void main(String args[]) {
      try {
        AxisReturnService service = new client.AxisReturnServiceLocator();
        client.AxisReturn_PortType client = service.getAxisReturn();
        String retValue = client.returnMsg("BaoSteel");
        System.out.println(retValue);
      }
      catch (Exception e) {
        System.err.println("Execution failed. Exception: " + e);
      }
    }
}

�~�写完后�Q�编译运行即可得到返回结�?br /> �?/span>如需传入多个参数�Q�需在String retValue = client.returnMsg("BaoSteel");�q�句中增加参敎ͼ��?br /> String retValue = client.returnMsg("BaoSteel","PSCS_IMS");
�?/span>相应的服务端也要更改�Q�如
package server;
public class AxisReturn {
    public String ReturnMsg(String servicesName�Q�String serviceID) {
      return "Axis Return: "+ servicesName+ serviceID;
    }
}

利用发布服务的wsdl的URL�~�写
package client;
import org.apache.axis.AxisFault;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import javax.xml.rpc.ParameterMode;
import javax.xml.rpc.encoding.XMLType;
public class ClientAxisReturnWsdl {
    public static void main(String args[]) throws Exception{
      String endPoint =
        http://190.2.63.239:8080/pscsaxis/services/AxisReturn?wsdl;
      Service service = new Service();
      Call call = (Call) service.createCall();
      Object result;
      try {
        call.setTargetEndpointAddress(new java.net.URL(endPoint));
        call.setOperationName("ReturnMsg");
        call.addParameter("OP1", XMLType.XSD_STRING, ParameterMode.IN);
        call.setReturnType(XMLType.XSD_STRING);
        result = (Object) call.invoke(new Object[] {"BaoSteel"});
      }
      catch (AxisFault fault) {
        result = "Error is: " + fault.toString();
      }
      System.out.println(result);
    }
}

�~�写完后�Q�编译运行即可得到返回结�?br /> �?/span>如许增加参数�Q�则需��d��语句
call.addParameter("OP1", XMLType.XSD_STRING, ParameterMode.IN);
��参数名OP1改�ؓ(f��)其他�Q�如OP2
在result = (Object) call.invoke(new Object[] {" BaoSteel "});�q�句中增加参敎ͼ��?br /> result = (Object) call.invoke(new Object[] {" BaoSteel "," PSCS_IMS "});
�?/span>相应的服务端也要更改�Q�如
package server;
public class AxisReturn {
    public String ReturnMsg(String servicesName�Q�String serviceID) {
      return "Axis Return: "+ servicesName+ serviceID;
    }
}

★在�q�里�Q�我们的服务端只有一个方法供我们调用�Q�如果我们需要调用多个服务端的方法，则可在服务端中加入其他方法，如我们在增加一个xxMsg

package server;
public class AxisReturn {
    public String ReturnMsg(String servicesName,String systemID) {
      return "Axis Return: "+ str+servicesName+systemID;
    }
    public String xxMsg(String serviceName,String systemID) {
    return "XX Return: "+ str+serviceName+systemID;
}
}

★修改完后将其编译，�q�将其注销后重新发布，反之需要重起tomcat�Q�否则服务将不被更新
★利用生成client stub文�g�~�写的客��L(f��ng)��E�序�Q�还需重新生成client stub文�g�Q��ƈ��其�~�译�Q�在客户端程序中调用其相应得�Ҏ(gu��)��卛_��

SOAPMonitor的配�|?/strong>

�? 布了Web服务以后�Q�如何观察请求和响应数据呢？记录�q�行日志是一�U�传�l�且有效的方法，但对于调试程序来讲还不够方便和直观。值得�ƣ慰的是�Q�Axis为我们提供了在客��L(f��ng)��观察SOAP��h��和响应流数据的工具SoapMonitor�Q�经�q�适当配置后，可以实时地观察到Web服务的SOAP��h��和响应数据�? SoapMonitor是一个Java Applet�E�序�Q�通过��览器下载到客户端运行。下面就介绍SoapMonitor的配�|�和使用�Ҏ(gu��)��?br />
在C:\Tomcat5\webapps\axis的目录下有一个SOAPMonitorApplet.java的程序，axis默认没有�l�我们编译，我们需要自��p��行编�?br />
打开windows命��o(h��)�H�口�Q��{到C:\Tomcat5\webapps\axis目录下，执行
javac -classpath %AXIS_HOME%\lib\axis.jar SOAPMonitorApplet.java

�~�译完成后需要发布服务，我们需要徏立一个wsdd文�gdeploy-monitor.wsdd�Q�内容如�?br />
http://xml.apache.org/axis/wsdd/
      xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
            type="java:org.apache.axis.handlers.SOAPMonitorHandler">











�?/span>需要注意的是红色的那句语句�Q�如果是在我们自��q��web应用目录下的话需�Ҏ(gu��)��自己的目录�?br /> 建立完成后执行命令进行发�?br /> java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient -lhttp://localhost:8080/axis/services/AdminService deploy-monitor.wsdd

发布SOAPMonitor服务后，�q�要对被监测的Web服务�q�行配置。方法是先注销该Web服务�Q�然后修改该服务对应的WSDD文�g�Q�在其中增加��h��和响应��的配置�Q�否则是观测不到SOAP��h��和响应流的。以我们上面的程序�ؓ(f��)例，��deploy.wsdd修改�?/p>

http://xml.apache.org/axis/wsdd/
              xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">










增加�?br />





�q�两�D?

然后我们通过点击http://localhost:8080/axis/主页上的SOAPMonitor或直接访�?a href="http://localhost:8080/axis/SOAPMonitor">http://localhost:8080/axis/SOAPMonitor�Q�点击start或stop启动或停止监控，然后我们�q�行客户端程序，SOAPMonitor�?x��)监控到��h��和响应流�Q�如下图

�?/span>�? �q�里�Q�我们需要注意一个配�|�问题，如果tomcat下有多个axis应用�Q�设�|�了多个SOAPmonitor�Q�我们则需要更改SOAPmonitor的端口（axis默认配置的是5001�Q�，否则�?x��)��生冲�H�，�q�行SOAPmonitor时会(x��)无法启动�Q�提�C�the soap monitor is unable to communcate with the server�Q�解��x��法如下：(x��)

打开C:\Tomcat5\webapps\axis\WEB-INF目录下的web.xml�Q�找�?br />

      SOAPMonitorService
      SOAPMonitorService

          org.apache.axis.monitor.SOAPMonitorService


        SOAPMonitorPort
        5001

      100

�q�段�Q�将其中�?001�Ҏ(gu��)��5002�Q�依此类�?br />
�ȝ��Q?/strong>
��量��发布websrrvice的文件夹和axis分开攄��
建立多个axis应用�Ӟ��应注意一些端口的讄��Q�命令的参数讄��以及(qi��ng)一些命令执行的路径讄��{�，否则�?x��)��生一些错误，如ClassNotFound�Q�service发布错误�{�的错误

server-config.wsdd

     xmlns="      xmlns:xsi="      name="defaultClientConfig" xsi:type="deployment">






















        languageSpecificType="java:com.isw2.ebay.callcenter.axis.CsrBean" />
       languageSpecificType="java:com.isw2.ebay.callcenter.axis.ContactRecordBean" />
       languageSpecificType="java:com.isw2.ebay.callcenter.axis.DisputeContactRecord" />
       languageSpecificType="java:com.isw2.ebay.callcenter.axis.WorkloadNumberBean" />







         http://xml.apache.org/axis/wsdd/




















虎啸长沙,龙跃深圳. 2008-11-13 00:33 发表评论

国产aⅴ精品一区二区四区,中文字幕欧美日韩精品,欧美电影一区二区

Tomcat+Axis实现webservice