OLEVARIANT的替代——FIREDAC的TFDJSONDataSets和TFDJSONDeltas

OLEVARIANT——这个COM的序列格式，也是DATASNAP已使用了20年的序列格式，
在20年以后的今天，终于有了它的替代者：FIREDAC的TFDJSONDataSets和TFDJSONDeltas，XE5 UPDATE2以上版本的DATASNAP的远程方法定义里面已经增加了这2种类型的支持。
FIREDAC的TFDCONNECTION尚没有“GENERATE DATASNAP CLIENT CLASSES”的项，感觉不方便，笔者测试的时候使用TSQLCONNECTION生成的客户端代理类，
易博龙稍后是否会提供？不得而知。

TFDJSONDataSets：数据集对象列表，可包含N个数据集对象，不论是单表查询或多表查询（主从表）的数据都用这种类型返回给客户端。

TFDJSONDeltas：客户端数据集的DELTA列表，可包含N个DELTA，不论是单表提交或多表提交（主从表）的数据都用这种类型提交给服务端。

为什么要有替代品？
DATASNAP为了完全去除对COM的依存，为了能跨平台。
替代者的性能是否强于OLEVARIANT？

笔者未作测试对比，不敢断言。
下面分别给出服务端和客户端的演示代码。

一）服务器端代码演示
1）常量定义：
const
  sDepartment = 'Department';
  sEmployees = 'Employees';

2）查询数据：

function TServerMethods1.GetDepartmentEmployees(const AID: string): TFDJSONDataSets;
begin
  // Clear active so that query will reexecute.
  FDQueryDepartmentEmployees.Active := False;
  FDQueryDepartment.Active := False;
  FDQueryDepartment.Params[0].Value := AID;
  FDQueryDepartmentEmployees.Params[0].Value := AID;
 
   // Create dataset list
  Result := TFDJSONDataSets.Create;
   // Add departments dataset
  TFDJSONDataSetsWriter.ListAdd(Result, sDepartment, FDQueryDepartment);
    // Add employees dataset
  TFDJSONDataSetsWriter.ListAdd(Result, sEmployees, FDQueryDepartmentEmployees);
end;

TFDJSONDataSets，FIREDAC的数据集列表对象，可返回多个数据集。

3）提交数据：

procedure TServerMethods1.ApplyChangesDepartmentEmployees(
  const ADeltaList: TFDJSONDeltas);
var
  LApply: IFDJSONDeltasApplyUpdates;
begin
  // Create the apply object
  LApply := TFDJSONDeltasApplyUpdates.Create(ADeltaList);
  // Apply the department delta
  LApply.ApplyUpdates(sDepartment, FDQueryDepartment.Command);
  if LApply.Errors.Count = 0 then
    // If no errors, apply the employee delta
    LApply.ApplyUpdates(sEmployees, FDQueryDepartmentEmployees.Command);
  if LApply.Errors.Count > 0 then
    // Raise an exception if any errors.
    raise Exception.Create(LApply.Errors.Strings.Text);
end;

二）客户端演示代码
1）查询数据：

procedure TForm2.GetDepartmentEmployees(const ADEPTNO: string);
var
    LDataSetList: TFDJSONDataSets;
    LDataSet: TFDDataSet;
begin
    LDataSetList := ClientModule1.ServerMethods1Client.GetDepartmentEmployees(ADEPTNO);
    // Get department dataset
    LDataSet := TFDJSONDataSetsReader.GetListValueByName(LDataSetList,sDepartment);
    // Update UI
    FDMemTableDepartment.Active := False;
    FDMemTableDepartment.AppendData(LDataSet);
 
    // Get employees dataset
    LDataSet := TFDJSONDataSetsReader.GetListValueByName(LDataSetList, sEmployees);
    // Update UI
    FDMemTableEmployee.Active  := False;
    FDMemTableEmployee.AppendData(LDataSet);
end;
2）提交数据：

function TForm2.GetDeltas: TFDJSONDeltas;
begin
  // Post if editing
  if FDMemTableDepartment.State in dsEditModes then
  begin
    FDMemTableDepartment.Post;
  end;
 
  if FDMemTableEmployee.State in dsEditModes then
  begin
    FDMemTableEmployee.Post;
  end;
 
  // Create a delta list
  Result := TFDJSONDeltas.Create;
  // Add deltas
  TFDJSONDeltasWriter.ListAdd(Result, sEmployees, FDMemTableEmployee);
  TFDJSONDeltasWriter.ListAdd(Result, sDepartment, FDMemTableDepartment);
end;

procedure TForm2.ApplyUpdates;
var
  LDeltaList: TFDJSONDeltas;
begin
  LDeltaList := GetDeltas;
 
  // Call server method.  Pass the delta list.
  ClientModule1.ServerMethods1Client.ApplyChangesDepartmentEmployees(LDeltaList);
 
end;

注意：
服务端和客户端都要放置2个控件：
TFDStanStorageJSONLink
 TFDStanStorageBinLink