在axis中通过wsdd文件发布和卸载webservice

yangyang

浏览: 175026 次
性别:
来自: 北京

最近访客更多访客>>

xuxiaowen

jackemark

yuzuwei

linjarne

博主相关

博客

微博

相册

留言

关于我

文章分类

全部博客 (23)

社区版块

存档分类

WebService Apache Java XML .net

在上一篇<>中我介绍了一种简单webservice的发布方式-jws。

这种发布方式非常的敏捷！但有它的局限性—你必须知道webservice的源代码。有时候这个的确很让人郁闷！比如：的webservice被打成了一个jar包，你并没有源代码。或者这个webservice根本就不是你的公司开发的。这时你发布这个webservice就会变得很困难。axis针对这种情况提供了wsdd文件的方式来发布和撤销webservice。

现在我们来通过一个wsdd文件来对wsdd有个初步的认识。注意：在开始下面的步骤前请安装axis.具体安装请看上一篇

xml 代码

<deployment xmlns="http://xml.apache.org/axis/wsdd/"
xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
<service name="MyService" provider="java:RPC">
<parameter name="className" value="samples.userguide.example3.MyService"/>
<parameter name="allowedMethods" value="*"/>
service>
deployment>

最外面的元素告诉我们这是一个wsdd发布项，并且定义了java的命名空间，service 元素定义了我们的service.java:RPC定义了axis的provider。parameter name定义了webservice类名及所在包的位置。allowedMethods value等于*，表示MyService的所有方法都可以被调用。

了解了wsdd文件，我们来认识一个非常有用的工具AdminClient.正式通过它我们才能通过wsdd文件发布我们的应用。它的全路径是org.apache.axis.client.AdminClient，在axis.jar包中。在使用这个工具前我们必须把相应的jar包加入classpath。如：axis.jar..。如果你做了<>的练习则这一步就不用再做了。

我们首先进入webservice所在源文件的目录找到deploy.wsdd文件。然后键入如下命令：

java org.apache.axis.client.AdminClient deploy.wsdd

（如果提示错误，请检查你是否将必须的jar包加入classpath）

如果成功则会显示：

<Admin>Done processingAdmin>

下面来解释AdminClient 所做的工作。AdminClient 首先会在axis.jar所在应用下的WEB-INF文件夹下创建一个webservice配置文件server-config.wsdd，并且根据wsdd文件的配置将我们的webservice加入到这个配置文件中。如果server-config.wsdd已经存在则不会创建，会修改这个文件将新的service 配置到server-config.wsdd文件中。

如图：

xml 代码

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="sendMultiRefs" value="true"/>
<parameter name="disablePrettyXML" value="true"/>
<parameter name="adminPassword" value="admin"/>
<parameter name="attachments.Directory" value="C:\tomcat5\webapps\axis\WEB-INF\attachments"/>
<parameter name="dotNetSoapEncFix" value="true"/>
<parameter name="enableNamespacePrefixOptimization" value="false"/>
<parameter name="sendXMLDeclaration" value="true"/>
<parameter name="sendXsiTypes" value="true"/>
<parameter name="attachments.implementation" value="org.apache.axis.attachments.AttachmentsImpl"/>
<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>
>
<service name="MyService" provider="java:RPC">
<parameter name="allowedMethods" value="*"/>
<parameter name="className" value="samples.userguide.example3.MyService"/>
service>
<transport name="http">
<requestFlow>
<handler type="URLMapper"/>
<handler type="java:org.apache.axis.handlers.http.HTTPAuthHandler"/>
requestFlow>
<parameter name="qs:list" value="org.apache.axis.transport.http.QSListHandler"/>
<parameter name="qs:wsdl" value="org.apache.axis.transport.http.QSWSDLHandler"/>
<parameter name="qs.list" value="org.apache.axis.transport.http.QSListHandler"/>
<parameter name="qs.method" value="org.apache.axis.transport.http.QSMethodHandler"/>
<parameter name="qs:method" value="org.apache.axis.transport.http.QSMethodHandler"/>
<parameter name="qs.wsdl" value="org.apache.axis.transport.http.QSWSDLHandler"/>
transport>
<transport name="local">
<responseFlow>
<handler type="LocalResponder"/>
responseFlow>
transport>
deployment>

xml 代码

我们来访问一下看看：

java samples.userguide.example3.Client -lhttp://localhost:8080/axis/services/MyService "test me!"

You typed : test me!

返回正确，部署成功！

如果你要卸载一个webservice也很简单！我们首先定义一个undeploy.wsdd

<undeployment xmlns="http://xml.apache.org/axis/wsdd/">
<service name="MyService"/>
undeployment>

xml 代码<service name="MyService"></service>

进入webservice所在源文件的目录找到undeploy.wsdd文件。然后键入如下命令：

java org.apache.axis.client.AdminClient undeploy.wsdd

