MyEclipse7.0创建基于Axis的Web service

之后点击设计界面中的“Source”Tab来查看其代码。如下：可以看到我们定义了一个SayHello的Web Services，她提供了一个SayHello的方法，她能够接受一个String（事实上是tns:SayHelloRequest对象，她对String进行了封装）类型的输入参数SayHelloRequest并返回一个String（事实上是tns:SayHelloResponse对象，她对String进行了封装）类型的SayHelloResponse结果。更多关于WSDL的信息，请参考W3C的规范文档。

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

<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://ws.easefulfil.org/SayHello/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="SayHello" targetNamespace="http://ws.easefulfil.org/SayHello/">

<wsdl:types>

<xsd:schema targetNamespace="http://ws.easefulfil.org/SayHello/">

<xsd:element name="SayHelloRequest">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="in" type="xsd:string"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="SayHelloResponse">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="out" type="xsd:string"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

</wsdl:types>

<wsdl:message name="SayHelloRequest">

<wsdl:part element="tns:SayHelloRequest" name="sayHelloRequest" />

</wsdl:message>

<wsdl:message name="SayHelloResponse">

<wsdl:part element="tns:SayHelloResponse" name="sayHelloResponse"/>

</wsdl:message>

<wsdl:portType name="SayHello">

<wsdl:operation name="SayHello">

<wsdl:input message="tns:SayHelloRequest"/>

<wsdl:output message="tns:SayHelloResponse"/>

</wsdl:operation>

</wsdl:portType>

<wsdl:binding name="SayHelloSOAP" type="tns:SayHello">

<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>

<wsdl:operation name="SayHello">

<soap:operation soapAction="http://ws.easefulfil.org/SayHello/SayHello"/>

<wsdl:input>

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output>

<soap:body use="literal"/>

</wsdl:output>

</wsdl:operation>

</wsdl:binding>

<wsdl:service name="SayHello">

<wsdl:port binding="tns:SayHelloSOAP" name="SayHelloSOAP">

<soap:address location="http://www.example.org/"/>

</wsdl:port>

</wsdl:service>

</wsdl:definitions>

至此WSDL的编写已经完成。

4.2. 从WSDL生成Java代码

i. 选择菜单“File->New->Other”，从对话框中选取“Axis2 Wizards”下面的“Axis2 Code Generator”.点击“Next”进入下一个页面，保持“Generate java source code from WSDL file”被选中，点击“Next”进入下一步。

ii. 点击“Browse”来选取存放在src目录下的SayHello.wsdl文件，“Next”进入下一步。设置如下：

iii. 点击“next”进入下一个页面，设置“Output path”为本Project的src目录。点击“finish”后代在SayHello项目上按F5刷新就可以看到有代码生成好了。但是能看到一堆红“x”，这是由于没有将Axis2的jar包放入class path 中以及源代码的package不为org.easefulfil.ws.sayhello引起的。

Exception: java.lang.reflect.InvocationTargetException 异常处理：

见附件一：Exception: java.lang.reflect.InvocationTargetException 异常处理

iv. 在MyEclispse 中添加一个用户库(User Library)命名为 axis2 ，将 axis2-1.4.1-bin\axis2-1.4.1\lib 下的包均添加进来。这一步操作的操作将解决如下问题。

添加一个用户库，解决上面的问题，首先选择“SayHello”项目，并右击选择“Build path->Add Libraries..”,

在下面的窗口中新建名为axis2的Libaray,并将部署在tomcat中的axis2 web应用WEB-INF/lib目录中的所有jar包添加到该Lirary中。之后右击“src.org.easefulfil.ws.sayhello”项目，选择“Refactor->rename”,将包名修改为“org.easefulfil.ws.sayhello”即可。

4.3. 编写业务代码

打开SayHelloSKeleton.java文件将其中的实现方法

