用Globus Toolkit 4构建Web服务2

<complexType name="LoanType">
    <sequence>
        <element name="loanNumber" type="int"/>
        <element name="UPB" type="double"/>
        <element name="status" type="string"/>
        <element name="createDate" type="string"/>
    </sequence>
</complexType>

　　下一步，我们要定义所有的消息服务。一条消息元素可能由一个或多个部分组成，消息元素的每个部分对应一个参数，并且还有一个类型属性。消息既可以是一个请求消息(输入消息)，也可以是一个响应消息(输出消息)。

<message name="CreateLoanInputMessage">
  <part name="parameters" element="tns:createLoan"/>
</message>
<message name="CreateLoanOutputMessage">
  <part name="parameters" element="tns:createLoanResponse"/>
</message>

<message name="ProcessLoanPaymentInputMessage">
  <part name="parameters" element="tns:processLoanPayment"/>
</message>
<message name="ProcessLoanPaymentOutputMessage">
  <part name="parameters"
    element="tns:processLoanPaymentResponse"/>
</message>

<message name="GetLoanInputMessage">
  <part name="parameters" element="tns:getLoan"/>
</message>
<message name="GetLoanOutputMessage">
  <part name="parameters" element="tns:getLoanResponse"/>
</message>

　　最后我们定义所有的端口类型，每个接口类型定义了一个或多个操作来使用当前的操作元素，每个独立的操作元素又定义了一个操作和与操作有联系的消息的输入输出。在一个端口类型内操作元素定义了端口类型内所有调用方法的语法。

<portType name="LoanPortType">
  <operation name="createLoan">
    <input message="tns:CreateLoanInputMessage"/>
    <output message="tns:CreateLoanOutputMessage"/>
    <fault name="Fault" message="ogsi:FaultMessage"/>
  </operation>
  <operation name="processLoanPayment">
    <input message="tns:ProcessLoanPaymentInputMessage"/>
    <output message="tns:ProcessLoanPaymentOutputMessage"/>
    <fault name="Fault" message="ogsi:FaultMessage"/>
  </operation>
  <operation name="getLoan">
    <input message="tns:GetLoanInputMessage"/>
    <output message="tns:GetLoanOutputMessage"/>
    <fault name="Fault" message="ogsi:FaultMessage"/>
  </operation>
</portType>

　　服务的实现:

　　在前面的步骤中，终端贷款端口类型的接口已经产生，在定义这些端口类型的接口时，所有的远程操作都要设为public，并且抛出java.rmi.RemoteException。在本文中给出了LoanServiceImpl类，主要实现贷款端口类型的接口，这些实现要用到前面所讲到的用loan.wsdl文件所生成的根类。

public class LoanServiceImpl implements LoanPortType

　　其中LoanServiceImpl 所实现的方法定义在LoanPortType接口中，createLoan方法在产生一个createLoan对象的构造器中要获取一个贷款数字作为它的参数。

public CreateLoanResponse createLoan(CreateLoan cl)
throws java.rmi.RemoteException
public ProcessLoanPaymentResponse processLoanPayment(ProcessLoanPayment plp)
throws java.rmi.RemoteException
public GetLoanResponse getLoan(GetLoan gl) throws java.rmi.RemoteException

　　请参考完整代码详细描述方法的实现。

编译并创建贷款/偿还处理的WEB服务:

　　下面我们介绍通过以下步骤来创建易部署的GT4打包文档。Ant在编译本文所提供文件时所产生的build.xml中包含了ant的执行任务的步骤。在build.xml中ant的执行任务调用GT4中的ant任务，这些任务伴随着GT4的发布可以在编译文件中找到。

%GLOBUS_LOCATION%/share/globus_wsrf_common/build-packages.xml
%GLOBUS_LOCATION%/share/globus_wsrf_tools/build-stubs.xml
%GLOBUS_LOCATION%/share/schema

　　编译GT4中易部署的GAR文件

　　为了创建易部署的网格打包文件，loan.gar，我们通过以下步骤来实现:(这些步骤与builder.xml中的ant任务是一致的):

　　· 与WSDL文件绑定
　　· 通过WSDL 文件生成一个根类，在安装时，提供一个特殊文件来对不同的命名空间和包之间进行映射，这些包与表格中的目录结构一致。
　　· 编译根类
　　· 编译接口类
　　· 用JAR压缩接口类，和根类一样(loan.jar and loan_stubs.jar).
　　· 通过创建部署描述文件deploy-server.wsdd.来生成易部署的GAR文件，loan.gar

　　请参考源代码中完整的build.xml文件，通过以上步骤来实现一系列的ant编译任务。GT4描述我们的WEB服务文件deploy-server.wsdd就想这样:

<service name="loan/impl/LoanService" provider="Handler"
use="literal" style="document">
    <parameter name="className" value="loan.impl.LoanServiceImpl"/>
    <wsdlFile>share/schema/loan/Loan_service.wsdl</wsdlFile>
    <parameter name="allowedMethods" value="*"/>
    <parameter name="handlerClass"
    value="org.globus.axis.providers.RPCProvider"/>
    <parameter name="scope" value="Application"/>
    <parameter name="providers" value="GetRPProvider"/>
    <parameter name="loadOnStartup" value="true"/>
</service>

　　让我们来介绍一下deploy-server.wsdd中的一些参数:

　　服务名称:指定我们所提供的WEB服务的路径，我们将它与WEB服务容器的地址相结合起来，我们会得到WEB服务的完整的URL。为了便于测试，使用独立的GT4容器，URL就像这样:

　　http://localhost:8080/wsrf/services/loan/impl/LoanService

　　类名:指实现服务接口的类(LoanServiceImpl).

　　WSDL文件:告诉GT4中的WEB服务容器对于当前的WEB服务的WSDL文件在那里可以找到。WSDL文件Loan_service.wsdl是在GT4 从loan.wsdl进行ANT时自动产生的。

　　启动时装载:如果我们需要服务在WEB服务容器启动时就开始装载，允许我们控制服务的装载。

　　部署GAR文件:

　　GAR文件loan.gar包含了所有的文件和WEB服务器需要的部署信息，我们使用GT4部署工具:

　　%GLOBUS_LOCATION%/bin/globus-deploy-gar $PROJECT_HOME/loan.gar

　　拷贝文档文件(loan.wsdl，编译的根类，编译的接口实现，loan.wsdd)到GT4容器的目录下适当位置。

　　测试借贷款处理实例

　　在图1描述了如何将贷款方的子系统和贷款结算子系统作为借贷款的WEB服务的客户端，现在我们就在GT4网格服务容器中创建和部署WEB服务，我们需要用一个客户端进行测试，测试用例模拟一个贷款事件，一个贷款月度偿还事件和一个贷款还清事件。作为客户端来说，他们希望WEB服务的URI(统一资源标识符)能够作为客户端访问WEB服务的依据。客户端的程序要独立的进行编译，下面来描述客户端访问WEB服务的主要步骤:

　　创建一终端引用类型对象，来代表终端引用的贷款服务。我们的终端引用只需要服务的URI:

　　EndpointReferenceType endpoint = new EndpointReferenceType();

　　endpoint.setAddress(new Address(serviceURI));