ACE
6.3.3
|
This class is an example of the Connector pattern. This class will establish new connections and create new HANDLER objects to handle the new connections. More...
#include <Asynch_Connector.h>
Public Member Functions | |
ACE_Asynch_Connector (void) | |
A do nothing constructor. More... | |
virtual | ~ACE_Asynch_Connector (void) |
Virtual destruction. More... | |
virtual int | open (bool pass_addresses=false, ACE_Proactor *proactor=0, bool validate_new_connection=true) |
virtual int | connect (const ACE_INET_Addr &remote_sap, const ACE_INET_Addr &local_sap=(const ACE_INET_Addr &) ACE_Addr::sap_any, int reuse_addr=1, const void *act=0) |
This initiates a new asynchronous connect. More... | |
virtual int | cancel (void) |
virtual int | validate_connection (const ACE_Asynch_Connect::Result &result, const ACE_INET_Addr &remote, const ACE_INET_Addr &local) |
virtual bool | pass_addresses (void) const |
virtual void | pass_addresses (bool new_value) |
virtual bool | validate_new_connection (void) const |
virtual void | validate_new_connection (bool new_value) |
Public Member Functions inherited from ACE_Handler | |
ACE_Handler (void) | |
A do nothing constructor. More... | |
ACE_Handler (ACE_Proactor *p) | |
A do nothing constructor which allows proactor to be set to <p>. More... | |
virtual | ~ACE_Handler (void) |
Virtual destruction. More... | |
virtual void | handle_read_stream (const ACE_Asynch_Read_Stream::Result &result) |
virtual void | handle_write_dgram (const ACE_Asynch_Write_Dgram::Result &result) |
virtual void | handle_read_dgram (const ACE_Asynch_Read_Dgram::Result &result) |
virtual void | handle_write_stream (const ACE_Asynch_Write_Stream::Result &result) |
virtual void | handle_read_file (const ACE_Asynch_Read_File::Result &result) |
virtual void | handle_write_file (const ACE_Asynch_Write_File::Result &result) |
virtual void | handle_accept (const ACE_Asynch_Accept::Result &result) |
This method will be called when an asynchronous accept completes. More... | |
virtual void | handle_transmit_file (const ACE_Asynch_Transmit_File::Result &result) |
virtual void | handle_time_out (const ACE_Time_Value &tv, const void *act=0) |
virtual void | handle_wakeup (void) |
ACE_Proactor * | proactor (void) |
Get the proactor associated with this handler. More... | |
void | proactor (ACE_Proactor *p) |
Set the proactor. More... | |
virtual ACE_HANDLE | handle (void) const |
virtual void | handle (ACE_HANDLE) |
Set the ACE_HANDLE value for this Handler. More... | |
Proxy_Ptr & | proxy (void) |
Protected Member Functions | |
virtual void | handle_connect (const ACE_Asynch_Connect::Result &result) |
This is called when an outstanding accept completes. More... | |
void | parse_address (const ACE_Asynch_Connect::Result &result, ACE_INET_Addr &remote_address, ACE_INET_Addr &local_address) |
This parses the address from read buffer. More... | |
ACE_Asynch_Connect & | asynch_connect (void) |
Return the asynch Connect object. More... | |
virtual HANDLER * | make_handler (void) |
Private Attributes | |
ACE_Asynch_Connect | asynch_connect_ |
Asynch_Connect used to make life easier :-) More... | |
bool | pass_addresses_ |
Flag that indicates if parsing of addresses is necessary. More... | |
bool | validate_new_connection_ |
Flag that indicates if address validation is required. More... | |
Additional Inherited Members | |
Public Types inherited from ACE_Handler | |
typedef ACE_Refcounted_Auto_Ptr< Proxy, ACE_SYNCH_MUTEX > | Proxy_Ptr |
Protected Attributes inherited from ACE_Handler | |
ACE_Proactor * | proactor_ |
The proactor associated with this handler. More... | |
ACE_HANDLE | handle_ |
The ACE_HANDLE in use with this handler. More... | |
ACE_Refcounted_Auto_Ptr< Proxy, ACE_SYNCH_MUTEX > | proxy_ |
Refers to proxy for this handler. More... | |
This class is an example of the Connector pattern. This class will establish new connections and create new HANDLER objects to handle the new connections.
Unlike the ACE_Connector, however, this class is designed to be used asynchronously with the ACE Proactor framework.
ACE_Asynch_Connector< HANDLER >::ACE_Asynch_Connector | ( | void | ) |
A do nothing constructor.
|
virtual |
Virtual destruction.
|
protected |
Return the asynch Connect object.
|
virtual |
This cancels all pending accepts operations that were issued by the calling thread.
|
virtual |
This initiates a new asynchronous connect.
|
protectedvirtual |
This is called when an outstanding accept completes.
Reimplemented from ACE_Handler.
|
protectedvirtual |
This is the template method used to create new handler. Subclasses must overwrite this method if a new handler creation strategy is required.
|
virtual |
This opens asynch connector
|
protected |
This parses the address from read buffer.
|
virtual |
Set and get flag that indicates if parsing and passing of addresses to the service_handler is necessary.
|
virtual |
|
virtual |
Template method to validate peer before service is opened. This method is called when the connection attempt completes, whether it succeeded or failed, if the validate_connection argument to open()
was non-zero or the validate_new_connection()
method is called to turn this feature on. The default implementation returns 0. Users can (and probably should) reimplement this method to learn about the success or failure of the connection attempt. If the connection completed successfully, this method can be used to perform validation of the peer using it's address, running an authentication procedure (such as SSL) or anything else necessary or desireable. The return value from this method determines whether or not ACE will continue opening the service or abort the connection.
result | Result of the connection acceptance. Use result.success() to determine success or failure of the connection attempt. |
remote | Peer's address. If the connection failed, this object is undefined. |
local | Local address connection was completed from. If the connection failed, this object is undefined. |
-1 | ACE_Asynch_Connector will close the connection, and the service will not be opened. |
0 | Service opening will proceeed. |
|
virtual |
Set and get flag that indicates if address validation is required.
|
virtual |
|
private |
Asynch_Connect used to make life easier :-)
|
private |
Flag that indicates if parsing of addresses is necessary.
|
private |
Flag that indicates if address validation is required.