observer.inc 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655
  1. { TObservers }
  2. function TObservers.CanObserve(const aID: Integer): Boolean;
  3. begin
  4. Result:=Assigned(FCanObserve) and FCanObserve(aID);
  5. end;
  6. procedure TObservers.AddObserver(const aID: Integer; const aIntf: IInterface);
  7. var
  8. I : integer;
  9. P : PIDArray;
  10. O : IObserver;
  11. E : IEditLinkObserver;
  12. begin
  13. if not Supports(aIntf,IObserver,O) then
  14. raise EObserverException.Create(SErrNotIObserverInterface);
  15. if not CanObserve(aID) then
  16. raise EObserverException.Create(SErrUnsupportedObserver);
  17. P:=FList.GetIDArrayFromID(aId);
  18. if P=Nil then
  19. FList.AddInterface(aID,aIntf)
  20. else
  21. begin
  22. if not Supports(aIntf,ISingleCastObserver) then
  23. P^.Add(aIntf)
  24. else
  25. begin
  26. if Supports(aIntf,IEditLinkObserver,E) and Not E.IsReadOnly then
  27. begin
  28. // There can be only one editing link observer.
  29. For I:=0 to P^.Count-1 do
  30. if Supports(P^.List[I],IEditLinkObserver,E) then
  31. if not E.IsReadOnly then
  32. Raise EObserverException.Create(SErrOnlyOneEditingObserverAllowed)
  33. end;
  34. P^.Add(aIntf)
  35. end;
  36. end;
  37. if Assigned(FObserverAdded) then
  38. FObserverAdded(aId,O);
  39. end;
  40. procedure TObservers.AddObserver(const aIDs: array of Integer; const aIntf: IInterface);
  41. var
  42. aID : integer;
  43. begin
  44. for aID in aIDs do
  45. AddObserver(aId,aIntf);
  46. end;
  47. procedure TObservers.RemoveObserver(const aID: Integer; const aIntf: IInterface);
  48. var
  49. P : PIDArray;
  50. begin
  51. P:=FList.GetIDArrayFromID(aID);
  52. if P=Nil then
  53. exit;
  54. P^.Remove(aIntf);
  55. end;
  56. procedure TObservers.RemoveObserver(const aIDs: array of Integer; const aIntf: IInterface);
  57. var
  58. aID : integer;
  59. begin
  60. for aID in aIDs do
  61. RemoveObserver(aId,aIntf);
  62. end;
  63. function TObservers.IsObserving(const aID: Integer): Boolean;
  64. var
  65. O : IInterface;
  66. begin
  67. Result:=TryIsObserving(aID,O);
  68. end;
  69. function TObservers.TryIsObserving(const aID: Integer; out aIntf: IInterface): Boolean;
  70. var
  71. P : PIDArray;
  72. begin
  73. aIntf:=Nil;
  74. Result:=False;
  75. P:=FList.GetIDArrayFromID(aID);
  76. if P=Nil then
  77. exit;
  78. aIntf:=P^.GetActive;
  79. Result:=aIntf<>Nil;
  80. end;
  81. function TObservers.GetSingleCastObserver(const aID: Integer): IInterface;
  82. var
  83. P : PIDArray;
  84. begin
  85. Result:=Nil;
  86. P:=FList.GetIDArrayFromID(aID);
  87. if P<>Nil then
  88. Result:=P^.GetSingleCast;
  89. if Result=Nil then
  90. raise EObserverException.CreateFmt(SErrObserverNoSinglecast, [aID]);
  91. end;
  92. function TObservers.GetMultiCastObserverArray(const aID: Integer): TIInterfaceArray;
  93. var
  94. aCount, I : Integer;
  95. P : PIDArray;
  96. O : IObserver;
  97. begin
  98. Result:=[];
  99. P:=FList.GetIDArrayFromId(aId);
  100. if P=Nil then
  101. exit;
  102. SetLength(Result,P^.Count);
  103. aCount:=0;
  104. for I:=0 to P^.Count-1 do
  105. if Supports(P^.List[I],IMultiCastObserver,O) then
  106. if O.Active then
  107. begin
  108. Result[aCount]:=O;
  109. Inc(aCount);
  110. end;
  111. SetLength(Result,aCount);
  112. if aCount=0 then
  113. raise EObserverException.CreateFmt(SerrObserverNoMulticastFound, [aID]);
  114. end;
  115. { TObservers.TIDArray }
  116. procedure TObservers.TIDArray.Add(const aInterface: IInterface);
  117. begin
  118. if Count=Length(List) then
  119. SetLength(List,Count+10);
  120. List[Count]:=aInterface;
  121. Inc(Count);
  122. end;
  123. procedure TObservers.TIDArray.Remove(const aInterface: IInterface);
  124. var
  125. I : Integer;
  126. begin
  127. I:=Count-1;
  128. While (I>=0) and (List[i]<>aInterface) do
  129. Dec(I);
  130. if (I>=0) then
  131. List[i]:=Nil;
  132. end;
  133. function TObservers.TIDArray.GetActive: IObserver;
  134. var
  135. I : integer;
  136. begin
  137. Result:=Nil;
  138. I:=Count-1;
  139. While (Result=Nil) and (I>=0) do
  140. begin
  141. if Supports(List[I],IObserver,Result) then
  142. if Not Result.Active then
  143. Result:=nil;
  144. Dec(I);
  145. end;
  146. end;
  147. function TObservers.TIDArray.GetSingleCast: ISingleCastObserver;
  148. var
  149. I : Integer;
  150. E : IEditLinkObserver;
  151. begin
  152. Result:=Nil;
  153. I:=Count-1;
  154. While (Result=Nil) and (I>=0) do
  155. begin
  156. Result:=nil;
  157. if Supports(List[I],ISingleCastObserver,Result) then
  158. begin
  159. if Not (Result.Active
  160. and Supports(Result,IEditLinkObserver,E)
  161. and not E.IsReadOnly) then
  162. Result:=nil;
  163. end;
  164. Dec(I);
  165. end;
  166. end;
  167. { TObservers.TIDArrayList }
  168. function TObservers.TIDArrayList.IndexOfID(aId: Integer): Integer;
  169. begin
  170. Result:=Count-1;
  171. While (Result>=0) and (List[Result].ID<>aID) do
  172. Dec(Result);
  173. end;
  174. function TObservers.TIDArrayList.AddID(aId: Integer): Integer;
  175. begin
  176. if Count=Length(List) then
  177. SetLength(List,Count+10);
  178. List[Count].ID:=aID;
  179. Result:=Count;
  180. Inc(Count);
  181. end;
  182. procedure TObservers.TIDArrayList.AddInterface(aID: integer;
  183. aInterFace: IInterface);
  184. var
  185. Idx : Integer;
  186. P : PIDarray;
  187. begin
  188. Idx:=AddID(aID);
  189. P:=GetIDArray(Idx);
  190. P^.Add(aInterface);
  191. end;
  192. function TObservers.TIDArrayList.GetIDArray(aIdx: Integer): PIDArray;
  193. begin
  194. Result:=@List[aIdx];
  195. end;
  196. function TObservers.TIDArrayList.GetIDArrayFromID(aId: Integer): PIDArray;
  197. var
  198. Idx : Integer;
  199. begin
  200. Result:=Nil;
  201. Idx:=IndexOfID(aId);
  202. if Idx<>-1 then
  203. Result:=GetIDArray(Idx);
  204. end;
  205. { TLinkObservers }
  206. class function TLinkObservers.CheckObserving(const aObservers: TObservers; aID : Integer) : Integer;
  207. begin
  208. Result:=aID;
  209. if Not aObservers.IsObserving(aID) then
  210. raise EObserverException.CreateFmt(SErrObserverNotAvailable,[aID]);
  211. end;
  212. class function TLinkObservers.GetEditGridLink(const aObservers: TObservers): IEditGridLinkObserver;
  213. var
  214. aId: Integer;
  215. begin
  216. aId:=CheckObserving(aObservers, TObserverMapping.EditGridLinkID);
  217. Result:=aObservers.GetSingleCastObserver(aID) as IEditGridLinkObserver;
  218. end;
  219. class function TLinkObservers.GetEditLink(const aObservers: TObservers): IEditLinkObserver;
  220. var
  221. aId: Integer;
  222. begin
  223. aId:=CheckObserving(aObservers,TObserverMapping.EditLinkID);
  224. Result:=aObservers.GetSingleCastObserver(aID) as IEditLinkObserver;
  225. end;
  226. class procedure TLinkObservers.EditLinkUpdate(const aObservers: TObservers);
  227. begin
  228. GetEditLink(AObservers).Update;
  229. end;
  230. class function TLinkObservers.EditLinkTrackUpdate(const aObservers: TObservers): Boolean;
  231. var
  232. E : IEditLinkObserver;
  233. T : IObserverTrack;
  234. begin
  235. Result:=False;
  236. E:=GetEditLink(aObservers);
  237. if Supports(E,IObserverTrack,T) then
  238. if T.Track then
  239. begin
  240. Result:=true;
  241. E.Update;
  242. end;
  243. end;
  244. class procedure TLinkObservers.EditLinkReset(const aObservers: TObservers);
  245. begin
  246. GetEditLink(AObservers).Reset;
  247. end;
  248. class procedure TLinkObservers.EditLinkModified(aObservers: TObservers);
  249. begin
  250. GetEditLink(aObservers).Modified;
  251. end;
  252. class function TLinkObservers.EditLinkIsModified(const aObservers: TObservers): Boolean;
  253. begin
  254. Result:=GetEditLink(aObservers).IsModified;
  255. end;
  256. class function TLinkObservers.EditLinkIsValidChar(const aObservers: TObservers; aKey: Char): Boolean;
  257. begin
  258. Result:=GetEditLink(aObservers).IsValidChar(aKey);
  259. end;
  260. class function TLinkObservers.EditLinkIsEditing(const aObservers: TObservers): Boolean;
  261. begin
  262. Result:=GetEditLink(aObservers).IsEditing;
  263. end;
  264. class function TLinkObservers.EditLinkEdit(const aObservers: TObservers): Boolean;
  265. begin
  266. Result:=GetEditLink(aObservers).Edit;
  267. end;
  268. class procedure TLinkObservers.EditLinkSetIsReadOnly(const aObservers: TObservers; AValue: Boolean);
  269. begin
  270. GetEditLink(aObservers).IsReadOnly:=aValue;
  271. end;
  272. class function TLinkObservers.EditLinkIsReadOnly(const aObservers: TObservers): Boolean;
  273. begin
  274. Result:=GetEditLink(aObservers).IsReadOnly;
  275. end;
  276. class procedure TLinkObservers.EditGridLinkUpdate(const aObservers: TObservers);
  277. begin
  278. GetEditGridLink(aObservers).Update;
  279. end;
  280. class procedure TLinkObservers.EditGridLinkReset(const aObservers: TObservers);
  281. begin
  282. GetEditGridLink(aObservers).Reset;
  283. end;
  284. class procedure TLinkObservers.EditGridLinkModified(const aObservers: TObservers
  285. );
  286. begin
  287. GetEditGridLink(aObservers).Modified;
  288. end;
  289. class function TLinkObservers.EditGridLinkIsModified(const aObservers: TObservers): Boolean;
  290. begin
  291. Result:=GetEditGridLink(aObservers).IsModified;
  292. end;
  293. class function TLinkObservers.EditGridLinkIsValidChar(const aObservers: TObservers; aKey: Char): Boolean;
  294. begin
  295. Result:=GetEditGridLink(aObservers).IsValidChar(aKey);
  296. end;
  297. class function TLinkObservers.EditGridLinkIsEditing(const aObservers: TObservers): Boolean;
  298. begin
  299. Result:=GetEditGridLink(aObservers).IsEditing
  300. end;
  301. class function TLinkObservers.EditGridLinkEdit(const aObservers: TObservers): Boolean;
  302. begin
  303. Result:=GetEditGridLink(aObservers).Edit;
  304. end;
  305. class function TLinkObservers.EditGridLinkIsReadOnly(
  306. const aObservers: TObservers): Boolean;
  307. begin
  308. Result:=GetEditGridLink(aObservers).IsReadOnly;
  309. end;
  310. class procedure TLinkObservers.EditGridLinkSetIsReadOnly(const aObservers: TObservers; aValue: Boolean);
  311. begin
  312. GetEditGridLink(aObservers).IsReadOnly:=aValue
  313. end;
  314. class procedure TLinkObservers.PositionLinkPosChanged(const aObservers: TObservers);
  315. var
  316. IntfArray : TIInterfaceArray;
  317. Intf : IInterface;
  318. PL: IPositionLinkObserver;
  319. PL170: IPositionLinkObserver170;
  320. begin
  321. if Not aObservers.IsObserving(TObserverMapping.PositionLinkID) then
  322. Exit;
  323. IntfArray:=aObservers.GetMultiCastObserverArray(TObserverMapping.PositionLinkID);
  324. for Intf in IntfArray do
  325. begin
  326. if Supports(Intf,IPositionLinkObserver,PL) then
  327. PL.PosChanged;
  328. if Supports(Intf,IPositionLinkObserver170,PL170) then
  329. PL.PosChanged;
  330. end;
  331. end;
  332. class procedure TLinkObservers.PositionLinkPosChanging(const aObservers: TObservers);
  333. var
  334. IntfArray : TIInterfaceArray;
  335. Intf : IInterface;
  336. PL: IPositionLinkObserver;
  337. PL170: IPositionLinkObserver170;
  338. begin
  339. if Not aObservers.IsObserving(TObserverMapping.PositionLinkID) then
  340. Exit;
  341. IntfArray:=aObservers.GetMultiCastObserverArray(TObserverMapping.PositionLinkID);
  342. for Intf in IntfArray do
  343. begin
  344. if Supports(Intf,IPositionLinkObserver,PL) then
  345. PL.PosChanging;
  346. if Supports(Intf,IPositionLinkObserver170,PL170) then
  347. PL.PosChanging;
  348. end;
  349. end;
  350. class procedure TLinkObservers.ListSelectionChanged(const aObservers: TObservers);
  351. begin
  352. if AObservers.IsObserving(TObserverMapping.EditLinkID) then
  353. if not TLinkObservers.EditLinkIsEditing(aObservers) then
  354. EditLinkReset(AObservers)
  355. else
  356. begin
  357. EditLinkModified(aObservers);
  358. EditLinkTrackUpdate(aObservers);
  359. PositionLinkPosChanged(aObservers);
  360. end;
  361. if aObservers.IsObserving(TObserverMapping.ControlValueID) then
  362. begin
  363. ControlValueModified(aObservers);
  364. ControlValueTrackUpdate(aObservers);
  365. end;
  366. if aObservers.IsObserving(TObserverMapping.PositionLinkID) then
  367. PositionLinkPosChanged(aObservers);
  368. end;
  369. class procedure TLinkObservers.ControlValueUpdate(aObservers: TObservers);
  370. var
  371. IntfArray : TIInterfaceArray;
  372. Intf : IInterface;
  373. O: IControlValueObserver;
  374. begin
  375. IntfArray:=aObservers.GetMultiCastObserverArray(TObserverMapping.ControlValueID);
  376. for Intf in IntfArray do
  377. if Supports(Intf,IControlValueObserver,O) then
  378. O.ValueUpdate;
  379. end;
  380. class procedure TLinkObservers.ControlValueModified(aObservers: TObservers);
  381. var
  382. IntfArray : TIInterfaceArray;
  383. Intf : IInterface;
  384. O: IControlValueObserver;
  385. begin
  386. IntfArray:=aObservers.GetMultiCastObserverArray(TObserverMapping.ControlValueID);
  387. for Intf in IntfArray do
  388. if Supports(Intf,IControlValueObserver,O) then
  389. O.ValueModified;
  390. end;
  391. class function TLinkObservers.ControlValueTrackUpdate(const aObservers: TObservers): Boolean;
  392. var
  393. IntfArray : TIInterfaceArray;
  394. Intf : IInterface;
  395. O: IControlValueObserver;
  396. T : IObserverTrack;
  397. begin
  398. Result:=False;
  399. IntfArray:=aObservers.GetMultiCastObserverArray(TObserverMapping.ControlValueID);
  400. for Intf in IntfArray do
  401. if Supports(Intf,IControlValueObserver,O)
  402. And Supports(O,IObserverTrack,T) then
  403. if T.Track then
  404. begin
  405. Result:=true;
  406. O.ValueUpdate;
  407. end;
  408. end;
  409. class function TLinkObservers.AllowControlChange(const aObservers: TObservers): Boolean;
  410. begin
  411. if aObservers.IsObserving(TObserverMapping.EditLinkID) then
  412. Result:=TLinkObservers.EditLinkEdit(aObservers)
  413. else
  414. Result := True;
  415. end;
  416. class procedure TLinkObservers.ControlChanged(const aObservers: TObservers);
  417. begin
  418. if (aObservers.IsObserving(TObserverMapping.EditLinkID))
  419. and EditLinkEdit(aObservers) then
  420. begin
  421. EditLinkModified(aObservers);
  422. EditLinkUpdate(aObservers);
  423. end;
  424. if aObservers.IsObserving(TObserverMapping.ControlValueID) then
  425. begin
  426. ControlValueModified(aObservers);
  427. ControlValueUpdate(aObservers);
  428. end;
  429. if aObservers.IsObserving(TObserverMapping.PositionLinkID) then
  430. PositionLinkPosChanged(aObservers);
  431. end;
  432. class function TLinkObservers.AllowControlChange(const aControl: TComponent): Boolean;
  433. begin
  434. AllowControlChange(aControl.Observers);
  435. end;
  436. class procedure TLinkObservers.ControlChanged(const aControl: TComponent);
  437. begin
  438. ControlChanged(aControl.Observers);
  439. end;
  440. class procedure TLinkObservers.IteratorLinkUpdateControlComponent(const aObservers: TObservers; aControl: TComponent);
  441. var
  442. O : IIteratorLinkObserver;
  443. IntfArray : TIInterfaceArray;
  444. Intf : IInterface;
  445. begin
  446. IntfArray:=aObservers.GetMultiCastObserverArray(TObserverMapping.IteratorLinkID);
  447. for Intf in IntfArray do
  448. if Supports(Intf,IIteratorLinkObserver,O) then
  449. O.UpdateControlComponent(aControl);
  450. end;
  451. class procedure TLinkObservers.IteratorLinkStartFrom(const aObservers: TObservers; aPosition: Integer);
  452. var
  453. O : IIteratorLinkObserver;
  454. IntfArray : TIInterfaceArray;
  455. Intf : IInterface;
  456. begin
  457. IntfArray:=aObservers.GetMultiCastObserverArray(TObserverMapping.IteratorLinkID);
  458. for Intf in IntfArray do
  459. if Supports(Intf,IIteratorLinkObserver,O) then
  460. O.StartFrom(aPosition);
  461. end;
  462. class function TLinkObservers.IteratorLinkMoveNext(const aObservers: TObservers): Boolean;
  463. var
  464. O : IIteratorLinkObserver;
  465. IntfArray : TIInterfaceArray;
  466. Intf : IInterface;
  467. begin
  468. Result:=false;
  469. IntfArray:=aObservers.GetMultiCastObserverArray(TObserverMapping.IteratorLinkID);
  470. for Intf in IntfArray do
  471. if Supports(Intf,IIteratorLinkObserver,O) then
  472. Result:=Result or O.MoveNext;
  473. end;
  474. class procedure TLinkObservers.IteratorLinkFinish(const aObservers: TObservers);
  475. var
  476. O : IIteratorLinkObserver;
  477. IntfArray : TIInterfaceArray;
  478. Intf : IInterface;
  479. begin
  480. IntfArray:=aObservers.GetMultiCastObserverArray(TObserverMapping.IteratorLinkID);
  481. for Intf in IntfArray do
  482. if Supports(Intf,IIteratorLinkObserver,O) then
  483. O.Finish;
  484. end;
  485. { TObserverMapping }
  486. constructor TObserverMapping.Create;
  487. begin
  488. FList:=TStringList.Create;
  489. // Don't use sorted, as it will change the IDs as more records are added
  490. end;
  491. destructor TObserverMapping.Destroy;
  492. begin
  493. FreeAndNil(FList);
  494. inherited Destroy;
  495. end;
  496. class constructor TObserverMapping.Init;
  497. begin
  498. _Instance:=TObserverMapping.Create;
  499. end;
  500. class destructor TObserverMapping.Done;
  501. begin
  502. FreeAndNil(_Instance)
  503. end;
  504. class function TObserverMapping.GetObserverID(const aKey: string): Integer;
  505. begin
  506. Result:=Instance.List.Indexof(aKey);
  507. if Result=-1 then
  508. Result:=Instance.List.Add(aKey);
  509. Result:=Result+MinPublicID;
  510. end;
  511. class procedure TObserverMapping.Clear;
  512. begin
  513. Instance.List.Clear;
  514. end;
  515. constructor ObservableMemberAttribute.Create(const aMemberName, aFramework: string; aTrack: Boolean);
  516. begin
  517. inherited Create;
  518. FFramework := AFramework;
  519. FMemberName := AMemberName;
  520. FTrack := ATrack;
  521. end;
  522. constructor ObservableMemberAttribute.Create(const aMemberName: string; aTrack: Boolean);
  523. begin
  524. inherited Create;
  525. FMemberName := AMemberName;
  526. FTrack := ATrack;
  527. end;
  528. constructor ObservableMemberAttribute.Create(const aMemberName: string);
  529. begin
  530. inherited Create;
  531. FMemberName := AMemberName;
  532. end;