XMLBrokr.TXMLBroker.BeforeDispatch
Contents |
Delphi Information
From XMLBrokr.pas
property BeforeDispatch: THTTPMethodEvent read FBeforeDispatch write FBeforeDispatch;
Unit: XMLBrokr
Type: event
Visibility: published
Member Of: TXMLBroker
C++ Information
From XMLBrokr.hpp
__property THTTPMethodEvent BeforeDispatch;
Unit: XMLBrokr
Type: property
Visibility: public
Member Of: TXMLBroker
Description
Occurs when the XML broker receives an HTTP request message.
Write a BeforeDispatch event handler to initialize the response to an update request or to handle any messages sent to the XML broker that are not update requests. If the event handler completely handles the request, filling out the response object so that it is ready to send, it should set the Handled parameter to true, thereby preventing the XML broker from applying the updates.
Unless the BeforeDispatch event handler sets the Handled parameter to true, the XML broker receives an OnRequestUpdate event after the BeforeDispatch event handler exits. After the OnRequestUpdate event, the XML broker applies the updates to the application server and generates the contents of the response based on whether there were any update errors. Finally, the XML broker receives an AfterDispatch event where it can perform any final changes to the response message before it is sent back to the Web browser.
If the BeforeDispatch event handler sets the Handled parameter to true, the XML broker receives an AfterDispatch event, but does not attempt to apply updates from the request message or receive any of the events that accompany that process.