集成axis开发webservice

一、基础知识
    Web Service主要是为了使原来各孤立的站点之间的信息能够相互通信、共享而提出的一种接口。 Web Service所使用的是Internet上统一、开放的标准，如HTTP、XML、SOAP（简单对象访问协议）、WSDL等，所以Web Service可以在任何支持这些标准的环境（Windows,Linux）中使用。
     Axis支持三种web service的部署和开发，分别为：
1、Dynamic Invocation Interface ( DII)
2、Stubs方式
3、Dynamic Proxy方式
名词解释：
    SOAP协议（Simple Object Access Protocal,简单对象访问协议）,它是一个用于分散和分布式环境下网络信息交换的基于XML的通讯协议。在此协议下，软件组件或应用程序能够通过标准的HTTP协议进行通讯。它的设计目标就是简单性和扩展性，这有助于大量异构程序和平台之间的互操作性，从而使存在的应用程序能够被广泛的用户访问。
    WSDL(网络服务描述语言，Web Services Description Language)是一种 XML 格式,用于将网络服务描述为一组端点,这些端点对包含面向文档信息或面向过程信息的消息进行操作。这种格式首先对操作和消息进行抽象描述,然后将其绑定到具体的网络协议和消息格式上以定义端点。相关的具体端点即组合成为抽象端点(服务)。
    UDDI(通用描述、发现与集成服务,Universal Description, Discovery and Integration)目的是为电子商务建立标准;UDDI是一套基于Web的、分布式的、为Web Service提供的、信息注册中心的实现标准规范,同时也包含一组使企业能将自身提供的Web Service注册,以使别的企业能够发现的访问协议的实现标准。
    JAXP(Java API for XML Parsing) 定义了在Java中使用DOM, SAX, XSLT的通用的接口。这样在你的程序中你只要使用这些通用的接口,当你需要改变具体的实现时候也不需要修改代码。
   JAXM(Java API for XML Messaging) 是为SOAP通信提供访问方法和传输机制的API。
二、使用axis开发webservice例一
(1)要发布的服务端程序

package com.logcd.webservice;
import com.logcd.model.OpResult;
public class Calculator {
	public int add(int i1, int i2) {
		return i1 + i2;
	}
	public int subtract(int i1, int i2) {
		return i1 - i2;
	}
	public int multiply(int i1, int i2) {
		return i1 * i2;
	}
	public int divide(int i1, int i2) {
		return i1 / i2;
	}
	public OpResult getOpResult(int i1, int i2){
		OpResult result = new OpResult();
		result.setSum(add(i1, i2));
		result.setDifference(subtract(i1, i2));
		result.setProduct(multiply(i1, i2));
		result.setQuotient(divide(i1, i2));
		return result;
	}
}

