HPROSE

使用Hprose制作一个简单的分布式应用程序只需要几分钟的时间，您先要创建服务器端应用程序，然后创建客户端应用程序，最后您就可以将它们运行起来了。本章将用一个简单但完整的实例来带您快速浏览使用Hprose for Java进行分布式程序开发的全过程。 

创建Hprose的Hello服务器 

我们以Netbeans作为开发环境为例，来介绍一下如何创建一个Hprose服务器，按照传统惯例，都是以Hello World为例来作为开始的，我们这里稍稍做一下改变，我们创建的服务器将发布一个sayHello方法，这样客户端就可以调用它来对任何事物说Hello啦。 

首先启动Netbeans开发环境，打开菜单的“文件→新建项目”，选择“Java Web→Web应用程序”，然后选择下一步，将项目名称改为HelloServer，再点下一步，选择好服务器后，点完成。 

下面我们该把Hprose.jar放到该项目中来了。在Netbeans创建的HelloServer目录下，新建一个lib目录，然后将Hprose.jar复制到其中。 

接下来在项目中，打开HelloServer下“库”的右键菜单，点击“添加JAR/文件夹…”，选择Hprose.jar，将其添加入库中。 

之后在“源包”上打开右键菜单，选“新建→Java类…”，将类名改为Hello，包名任意，也可以不填写，只要跟后面配置HproseServlet时保持一致就可以啦。 

Hello类的代码如下： 

Java代码 

1. public class Hello {   
2.     public String sayHello(String name) {   
3.         return "Hello " + name + "!";   
4.     }   
5. }  

好了，下面我们只要再配置一下Servlet，就可以发布这个服务啦。配置方法如下： 

1. 打开“HelloServer→配置文件→web.xml”。
2. 打开“Servlet”选单，点击“添加Servlet元素…”按钮，设置Servlet名称为HelloServlet，Servlet类为hprose.server.HproseServlet，URL模式为/Hello。
3. 在初始化参数部分，点“添加(A)…”按钮，设置参数名为class，参数值为Hello，这里的Hello对应我们刚才创建的Hello类。如果您在创建Hello类时包含有包名，这里也应该写包含了包名的全名。

这样我们的服务器端就创建好了，是不是相当的简单啊？ 

好了我们来看看效果吧，打开“HelloServer”的右键菜单，选择“运行”，之后您会看到浏览器窗口被打开，不过默认页面并不是我们的Servlet页面，没关系，我们直接在浏览器中更改一下URL，改为：http://localhost:8084/HelloServer/Hello，然后回车，如果看到如下页面内容就表示我们的服务发布成功啦。 

接下来我们来看一下客户端如何创建吧。 

创建Hprose的Hello客户端 

客户端我们以Java控制台程序为例，开发环境仍然为Netbeans。 

客户端可以通过invoke方法动态调用服务，也可以通过接口方式来调用，下面我们来分别介绍这两种方式。 

通过invoke方法动态调用 

首先我们先来看看如何使用invoke方法来动态调用服务。 

在Netbeans中， 打开菜单的“文件→新建项目”，选择“Java→Java应用程序”。然后选择下一步，将项目名称改为HelloClient，并将主类名也改为HelloClient，然后点击完成即可。 

下面我们该把HproseClient.jar放到该项目中来了。在Netbeans创建的HelloClient目录下，新建一个lib目录，然后将HproseClient.jar复制到其中。 

接下来在项目中，打开HelloClient下“库”的右键菜单，点击“添加JAR/文件夹…”，选择HproseClient.jar，将其添加入库中。 

接下来开始编写HelloClient类的代码： 

Java代码 

1. import hprose.client.HproseHttpClient;   
2. import java.io.IOException;   
3. public class HelloClient {   
4.     public static void main(String[] args) throws IOException {   
5.         HproseHttpClient client = new HproseHttpClient();   
6.         client.useService("http://localhost:8084/HelloServer/Hello");   
7.         String result = (String) client.invoke("sayHello", new Object[] { "Hprose" });   
8.         System.out.println(result);   
9.     }   
10. }  

最后我们来运行一下看看结果吧，如果没有操作错误的话，您应该可以看到如下的输出结果： 

通过invoke方法调用服务器方法很灵活，invoke方法具有多个重载，即使是对同一个服务器方法，您也可以通过指定不同的参数来获得不同类型的结果。后面我们会在详细介绍Hprose客户端时，再对invoke方法作更详细的介绍。 

但是您也会发现，通过invoke调用不是那么的直观，参数需要自己写入数组，结果也需要自己转型，那么有没有方法可以向本地调用那样来进行远程调用呢？可以，那就是通过接口方式调用。 

通过接口方式调用 

我们用与上面同样的方式来创建项目HelloClient2，然后打开HelloClient2.java，编辑其代码如下： 

Java代码 

1. import hprose.client.HproseHttpClient;   
2. import java.io.IOException;   
3. interface IHello {   
4.     String sayHello(String name);   
5. }   
6. public class HelloClient2 {   
7.     public static void main(String[] args) throws IOException {   
8.         HproseHttpClient client = new HproseHttpClient();   
9.         client.useService("http://localhost:8084/HelloServer/Hello");   
10.         IHello hello = (IHello) client.useService(IHello.class);   
11.         String result = hello.sayHello("Hprose");   
12.         System.out.println(result);   
13.     }   
14. }  

现在代码虽然多了，但是在调用时，却方便了不少。 

如果您曾经用过RMI或者其它的远程调用工具的话，您可能会惊讶的发现，这里的IHello接口在服务器端并没有实现，只是有相同的方法，但在客户端仍然可以直接通过接口进行调用。Hprose就是这样灵活，您甚至可以定义不同于服务器实现的客户端接口，只要参数和结果类型是相容或者可以转换的类型，就可以正常的进行调用。所以在Hprose中，您不但可以通过接口方式来调用Java服务器提供的服务，同样可以调用非Java服务器提供的服务。