Question

我正在开发一个Web应用程序，它将广泛使用AJAX技术进行客户端/服务器通信......特别是JSON-RPC。 Zend Framework正在服务器端使用，它提供了一个很好的JSON-RPC服务器，我想用它。

我的目标是构建一个可维护的系统，将服务器端功能的 large 子集暴露给客户端（javascript），而不会产生不必要的代码重复。我已经看过很多关于如何使用ZF的JSON-RPC服务器的博客文章和教程（参见here和here），但它们似乎都面向暴露一个小型的公共可用API。代码重复很常见，例如，一篇博文中公开了以下方法：

public static function setTitle($bookId, $title) {
    $book = new Nickel_Model_Book($bookId);
    $book->setTitle($title);
    $book->update();
    return true;
}

我不喜欢有两种setTitle方法的事实。如果一个方法签名发生变化，另一个必须保持同步...如果你的API很广泛，那么看起来就像是一个可维护性的噩梦。在我看来，应该有一个Book类，一个setTitle方法。

我最初的想法是将docblock注释@export添加到我想要公开的方法/类中。当我决定公开setTitle方法时，我只是添加注释而不是新方法。

我看到的一个潜在问题涉及对象持久性。在服务器端，setTitle设置对象的title属性是有意义的......但是在调用update()之前不会将其保留在数据库中。客户端，调用setTitle应立即影响数据库。一个可能的解决方案是修改所有访问器，使得它们采用可选的第二个参数，表示修改应立即更新数据库：

function setTitle($title, $persist = false) {
    $this->title = $title;

    if ($persist) $this->update();
}

某种代理类可以确保为所有客户端RPC调用设置$persist标志。

另一个问题是PHP对象的序列化。在服务器端，进行OO风格的$book->setTitle("foo")调用是有意义的，但由于缺乏状态，客户端book.setTitle(1234, "foo")有意义（其中1234是本书的ID）。我的解决方案是让上述代理类负责以某种方式将book.setTitle(1234, "foo")转换为：

$book = new Book();
$book->load(1234);
return $book->setTitle($title);

我觉得这个问题必须先解决或讨论过......但我在网上找不到很多资源。这看起来像是一个理智的解决方案吗？

Answer 1

您要找的是 Service Layer 。

他们的实体应该是纯粹的数据容器（除非你使用Active Record），你应该只公开你的服务层，然后这会访问他们的实体及其各自的方法。

"Your Book class is a Domain Model, you should now create your Service Layer"

您的服务等级将是这样的：

class BookService extends Service {

    //...

    public function changeBookTitle( $title, Book $book )
    {
        //verify if the $title is correct and valid
        $book->setTitle( $title );
        $this->methodToGetThePersistenceManager()->save( $book );

        //fire events, create a result object, etc...
    }
}

Answer 2

我正在考虑你的问题几分钟。如果你想尝试，并且它是在PHP中，你可以制作一些形式的魔术方法

集合{属性} {对象}。

您可以通过magic __call方法执行此操作。

这样你就不必明确定义方法，但仍然可以设置属性。

魔术方法将识别它必须实例化的对象类型以及要在其上设置的属性然后持久化。

您必须找到一些区分远程呼叫和本地呼叫的方法，因此如果您正在进行本地库调用并且您确实持续远程呼叫，则不会错误地持续存在。

我觉得我以某种方式误解了你的问题，但我试过了。

Answer 3

那么，

你想要做的事情在纸面上听起来真的很好，并且你希望代码可以维护，并且根据你的实际系统，你要求的东西甚至可能有点安全，但它接近危险且容易出错。

无论如何，你可能不得不自己完成大部分工作，或者只是在所有方法调用中插入某种拦截器，这是一个简单的例子：

class Book {
  public $title = '';
  public $id = 0;
  public function setTitle($string) {
    $this->title = $string;
    echo "title called with $string\n";
  }
  public function twoArgs($arg1,$arg2) {
    echo "Multi-call: $arg1,$arg2\n";
  }
}
class Api {
  public function parse($json) {
    $jsonobj = json_decode($json,true);
    foreach ($jsonobj as $key=>$value) {
      $class_name = $key;
      $obj = new $class_name();
      foreach ($value as $vkey=>$vvalue) {
        if (method_exists($obj,$vkey)) {
          call_user_func_array(array($obj,$vkey),$vvalue);
        } else if (isset($obj->$vkey)) {
          echo "Setting $vkey\n";
          $obj->$vkey = $vvalue;
        }
      }
    }
  }
}

$json = json_encode(array('Book' => array('id' => 1234, 'setTitle' => array('The new title'))));
$api = new Api();
$api->parse($json);
$json = json_encode(array('Book' => array('id' => 1234, 'twoArgs' => array('arg1 :) ', 'arg2 :]'))));
$api->parse($json);

显然你想要添加逻辑来处理持久化标记，并加载或允许它们传入一个构造函数：[args]并处理它。当涉及到公开函数时，你将它们暴露在文档中，只要它们是那时的公共函数等就可以访问它们。

开发可维护的RPC系统

3 个答案: