Web.HTTPApp.TCustomWebDispatcher.DispatchAction

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function DispatchAction(Request: TWebRequest;
Response: TWebResponse): Boolean;

C++

bool __fastcall DispatchAction(TWebRequest* Request, TWebResponse* Response);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function protected
Web.HTTPApp.pas
Web.HTTPApp.hpp
Web.HTTPApp TCustomWebDispatcher

Beschreibung

Übergibt eine HTTP-Anforderung an die Aktionselemente von Actions.

Die Web-Anwendung ruft DispatchAction auf, wenn sie eine HTTP-Anforderungsbotschaft erhält. Der Dispatcher kann die Anforderung dann an alle Aktionselemente weitergeben, die die Antwort generieren.

Bevor DispatchAction nach Aktionselementen sucht, die die HTTP-Anforderungsbotschaft bearbeiten, wird das Ereignis BeforeDispatch erzeugt. Wenn die erforderlichen Aktionen in der Ereignisbehandlungsroutine für BeforeDispatch durchgeführt werden, gibt der Dispatcher die Botschaft nicht an die Aktionselemente weiter.

Wenn keine Ereignisbehandlungsroutine für BeforeDispatch definiert ist, vergleicht DispatchAction die Eigenschaften MethodType und PathInfo der HTTP-Anforderung mit den Eigenschaften MethodType und PathInfo aller in der Eigenschaft Actions enthaltenen Aktionselemente. Bei einer Übereinstimmung wird die Ereignisbehandlungsroutine für OnAction aufgerufen.

Die Ereignisbehandlungsroutine für OnAction kann die Antwort auf die Anforderung vervollständigen oder anzeigen, dass die Anforderung nicht vollständig bearbeitet wurde und von einem anderen Aktionselement abgeschlossen werden kann. Wenn die Ereignisbehandlungsroutine für OnAction die Anforderung nicht fertig stellt, führt DispatchAction mit der Überprüfung der Aktionselemente der Eigenschaft Actions fort und ruft bei einer Übereinstimmung die Ereignisbehandlungsroutine für OnAction auf.

Wenn alle Aktionselemente überprüft wurden und die Anforderung immer noch nicht vollständig bearbeitet ist, ruft DispatchAction die Behandlungsroutine für das Ereignis OnAction des Standard-Aktionselementes auf.

Wenn die Anforderung von der Ereignisbehandlungsroutine für BeforeDispatch oder von einem der Aktionselemente bearbeitet wurde, generiert DispatchAction das Ereignis AfterDispatch. Das Ereignis tritt jedoch nicht ein, wenn die Ereignisbehandlungsroutine für BeforeDispatch oder eines der Aktionselemente die Antwort bereits gesendet hat.

DispatchAction gibt einen boolschen Wert zurück, der angibt, ob die Web-Anwendung die Antwort senden soll. True bedeutet, dass die Anforderung von den Aktionselementen bearbeitet wurde und die Ereignisbehandlungsroutine für AfterDispatch den Parameter Handled nicht auf false gesetzt hat.

Siehe auch