Hprose for Java 快速入门

使用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. }  

public class Hello { public String sayHello(String name) { return "Hello " + name + "!"; } }

好了，下面我们只要再配置一下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

，然后回车，如果看到如下页面内容就表示我们的服务发布成功啦。

引用

Fa1{s8"sayhello"}z

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

创建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. }  

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

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

引用

Hello Hprose!

通过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. }  

import hprose.client.HproseHttpClient; import java.io.IOException; interface IHello { String sayHello(String name); } public class HelloClient2 { public static void main(String[] args) throws IOException { HproseHttpClient client = new HproseHttpClient(); client.useService("http://localhost:8084/HelloServer/Hello"); IHello hello = (IHello) client.useService(IHello.class); String result = hello.sayHello("Hprose"); System.out.println(result); } }

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

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