使用myeclipse快速建立webservice
打开MyEclipse新建一个WebService Project,为你的项目命名,我选择了Java EE5.0,项目在你的WorkSpace目录下。下一步:看到了这个界面
在这里Eclipse为你创建了webService的配置文件services.xml(主意文件名是有“s”的),并进行了Xfire的 Servlet基本配置告诉项目你使用了Xfire改信息将体现在项目的web.xml文件中。继续下一步,加载Xfire相关的jar包,你看到了
在这个项目里我勾选了Xfire1.2 Core Libraries;HTTP Client Libraries;XML Beans Libraries。主要是确保引入了这些包包:
- ? activation-1.0.2.jar
- ? commons-codec-1.3.jar
- ? commons-httpclient-3.0.jar
- ? commons-logging-1.0.4.jar
- ? jaxen-1.1-beta-8.jar
- ? jdom-1.0.jar
- ? log4j-1.2.x.jar
- ? mail-1.3.3_01.jar
- ? spring-1.2.x.jar
- ? stax-api-1.0.jar
- ? wsdl4j-1.5.2.jar
- ? wstx-asl-2.9.jar
- ? xbean-2.1.0.jar
- ? xbean-spring-2.2.jar
- ? xfire-all-1.0.jar
- ? XmlSchema-1.0.jar
接下来我们要写一个服务端java类。模拟应用是一个银行转账应用,从账户A转账到账户B并需要给出金额和货币种类。我们先来实现一个接口IBankingService.java代码全文如下:
java 代码- package com.mybank.xfire.example;
- public interface IBankingService {
- public String transferFunds(
- String fromAccount, String toAccount, double amount, String currency);
- }
然后编写一个普通的Java类BankingService包含了一个叫做transferFunds()的方法来为我们完成这项工作。它需要四个输入参数:
java 代码- package com.mybank.xfire.example;
- import java.text.NumberFormat;
- import java.text.DecimalFormat;
- public class BankingService implements IBankingService {
- //Default constructor.
- public BankingService(){
- }
- /** Transfers fund from one account to another.
- */
- public String transferFunds(
- String fromAccount, String toAccount, double amount, String currency){
- String statusMessage = "";
- //调用业务逻辑执行操作.
- //建立并返回状态信息.
- try {
- NumberFormat formatter = new DecimalFormat("###,###,###,###.00");
- statusMessage = "COMPLETED: " + currency + " " + formatter.format(amount)+
- " was successfully transferred from A/C# " + fromAccount + " to A/C# " + toAccount;
- } catch (Exception e){
- statusMessage = "BankingService.transferFunds(): EXCEPTION: " + e.toString();
- }
- return statusMessage;
- }
- }
你可以看到BankingService是一个普通的Java类,没有任何代码告诉我们它将会在Web Services中使用。只是要有默认的构造函数,类型是public。这是必须的。否则,XFire不能够初始化这个类。好的,这里我们不需要增加任何 东西。我们所有的工作都在部署描述符里完成。
Web应用的部署描述符
在Java中,Web应用程序通常需要至少一个部署描述符(叫做web.xml)对其进行配置。XFire本身是一个基于servlet的应用 程序。因此,我们需要增加必要的引用到描述符文件中。然后我们还必须配置将要创建的Web Services。我们使用一个称为services.xml的新文件来完成这件事。在使用Eclipse工具构建工程的时候我们已经完成了这项配置(参 见(上)文)。
services.xml
xml 代码- <beans xmlns="http://xfire.codehaus.org/config/1.0">
- <service>
- <name>Banking</name>
- <namespace>mybank</namespace>
- <serviceClass>com.mybank.xfire.example.IBankingService</serviceClass>
- <implementationClass>com.mybank.xfire.example.BankingService</implementationClass>
- </service>
- </beans>
Web Services的定义包含在元素中,它还含有一些子元素。
第一个子元素是Banking,它可以是你提供任何的合法名字。这将会被客户端程序和其它需要定位你的服务的组件用到。例如,在服务准备好以后,你将在浏览器上使用这个名字来查看WSDL。
下一个子元素是。任何合法的XML名字都是可以的。用来唯一标识你的服务的各个参数。(注释@)
注释@:Namespace派什么用?namespace的作用是要避免命名冲突。如果我建立一项Web
Service,其中的WSDL文件包含一个名为"foo"的元素,而你想要使用我的服务与另一项服务连接作为补充,这样的话另一项服务的WSDL文件就 不能包含名为"foo"的元素。两个服务器程序只有在它们在两个事例中表示完全相同的东西时,才可以取相同的名字。如果有了表示区别的 namespace,我的网络服务里的"foo"就可以表示完全不同于另一个网络服务里"foo"的含义。在你的客户端里,你只要加以限制就可以引用我 的"foo"。
元素包含了Java类的名字,它指定了方法签名。在我们的例子中,它是接口 IBankingService。如果Java类没有实现任何接口,你就需要把类的名字放在这里。在你的Java类或者接口中可能有几个方法。只需要一个 入口把它们全部发布为Web Services。保存了实现方法的Java类名。这是一个可选元素。如果上一个元素包含了一个接口,那么相应的实现类必须在这里指定。
我们如何知道Web Service正在工作呢?
为了了解Web Service是否正在工作,我们需要测试。首先,我们测试来看WSDL是否可用。我们在浏览器中输入URL。哪个URL?因为我们的应用程序的war文 件是aa.war,并且在services.xml中给出的服务名是Banking,WSDL的URL应该 是:http://localhost:8080/aa/services/Banking?wsdl。
请注意:URL的第一部分,例如,http://localhost:8080,可能会根据你的应用服务器不同而不同。无论怎样,当你输入URL后,将会看到一个XML文档,这个文档叫做服务的WSDL。如果你看到了,这就是你的应用作为Web Service已经可用的第一个证明。