使用 mORMot Framework 在服务器和客户端之间发送消息

Use mORMot Framework to send message between server and clients

mORMot Framework (www.synopse.info) 添加了对 WebSockets 的支持,在包中还有一个关于 WebSockets 的演示(示例 31)。在此示例中,客户端向服务器发送一条消息,并向客户端回复一条新消息。 我想使用此库来执行此操作:

  1. 客户端向服务器发送消息并发送 IP 地址(无需等待来自服务器的消息。);
  2. 服务器可以通过IP地址向单个客户端发送消息;

注意:IP地址仅用于识别客户端。我也可以使用唯一的名称。

有点像客户端和服务器之间的 LAN 聊天。我不明白如何编辑样本 n。 31 去做。此示例基于接口。

无需存储 IP 或任何低级实现参数(顺便说一下,IP 无法以唯一方式识别连接:多个客户端可能共享相同的 IP)。

mORMot框架中,异步回调是通过接口参数实现的。在服务器端,此参数的每个实例实际上都是一个 "fake" class 实例,链接到输入连接,能够通过其接口方法回调客户端。

这是实现回调的一种非常直接的方式 - 事实上,这是在服务器端实现 SOLID 回调的好方法,并且 mORMot 框架允许发布这种机制以 client/server 的方式,通过使用 WebSockets.

所以你先定义回调接口,服务接口:

  IChatCallback = interface(IInvokable)
    ['{EA7EFE51-3EBA-4047-A356-253374518D1D}']
    procedure BlaBla(const pseudo, msg: string);
  end;

  IChatService = interface(IInvokable)
    ['{C92DCBEA-C680-40BD-8D9C-3E6F2ED9C9CF}']
    procedure Join(const pseudo: string; const callback: IChatCallback);
    procedure BlaBla(const pseudo,msg: string);
    procedure CallbackReleased(const callback: IInvokable);
  end;

然后,在服务器端,对IChatService.Join()的每次调用都会订阅一个内部连接列表:

  TChatService = class(TInterfacedObject,IChatService)
  protected
    fConnected: array of IChatCallback;
  public
    procedure Join(const pseudo: string; const callback: IChatCallback);
    procedure BlaBla(const pseudo,msg: string);
    procedure CallbackReleased(const callback: IInvokable);
  end;

procedure TChatService.Join(const pseudo: string;
  const callback: IChatCallback);
begin
  InterfaceArrayAdd(fConnected,callback);
end;

然后对 IChatService.BlaBla() 方法的远程调用应该广播到所有连接的客户端,只需调用 IChatCallback.BlaBla() 方法:

procedure TChatService.BlaBla(const pseudo,msg: string);
var i: integer;
begin
  for i := 0 to high(fConnected) do
    fConnected[i].BlaBla(pseudo,msg);
end;

请注意,所有对 IChatCallback.BlaBla() 的循环调用都将通过 WebSockets 以异步和非阻塞的方式进行,因此即使在大量的情况下客户端,IChatService.BlaBla() 方法不会阻塞。在消息数量较多的情况下,该框架甚至能够收集 将通知消息推送到单个消息中,以减少资源使用。

以下方法将由服务器调用,当客户端回调实例被释放时(明确地,或者如果连接断开),因此可用于取消订阅到通知:

procedure TChatService.CallbackReleased(const callback: IInvokable);
begin
  InterfaceArrayDelete(fConnected,callback);
end;

在服务器端,您这样定义服务:

  Server.ServiceDefine(TChatService,[IChatService],sicShared).
    SetOptions([],[optExecLockedPerInterface]);

这里设置了optExecLockedPerInterface选项,这样所有的方法调用都是线程安全的,因此对内部fConnected[]列表的并发访问是安全的。

在客户端,实现IChatCallback回调接口:

type
  TChatCallback = class(TInterfacedCallback,IChatCallback)
  protected
    procedure BlaBla(const pseudo, msg: string);
  end;

procedure TChatCallback.BlaBla(const pseudo, msg: string);
begin
  writeln(#13'@',pseudo,' ',msg);
end;

然后您订阅您的远程服务:

var Service: IChatService;
    callback: IChatCallback;
...
    Client.ServiceDefine([IChatService],sicShared);
    if not Client.Services.Resolve(IChatService,Service) then
      raise EServiceException.Create('Service IChatService unavailable');
...
      callback := TChatCallback.Create(Client,IChatCallback);
      Service.Join(pseudo,callback);
...
    try
      repeat
        TextColor(ccLightGray);
        readln(msg);
        if msg='' then
          break;
        Service.BlaBla(pseudo,msg);
      until false;
    finally
      callback := nil;
      Service := nil; // release the service local instance BEFORE Client.Free
    end;

如果与现有的 client/server SOA 解决方案(在 Delphi、Java、C# 甚至 Go 或其他框架中)进行比较,这种基于接口的回调机制听起来非常独特并且易于使用。当然,由于 FPC 或 CrossKylix,这项工作从 Delphi 6 到 XE7,在 Linux 下也是如此。

我已经在我们的存储库中上传了完整的示例源代码,the server side application and the client side