基于Axis1.4开发Web Service程序

   随着 Web Services 以及 SOA 的不断发展，越来越多的人投入到了相关技术的实现、开发和标准的制定的工作中。而实现Web Services的主要途径由Axis1.x，Axis2.x以及XFire等技术。
   这里提及Axis1.x是由于存在大量的旧项目中所用到的技术；Axis2是Apache Axis SOAP 项目的后继项目。此项目是 Web Services 核心引擎的重要改进，目标是成为 Web Services 和面向服务的体系结构（Service-Oriented Architecture，SOA）的下一代平台；而XFire是与Axis2并列的新一代WebService框架。
  
   以下先摘录了Axis1.x的开发过程：
   一、Axis环境的安装

　　1、安装环境 J2SE SDK 1.4，Tomcat 5.0，eclipse 3.2。

　　2、到 http://xml.apache.org 网站下载Axis安装包。

　　3、将Axis相关包文件放在WEB-INF\lib目录下。

　　4、Axis可选的包：activation.jar； mail.jar； xmlsec-1.4.Beta1.jar拷贝到WEB-INF目录下，生成客户端时候需要使用。

　　Axis支持三种web service的部署和开发，分别为：

　　1、Dynamic Invocation Interface （DII）

　　2、Dynamic Proxy方式

　　3、Stubs方式

   　1、DII(Dynamic Invocation Interface )方式web服务主要方式是：
a 编写服务端程序HelloClient.java
b 将源码拷贝到Axis_HOME下，重命名为 HelloClient.jws
c 访问连接http://localhost:8080/Axis/HelloClient.jws?wsdl，页面显示Axis自动生成的wsdl
   这种方式的局限性太大。

    2、编写Dynamic Proxy方式访问服务
a 编写部署服务端程序，同上边DII方式，本次仍使用上边部署的HelloClient
b 编写代理接口
3 编写并执行客户端程序TestHelloClient.java 主要是通过调用Service专递endpoint和相关信息调用接口 大家可参照其他文章（http://www.iteye.com/topic/210733）。


   3、Stubs方式（推荐使用）

　　我自己的Java源代码是放在D：\workspace\test\目录下，Axis相关包文件放在D：\workspace\test\WEB-INF目录下。

　　二、编写wsdd发布web服务，编写stub client访问web服务

　　1、编写服务端程序server，SayHello.java，编译

package server;

public class SayHello {
	public String getName(String name) {
		return "hello " + name;
	}
}

　2、编写wsdd文件

　　deploy.wsdd文件内容如下：

<deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">    
<service name="SayHello" provider="java:RPC">    
<parameter name="className" value="server.SayHello.getName"/>    
<parameter name="allowedMethods" value="*"/>    
</service>    
</deployment> 

　　3、发布服务：

　　编辑一个deploy.bat，Axis_Lib为axis.jar路径。内容如下：

set Axis_Lib=D:\workspace\test\WEB-INF\lib    
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%    
set Axis_Servlet=http://localhost:8080/test/servlet/AxisServlet    
%Java_Cmd% org.apache.axis.client.AdminClient -l%Axis_Servlet% deploy.wsdd 

执行这个批处理文件，这时候，如果提示成功的话，访问http://localhost:8080/test/services 就会显示服务列表。

　　4、生成客户端client stub文件

　　在浏览器上访问服务器端的服务，可以下载到WSDL文件，通过Axis的相关工具，可以自动从WSDL文件中生成Web Service的客户端代码。

　　编写一个WSDL2Java.bat文件，其内容如下：

set Axis_Lib=D:\workspace\test\WEB-INF\lib    
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%    
set Output_Path=D:\workspace\test\src    
set Package=server.SayHello    
%Java_Cmd% org.apache.axis.wsdl.WSDL2Java -o%Output_Path% -p%Package% SayHello.wsdl 

执行这个批处理文件就可以生成client stub.

　　生成的stub client文件列表为：SayHello.java，SayHelloService.java，SayHelloServiceLocator.java，SayHelloSoapBindingStub.java .

　　5、编写客户端程序，编译并执行

　　下面是一段junit测试客户端代码。

