Hessian通讯协议【附PHP源代码】

 

提示:
  绿色加粗有下划线是文本的链接
  蓝色加粗强调
  红色加粗重点

PHP源码:
  点击下载

  

什么是Hessian

  

  Hessian是由caucho提供的一种开源的远程通讯协议。

  采用二进制 RPC 协议,基于 HTTP 传输,服务器端不用另开放防火墙端口。

  协议的规范是公开的,可以用于任意语言。

  采用客户机/服务器模式。

  请求程序就是一个客户机,而服务提供程序就是一个服务器。

  客户机调用进程发送一个有进程参数的调用信息到服务进程,然后等待应答信息。

  在服务器端,进程保持睡眠状态直到调用信息的到达为止。

  当一个调用信息到达,服务器获得进程参数,计算结果,发送答复信息,然后等待下一个调用信息,最后,客户端调用进程接收答复信息,

  获得进程结果,然后调用执行继续进行。

 

Hessian协议工作流程图

  

  客户端程序请求服务端函数 

  1.调用客户端句柄,执行传送参数。

  2.调用本地系统内核发送网络消息。

  3.消息传送到远程主机。

  4.服务器句柄得到消息并取得参数。

  5.执行远程过程。

  

  

  服务端函数返回结果给客户端 

  1.执行的过程将结果返回服务器句柄。

  2.服务器句柄返回结果,调用远程系统内核。

  3.消息传回本地主机。

  4.客户句柄由内核接收消息。

  5.客户接收句柄返回的数据。

  

 

  

