XFire WebService开发快速起步

XFire WebService开发快速起步

环境：

XFire-1.2.6

JDK1.5

MyEclipse 6.5

Tomcat-5.5.27

Windows XP Professional简体中文版

软件下载地址：

[url]http://repository.codehaus.org/org/codehaus/xfire/xfire-distribution/1.2.6/xfire-distribution-1.2.6.zip[/url]

[url]http://apache.mirror.phpchina.com/tomcat/tomcat-5/v5.5.27/bin/apache-tomcat-5.5.27.zip[/url]

有关WebService的概念、原理、数据发现、描述、绑定等过程、方式也不说了。这里就只关注如何快速开发出来一个通用的、易懂的Hello World例子。

以下是开发步骤：

1、创建工程

打开MyEclipse 6.5，新建一个WebService工程。如下图

然后一路next，直到完成。

创建完成后，打开生成的web.xml文件，可以看到，XFire已经配置好了。

<? xml version ="1.0" encoding ="UTF-8" ?>
< web-app xmlns ="http://java.sun.com/xml/ns/javaee" xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance" version ="2.5" xsi:schemaLocation ="http://java.sun.com/xml/ns/javaee     [url]http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd[/url]" >
     < servlet >
         < servlet-name >XFireServlet </ servlet-name >
         < servlet-class >org.codehaus.xfire.transport.http.XFireConfigurableServlet </ servlet-class >
         < load-on-startup >0 </ load-on-startup >
     </ servlet >
     < servlet-mapping >
         < servlet-name >XFireServlet </ servlet-name >
         < url-pattern >/services/* </ url-pattern >
     </ servlet-mapping >
     < welcome-file-list >
         < welcome-file >index.jsp </ welcome-file >
     </ welcome-file-list >
</ web-app >

2、创建WebService服务

创建两个个包“wstest.server”和“wstest.client”，用来保存服务端和客户端程序。然后开始创建服务端程序，如下图

完成后，生成了一个Service的配置services.xml：

<? xml version ="1.0" encoding ="UTF-8" ?>
< beans xmlns ="http://xfire.codehaus.org/config/1.0" >

   < service >
     < name >MyService </ name >
     < serviceClass >wstest.server.IMyService </ serviceClass >
     < implementationClass >
      wstest.server.MyServiceImpl
     </ implementationClass >
     < style >wrapped </ style >
     < use >literal </ use >
     < scope >application </ scope >
   </ service >
</ beans >

也生成了接口和默认实现，改写后如下：

package wstest.server;
//Generated by MyEclipse

public interface IMyService {

   public String sayHello(String user);

}

package wstest.server;
//Generated by MyEclipse

public class MyServiceImpl implements IMyService {

   public String sayHello(String user) {
     return "您好，"+user;
  }

}

至此，服务端代码已经完成。

3、测试服务端代码

测试依赖与Servlet容器Tomcat，需要将做好的服务端打包部署到tomcat上，然后启动。才可以进行测试。假设你已经配置了Tomcat服务器，并完成了WebService服务端的部署。那么，现在就启动Tomcat，然后：

输入访问地址： [url]http://localhost:8080/xfire126Demo/services/MyService?wsdl[/url] ，然后go一把！

这样，出现上上面的结果，表明测试成功了。

4、生成客户端代码

很郁闷，这个生成的客户端代码一部分跑到服务端的包里面了。真是垃圾，rubbish！！！

但是，这就是MyEclipse的功能，我改变不了。

5、客户端测试

下面就耐心看怎么用这个客户端代码。

打开生成的代码如下：

package wstest.client;

import java.net.MalformedURLException;
import java.util.Collection;
import java.util.HashMap;
import javax.xml.namespace.QName;
import org.codehaus.xfire.XFireRuntimeException;
import org.codehaus.xfire.aegis.AegisBindingProvider;
import org.codehaus.xfire.annotations.AnnotationServiceFactory;
import org.codehaus.xfire.annotations.jsr181.Jsr181WebAnnotations;
import org.codehaus.xfire.client.XFireProxyFactory;
import org.codehaus.xfire.jaxb2.JaxbTypeRegistry;
import org.codehaus.xfire.service.Endpoint;
import org.codehaus.xfire.service.Service;
import org.codehaus.xfire.soap.AbstractSoapBinding;
import org.codehaus.xfire.transport.TransportManager;

public class MyServiceClient {

         private static XFireProxyFactory proxyFactory = new XFireProxyFactory();
         private HashMap endpoints = new HashMap();
         private Service service0;

         public MyServiceClient() {
                create0();
                Endpoint MyServicePortTypeLocalEndpointEP = service0 .addEndpoint( new QName( "http://server.wstest","MyServicePortTypeLocalEndpoint"),new QName("http://server.wstest","MyServicePortTypeLocalBinding"),"xfire.local://MyService");
                endpoints.put(new QName("http://server.wstest",MyServicePortTypeLocalEndpointEP);
                Endpoint MyServiceHttpPortEP = service0 .addEndpoint(new QName("http://server.wstest","MyServiceHttpPort"),"MyServiceHttpBinding"),"http://localhost:8080/xfire126Demo/services/MyService");
                endpoints.put(new QName("http://server.wstest",MyServiceHttpPortEP);
        }

        public Object getEndpoint(Endpoint endpoint) {
                try {
                        return proxyFactory.create((endpoint).getBinding(),(endpoint).getUrl());
                } catch (MalformedURLException e) {
                        throw new XFireRuntimeException("Invalid URL",e);
                }
        }

        public Object getEndpoint(QName name) {
                Endpoint endpoint = ((Endpoint) endpoints.get((name)));
                if ((endpoint) == null) {
                        throw new IllegalStateException("No such endpoint!");
                }
                return getEndpoint((endpoint));
        }

        public Collection getEndpoints() {
                return endpoints.values();
        }

        private void create0() {
                TransportManager tm = (org.codehaus.xfire.XFireFactory.newInstance().getXFire().getTransportManager());
                HashMap props = new HashMap();
                props.put("annotations.allow.interface",true);
                AnnotationServiceFactory asf = new AnnotationServiceFactory(new Jsr181WebAnnotations(),tm,new AegisBindingProvider(new JaxbTypeRegistry()));
                asf.setBindingCreationEnabled(false);
                service0 = asf.create((wstest.client.MyServicePortType.class),props);
                {
                        AbstractSoapBinding soapBinding = asf.createSoap11Binding(service0,new QName("http://server.wstest","http://schemas.xmlsoap.org/soap/http");
                }
                {
                        AbstractSoapBinding soapBinding = asf.createSoap11Binding(service0,"urn:xfire:transport:local");
                }
        }

        public MyServicePortType getMyServicePortTypeLocalEndpoint() {
                return ((MyServicePortType)(this).getEndpoint(new QName("http://server.wstest","MyServicePortTypeLocalEndpoint")));
        }

        public MyServicePortType getMyServicePortTypeLocalEndpoint(String url) {
                MyServicePortType var = getMyServicePortTypeLocalEndpoint();
                org.codehaus.xfire.client.Client.getInstance(var).setUrl(url);
                return var;
        }

        public MyServicePortType getMyServiceHttpPort() {
                return ((MyServicePortType)(this).getEndpoint(new QName("http://server.wstest","MyServiceHttpPort")));
        }

        public MyServicePortType getMyServiceHttpPort(String url) {
                MyServicePortType var = getMyServiceHttpPort();
                org.codehaus.xfire.client.Client.getInstance(var).setUrl(url);
                return var;
        }

        public static void main(String[] args) {


                MyServiceClient client = new MyServiceClient();

    //create a default service endpoint
                MyServicePortType service = client.getMyServiceHttpPort();

    //Todo: Add custom client code here
                    //
                    //service.yourServiceOperationHere();

    System.out.println("test client completed");
                    System.exit(0);
        }

}

看得很晕，不知道啥意思，但是从“Todo”标记处，我知道了：

     //Todo: Add custom client code here
                     //
                     //service.yourServiceOperationHere();

现在就在这里添加测试代码吧：

     //Todo: Add custom client code here
                     //
                     //service.yourServiceOperationHere();
                String helloString = service.sayHello( "熔岩");
                System.out.println(helloString);

添加了很傻蛋的两行代码后，就可以运行起来看看测试代码了。

运行结果如下：

您好，熔岩
test client completed

终于可以松一口气了。完整的例子跑起来了。

6、总结

总感觉这个开发过程不爽，其实有更好的工具和开发方式：

WebService的编写，比较麻烦的是客户端代码，客户端代码依靠人工去写基本上是不可能的，除非你愿意付出惊人的时间和精力，既便如此也得不偿失。

MyEclipse的客户端开发太差，主要是生成的客户端代码混乱，解决办法是将客户端的编写放到单独一个工程里面来做。

其实，只要服务端编写好了，就完全可以用别的方式根据wsdl的url去生成客户端代码，在这里不得不将一个强大的工具IDEA8推荐出来，IDEA8自带WebService开发工具，插件非常强大，易用。在后面的篇幅中，我会做专门介绍，敬请关注。

当然，MyEclipse也并非一无是处，MyEclipse的服务端调试工具就很不错，很喜欢。提高了开发效率，这也是MyEclipse的过人之处。

最后，告诫各位，即使WebService支持复杂对象参数，也不建议使用，因为数据绑定还不是那么完美，总有些缺憾，为了保险起见，还是建议使用String作为参数最好了。

XFire WebService开发快速起步

相关推荐