本章节主要介绍Axis1.4发布WebService。这里只说明发布相关内容,调用方法后续会说明。
1、下载安装
下载完成之后解压文件,得到目录如下
目录说明:
docs:存放Axis的说明文档。
lib:存放Axis的二进制发布包,(如果你想在你项目中使用就导入这里的包)。
samples:官方给的一些简单案例。
webapps:里面放了一个axis项目,放到tomcat的webapps下可以直接使用。
xmls:相关说明文档。
maven安装:大多数情况下我们只是想在自己的web项目中引入这项技术,我们只需要导入jar包即可。
<dependency> <groupId>axis</groupId> <artifactId>axis</artifactId> <version>1.4</version> </dependency> <dependency> <groupId>axis</groupId> <artifactId>axis-wsdl4j</artifactId> <version>1.5.1</version> </dependency> <dependency> <groupId>javax.mail</groupId> <artifactId>mail</artifactId> <version>1.4.7</version> </dependency>
2、即时发布JWS
public class HelloJWS { public String sayHello(String name){ return "jws = " + name; } }将上面java类后缀修改为jws复制到tomcat/webapps/axis/ 目录下。访问路径 :项目名/类名.jws?wsdl
访问这个路径:http://127.0.0.1:8080/axis/HelloJWS.jws?wsdl 在浏览器上就可以看到wsdl了,表示发布服务成功。
JWS方式总结:
1. 即时发布方式比较简单,写个类一丢就可以了。
2. 类不能有包名,而且如果你只有class或者jar包则不可以使用这种方式。
3. 所以可以看出,这种方式只能发布特别特别简单的服务。
不适用企业开发,所以了解就好了。
3、定制发布
定制发布的步骤:
一般来说定制发布的步骤如下:
1. 新建一个web工程。
3. 像正常项目那样编写业务类。
6. 访问wsdl,看看服务是否发布成功。
定制发布的详细流程:
上图就是整个项目的结构了。其中WEB-INF目录下的deploy.wsdd表示写入其中的配置会被发布。undeploy.wsdd则用于取消发布。
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems,Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd" > <web-app> <servlet> <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>/services/*</url-pattern> </servlet-mapping> </web-app>3. 新建deploy.wsdd文件,将我们服务发布出去。
<deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"> <!-- name: 服务名随便写。 --> <service name="SayHello" provider="java:RPC"> <parameter name="className" value="com.ztesoft.axis.ws.HelloImpl" /> <!-- value表示哪些方法需要发布,*表示全部的public方法。 --> <!-- 如果想指定方法名,方法名与方法名用逗号隔开 --> <parameter name="allowedMethods" value="*" /> <!-- 指定命名空间 --> <namespace>http://www.ztesoft.com/axis/sayHello</namespace> </service> </deployment>
4. 部署项目到tomcat,并且启动项目。这个时候访问 http://127.0.0.1:8080/axis/services(因为web.xml配置了这个servlet路径,
java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient -l http://127.0.0.1:8080/axis/services deploy.wsdd注意:此处是相对路径,所以你需要到tomcat/webapps/axis/WEB-INF 目录下执行cmd。你就会看到
你就可以看见服务描述了。
如果不想发布这个服务了,则同样执行上面的命令,将deploy.wsdd换成undeploy.wsdd即可。undeploy.wsdd内容如下
执行之后就看不到该服务了。下面的服务名就是上面可以随便写的name。
<deployment xmlns="http://xml.apache.org/axis/wsdd/" > <service name="SayHello" /> </deployment>总结:
<?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="dotNetSoapEncFix" value="true" /> <parameter name="enableNamespacePrefixOptimization" value="false" /> <parameter name="sendXMLDeclaration" value="true" /> <parameter name="attachments.implementation" value="org.apache.axis.attachments.AttachmentsImpl" /> <parameter name="sendxsitypes" 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="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"> <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> <!-- 想要添加或者取消修改一下内容即可,AdminService与Version注销不提供服务。 --> <service name="SayHello" provider="java:RPC"> <parameter name="allowedMethods" value="*" /> <parameter name="className" value="com.ztesoft.axis.ws.HelloImpl" /> <namespace>http://www.ztesoft.com/axis/sayHello</namespace> </service> </deployment>
4、高级特性Handler & Chain
上面说了直接编辑server-config.wsdd即可发布服务,所以下面就不再使用命令行方式。
Handler:
具体步骤:
1. 写两个类,继承BasicHandler。类分别叫BeforeHandle,AfterHandler。
详细步骤:
1. 创建类并继承BasicHandler
package com.ztesoft.axis.ws; import org.apache.axis.AxisFault; import org.apache.axis.MessageContext; import org.apache.axis.handlers.BasicHandler; public class BeforeHandle extends BasicHandler { /** */ private static final long serialVersionUID = -1804045183252961242L; @Override public void invoke(MessageContext msgContext) throws AxisFault { String someParam = (String) this.getoption("someParam"); System.out.println("前置方法,这里会第一个被调用"); System.out.println("server-config.wsdd中配置的自定义参数 :" + someParam); } }
package com.ztesoft.axis.ws; import org.apache.axis.AxisFault; import org.apache.axis.MessageContext; import org.apache.axis.handlers.BasicHandler; public class AfterHandler extends BasicHandler{ /** */ private static final long serialVersionUID = -1077633556581583559L; @Override public void invoke(MessageContext msgContext) throws AxisFault { System.out.println("后置方法,执行完服务后调用我。我是第三个被调用的。"); } }2. 修改server-config.wsdd文件,type里面的类路径前面需要加上前缀 java:
<!-- 添加一个自定义的handler --> <handler name="beforeHandler" type="java:com.ztesoft.axis.ws.BeforeHandle"> <!-- 这里还可以设置自定义参数,在类中使用this.getoptions("someParam") 获取参数 --> <parameter name="someParam" value="好好学习,天天向上" /> </handler> <handler name="afterHandler" type="java:com.ztesoft.axis.ws.AfterHandler" /> <service name="SayHello" provider="java:RPC"> <parameter name="allowedMethods" value="*" /> <parameter name="className" value="com.ztesoft.axis.ws.HelloImpl" /> <namespace>http://www.ztesoft.com/axis/sayHello</namespace> <!-- 添加handler --> <requestFlow> <handler type="beforeHandler" /> </requestFlow> <responseFlow> <handler type="afterHandler" /> </responseFlow> </service>
Chain:
步骤:
1. 新建一个类继承SimpleChain。
2. 将这个类提供的服务像Handler一样配置到server-config.wsdd中。
详细步骤:
1. 新建类
package com.ztesoft.axis.ws; import org.apache.axis.SimpleChain; public class BeforeChain extends SimpleChain{ /** */ private static final long serialVersionUID = 7781745675745772330L; // 写在构造器重即可 public BeforeChain(){ BeforeHandle beforeHandle = new BeforeHandle(); AfterHandler afterHandler = new AfterHandler(); // 执行顺序与添加顺序一致。 this.addHandler(beforeHandle); this.addHandler(afterHandler); } }
package com.ztesoft.axis.ws; import org.apache.axis.SimpleChain; public class AfterChain extends SimpleChain { /** */ private static final long serialVersionUID = -620214048210047247L; public AfterChain(){ BeforeHandle beforeHandle = new BeforeHandle(); AfterHandler afterHandler = new AfterHandler(); // 执行顺序与添加顺序一致。 this.addHandler(afterHandler); this.addHandler(beforeHandle); } }
<!-- 添加自定义Chain --> <chain name="beforeChain"> <handler type="java:com.ztesoft.axis.ws.BeforeChain" /> </chain> <chain name="afterChain"> <handler type="java:com.ztesoft.axis.ws.AfterChain" /> </chain> <service name="SayHello" provider="java:RPC"> <parameter name="allowedMethods" value="*" /> <parameter name="className" value="com.ztesoft.axis.ws.HelloImpl" /> <!-- 添加handler --> <requestFlow> <chain type="beforeChain" /> </requestFlow> <responseFlow> <chain type="afterChain" /> </responseFlow> </service>总结:
Handler与Chain只是一种拦截作用,Axis也默认提供了一些拦截的类。例如:有个Handler叫做 Authenticate。
5、自带调试工具tcpmon
回给tcpmon,tcpmon记录返回内容。在将处理结果转发给我们。
该工具集成到了axis包中,查找org.apache.axis.utils.tcpmon ,运行这个类的main方法即可看见
总结:
通过拦截webservice的请求我们发现,webservice采用http的方式传递数据。传输的数据是满足soap规则的xml文档。
由此可以证明
WebService = HTTP + SOAP + WSDL
6、额外注意事项
Axis技术发布服务就暂时写到这里了。如果博文中有什么不对的地方请指出,我会第一时间修订过来。这里只说了如何
7、附录一些最终的配置文件
web.xml配置
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems,Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd" > <web-app> <servlet> <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>/services/*</url-pattern> </servlet-mapping> </web-app>
<?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="dotNetSoapEncFix" value="true" /> <parameter name="enableNamespacePrefixOptimization" value="false" /> <parameter name="sendXMLDeclaration" value="true" /> <parameter name="attachments.implementation" value="org.apache.axis.attachments.AttachmentsImpl" /> <parameter name="sendxsitypes" 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="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"> <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> <!-- 添加一个自定义的handler --> <handler name="beforeHandler" type="java:com.ztesoft.axis.ws.BeforeHandle"> <!-- 这里还可以设置自定义参数,在类中使用this.getoptions("someParam") 获取参数 --> <parameter name="someParam" value="好好学习,天天向上" /> </handler> <handler name="afterHandler" type="java:com.ztesoft.axis.ws.AfterHandler" /> <!-- 添加自定义Chain --> <chain name="beforeChain"> <handler type="java:com.ztesoft.axis.ws.BeforeChain" /> </chain> <chain name="afterChain"> <handler type="java:com.ztesoft.axis.ws.AfterChain" /> </chain> <service name="SayHello" provider="java:RPC"> <parameter name="allowedMethods" value="*" /> <parameter name="className" value="com.ztesoft.axis.ws.HelloImpl" /> <namespace>http://www.ztesoft.com/axis/sayHello</namespace> <!-- 添加handler或者Chain --> <requestFlow> <!-- <handler type="beforeHandler"/> --> <chain type="beforeChain" /> </requestFlow> <responseFlow> <!-- <handler type="afterHandler"/> --> <chain type="afterChain" /> </responseFlow> </service> </deployment>
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。