（如果提示错误，请检查你是否将必须的jar包加入classpath）

如果成功则会显示：

<Admin>Done processingAdmin>

在看server-config.wsdd已经删除了原来service的定义

xml 代码

<?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="sendMultiRefs" value="true"/>
<parameter name="disablePrettyXML" value="true"/>
<parameter name="adminPassword" value="admin"/>
<parameter name="attachments.Directory" value="C:\tomcat5\webapps\axis\WEB-INF\attachments"/>
<parameter name="dotNetSoapEncFix" value="true"/>
<parameter name="enableNamespacePrefixOptimization" value="false"/>
<parameter name="sendXMLDeclaration" value="true"/>
<parameter name="sendXsiTypes" value="true"/>
<parameter name="attachments.implementation" value="org.apache.axis.attachments.AttachmentsImpl"/>
<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>
<!--
原来的service的定义已经删除！
-->
<transport name="http">
<requestFlow>
<handler type="URLMapper"/>
<handler type="java:org.apache.axis.handlers.http.HTTPAuthHandler"/>
</requestFlow>
<parameter name="qs:list" value="org.apache.axis.transport.http.QSListHandler"/>
<parameter name="qs:wsdl" value="org.apache.axis.transport.http.QSWSDLHandler"/>
<parameter name="qs.list" value="org.apache.axis.transport.http.QSListHandler"/>
<parameter name="qs.method" value="org.apache.axis.transport.http.QSMethodHandler"/>
<parameter name="qs:method" value="org.apache.axis.transport.http.QSMethodHandler"/>
<parameter name="qs.wsdl" value="org.apache.axis.transport.http.QSWSDLHandler"/>
</transport>
<transport name="local">
<responseFlow>
<handler type="LocalResponder"/>
</responseFlow>
</transport>
</deployment>

看是不是很简单，不仅省去了ctrl+c和ctrl+v，还防止了手动配置出错。一举两得岂不快哉！<o:p></o:p>

分享到：

手把手教你用axis创建自己的webservice（一 ... | axis—安装

2007-02-28 18:31
浏览 25152
评论(13)
论坛回复 / 浏览 (9 / 33590)
分类:企业架构
查看更多

13 楼滁筱梦 2013-01-05

lvxin006 写道

请问哈为什么我的老是报这样的错啊？exception in thread main java.lang.noclassfoundexceptionerror:org/apache/client/adminclient

我能肯定是那些jar包加入classpath配置没起作用，多个jar包配置我也用；隔开了啊，什么原因呢？

12 楼 kusix 2007-08-22

axis用起太麻烦了，还是用XFIRE

11 楼 lvxin006 2007-08-22

我们首先进入webservice所在源文件的目录找到deploy.wsdd文件。然后键入如下命令：

java org.apache.axis.client.AdminClient deploy.wsdd

（如果提示错误，请检查你是否将必须的jar包加入classpath）

这里改正一下，键入：
java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient deploy.wsdd
切记！！！

10 楼 lvxin006 2007-08-21

请问哈为什么我的老是报这样的错啊？exception in thread main java.lang.noclassfoundexceptionerror:org/apache/client/adminclient

9 楼 ziyang_liu 2007-07-18

不错，支持一下！

8 楼 huangguan 2007-06-28

版主，axis2不是有自动生成自动配置文件的吗？

不用手写了吧？
难道手写更有优势？

7 楼 laozhuang 2007-06-27

写得非常不错，两篇都学习并跑了一下，成功！

6 楼 onlykwx 2007-06-21

这是我按版主说的执行历史，希望对后边看的兄弟有点帮助：
1、启动你的应用服务器（当然是部署好axis后）
2、进入samples\userguide\example3目录

创建服务：
java org.apache.axis.client.AdminClient -lhttp://localhost:80/axis/services/AdminService deploy.wsdd
调用服务：
java samples.userguide.example3.Client -lhttp://localhost:80/axis/services/MyService "test me!"
删除服务：
java org.apache.axis.client.AdminClient -lhttp://localhost:80/axis/services/AdminService undeploy.wsdd

（具体IP及端口根据本地实际情况进行修改）

5 楼 onlykwx 2007-06-21

看完第二篇也实践成功了，支持！

4 楼 janmy 2007-05-22

我将Axis安装好了，进入samples.userguide.example3.Client看了一下源代码，如下:
package samples.userguide.example3;

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.namespace.QName;
import javax.xml.rpc.ParameterMode;