import java.net.URL;
import junit.framework.Test;
import junit.framework.TestCase;
import junit.framework.TestSuite;

public class TestWSClient extends TestCase {

	public TestWSClient(String string) {
		super(string);
	}

	public void SayHelloClient() throws Exception {

		SayHelloService service = new SayHelloServiceLocator();
		SayHello_PortType client = service.getSayHello();
		String retValue = client.getName("clientname");
		System.out.println(retValue);

	}

	public static Test suite() {
		TestSuite suite = new TestSuite();
		suite.addTest(new TestWSClient("SayHelloClient"));
		return suite;
	}
}

至此，整个服务器端和客户端的Web Service框架代码就完成了，剩下的就是在里面加入你的业务代码了。

评论

2 楼 兰文平 2011-07-11  

补充上面的:
public static TransportClientProperties create(String protocol)
    {
        TransportClientProperties tcp =
            (TransportClientProperties)cache.get(protocol);
       
        if (tcp == null) {
            tcp = (TransportClientProperties)
                AxisProperties.newInstance(TransportClientProperties.class,
                                           (Class)defaults.get(protocol));

            if (tcp != null) {
                cache.put(protocol, tcp);
            }
        }
       
        return tcp;
    }

AxisProperties.newInstance(TransportClientProperties.class,
                                           (Class)defaults.get(protocol));
就是从AxisProerties中取得值来设置proxyHost（代理主机）和proxyPort（端口）
这个是axis中的源代码。2个接口，所用代理不同，我想要让2个接口调用时，分别用自己的代理地址，应该如何处理？解决方法？条件，这2个接口都必须通过代理来访问，代理和端口都不同。以上为个人解，有理解错误的地方请指教。多谢！期待答案....问题没有解是一种困扰

1 楼 兰文平 2011-07-11  

请问下，有没有关于axis设置代理服务器来访问webservice接口的解决方法:
  问题是，axis1.4在一个项目中有2个接口，调用接口时都要使用代理服务器访问。 2个接口分别调用的代理服务器都不同！如果相同的话，设置个全局的 AxisProperties参数就行。这样只能使用一个代理。
  我想接口访问的都是使用他们自己的代理服务器来访问接口，应该如何做呢？才能使访问哪个接口就调用相应的代理进行访问!
  如何修改引擎中给定的值，因为我看源代码中
public Socket create(
            String host, int port, StringBuffer otherHeaders, BooleanHolder useFullURL)
            throws Exception {

        int timeout = 0;
        if (attributes != null) {
            String value = (String)attributes.get(CONNECT_TIMEOUT);
            timeout = (value != null) ? Integer.parseInt(value) : 0;
        }

        TransportClientProperties tcp = TransportClientPropertiesFactory.create("http");

        Socket sock = null;
        boolean hostInNonProxyList = isHostInNonProxyList(host, tcp.getNonProxyHosts());

        if (tcp.getProxyUser().length() != 0) {
            StringBuffer tmpBuf = new StringBuffer();

            tmpBuf.append(tcp.getProxyUser())
                  .append(":")
                  .append(tcp.getProxyPassword());
            otherHeaders.append(HTTPConstants.HEADER_PROXY_AUTHORIZATION)
                        .append(": Basic ")
                        .append(Base64.encode(tmpBuf.toString().getBytes()))
                        .append("\r\n");
        }
        if (port == -1) {
            port = 80;
        }
        if ((tcp.getProxyHost().length() == 0) ||
            (tcp.getProxyPort().length() == 0) ||
            hostInNonProxyList)
        {
            sock = create(host, port, timeout);
            if (log.isDebugEnabled()) {
                log.debug(Messages.getMessage("createdHTTP00"));
            }
        } else {
            sock = create(tcp.getProxyHost(),
                    new Integer(tcp.getProxyPort()).intValue(),
                    timeout);
            if (log.isDebugEnabled()) {
                log.debug(Messages.getMessage("createdHTTP01", tcp.getProxyHost(),
                          tcp.getProxyPort()));
            }
            useFullURL.value = true;
        }
        return sock;
    }
这个是根据tcp里的值和hostInNonProxyList 来判断是否有代理，有代理则设置代理的ip和端口，以及timeout设置.