传统的数据集的读取和更新,是通过中间层的TDataSetProvider来完成的。TDataSetProvider负责从它上游的数据集读取数据生成Data包,再传给客户端;另一方面,在客户端提交更新时(TClientDataSet.ApplyUpdates),TDataSetProvider还负责解析上传的Delta包,并最终实现数据库的更新。现在在我们当前的方法调用方式下,不能再通过TDataSetProvider.ApplyUpdates来自动完成更新了,但是,我们还可以借用TDataSetProvider解析Delta数据包的功能,手动生成SQL语句来完成数据库的更新。手动更新看似复杂,实际上编码并不多,而且这种方式具有很大的灵活性,同时还解决了在传统方式下,多表联合查询不能完全自动更新的软肋。
下面来看看示例代码:
中间层代码
...
interface
uses
SysUtils, Classes, DSServer, DBXOracle, FMTBcd, DB, SqlExpr, WideStrings, Provider,
CodeSiteLogging, DBClient;
type
{$METHODINFO ON}
TServerMethods1 = class(TDataModule)
SQLConnection1: TSQLConnection;
SQLDataSet1: TSQLDataSet;
DataSetProvider1: TDataSetProvider;
procedure DataSetProvider1BeforeUpdateRecord(Sender: TObject; SourceDS: TDataSet;
DeltaDS: TCustomClientDataSet; UpdateKind: TUpdateKind; var Applied: Boolean);
private
{ Private declarations }
FOnDeltaRecordUpdate: TBeforeUpdateRecordEvent;
procedure UpdateEmployeesDelta(Sender: TObject; SourceDS: TDataSet;
DeltaDS: TCustomClientDataSet; UpdateKind: TUpdateKind;
var Applied: Boolean);
public
{ Public declarations }
function GetEmployeeFullName(EmployeeId: Integer): string;
function GetEmployees: TDataSet;
function UpdateEmployees(EMPDelta: OleVariant): Boolean;
end;
{$METHODINFO OFF}
...
implementation
...
procedure TServerMethods1.DataSetProvider1BeforeUpdateRecord(Sender: TObject; SourceDS: TDataSet;
DeltaDS: TCustomClientDataSet; UpdateKind: TUpdateKind; var Applied: Boolean);
begin
if Assigned(FOnDeltaRecordUpdate) then
FOnDeltaRecordUpdate(Sender, SourceDS, DeltaDS, UpdateKind, Applied);
end;
procedure TServerMethods1.UpdateEmployeesDelta(Sender: TObject; SourceDS: TDataSet;
DeltaDS: TCustomClientDataSet; UpdateKind: TUpdateKind; var Applied: Boolean);
var
SQLStr, Clause1, Clause2: string;
I: Integer;
begin
Applied := False;
case UpdateKind of
{$REGION 'Process ukModify'}
ukModify:
begin
with DeltaDS do
begin
for I := 0 to Fields.Count - 1 do
if not Fields[I].IsNull then
Clause1 := Clause1 + ', ' + Fields[I].FieldName + '=:' + Fields[I].FieldName;
Clause1 := System.Copy(Clause1, 2, Length(Clause1) - 1);
SQLStr := 'UPDATE EMPLOYEES SET ' + Clause1 + ' WHERE EMPLOYEE_ID = :EMPLOYEE_ID';
end;
with SQLDataSet1 do
begin
Close;
CommandText := SQLStr;
for I := 0 to DeltaDS.Fields.Count - 1 do
if not DeltaDS.Fields[I].IsNull then
ParamByName(DeltaDS.Fields[I].FieldName).Value := DeltaDS.Fields[I].Value;
ParamByName('EMPLOYEE_ID').AsInteger := DeltaDS.FieldByName('EMPLOYEE_ID').OldValue;
if (ExecSQL() = 0) then Abort;
end;
end;
{$ENDREGION}
{$REGION 'Process ukInsert'}
ukInsert:
begin
for I := 0 to DeltaDS.Fields.Count - 1 do
begin
if not DeltaDS.Fields[I].IsNull then
begin
Clause1 := Clause1 + ', ' + DeltaDS.Fields[I].FieldName;
Clause2 := Clause2 + ', :' + DeltaDS.Fields[I].FieldName;
end;
end;
Clause1 := System.Copy(Clause1, 2, Length(Clause1) - 1);
Clause2 := System.Copy(Clause2, 2, Length(Clause2) - 1);
SQLStr := 'INSERT INTO EMPLOYEES(' + Clause1 + ') VALUES(' + Clause2 + ')';
with SQLDataSet1 do
begin
Close;
CommandText := SQLStr;
for I := 0 to DeltaDS.Fields.Count - 1 do
if not DeltaDS.Fields[I].IsNull then
ParamByName(DeltaDS.Fields[I].FieldName).Value := DeltaDS.Fields[I].Value;
if (ExecSQL() = 0) then Abort;
end;
end;
{$ENDREGION}
{$REGION 'Process ukDelete'}
ukDelete:
begin
SQLStr := 'DELETE EMPLOYEES WHERE EMPLOYEE_ID = :EMPLOYEE_ID';
with SQLDataSet1 do
begin
Close;
CommandText := SQLStr;
ParamByName('EMPLOYEE_ID').AsInteger := DeltaDS.FieldByName('EMPLOYEE_ID').OldValue;
if (ExecSQL() = 0) then Abort;
end;
end;
{$ENDREGION}
end;
Applied := True;
end;
function TServerMethods1.UpdateEmployees(EMPDelta: OleVariant): Boolean;
var
ErrorCount: Integer;
begin
//指定Employees的专有更新过程
FOnDeltaRecordUpdate := UpdateEmployeesDelta;
DataSetProvider1.ApplyUpdates(EMPDelta, 0, ErrorCount);
Result := ErrorCount = 0;
end;
1、增加一个DataSetProvider1控件,让它与SQLDataSet1控件关联。
2、申明一个事件句柄FOnDeltaRecordUpdate: TBeforeUpdateRecordEvent,然后在DataSetProvider1的BeforeUpdateRecord事件过程中,再嵌套一个TBeforeUpdateRecordEvent事件。
3、申明和定义一个私有过程UpdateEmployeesDelta,其参数定义遵循TBeforeUpdateRecordEvent事件过程的定义,此过程专门用来处理Employees的更新。实际上,所有表的更新只有Update、Insert和Delete三种类型,针对当前传入的Delta包,可以手动构造出SQL语句。这里只有具有的表不一样,但处理流程都是完全一样的,所以,若有其他新表的更新,可以直接套用相关代码段,甚至可以做成一个专门的一个通用过程。
4、申明和定义UpdateEmployees函数,此方法是暴露给客户端进行调用的。若客户端有多个表需要在一个事务中完成更新,则可以在此过程中手动启动事务,分别完成多个表Delta数据包的更新,最后提交或rollback。若有新的方法暴露给客户端来更新其他表的时候,只需要相应地再创建一个私有更新过程,并把此过程指针赋给FOnDeltaRecordUpdate即可。
客户端代码:
通过在客户端中的TSQLConection控件,可以生成DataSnap client class:
...
TServerMethods1Client = class
private
FDBXConnection: TDBXConnection;
FInstanceOwner: Boolean;
FEchoStringCommand: TDBXCommand;
FReverseStringCommand: TDBXCommand;
FGetEmployeeFullNameCommand: TDBXCommand;
FGetEmployeesCommand: TDBXCommand;
FGetJobsCommand: TDBXCommand;
FUpdateEmployeesCommand: TDBXCommand;
public
constructor Create(ADBXConnection: TDBXConnection); overload;
constructor Create(ADBXConnection: TDBXConnection; AInstanceOwner: Boolean); overload;
destructor Destroy; override;
function GetEmployeeFullName(EmployeeId: Integer): string;
function GetEmployees: TDataSet;
function UpdateEmployees(EMPDelta: OleVariant): Boolean;
end;
...
在调用模块中,比如一个按钮事件中完成Employees被更新数据的提交,其中FMethodProxy为TServerMethods1Client的实例:
...
procedure TForm2.Button2Click(Sender: TObject);
begin
if ClientDataSet1.ChangeCount > 0 then
begin
FMethodProxy.UpdateEmployees(ClientDataSet1.Delta);
end;
end;
...
通过上述方式,中间层业务类模块,只需要三个控件,就可以完成现在和今后所有的数据读取和更新操作。更重要的是,由于每次方法调用之间是不需要客户端到中间层、中间层到数据库的两个连接始终保持并专用的,在实际调用方法的时候才需要连接。但在上述例子中,我们的类工厂(TDSServerClass)的LifeCycle属性采用的是缺省的Session方式,也就是说,一旦客户端请求了一次方法调用,则此客户端与中间层、中间层与数据库的连接就一直保持着,并且只能为此客户端专用,直到此客户端关闭连接为止。客户端与中间层的连接先不说,中间层与数据库的连接也是专用的话,那数据库连接资源的使用效率就太差了。为了解决此问题,我们可以在中间层引用对象池的机制。后文将关注对象池的问题,敬请等待续集。