public class Client
{
    public static void main(String [] args)
    {
        try {
            Options options = new Options(args);

            String endpointURL = options.getURL();
            String textToSend;

            args = options.getRemainingArgs();
            if ((args == null) || (args.length < 1)) {
                textToSend = "<nothing>";
            } else {
                textToSend = args[0];
            }

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

            call.setTargetEndpointAddress( new java.net.URL(endpointURL) );
            call.setOperationName( new QName("http://example3.userguide.samples", "serviceMethod") );
            call.addParameter( "arg1", XMLType.XSD_STRING, ParameterMode.IN);
            call.setReturnType( org.apache.axis.encoding.XMLType.XSD_STRING );

            String ret = (String) call.invoke( new Object[] { textToSend } );

            System.out.println("You typed : " + ret);
        } catch (Exception e) {
            System.err.println(e.toString());
        }
    }
}

是传参数进来才能运行吧！！楼主说进入到这个目录下运行 java org.apache.axis.client.AdminClient deploy.wsdd,就会产生service-config.xml文件，我因为我是新学这个东西，不知道要怎样传参数（或是否需要传参数，传什么样的参数）,我运下了产生了如下异常(各位给几个指点吧)：
minClient deploy.wsdd
Processing file deploy.wsdd
Exception: AxisFault
faultCode: {http://schemas.xmlsoap.org/soap/envelope/}Server.userException
faultSubcode:
faultString: java.net.ConnectException: Connection refused: connect
faultActor:
faultNode:
faultDetail:
        {http://xml.apache.org/axis/}stackTrace:java.net.ConnectException: Conne
ction refused: connect
        at java.net.PlainSocketImpl.socketConnect(Native Method)
        at java.net.PlainSocketImpl.doConnect(PlainSocketImpl.java:333)
        at java.net.PlainSocketImpl.connectToAddress(PlainSocketImpl.java:195)
        at java.net.PlainSocketImpl.connect(PlainSocketImpl.java:182)
        at java.net.SocksSocketImpl.connect(SocksSocketImpl.java:366)
        at java.net.Socket.connect(Socket.java:507)
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
        at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.
java:39)
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAcces
sorImpl.java:25)
        at java.lang.reflect.Method.invoke(Method.java:585)
        at org.apache.axis.components.net.DefaultSocketFactory.create(DefaultSoc
ketFactory.java:153)
        at org.apache.axis.components.net.DefaultSocketFactory.create(DefaultSoc
ketFactory.java:120)
        at org.apache.axis.transport.http.HTTPSender.getSocket(HTTPSender.java:1
91)
        at org.apache.axis.transport.http.HTTPSender.writeToSocket(HTTPSender.ja
va:404)
        at org.apache.axis.transport.http.HTTPSender.invoke(HTTPSender.java:138)

        at org.apache.axis.strategies.InvocationStrategy.visit(InvocationStrateg
y.java:32)
        at org.apache.axis.SimpleChain.doVisiting(SimpleChain.java:118)
        at org.apache.axis.SimpleChain.invoke(SimpleChain.java:83)
        at org.apache.axis.client.AxisClient.invoke(AxisClient.java:165)
        at org.apache.axis.client.Call.invokeEngine(Call.java:2784)
        at org.apache.axis.client.Call.invoke(Call.java:2767)
        at org.apache.axis.client.Call.invoke(Call.java:1792)
        at org.apache.axis.client.AdminClient.process(AdminClient.java:439)
        at org.apache.axis.client.AdminClient.process(AdminClient.java:404)
        at org.apache.axis.client.AdminClient.process(AdminClient.java:410)
        at org.apache.axis.client.AdminClient.process(AdminClient.java:320)
        at org.apache.axis.client.AdminClient.main(AdminClient.java:463)

        {http://xml.apache.org/axis/}hostname:PA-A-zjming

3 楼 piper 2007-04-06

版主文章写的很好，不过难免有所疏忽，不可能面面俱全
楼上，你的解决办法：
java org.apache.axis.client.AdminClient -lhttp://地址:端口/context模块/services/AdminService deploy.wsdd

2 楼 piper 2007-04-06

版主写的很好，不过也不能面面俱全，楼上，你的解决办法：

java org.apache.axis.client.AdminClient -lhttp://地址:端口/context模块/services/AdminService deploy.wsdd

1 楼 crejavasky 2007-04-04

出错了！怎么回事？

Processing file delopy.wsdd
Exception: AxisFault
faultCode: {http://xml.apache.org/axis/}HTTP
faultSubcode:
faultString: (404)/axis/services/AdminService
faultActor:
faultNode:
faultDetail:
{}:return code: 404
<html><head><title>Apache Tomcat/5.5.16 - Error report</tit
le><style></style> </hea
d><body><h1>HTTP Status 404 - /axis/services/AdminService</h1&
gt;<HR size="1" noshade="noshade"><p><b>ty
pe</b> Status report</p><p><b>message</b> <u&gt
;/axis/services/AdminService</u></p><p><b>description&lt
;/b> <u>The requested resource (/axis/services/AdminService) is not ava
ilable.</u></p><HR size="1" noshade="noshade"
><h3>Apache Tomcat/5.5.16</h3></body></html>
{http://xml.apache.org/axis/}HttpErrorCode:404

发表评论

您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论