使用 mORMot Framework 在服务器和客户端之间发送消息
Use mORMot Framework to send message between server and clients
mORMot Framework (www.synopse.info) 添加了对 WebSockets 的支持,在包中还有一个关于 WebSockets 的演示(示例 31)。在此示例中,客户端向服务器发送一条消息,并向客户端回复一条新消息。
我想使用此库来执行此操作:
- 客户端向服务器发送消息并发送 IP 地址(无需等待来自服务器的消息。);
- 服务器可以通过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。
mORMot Framework (www.synopse.info) 添加了对 WebSockets 的支持,在包中还有一个关于 WebSockets 的演示(示例 31)。在此示例中,客户端向服务器发送一条消息,并向客户端回复一条新消息。 我想使用此库来执行此操作:
- 客户端向服务器发送消息并发送 IP 地址(无需等待来自服务器的消息。);
- 服务器可以通过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。