Myeclpse6.0+Axis2 返回对象数组(List)的webservice例子

【wayfoon】 

最近公司要求实现一个webservice调用，之前也接触过，但只是看看，没有动手试试，于是现在正式开始学习webservice。

之前参照网上的例子写了一个简单的say hello webservice例子。传递的对象是string，而且只有一个方法；但实际应用中，需要传递一些复制的对象，比如：数组，集合，对象数组。

由于webservice 是通过xml来交互数据的，而且是不分平台的。因此，java 中的List等集合类的哦是通过数组来实现的。学习webservice最好不要从一种语言的角度（java、c#）来对待问题，如果非要看成一中语言，那看成是c语言吧。

 

简单的hello world 例子见 http://www.blogjava.net/mlzry0612/articles/185209.html?opt=admin 里面有详细的axis+myeclipse5.5安装部署，图文并茂。不同myeclipse版本 有所不同。

 

在演示例子前，你必须已经安装好了Axis，并且已经知道怎样使用axis，知道通过wsdl生成webservice代码和生成aar发布文件。不会的话，先学习前面的hello 例子。

下面演示一个比较复杂的例子。例子实现：输入一个string 返回得到一个对象数组（输入里面所有的元素对象），注意是对象数组。每个对象对应一个bean实体。

使用axis的好处是可以根据wsdl自动生成大部分代码。因此，采用axis开发webservice 的实现关键在于生成wsdl文件的编写。

生成wsdl文件可以采用两种方式：

第一种：直接新建wsdl再通过wsdl设计器来设计（也就是hello例子里面将的）

如果你对wsdl不是很熟悉，而且，输入或输出的参数都非常复杂，不清楚输入输出的组成结构时，你可以采用第二种方法。这种方式，可以让你使用你最熟悉的语言来表达你的意思。以java为例，你可以将对个对象放到List里面来表达你要输出的值，这个在wsdl里面是另外一种表达方式（没有List）。

第二种：选中建立好的web service项目,
file - new - other - myeclipse - web services - web service,
选中要将webservice添加到哪个项目,
勾选create new java bean,
next,
填web service name, 比如hello
其他的会自动生成,
如果有包的话选一下包,finish.
然后会生成Ihello.java和helloImpl.java两个文件,
前面的是接口,后面的是实现.

Ihello.java文件：

1. package org.way;
3. import java.util.List;
5. // Generated by MyEclipse 
7. public interface Ihello
8. {
10.     public String example(String message);
12. }

helloImpl.java文件

1. package org.way;
3. import java.util.ArrayList;
4. import java.util.List;
6. // Generated by MyEclipse
8. public class helloImpl implements Ihello
9. {
11.     public String example(String message)
12.     {
13.         return null;
14.     }
16. }

例子的目的是要返回一个对象数组，因此我可以将上面文件改成

新的Ihello.java文件：

1. package org.way;
3. import java.util.List;
5. // Generated by MyEclipse
7. public interface Ihello
8. {
10.     public List<HelloBean> example(String message);
12. }

新的helloImpl.java文件

1. package org.way;
3. import java.util.ArrayList;
4. import java.util.List;
6. // Generated by MyEclipse
8. public class helloImpl implements Ihello
9. {
11.     public List<HelloBean> example(String message)
12.     {
13.         List<HelloBean> list = new ArrayList<HelloBean>();
14.         return list;
15.     }
17. }

新的两个文件对学习java的来说，非常熟悉了。HelloBean 是一个实体bean，你可以写多个字段 以及get/set方法，这里不列出。

然后将这个项目部署到tomcat里,
启动tomcat,打开http://127.0.0.1:8080/项目名/services, （注意必须加services）
会出现项目所提供的web service列表,
点进去就是wsdl, 另存为网页成*.wsdl文件。这样就生成了需要的wsdl文件。

 

生成的wsdl 文件以及详解 见：http://blog.csdn.net/wayfoon322/archive/2008/09/11/2914792.aspx

 

好了，关键的wsdl文件生成，现在可以利用这个wsdl生成webservice代码。生成方法见hello例子

生成之后的项目结构是：

 

 

