Axis基本配置与实现

简单对象访问协议(SOAP Simple Object Access Protocol)

      简单对象访问协议是交换数据的一种协议规范，是一种轻量的、简单的、基于XML（标准通用标记语言下的一个子集）的协议，它被设计成在WEB上交换结构化的和固化的信息。

webService三要素

SOAP-->描述传递信息的格式

WSDL(Web Services Description Language)-->描述访问的具体接口

UDDI(Universal Description Discovery and Integration)

-->管理,分发,查询WebService

Axis部署 WebService:

1>jar包:

activation.jar

asm-attrs.jar

asm.jar

axis-ant.jar

axis.jar

commons-discovery-0.2.jar

commons-logging-1.0.4.jar

dom4j-1.6.1.jar

jaxrpc.jar

log4j-1.2.8.jar

mail.jar

saaj.jar

wsdl4j-1.5.1.jar

xerces-2.6.2.jar

xml-apis.jar

XmlSchema-1.0.jar

2>配置文件server-config.wsdd+web.xml

<!-- 表明这是一个axis部署描述文件 -->

<deployment xmlns="http://xml.apache.org/axis/wsdd/" 

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

 

    <!-- 处理器 --> 

<handler name="URLMapper"type="java:org.apache.axis.handlers.http.URLMapper"/> 

         

    <!-- 一个服务 --> 

    <!--provider="java:RPC"  webservice是以javabean的形式提供的-->

    <!--provider：服务类型，共有四种，分别是RPC,Document,Wrapped和Message -->

    <service name="axisTest"provider="java:RPC">     

        <!-- 指定类名 --> 

        <!-- parameter：用来设置Axis的各种属性； -->

        <parameter name="className"value="com.taikang.study.studyAxis.service.PersonInfoService"/>       

        <!-- allowedMethod用于指定一个以空格分隔的方法名，只有这些方法可以通过web service访问。

               也可以将这个值指定为"* "表示所有的方法都可以访问。 -->

        <parameter name="allowedMethod" value="*"></parameter>

     </service> 

     

    <!-- 指定处理器 http协议传输, transport：定义了服务器端的传输方式--> 

    <transport name="http"> 

        <requestFlow> 

            <handler type="URLMapper"/><!-- 引用上边的 --> 

        </requestFlow> 

    </transport>       

</deployment>  

web.xml

<!--配置这个拦截器的目的是请求走给axis处理 -->

<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>/axis/*</url-pattern>

</servlet-mapping>

3>java文件

主要学习写客户端程序

4>访问路径: http://10.136.12.148:8080/myTemp/axis/axisTest?wsdl

myTemp是工程名

axis是web.xml中配置的名称

axisTest是接口名?wsdl表示发布wsdl,这是一个webSevice描述性文件

 /myTemp 这个是工程的名字,表示进入了工程,执行了默认的index.jsp文件

<!--制定首页,当使用IP地址http://localhost:8080/myTemp时默认会访问index.jsp -->

<welcome-file-list>

   <welcome-file>index.jsp</welcome-file>

</welcome-file-list>

进入了/myTemp/axis:表示可以提供的一些接口,相当于一个WebService服务界面,可能这个服务界面有多个接口,这个路径在web.xml中配置,也就是说进来的WebService请求交给了org.apache.axis.transport.http.AxisServlet这个类来处理

 

Ø  进入了myTemp/axis/axisTest,这个路径映射具体的接口类,处理客户端请求

 

Ø  最后获得了接口的详细描述界面,显示了该接口的WSDL

此处provider一直写成provicer,导致无法正常访问HelloAxis接口服务,改正后可以正常访问.

 

客户端程序:

Service service = new Service();

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

call.setTargetEndpointAddress(newjava.net.URL(webLogUrl));//接口的url

call.setOperationName(new QName("http://serv","pdfSeal"));

result = (String) call.invoke(new Object[] { xmlContent});

 

(1)实例化一个Service类,并创建一个Call实例,sevice.createCall();创建一个请求连接对象.

(2)call.setTargetEndpointAddress:指定访问接口地址

   call.setOperationName():指定接口名字

(3)call.invoke(): 传参调用接口,返回结果,参数写在大括号中