如何配置和使用WebServices集群

随着WebServices的推广，WebServices应用逐渐增多，一些使用WebServices的关键应用对WebServices实现也提出了更高的要求，而集群往往是高可用性和高性能应用所必须的。本文档将详细的描述windows平台上Apusic应用服务器3.0的WebServices集群的配置和使用方法。在各种Unix平台（如AIX）和linux平台上配置和使用Apusic WebServices集群的方法与本文所讲述的方法大同小异。
    本文所讲述的例子的集群结构如下图所示：


    图中包括了一个负载均衡器，两个内部服务器和一个客户端，我们的WebServices将部署在两个内部服务器Backend1和Backend2上。客户端请求将发向负载均衡器，负载均衡器将选择一个后台服务器来处理客户端的请求。

    安装Apusic应用服务器

    获取Apusic应用服务器3.0   你可以在金蝶中间件的网站http://www.apusic.com上免费下载Apusic3.0开发版。Windows平台的安装程序的文件名为Apusic-3.0.exe。

    安装Apusic负载均衡器    运行Apusic-3.0.exe来执行Apusic安装程序，Apusic应用服务器默认安装在系统盘根目录下如：c:/Apusic-3.0，本文假设安装在c:/Apusic-3.0目录。把C:/Apusic-3.0分别拷贝两份放在c:/Apusic1和c:/Apusic2目录下。为了便于说明，我们把放在c:/Apusic-3.0目录下的应用服务器叫做负载均衡器，把c:/Apuisc1目录下的应用服务器叫Backend1，把c:/Apuisc2目录下的应用服务器叫Backend2。

    配置Apusic负载均衡器    修改Backend1的多路复用端口为6881，修改方法如下：打开c:/Apusic1/config/apusic.conf文件，把6888替换成6881。把6889（SSL端口）替换成6789。

    修改Backend2的多路复用端口为6882，修改方法如下：打开c:/Apusic2/config/apusic.conf文件，把6888替换成6882。把6889（SSL端口）替换成6689。

    注意：此处的端口号可以改成你所喜欢的有效的端口，只要不与别的端口号冲突就可以了。

     配置负载均衡器的端口：把c:/Apusic-3.0/config目录下的loadbalancer.conf文件替换掉apusic.conf文件。Apusic负载均衡器的默认端口为80，此处我们不需要修改，就采用80端口。

    配置负载均衡器的内部服务器，打开c:/Apusic-3.0/config/loadbalancer.conf文件，其中有一个重要的属性BackendServers定义了集群中的服务器，这是一个用逗号分隔的服务器地址列表，包括主机名和端口号，Apusic负载均衡器将根据这个列表采取Rand-robin策略来选择服务器。负载均衡器和内部服务器启动的先后次序无关紧要，负载均衡器将总是选择目前可用的内部服务器，并周期性地检测内部服务器是否正常工作。它的默认设置如下：    修改成： 其中6881和6882分别为前面指定的两个内部服务器Banckend1和Backend2的多路复用端口。

    以上的工作全部完成后，此时我们的集群的基本配置已经全部完成，下面可以分别启动三个服务器，你可以分别运行三个服务器的bin目录下的Apusicw.exe来启动三个服务器（分别为负载均衡器，内部服务器Backend1和Backend2）。

    访问http://localhost/可以看到Apusic3.0的欢迎信息，查看Backend1和Backend2的系统日志的最后一行分别可以看到如下信息：“ 信息 [apusic.webapp.default./"> file: init”若能看到以上信息，表示Apusic集群基本配置已经完成。下面将讲述如何开发WebServices应用和部署Apusic WebServices应用到这一个集群当中。

    开发WebServices

    开发部署到Apusic集群中的WebServices与开发普通的WebServices一样，因此本文简单的描述如何开发Apusic WebServices。详细的开发手册请参考Apusic应用服务器用户手册，你可以在c:/Apusic-3.0/docs/ webservice目录下找到Apusic WebServices的详细的开发文档。

    编写Endpoint接口类

    首先编写一个Endpoint接口类Hello.java，在这个Endpoint接口中定义一个WebServices方法sayHello()。

    import java.rmi.Remote;

    import java.rmi.RemoteException;

    public interface Hello extends Remote

   {

    public String sayHello() throws RemoteException;

    }

     编写Endpoint实现类实现Endpoint接口 编写Endpoint实现类HelloImpl.java，实现前面定义的Endpoint接口Hello。

     public class HelloImpl implements Hello

    {

    public String sayHello()

     {

     return "Hello,my first web service! ";

        }

    }

    编译服务类

    前面讲述的WebServices服务类源文件Hello.java和HelloImpl.java可以直接在Apusic应用服务器的目录中找到，无须自己编写，它存放的目录为：

     c:/ Apusic-3.0/docs/samples/webservices/hello

    编译刚才编写两个java源文件到build目录下，打开DOS命令窗口，

    在c:/ Apusic-3.0/docs/samples/webservices/hello目录下执行如下命令：

     mkdir build

    javac -d build Hello.java HelloImpl.java

    部署WebSerivces到集群服务器

    编写部署描述文件config.xml

    部署描述文件config.xml内容如下：

    'http://www.apusic.com/dtds/endpoint-config_1_0.dtd'>
    
        HelloWorld Service

        A simple web service

        Hello

        HelloImpl
 
       MyHello

        /hello

       部署描述文件config.xml同样可以在c:/ Apusic-3.0/docs/samples/webservices/hello目录下找到。

    部署WebSerivces到Apusic集群

    在执行部署之前确保内部服务器Backend1和Backend2已经处于运行状态。

    打开DOS命令窗口，在c:/ Apusic-3.0/docs/samples/webservices/hello目录下执行如下命令：部署到Backend1：

     wsdeploy -s localhost:6881 -u admin -p admin -d ./config.xml build hello.ear

     部署到Backend2：

    wsdeploy -s localhost:6882 -u admin -p admin -d ./config.xml build hello.ear client.jar

    上面两步运行成功以后，我们可以在c:/Apusic1/upload目录下看到hello????.ear。同样也可以在c:/Apusic2/upload目录下看到hello????.ear。其中的????表示几个数字，这几个数字是随机产生的。此时我的集群部署还没有完成。还必须的执行下面三个步骤：停止Backend1服务器，把c:/Apusic2/upload目录下看到hello????.ear文件覆盖c:/Apusic1/upload目录下hello????.ear，然后再启动Backend1服务器。此时整个部署才算完成。

    调用WebSerivces集群中的WebSerivces

    到现在我们可以开始调用前面部署的WebServices了。

    编写客户端HelloClient.java

    首先编写WebServices的客户端HelloClient.java：

    import javax.xml.rpc.Stub;

    public class HelloClient

    {

     public static void main(String["> args)

    {

    try

    {

    //获得静态存根类

    Stub stub =
b6f9
new Hello_Stub();

     //指定要调用的目标服务器，（这里我们指向前面配置的负载均衡器）

     stub._setProperty(Stub.ENDPOINT_ADDRESS_PROPERTY,    

     http://locahost:80/hellobase/hello)

    //转换成接口类

   Hello hello = (Hello)stub;

    //调用接口类的方法

    String ret = hello.sayHello();

    //输出调用结果 System.out.println(ret);

    }catch(Exception ex)

     {

   ex.printStackTrace();

    }

 }

}

    HelloClient.java同样可以在c:/ Apusic-3.0/docs/samples/webservices/hello目录下找到。但是我们得做一些修改，在获得客户端存根stub后，必须设置属性Stub.ENDPOINT_ADDRESS_PROPERTY，指向负载均衡器，设置方法如前面代码段中的黑体所示。因为它默认不是指向负载均衡器。

     编译客户端程序: javac -classpath "./;client.jar;%classpath%;" HelloClient.java

    运行客户端程序

    在运行客户端之前，必须确保负载均衡器和两个后台服务器Backend1和Backend2都已经处于运行状态。

     运行客户端程序，命令如下：

     java -classpath "./;client.jar;%classpath%;" HelloClient

    如果运行成功将看到如下信息：

     Hello,my first web service!

    到此时我们的整个Apusic WebServices集群的基本配置方法和如何使用已经完成。正如你所看到的不管是Apusic集群的配置，还是Apusic的Webservices的开发和使用都是如此的简单，很多人都认为简单就是美，不是吗？

    'http://www.apusic.com/dtds/endpoint-config_1_0.dtd'>
    
        HelloWorld Service

        A simple web service

        Hello

        HelloImpl
 
       MyHello

        /hello

       部署描述文件config.xml同样可以在c:/ Apusic-3.0/docs/samples/webservices/hello目录下找到。

    部署WebSerivces到Apusic集群

    在执行部署之前确保内部服务器Backend1和Backend2已经处于运行状态。

    打开DOS命令窗口，在c:/ Apusic-3.0/docs/samples/webservices/hello目录下执行如下命令：部署到Backend1：

     wsdeploy -s localhost:6881 -u admin -p admin -d ./config.xml build hello.ear

     部署到Backend2：

    wsdeploy -s localhost:6882 -u admin -p admin -d ./config.xml build hello.ear client.jar

    上面两步运行成功以后，我们可以在c:/Apusic1/upload目录下看到hello????.ear。同样也可以在c:/Apusic2/upload目录下看到hello????.ear。其中的????表示几个数字，这几个数字是随机产生的。此时我的集群部署还没有完成。还必须的执行下面三个步骤：停止Backend1服务器，把c:/Apusic2/upload目录下看到hello????.ear文件覆盖c:/Apusic1/upload目录下hello????.ear，然后再启动Backend1服务器。此时整个部署才算完成。

    调用WebSerivces集群中的WebSerivces

    到现在我们可以开始调用前面部署的WebServices了。

    编写客户端HelloClient.java

    首先编写WebServices的客户端HelloClient.java：

    import javax.xml.rpc.Stub;

    public class HelloClient

    {

     public static void main(String["> args)

    {

    try

    {

    //获得静态存根类

    Stub stub = new Hello_Stub();

     //指定要调用的目标服务器，（这里我们指向前面配置的负载均衡器）

     stub._setProperty(Stub.ENDPOINT_ADDRESS_PROPERTY,    

     http://locahost:80/hellobase/hello)

    //转换成接口类

   Hello hello = (Hello)stub;

    //调用接口类的方法

    String ret = hello.sayHello();

    //输出调用结果 System.out.println(ret);

    }catch(Exception ex)

     {

   ex.printStackTrace();

    }

 }

}

    HelloClient.java同样可以在c:/ Apusic-3.0/docs/samples/webservices/hello目录下找到。但是我们得做一些修改，在获得客户端存根stub后，必须设置属性Stub.ENDPOINT_ADDRESS_PROPERTY，指向负载均衡器，设置方法如前面代码段中的黑体所示。因为它默认不是指向负载均衡器。

     编译客户端程序: javac -classpath "./;client.jar;%classpath%;" HelloClient.java

    运行客户端程序

    在运行客户端之前，必须确保负载均衡器和两个后台服务器Backend1和Backend2都已经处于运行状态。

     运行客户端程序，命令如下：

     java -classpath "./;client.jar;%classpath%;" HelloClient

    如果运行成功将看到如下信息：

     Hello,my first web service!

    到此时我们的整个Apusic WebServices集群的基本配置方法和如何使用已经完成。正如你所看到的不管是Apusic集群的配置，还是Apusic的Webservices的开发和使用都是如此的简单，很多人都认为简单就是美，不是吗？