需要注意其他三个文件：HelloTest.java 是测试文件，HelloStub,java是给客户端用的，HelloSkeleton.java:我们要实现的webservice业务代码需要在这个文件中编写，我们的业务是：输入string 输出对象数组，采用java语言描述则是 见代码注释

HelloSkeleton.java：

1. /**
2.  * HelloSkeleton.java
3.  * 
4.  * This file was auto-generated from WSDL by the Apache Axis2 version: 1.4 Built on : Apr 26, 2008
5.  * (06:24:30 EDT)
6.  */
7. package org.way;
9. /**
10.  * HelloSkeleton java skeleton for the axisService
11.  */
12. public class HelloSkeleton implements HelloSkeletonInterface
13. {
15.     /**
16.      * Auto generated method signature
17.      * 
18.      * @param examplein00
19.      */
20.     public org.way.Exampleout example(org.way.Examplein0 examplein00)
21.     {
22.         //输出的对象
23.         Exampleout out=new Exampleout();
24.         HelloBean hb=null;
25.         //包含一个数组 的对象
26.         ArrayOfHelloBean param=new ArrayOfHelloBean();
27.         for (int i = 0; i <10; i++)
28.         {
29.             hb=new HelloBean();
30.             hb.setCid("Cid="+i);
31.             hb.setName(examplein00.getExamplein0());
32.             hb.setSex("sex");
33.             //将单个实体加入到对象数组里面
34.             param.addHelloBean(hb);
35.         }
36.         out.setExampleout(param);
37.         
38.         return out;
39.     }
41. }

 

打包生成*.arr 文件。名称任意。放到 axis2\WEB-INF\services 下面

启动tomcat

最后junit测试，HelloTest.java 文件

2. package org.way;
4. import org.way.HelloStub.HelloBean;
7. /*
8.  * HelloTest Junit test case
9.  */
11. public class HelloTest extends junit.framework.TestCase
12. {
14.     /**
15.      * Auto generated test method
16.      */
17.     public void testexample() throws java.lang.Exception
18.     {
20.         String url="http://192.168.0.70:8080/axis2/services/hello";
21.         org.way.HelloStub stub = new org.way.HelloStub(url);// the default implementation should
22.         // point to the right endpoint
23.         org.way.HelloStub.Examplein0 request = (org.way.HelloStub.Examplein0) getTestObject(org.way.HelloStub.Examplein0.class);
25.         request.setExamplein0("wayfoon");
26.         
27.         //System.out.println(stub.example(request).getExampleout());
28.         HelloStub.ArrayOfHelloBean arrayOfHelloBean=(HelloStub.ArrayOfHelloBean)stub.example(request).getExampleout();
29.         HelloStub.HelloBean[] localHelloBean=(HelloStub.HelloBean[])arrayOfHelloBean.getHelloBean();
30.         System.out.println("length:"+localHelloBean.length);
31.         for (int i = 0; i < localHelloBean.length; i++)
32.         {
33.             HelloStub.HelloBean hb=(HelloStub.HelloBean)localHelloBean[i];
34.             System.out.println("{Cid:"+hb.getCid()+" Name:"+hb.getName()+"},");
35.             
36.         }
37.         
38.         assertNotNull(stub.example(request));
40.     }
42.     // Create an ADBBean and provide it as the test object
43.     public org.apache.axis2.databinding.ADBBean getTestObject(
44.             java.lang.Class type) throws java.lang.Exception
45.     {
46.         return (org.apache.axis2.databinding.ADBBean) type.newInstance();
47.     }
49. }

 

输入：wayfoon

输出

最终结果：

{Cid:Cid=0 Name:wayfoon },
{Cid:Cid=1 Name:wayfoon },
{Cid:Cid=2 Name:wayfoon },
{Cid:Cid=3 Name:wayfoon },
{Cid:Cid=4 Name:wayfoon },
{Cid:Cid=5 Name:wayfoon },
{Cid:Cid=6 Name:wayfoon },
{Cid:Cid=7 Name:wayfoon },
{Cid:Cid=8 Name:wayfoon },
{Cid:Cid=9 Name:wayfoon },

 

 

注意：使用axis，jdk最好使用1.6。新建webservice 项目 最好选择JAVA EE 5.0,

作者：南极光  
时间：2008-9-5

欢迎大家同我联系，[e-mail]
欢迎转载，转载请保留申明信息。