随着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 = 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的开发和使用都是如此的简单,很多人都认为简单就是美,不是吗?