回叫信道
回叫信道
回叫信道
DataSnap XE3新增回叫信道功能。技术关键点：
（1）TDBXCallback机制；
（2）TDServer.BroadcastMessage方法；
（3）TDSClientCallbackChanneManager1.RegisterCallback方法；
一、回叫的方式
1、服务器端回叫所有（同一信道）客户端
2、客户端回叫（同一信道）的其它客户端
3、客户端可以注册多个信道
二、服务器端对回叫信道的设置
1、服务器端回叫信道的注册
编程时，将相关的回叫信道字符，确定下来，便于代码中识别调用。
const DEMOChannel='DemoChannel';
2、服务器端对客户端的回叫
服务器端使用 TDServer组件的BroadcastMessage方法回叫所有注册的客户端。
TDServer组件重载了二个的BroadcastMessage方法
（1）使用二参数
function BroadcastMessage(const ChannelName:String; const Msg: TJSONValue; const ArgType:Integer=TDBXCallback.ArgJason):boolean; overload;
第1参数ChannelName指定通道中所有的回叫客户端；
第2参数Meg回传；
功能：通过Meg传递信息给带ChannelNamer指定的全部客户端。
（2）使用三参数
function BroadcastMessage(const ChannelName:String; const CallbackID:String; const Msg: TJSONValue; const ArgType:Integer=TDBXCallback.ArgJason):boolean; overload;
第1参数ChannelName指定通道中所有的回叫客户端；
第2参数CallbackID指定客户端的识别码；
第3参数Meg回传；
功能：通过Meg传递信息给带ChannelNamer中，指定的CallbackID客户端。
实例：例如在服务器端的TMemo1.onChange事件中:
procedure TSMainFrm.mmMessageChange(Sender: TObject);
var vMessage:TJSONString;
begin
vMessage := TJSONString.Create(mmMessage.Lines.Text);
ServerContainer1.DSServer1.BroadcastMessage(DEMOChannel, vMessage);
end;
3、服务器端对客户端注册的回叫通道的搜索
（1）搜索注册回叫通道的客户端ID，通过DSServer1.GetAllChannelClientId方法实现，代码如下：
procedure TForm1.btnListAllClientIdsClick(Sender: TObject);
var
aIdList : TList<String>;
sId : String;
begin
aIdList := ServerContainer5.DSServer1.GetAllChannelClientId(DEMOChannel);
try
for sId in aIdList do
lbAllClientIds.Items.Add(sId);
finally
aIdList.Free;
end;
end;
（2）搜索注册回叫通道客户端的回叫ID ，通过DSServer1.GetAllChannelCallbackId方法实现，代码如下：
procedure TForm1.btnListAllCallbackIdsClick(Sender: TObject);
var
aIdList : TList<String>;
sId : String;
begin
aIdList := ServerContainer5.DSServer1.GetAllChannelCallbackId(DEMOChannel);
try
for sId in aIdList do
lbAllCallbackIds.Items.Add(sId);
finally
aIdList.Free;
end;
end;
三、客户端对回叫信道的设置
1、客户端注册
客户端注册回叫信道，由TDSClientCallbackChannelManager1.RegisterCallback方法实现;执行语句如下：
TDSClientCallbackChanneManager1.RegisterCallback(Combobox1.Text, TDemoCallback.Create);
现在我们看一看，客户端向服务器端注册回叫信道时，上述代码包含了注册回叫通道的四个要素：
（1）回叫通道ID，TDSClientCallbackChanneManager.ChannelNament属性值；相关字符应与服务器注册的“回叫信道”字符一致。
（2）客户端ID，TDSClientCallbackChanneManager.ManagerID属性值；每个客户端应明确一个唯一的识别码。
（3）回叫ID ,由TDSClientCallbackChanneManager1.RegisterCallback方法的第1个参数；
（4）回叫方法，由TDSClientCallbackChanneManager1.RegisterCallback第2个参数带入，创建TDemoCallback继承的方法，该对象复载Execute方法，就是用于回叫识别。
2、客户端与客户端之间的回叫，使用TDSAdminClient类别的NotifyCallback方法
XE在DSProxy单元，增加TDSAdminClient类别，强化回叫功能。其中TDSAdminClient类别的NotifyCallback方法用于客户端之间的回叫，可以回叫指定回叫通道中的特定客户端（客户端ID）或回叫识别(回叫ID)的客户端。声明如下：
function NotifyCallback(ChannelName:string; ClientID:string;CallbackID:string;Msg:TJSONValue; out Respones :TJSONValue):Boolean;
NotifyCallback方法的参数含意：
（1）ChannelName，回叫通道名称；
（2）ClientID，客户端识别；
（3）CallbackID，回叫识别；
（4）Msg，传递信息；
（5）Respones，被叫客户端的回传信息。
实例如下：
procedure TfmMainForm.btnBroadcastToClientClick(Sender: TObject);
var
LClient: TDSAdminClient;
LMessage: TJSONString;
LResponse: TJSONValue;
LConnection: TDBXConnection;
begin
LConnection := scnnCallbackServer.DBXConnection;
LClient := TDSAdminClient.Create(LConnection, False);
try
LMessage := TJSONString.Create(Format('呼叫通道：%s，客户端识别：%s，回叫识别：%s，回叫信息：%s',
[DemoChannelManager.ChannelName, cbClientIds.Text, cbCallbackIds.Text, mmChannelCallbacks.Text]));
try
LClient.NotifyCallback(DemoChannelManager.ChannelName, cbClientIds.Text, cbCallbackIds.Text, LMessage, LResponse);
try
if LResponse <> nil then
edtResponse.Text := Format('客户端响应：%s', [LResponse.ToString])
else
edtResponse.Text := Format('客户端响应：%s', ['nil']);
finally
LResponse.Free;
end;
finally
LMessage.Free;
end;
finally
LClient.Free;
end;
end;
