Abstract factory for creating a service handler (SVC_HANDLER), accepting into the SVC_HANDLER, and activating the SVC_HANDLER. More...
#include <Acceptor.h>


Public Types | |
| typedef ACE_PEER_ACCEPTOR_ADDR | addr_type |
| typedef ACE_PEER_ACCEPTOR | acceptor_type |
| typedef SVC_HANDLER | handler_type |
| typedef SVC_HANDLER::stream_type | stream_type |
Public Member Functions | |
| ACE_Acceptor (ACE_Reactor *=0, int use_select=1) | |
| "Do-nothing" constructor. | |
| ACE_Acceptor (const ACE_PEER_ACCEPTOR_ADDR &local_addr, ACE_Reactor *reactor=ACE_Reactor::instance(), int flags=0, int use_select=1, int reuse_addr=1) | |
| virtual int | open (const ACE_PEER_ACCEPTOR_ADDR &local_addr, ACE_Reactor *reactor=ACE_Reactor::instance(), int flags=0, int use_select=1, int reuse_addr=1) |
| virtual | ~ACE_Acceptor (void) |
| Close down the Acceptor's resources. | |
| virtual | operator ACE_PEER_ACCEPTOR & () const |
| Return the underlying PEER_ACCEPTOR object. | |
| virtual ACE_PEER_ACCEPTOR & | acceptor (void) const |
| Return the underlying PEER_ACCEPTOR object. | |
| virtual ACE_HANDLE | get_handle (void) const |
| Returns the listening acceptor's {ACE_HANDLE}. | |
| virtual int | close (void) |
| Close down the Acceptor. | |
| virtual int | handle_accept_error (void) |
| void | dump (void) const |
| Dump the state of an object. | |
| virtual int | suspend (void) |
| This method calls {Reactor::suspend}. | |
| virtual int | resume (void) |
| This method calls {Reactor::resume}. | |
Public Attributes | |
| ACE_ALLOC_HOOK_DECLARE | |
| Declare the dynamic allocation hooks. | |
Protected Member Functions | |
| virtual int | make_svc_handler (SVC_HANDLER *&sh) |
| virtual int | accept_svc_handler (SVC_HANDLER *svc_handler) |
| virtual int | activate_svc_handler (SVC_HANDLER *svc_handler) |
| virtual int | handle_close (ACE_HANDLE=ACE_INVALID_HANDLE, ACE_Reactor_Mask=ACE_Event_Handler::ALL_EVENTS_MASK) |
| virtual int | handle_input (ACE_HANDLE) |
| virtual int | init (int argc, ACE_TCHAR *argv[]) |
| virtual int | fini (void) |
| Calls {handle_close}. | |
| virtual int | info (ACE_TCHAR **buf, size_t) const |
| Default version returns address info in {buf}. | |
Protected Attributes | |
| ACE_PEER_ACCEPTOR | peer_acceptor_ |
| Concrete factory for accepting connections from clients... | |
| ACE_PEER_ACCEPTOR_ADDR | peer_acceptor_addr_ |
| Needed to reopen the socket if {accept} fails. | |
| int | flags_ |
| int | use_select_ |
| int | reuse_addr_ |
| Needed to reopen the socket if {accept} fails. | |
Abstract factory for creating a service handler (SVC_HANDLER), accepting into the SVC_HANDLER, and activating the SVC_HANDLER.
Implements the basic strategy for passively establishing connections with clients. An ACE_Acceptor is parameterized by concrete types that conform to the interfaces of PEER_ACCEPTOR and SVC_HANDLER. The PEER_ACCEPTOR is instantiated with a transport mechanism that passively establishes connections. The SVC_HANDLER is instantiated with a concrete type that performs the application-specific service. An ACE_Acceptor inherits from ACE_Service_Object, which in turn inherits from ACE_Event_Handler. This enables the ACE_Reactor to dispatch the ACE_Acceptor's handle_input method when connection events occur. The handle_input method performs the ACE_Acceptor's default creation, connection establishment, and service activation strategies. These strategies can be overridden by subclasses individually or as a group.
| typedef ACE_PEER_ACCEPTOR ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::acceptor_type |
| typedef ACE_PEER_ACCEPTOR_ADDR ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::addr_type |
| typedef SVC_HANDLER ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::handler_type |
| typedef SVC_HANDLER::stream_type ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::stream_type |
| ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::ACE_Acceptor | ( | ACE_Reactor * | = 0, |
|
| int | use_select = 1 | |||
| ) |
"Do-nothing" constructor.
| ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::ACE_Acceptor | ( | const ACE_PEER_ACCEPTOR_ADDR & | local_addr, | |
| ACE_Reactor * | reactor = ACE_Reactor::instance(), |
|||
| int | flags = 0, |
|||
| int | use_select = 1, |
|||
| int | reuse_addr = 1 | |||
| ) |
Open the contained PEER_ACCEPTOR object to begin listening, and register with the specified reactor for accept events. An acceptor can only listen to one port at a time, so make sure to close() the acceptor before calling open() again.
The PEER_ACCEPTOR handle is put into non-blocking mode as a safeguard against the race condition that can otherwise occur between the time when the passive-mode socket handle is "ready" and when the actual accept() call is made. During this interval, the client can shutdown the connection, in which case, the accept() call can hang.
| local_addr | The address to listen at. | |
| reactor | Pointer to the ACE_Reactor instance to register this object with. The default is the singleton. | |
| flags | Flags to control what mode an accepted socket will be put into after it is accepted. The only legal value for this argument is ACE_NONBLOCK, which enables non-blocking mode on the accepted peer stream object in SVC_HANDLER. The default is 0. | |
| use_select | Affects behavior when called back by the reactor when a connection can be accepted. If non-zero, this object will accept all pending connections, instead of just the one that triggered the reactor callback. Uses ACE_OS::select() internally to detect any remaining acceptable connections. The default is 1. | |
| reuse_addr | Passed to the PEER_ACCEPTOR::open() method with local_addr. Generally used to request that the OS allow reuse of the listen port. The default is 1. |
| virtual ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::~ACE_Acceptor | ( | void | ) | [virtual] |
Close down the Acceptor's resources.
| virtual int ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::accept_svc_handler | ( | SVC_HANDLER * | svc_handler | ) | [protected, virtual] |
Bridge method for accepting the new connection into the svc_handler. The default behavior delegates to the PEER_ACCEPTOR::accept.
Reimplemented in ACE_Strategy_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >.
| virtual ACE_PEER_ACCEPTOR& ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::acceptor | ( | void | ) | const [virtual] |
Return the underlying PEER_ACCEPTOR object.
Reimplemented in ACE_Strategy_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >.
| virtual int ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::activate_svc_handler | ( | SVC_HANDLER * | svc_handler | ) | [protected, virtual] |
Bridge method for activating a {svc_handler} with the appropriate concurrency strategy. The default behavior of this method is to activate the SVC_HANDLER by calling its {open} method (which allows the SVC_HANDLER to define its own concurrency strategy). However, subclasses can override this strategy to do more sophisticated concurrency activations (such as making the SVC_HANDLER as an "active object" via multi-threading or multi-processing).
Reimplemented in ACE_Strategy_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >.
| virtual int ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::close | ( | void | ) | [virtual] |
Close down the Acceptor.
| void ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::dump | ( | void | ) | const |
Dump the state of an object.
Reimplemented in ACE_Strategy_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >.
| virtual int ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::fini | ( | void | ) | [protected, virtual] |
Calls {handle_close}.
Reimplemented from ACE_Shared_Object.
Reimplemented in ACE_Strategy_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >.
| virtual ACE_HANDLE ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::get_handle | ( | void | ) | const [virtual] |
Returns the listening acceptor's {ACE_HANDLE}.
Reimplemented in ACE_Strategy_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >.
| virtual int ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::handle_accept_error | ( | void | ) | [virtual] |
In the event that an accept fails, this method will be called and the return value will be returned from handle_input().
| virtual int ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::handle_close | ( | ACE_HANDLE | = ACE_INVALID_HANDLE, |
|
| ACE_Reactor_Mask | = ACE_Event_Handler::ALL_EVENTS_MASK | |||
| ) | [protected, virtual] |
Perform termination activities when {this} is removed from the {reactor}.
Reimplemented in ACE_Strategy_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >.
| virtual int ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::handle_input | ( | ACE_HANDLE | ) | [protected, virtual] |
Accepts all pending connections from clients, and creates and activates SVC_HANDLERs.
| virtual int ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::info | ( | ACE_TCHAR ** | buf, | |
| size_t | ||||
| ) | const [protected, virtual] |
Default version returns address info in {buf}.
Reimplemented from ACE_Shared_Object.
Reimplemented in ACE_Strategy_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >.
| virtual int ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::init | ( | int | argc, | |
| ACE_TCHAR * | argv[] | |||
| ) | [protected, virtual] |
Default version does no work and returns -1. Must be overloaded by application developer to do anything meaningful.
Reimplemented from ACE_Shared_Object.
| virtual int ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::make_svc_handler | ( | SVC_HANDLER *& | sh | ) | [protected, virtual] |
Bridge method for creating a SVC_HANDLER. The default is to create a new {SVC_HANDLER} if {sh} == 0, else {sh} is unchanged. However, subclasses can override this policy to perform SVC_HANDLER creation in any way that they like (such as creating subclass instances of SVC_HANDLER, using a singleton, dynamically linking the handler, etc.). Returns -1 on failure, else 0.
Reimplemented in ACE_Strategy_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >.
| virtual int ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::open | ( | const ACE_PEER_ACCEPTOR_ADDR & | local_addr, | |
| ACE_Reactor * | reactor = ACE_Reactor::instance(), |
|||
| int | flags = 0, |
|||
| int | use_select = 1, |
|||
| int | reuse_addr = 1 | |||
| ) | [virtual] |
Open the contained PEER_ACCEPTOR object to begin listening, and register with the specified reactor for accept events. An acceptor can only listen to one port at a time, so make sure to close() the acceptor before calling open() again.
The PEER_ACCEPTOR handle is put into non-blocking mode as a safeguard against the race condition that can otherwise occur between the time when the passive-mode socket handle is "ready" and when the actual accept() call is made. During this interval, the client can shutdown the connection, in which case, the accept() call can hang.
| local_addr | The address to listen at. | |
| reactor | Pointer to the ACE_Reactor instance to register this object with. The default is the singleton. | |
| flags | Flags to control what mode an accepted socket will be put into after it is accepted. The only legal value for this argument is ACE_NONBLOCK, which enables non-blocking mode on the accepted peer stream object in SVC_HANDLER. The default is 0. | |
| use_select | Affects behavior when called back by the reactor when a connection can be accepted. If non-zero, this object will accept all pending connections, instead of just the one that triggered the reactor callback. Uses ACE_OS::select() internally to detect any remaining acceptable connections. The default is 1. | |
| reuse_addr | Passed to the PEER_ACCEPTOR::open() method with local_addr. Generally used to request that the OS allow reuse of the listen port. The default is 1. |
| 0 | Success | |
| -1 | Failure, errno contains an error code. |
Reimplemented in ACE_Strategy_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >.
| virtual ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::operator ACE_PEER_ACCEPTOR & | ( | ) | const [virtual] |
Return the underlying PEER_ACCEPTOR object.
Reimplemented in ACE_Strategy_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >.
| virtual int ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::resume | ( | void | ) | [virtual] |
This method calls {Reactor::resume}.
Reimplemented from ACE_Service_Object.
Reimplemented in ACE_Strategy_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >.
| virtual int ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::suspend | ( | void | ) | [virtual] |
This method calls {Reactor::suspend}.
Reimplemented from ACE_Service_Object.
Reimplemented in ACE_Strategy_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >.
| ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::ACE_ALLOC_HOOK_DECLARE |
Declare the dynamic allocation hooks.
Reimplemented in ACE_Strategy_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >.
int ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::flags_ [protected] |
Flags that indicate how {SVC_HANDLER}'s should be initialized prior to being activated. Right now, the only flag that is processed is {ACE_NONBLOCK}, which enabled non-blocking I/O on the {SVC_HANDLER} when it is opened.
ACE_PEER_ACCEPTOR ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::peer_acceptor_ [protected] |
Concrete factory for accepting connections from clients...
ACE_PEER_ACCEPTOR_ADDR ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::peer_acceptor_addr_ [protected] |
Needed to reopen the socket if {accept} fails.
int ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::reuse_addr_ [protected] |
Needed to reopen the socket if {accept} fails.
int ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_1 >::use_select_ [protected] |
Flag that indicates whether it shall use {select} in the {accept}-loop.
1.7.1