(2)web.xml中配置AxisServlet

	<servlet>
	    <display-name>Apache-Axis Servlet</display-name>
	    <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>/servlet/AxisServlet</url-pattern>
	</servlet-mapping>
	<servlet-mapping>
	    <servlet-name>AxisServlet</servlet-name>
	    <url-pattern>*.jws</url-pattern>
	</servlet-mapping>
	<servlet-mapping>
	    <servlet-name>AxisServlet</servlet-name>
	    <url-pattern>/services/*</url-pattern>
	</servlet-mapping>

(3)配置静态发布文件server-config.wsdd

<?xml version="1.0" encoding="UTF-8"?>
<deployment name="defaultClientConfig"
    xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"
    xmlns:handler="http://xml.apache.org/axis/wsdd/providers/handler" xmlns="http://xml.apache.org/axis/wsdd/">
    <globalConfiguration name="defaultClientConfig">
        <requestFlow name="RequestFlow1" type="">
            <handler name="Handler1" type="java:org.apache.axis.handlers.JWSHandler">
                <parameter name="scope" value="session"/>
            </handler>
            <handler name="Handler2" 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" type="">
        <requestFlow name="RequestFlow1" type="">
            <handler name="Handler1" type="URLMapper"/>
            <handler name="Handler2" type="java:org.apache.axis.handlers.http.HTTPAuthHandler"/>
        </requestFlow>
    </transport>
    <transport name="local" type="">
        <responseFlow name="ResponseFlow1" type="">
            <handler name="Handler1" type="LocalResponder"/>
        </responseFlow>
    </transport>
    <service name="AdminService" type="" 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" type="" provider="java:RPC">
        <parameter name="allowedMethods" value="getVersion"/>
        <parameter name="className" value="org.apache.axis.Version"/>
    </service>
    <service name="Calculator" type="" provider="java:RPC" style="rpc" use="encoded">
        <parameter name="scope" value="Request"/>
        <parameter name="className" value="com.logcd.webservice.Calculator"/>
        <parameter name="allowedMethods" value="*"/>
        
        <!--
        	 typeMapping:需要自定义deserializer和serializer的时候使用这个标签
			beanMapping:使用axis默认的deserializer和serializer
         -->
		<beanMapping languageSpecificType="java:com.logcd.model.OpResult"
		 qname="ns:resp" xmlns:ns="urn:BeanService"
		 encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
		 />
        
        <namespace>http://axis.userguide.samples</namespace>
    </service>
</deployment>

(4)调用测试

package com.logcd.webservice;
import javax.xml.rpc.ParameterMode;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.XMLType;
public class CalcTest {
	   public static void main(String [] args) throws Exception {
	       try{
	           String endpoint = "http://127.0.0.1/js_test/services/Calculator";
	           Integer i1 = new Integer(1000);
	           Integer i2 = new Integer(1009);

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

	           call.setTargetEndpointAddress(new java.net.URL(endpoint));
	           call.setOperationName("add");
	           call.addParameter("i1", XMLType.XSD_INT, ParameterMode.IN);
	           call.addParameter("i2", XMLType.XSD_INT, ParameterMode.IN);
	           call.setReturnType(XMLType.XSD_INT);

	           Integer ret = (Integer) call.invoke(new Object[] {i1, i2});
	           
	           System.out.println("Got result : " + ret);
	       }
	       catch(Exception e){
	           e.printStackTrace();
	       }
	   }
}

package com.logcd.webservice;
import javax.xml.namespace.QName;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.ser.BeanDeserializerFactory;
import org.apache.axis.encoding.ser.BeanSerializerFactory;
import com.logcd.model.OpResult;
public class ObjResultTest {
	public static void main(String[] args) throws Exception {
		try {
			String endpoint = "http://127.0.0.1/js_test/services/Calculator";
			Integer i1 = new Integer(1009);
			Integer i2 = new Integer(1000);
			
			Service service = new Service();
            Call call = (Call) service.createCall();
            QName qn = new QName("urn:BeanService","resp");
            //注册 bean
            call.registerTypeMapping(OpResult.class, qn, 
            		new BeanSerializerFactory(OpResult.class, qn), 
            		new BeanDeserializerFactory(OpResult.class, qn));

            call.setTargetEndpointAddress(new java.net.URL(endpoint));
            call.setOperationName(new QName("http://axis.userguide.samples","getOpResult"));

			OpResult ret = (OpResult) call.invoke(new Object[] { i1, i2 });

			System.out.println("the operation result following:");
			System.out.println("sum = " + ret.getSum());
			System.out.println("difference = " + ret.getDifference());
			System.out.println("product = " + ret.getProduct());
			System.out.println("quotient = " + ret.getQuotient());
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

三、例二，使用Spring的ServletEndpointSupport来实现WebService
(1)、接口和实现

package com.logcd.service;

public interface IHelloWorld {
	public String getMessage(String name);
}

package com.logcd.service.impl;

import com.logcd.service.IHelloWorld;

public class HelloWorldImpl implements IHelloWorld {

	private String helloStr;

	public String getMessage(String name) {
		return helloStr + ":" + name;
	}

	public String getHelloStr() {
		return helloStr;
	}

	public void setHelloStr(String helloStr) {
		this.helloStr = helloStr;
	}

}

(2)、使用ServletEndpointSupport

package com.logcd.webservice;

import javax.xml.rpc.ServiceException;

import org.springframework.remoting.jaxrpc.ServletEndpointSupport;

import com.logcd.service.IHelloWorld;

public class JaxRpcHelloWorld extends ServletEndpointSupport implements IHelloWorld{

	private IHelloWorld helloWorld;
	  
	protected void onInit() throws ServiceException {
	//在Spring容器中获取Bean的实例
		helloWorld = (IHelloWorld) getApplicationContext().getBean(
	            "helloWorld");
	}
	  
	public String getMessage(String name){
		return helloWorld.getMessage(name);
	}

}

(3)、web.xml和applicationContext.xml

<?xml version="1.0" encoding="UTF-8"?>

<web-app version="2.4"
         xmlns="http://java.sun.com/xml/ns/j2ee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" >

    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>
            classpath:applicationContext.xml
        </param-value>
    </context-param>

    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

	<!--axis需要的Servlet -->
    <servlet>
        <servlet-name>axis</servlet-name>
        <servlet-class>org.apache.axis.transport.http.AxisServlet</servlet-class>
        <load-on-startup>2</load-on-startup>
    </servlet>

	<!--axis的Web Service的Web发布路径-->
    <servlet-mapping>
        <servlet-name>axis</servlet-name>
        <url-pattern>/services/*</url-pattern>
    </servlet-mapping>

</web-app>

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING/DTD BEAN/EN"    
  "http://www.springframework.org/dtd/spring-beans.dtd"> 
 
 <beans>
    <bean id="helloWorld" class="com.logcd.service.impl.HelloWorldImpl">
        <property name="helloStr">
        	<value>Say Hello to :</value>
        </property>
    </bean>
</beans>

(4)、server-config.wsdd

<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"/>
    
    <service name="HelloWorld" provider="java:RPC">
    	<parameter name="className" 
            value="com.logcd.webservice.JaxRpcHelloWorld"/>
      	<parameter name="allowedMethods" value="*"/>
    </service>
    
    <transport name="http">
      <requestFlow>
          <handler type="URLMapper"/>
      </requestFlow>
    </transport>
    
</deployment>

(5)、测试

package com.logcd.test;

import java.net.URL;

import javax.xml.namespace.QName;

import org.apache.axis.client.Call;
import org.apache.axis.client.Service;

public class testWebServiceClient {

	public static void main(String[] args) {
		try {
			String wsdlUrl = "http://localhost:8088/webService/services/HelloWorld?wsdl";
			String nameSpaceUri = "http://localhost:8088/webService/services/HelloWorld";
			
			Service service = new Service();
			Call call = null;
			call = (Call) service.createCall();
			
			System.out.println(">>>getMessage");
			call.setOperationName(new QName(nameSpaceUri, "getMessage"));
			call.setTargetEndpointAddress(new URL(wsdlUrl));
			String ret = (String) call.invoke(new Object[] { "ABC" });
			System.out.println("return value is " + ret);
			
		} catch (Exception e) {
			e.printStackTrace();
		}
	}

}