/**

*Autogeneratedmethodsignature

*@paramsayHelloRequest

public org.easefulfil.ws.sayhello.SayHelloResponse SayHello

(

org.easefulfil.ws.sayhello.SayHelloRequest sayHelloRequest )

{

//TODO : fill this with the necessary business logic

thrownew java.lang.UnsupportedOperationException("Please implement " + this.getClass().getName() + "#SayHello");

}

改为

public org.easefulfil.ws.sayhello.SayHelloResponse SayHello

(

org.easefulfil.ws.sayhello.SayHelloRequest sayHelloRequest )

{

//TODO : fill this with the necessary business logic

try

{

SayHelloResponse response = new SayHelloResponse();

response.setOut("Hi," + sayHelloRequests.getIn()

+ ".How are you?");

return response;

} catch (UnsupportedOperationException e)

{

throw e;

}

4.4. 生成测试的客户端程序

i. 代码生成的步骤同4.2，选择生成客户测试用例，并将包名修改为org.easefulfil.ws.sayhello.client，如下图

ii. 通过重构将src.org.easefulfil.ws.sayhello包名改为org.easefulfil.ws.sayhello.client　并将SayHelloTest.java类移到org.easefulfil.ws.sayhello.client包中，便可以解决下面的问题.

iii. 这个时候发现org.easefulfil.ws.sayhello.client下面的SayHelloTest.java仍然存在问题。选择public class SayHelloTest前的红“x”，选择第e二项。

iv. 进行完这几个改动之后，生成的代码就没有问题了。其中:

SayHelloRequest，SayHelloResponse是输入输出参数对象。

SayHelloSkeleton是服务端对象，用来编写业务逻辑调用。

SayHelloStub是客户端用来定位endpoint（就是发布的Web Services的地址）的类，客户端根据其提供的方法定位Web服务并发起调用

SayHelloMessageReceiverInOut是一个实现同步调用的web服务信息转换处理类。

Resources目录下的services.xml文件是webservices的描述文件。

SayHelloTest是一个客户端的TestCase示例，用户可以根据这个示例来编写自己的客户端调用类。

4.5. 打包

i. 选择菜单“File->New->Other”，从对话框中选取“Axis2 Wizards”下面的“Axis2 Services Archive”.点击“Next”进入下一个页面。

ii. 选择编译好的class文件所在目录（本项目应该是WebRoot下面WEB-INF/classes），“Next”进入下一步。

iii. 选择WSDL文件所在目录，此处为src目录下的SayHello.wsdl文件。“Next”,再“Next”，选择services.xm文件，本文应该是生成在src/resources下面的services.xml文件。

iv. 点击“Next”，将记入最后一个页面，此处有两个选项，一个是输出目录一个是处处文件名称。我这里的输出文件名称给的是SayHello。点击“Finish”完成。

4.6. 部署

i. 将打包好的文件SayHello.aar,拷贝到Tomcat中已经部署的Axis2应用的WEB-INF/services目录下面。

ii. 启动Tomcat，如果已启动，重启Tomcat。

iii. 打开浏览器，输入http://ipaddress:port/axis2（一般为http://localhost:8080/axis2）,并点击其中的“services”链接，如果出现下面的错误，修改src/resources/services.xml的

<parameter name="useOriginalwsdl">true</parameter>为

<parameter name="useOriginalwsdl">false</parameter>即可。

iv. 重新执行4.5打包和4.6部署（A、Ｂ）过程，打开浏览器，输入http://ipaddress:port/axis2（一般为http://localhost:8080/axis2）,并点击其中的“services”链接，可以看到SayHello已经被部署。点击SayHello提供的连接可以看到与之对应的WSDL。

。

4.7. 测试

i. 修改SayHelloTest.java文件中的方法testSayHello的内容为：

public void testSayHello() throws java.lang.Exception{

String url="http://localhost:8080/axis2/services/SayHello";

org.easefulfil.ws.sayhello.client.SayHelloStub stub =

new org.easefulfil.ws.sayhello.client.SayHelloStub(url);//the default implementation should point to the right endpoint

org.easefulfil.ws.sayhello.client.SayHelloStub.SayHelloRequest sayHelloRequest4=

(org.easefulfil.ws.sayhello.client.SayHelloStub.SayHelloRequest)getTestObject(org.easefulfil.ws.sayhello.client.SayHelloStub.SayHelloRequest.class);

// TODO : Fill in the sayHelloRequest4 here

sayHelloRequest4.setIn("easefulfil");

System.out.println(stub.SayHello(sayHelloRequest4).getOut());

assertNotNull(stub.SayHello(

sayHelloRequest4));

}

附件一：代码生成时的异常处理

Exception: java.lang.reflect.InvocationTargetException 异常处理

开发axis2中，我在用到axis2的eclipse 插件是所遇到：Code Generator 在Finish 时产生Exception: java.lang.reflect.InvocationTargetException 这个问题，看到有很多人像我一样遇到这个问题,查了很多资料终于解决，我的开发环境是 Myeclipse7.0 +axis1.4.

狂晕：

必须先将这两个jar文件及plugins.xml修改好后放入plugins文件夹，否则还是会报异常。

解决方法：

1、将\webapps\axis2\WEB-INF\lib 目录下的backport-util-concurrent-3.1.jar、geronimo-stax-api_1.0_spec-1.0.1.jar　二个文件拷贝到eclipse\plugins\Axis2_Codegen_Wizard_1.3.0\lib 文件夹中.

2、修改eclipse\plugins\Axis2_Codegen_Wizard_1.3.0\plugins.xml，添加如下内容。