Hessian的优、缺点

  

  优缺点在实践中根据使用和同事反馈情况而写的,只代表个人的一些观点。

  
  优点
  1.目前的WEB端基本上都支持hessian,hessian本身就是使用http的传输协议,来保证安全性和稳定性。

  2.通信速度不错。(数据少的时候)。

  3.可以以对象方式接受数据。

  

  缺点

  1.报错机制不够完善。

  2.没有事务处理。

  3.PHP和Java之间经常会出现一些问题,如编码,需强制转换字符等。(已经在源码包体现了

  4.返回数据量大,总会感觉有延迟的情况。(返回数据加缓存机制可以避免)

 

附带源码解释

 1.引用配置文件,包括网站根目录,以及Hessian的地址。

 2.我本地配置的虚拟主机(域名qx.com),不会配置虚拟主机请参考我之前搭建环境文章。

<?php
/**
 * 文件名        : config.php
 * 创建人        : 吴佰清
 * 创建时间    : 2012-05-09 11:12
 * 用途        : Hessian配置文件
 *
 * @author wubaiqing <xinxiangmo@gmail.com>
 * @package system.core.code applied to the whole site
 * @copyright Copyright (c) 2012 
 * @since 1.0
 */

// 根目录
define( 'PATH' , dirname(__FILE__) . DIRECTORY_SEPARATOR );

// Hessian Url地址
define( 'HESSIAN_URL' , 'http://qx.com/server.php' );

// IDE : Zend Studio 9.0
// IDE Extension : Toggle Vrapper
?>

  3.下载HessianPHP.

  4.配置服务端。

<?php
/**
 * 文件名        : server.php
 * 创建人        : 吴佰清
 * 创建时间    : 2012-05-09 11:54
 *
 * 参考资料    :
 * 1.http://hessian.caucho.com/ ( Hessian主页 )
 * 2.http://hessianphp.sourceforge.net/ ( Hessian PHP )
 * 3.http://sourceforge.net/projects/hessianphp/ ( Hessian PHP开源 )
 * 4.http://baike.baidu.com/view/1859857.htm ( 单例模式 )
 *
 * @author wubaiqing <xinxiangmo@gmail.com>
 * @package system.core applied to the whole site
 * @copyright Copyright (c) 2012
 * @since 1.0
 */
require_once ( dirname(__FILE__) . DIRECTORY_SEPARATOR . 'config.php' );
require_once ( PATH . 'extensions/HessianPHP/HessianService.php' );

class HessianServer
{
    public function __construct() {}
    /**
     * 商品详细信息APi接口
     * @param string $title 标题
     * @param int $price 价格
     */
    public function goodsInfomationApi( $title , $price ) {
        $price = (int) $price;
        return '<h1 style="background-color:#036; color:#fff; font-size:16px; padding:10px 10px 10px 3px;">使用Hessian协议调用远程方法.</h1> 标题:' . $title . '<br>价格:'.$price;
    }
}

$server = new HessianService( new HessianServer() );
//$server->displayInfo();
$server->handle();

// IDE : Zend Studio 9.0
// IDE Extension : Toggle Vrapper
?>


 5.可以通过HessianService类中的displayInfo方法去查看开启多少个通讯方法。

  如果搭建服务端要使用handle方法,如出现Hessian Requires POST提示,服务端就已经搭建成功。

 

 6.封装Hessian接口

<?php
/**
 * 类名        : HessianApi
 * 创建人        : 吴佰清
 * 创建时间    : 2012-05-08 18:00
 * 
 * 参考资料    : 
 * 1.http://hessian.caucho.com/ ( Hessian主页 )
 * 2.http://hessianphp.sourceforge.net/ ( Hessian PHP )
 * 3.http://sourceforge.net/projects/hessianphp/ ( Hessian PHP开源 )
 * 4.http://baike.baidu.com/view/1859857.htm ( 单例模式 )
 *
 * @author wubaiqing <xinxiangmo@gmail.com>
 * @package system.core applied to the whole site
 * @copyright Copyright (c) 2012
 * @since 1.0
 */
class HessianApi
{
    /**
     * @var string 接口地址
     */
    private $_url = NULL;
    
    /**
     * @var result 句柄
     */
    private $_handle = NULL;

    /**
     * @var array 存放单例模式数组
     */
    private static $_objects = array();

    /**
     * 设置URL地址
     * 实例化HessianClient类
     * 参数    : (1) url地址 , 2
     * 
     * 2.Java调用字段
     * @param string $url
     */
    public function __construct( $url )
    {
        $this->setUrl( $url );
        $handler = new HessianClient ( $this->getUrl (), $this->getOptions () );
        $this->setHandler ( $handler );
    }

    /**
     * @return result $_handle 句柄
     */
    public function getHandler() {
        return $this->_handle;
    }

    /**
     * 设置句柄
     * @param result $_handle
     */
    public function setHandler($_handle) {
        $this->_handle = $_handle;
    }

    /**
     * 获取URL地址
     */
    public function getUrl() {
        return $this->_url;
    }

    /**
     * 设置URL地址
     * @param string $url
     */
    public function setUrl($url) {
        $this->_url = $url;
    }

    /**
     * typeMap映射Java等平台对象
     * @return array
     */
    public function getOptions() {
        return array (
      'version' => 1,
      'saveRaw' => TRUE,
      'typeMap' => array(
        'JavaNullPointException' => 'java.lang.NullPointerException' ,
        'StackTraceElement' => 'java.lang.StackTraceElement')
     ); }
/** * 记录接口调用信息 * @param string $method 调用的方法 * @param string $returnMsg 需要记入log的文字信息 */ public function resultLog( $method , $returnMsg ) { $logPath = PATH.'/runtime/hessian/'; if( !is_dir( $logPath ) ) { mkdir($logPath,0777); } error_log(date('Ymd H:i:s', time()) . '|' . $method . '|' . $returnMsg."\n", 3, $logPath . date('Y-m-d', time()) . '.log'); } /** * 静态工厂方法,生成单个URL的唯一实例 * @param string $url */ public static function start( $url ) { $key = md5( $url ); if ( isset(self::$_objects[$key]) ) { return self::$_objects[$key]; } self::$_objects[$key] = new HessianApi( $url ); return self::$_objects[$key]; } } class JavaNullPointException extends Exception {} class StackTraceElement extends Exception {} // IDE : Zend Studio 9.0 // IDE Extension : Toggle Vrapper ?>

 7.封装客户端请求方法,继承HessianApi类

<?php
/**
 * 类名        : Goods
 * 继承类        : HessianApi
 * 创建人        : 吴佰清
 * 创建时间    : 2012-05-09 12:12
 * 用途        : 调用server.php方法
 *
 * @author wubaiqing <xinxiangmo@gmail.com>
 * @package system.core.code applied to the whole site
 * @copyright Copyright (c) 2012 
 * @since 1.0
 */
class Goods extends HessianApi
{
    /**
     * 设置接口地址
     * @param string $url
     */
    public function __construct( $url ) {
        parent::__construct( $url );
    }

    /**
     * 获取商品信息
     * 调用server.php文件中的goodsInfomationApi方法
     * @param string $title 标题
     * @param string $title 价格
     */
    public function getGoodsInfomation( $title , $price )
    {
        // 如果调用java平台的hessian服务 需要指定你传递参数的类型,特别是整形和字符串.
        $price = (int) $price; 
        
        $result = $this->getHandler()->goodsInfomationApi( $title , $price );
        $this->resultLog( 'getGoodsInfomation' , '访问接口,但接口没有进行逻辑验证.');
        return $result;
    }
}

// IDE : Zend Studio 9.0
// IDE Extension : Toggle Vrapper
?>

 8.修改index.php可以请求服务端接口

<?php 
/**
 * 文件名        : index.php
 * 创建人        : 吴佰清
 * 创建时间    : 2012-05-09 11:57
 *
 * 参考资料    :
 * 1.http://hessian.caucho.com/ ( Hessian主页 )
 * 2.http://hessianphp.sourceforge.net/ ( Hessian PHP )
 * 3.http://sourceforge.net/projects/hessianphp/ ( Hessian PHP开源 )
 * 4.http://baike.baidu.com/view/1859857.htm ( 单例模式 )
 *
 * @author wubaiqing <xinxiangmo@gmail.com>
 * @package system.core applied to the whole site
 * @copyright Copyright (c) 2012
 * @since 1.0
 */


require_once ( dirname(__FILE__) . DIRECTORY_SEPARATOR .'config.php' );

// Hessian 扩展及配置文件
require_once ( PATH . 'extensions/HessianPHP/HessianClient.php' );
require_once ( PATH . 'class/HessianApi.php' );


// 调用 server.php 方法
require_once ( PATH . 'class/Goods.php');

// 请求接口获取数据
$goods = new Goods( HESSIAN_URL );

// 设置商品标题 , 价格.
$title = '北京移动充值平台';
$price = '50';

// 请求Hessian协议
$goodsInfo = $goods->getGoodsInfomation( (string) $title , (int) $price );

// 打印请求结果
echo ( $goodsInfo );

// IDE : Zend Studio 9.0
// IDE Extension : Toggle Vrapper

?>

 

参考资料

  1.Hessian主页:http://hessian.caucho.com/Hessian

  2.PHP实现主页:http://hessianphp.sourceforge.net/

  3.HessianPHP开源项目主页:http://sourceforge.net/projects/hessianphp/

  4.RMI协议:http://baike.baidu.com/view/99017.htm

  5.维基百科:http://en.wikipedia.org/wiki/Hessian

  6.PHP源码:http://files.cnblogs.com/wubaiqing/Hessian.zip

 

posted @ 2012-05-09 17:48 吴佰清 阅读(...) 评论(...) 编辑 收藏