A manager for asynchronous event demultiplexing. This class is the base class for all the concrete implementation classes.
#include <ace/Proactor_Impl.h>
class ACE_Proactor_Impl : public ACE_Event_Handler {
public:
inline virtual ~ACE_Proactor_Impl (void);
virtual int close (void) = 0;
virtual int register_handle ( ACE_HANDLE handle, const void *completion_key ) = 0;
virtual int handle_events (ACE_Time_Value &wait_time) = 0;
virtual int handle_events (void) = 0;
virtual int wake_up_dispatch_threads (void) = 0;
virtual int close_dispatch_threads (int wait) = 0;
virtual size_t number_of_threads (void) const = 0;
virtual void number_of_threads (size_t threads) = 0;
virtual ACE_HANDLE get_handle (void) const = 0;
= Factory methods for the operations virtual ACE_Asynch_Read_Stream_Impl *create_asynch_read_stream ( void ) = 0;
virtual ACE_Asynch_Write_Stream_Impl *create_asynch_write_stream ( void ) = 0;
virtual ACE_Asynch_Read_File_Impl *create_asynch_read_file ( void ) = 0;
virtual ACE_Asynch_Write_File_Impl *create_asynch_write_file ( void ) = 0;
virtual ACE_Asynch_Accept_Impl *create_asynch_accept (void) = 0;
virtual ACE_Asynch_Transmit_File_Impl *create_asynch_transmit_file ( void ) = 0;
= Factory methods for the results virtual ACE_Asynch_Read_Stream_Result_Impl *create_asynch_read_stream_result ( ACE_Handler &handler, ACE_HANDLE handle, ACE_Message_Block &message_block, u_long bytes_to_read, const void* act, ACE_HANDLE event = ACE_INVALID_HANDLE, int priority = 0, int signal_number = ACE_SIGRTMIN ) = 0;
virtual ACE_Asynch_Write_Stream_Result_Impl *create_asynch_write_stream_result ( ACE_Handler &handler, ACE_HANDLE handle, ACE_Message_Block &message_block, u_long bytes_to_write, const void* act, ACE_HANDLE event = ACE_INVALID_HANDLE, int priority = 0, int signal_number = ACE_SIGRTMIN ) = 0;
virtual ACE_Asynch_Read_File_Result_Impl *create_asynch_read_file_result ( ACE_Handler &handler, ACE_HANDLE handle, ACE_Message_Block &message_block, u_long bytes_to_read, const void* act, u_long offset, u_long offset_high, ACE_HANDLE event = ACE_INVALID_HANDLE, int priority = 0, int signal_number = ACE_SIGRTMIN ) = 0;
virtual ACE_Asynch_Write_File_Result_Impl *create_asynch_write_file_result ( ACE_Handler &handler, ACE_HANDLE handle, ACE_Message_Block &message_block, u_long bytes_to_write, const void* act, u_long offset, u_long offset_high, ACE_HANDLE event = ACE_INVALID_HANDLE, int priority = 0, int signal_number = ACE_SIGRTMIN ) = 0;
virtual ACE_Asynch_Accept_Result_Impl *create_asynch_accept_result ( ACE_Handler &handler, ACE_HANDLE listen_handle, ACE_HANDLE accept_handle, ACE_Message_Block &message_block, u_long bytes_to_read, const void* act, ACE_HANDLE event = ACE_INVALID_HANDLE, int priority = 0, int signal_number = ACE_SIGRTMIN ) = 0;
virtual ACE_Asynch_Transmit_File_Result_Impl *create_asynch_transmit_file_result ( ACE_Handler &handler, ACE_HANDLE socket, ACE_HANDLE file, ACE_Asynch_Transmit_File::Header_And_Trailer *header_and_trailer, u_long bytes_to_write, u_long offset, u_long offset_high, u_long bytes_per_send, u_long flags, const void *act, ACE_HANDLE event = ACE_INVALID_HANDLE, int priority = 0, int signal_number = ACE_SIGRTMIN ) = 0;
virtual ACE_Asynch_Result_Impl *create_asynch_timer ( ACE_Handler &handler, const void *act, const ACE_Time_Value &tv, ACE_HANDLE event = ACE_INVALID_HANDLE, int priority = 0, int signal_number = 0 ) = 0;
virtual int post_wakeup_completions (int how_many) = 0;
};
See the Proactor pattern description at http://www.cs.wustl.edu/~schmidt/proactor.ps.gz for more details.
inline virtual ~ACE_Proactor_Impl (void);
virtual int close (void) = 0;
virtual int register_handle (
ACE_HANDLE handle,
const void *completion_key
) = 0;
handle
to the I/O completion port. This
function is a no-op function for Unix systems.
virtual int handle_events (ACE_Time_Value &wait_time) = 0;
wait_time
elapses before
any events occur, return 0. Return 1 on success i.e., when a
completion is dispatched, non-zero (-1) on errors and errno is
set accordingly.
virtual int handle_events (void) = 0;
wait_time
elapses before
any events occur, return 0. Return 1 on success i.e., when a
completion is dispatched, non-zero (-1) on errors and errno is
set accordingly.
virtual int wake_up_dispatch_threads (void) = 0;
virtual int close_dispatch_threads (int wait) = 0;
virtual size_t number_of_threads (void) const = 0;
virtual void number_of_threads (size_t threads) = 0;
virtual ACE_HANDLE get_handle (void) const = 0;
= Factory methods for the operations virtual ACE_Asynch_Read_Stream_Impl *create_asynch_read_stream (
void
) = 0;
virtual ACE_Asynch_Write_Stream_Impl *create_asynch_write_stream (
void
) = 0;
virtual ACE_Asynch_Read_File_Impl *create_asynch_read_file (void) = 0;
virtual ACE_Asynch_Write_File_Impl *create_asynch_write_file (
void
) = 0;
virtual ACE_Asynch_Accept_Impl *create_asynch_accept (void) = 0;
virtual ACE_Asynch_Transmit_File_Impl *create_asynch_transmit_file (
void
) = 0;
= Factory methods for the results virtual ACE_Asynch_Read_Stream_Result_Impl *create_asynch_read_stream_result (
ACE_Handler &handler,
ACE_HANDLE handle,
ACE_Message_Block &message_block,
u_long bytes_to_read,
const void* act,
ACE_HANDLE event = ACE_INVALID_HANDLE,
int priority = 0,
int signal_number = ACE_SIGRTMIN
) = 0;
virtual ACE_Asynch_Write_Stream_Result_Impl *create_asynch_write_stream_result (
ACE_Handler &handler,
ACE_HANDLE handle,
ACE_Message_Block &message_block,
u_long bytes_to_write,
const void* act,
ACE_HANDLE event = ACE_INVALID_HANDLE,
int priority = 0,
int signal_number = ACE_SIGRTMIN
) = 0;
virtual ACE_Asynch_Read_File_Result_Impl *create_asynch_read_file_result (
ACE_Handler &handler,
ACE_HANDLE handle,
ACE_Message_Block &message_block,
u_long bytes_to_read,
const void* act,
u_long offset,
u_long offset_high,
ACE_HANDLE event = ACE_INVALID_HANDLE,
int priority = 0,
int signal_number = ACE_SIGRTMIN
) = 0;
virtual ACE_Asynch_Write_File_Result_Impl *create_asynch_write_file_result (
ACE_Handler &handler,
ACE_HANDLE handle,
ACE_Message_Block &message_block,
u_long bytes_to_write,
const void* act,
u_long offset,
u_long offset_high,
ACE_HANDLE event = ACE_INVALID_HANDLE,
int priority = 0,
int signal_number = ACE_SIGRTMIN
) = 0;
virtual ACE_Asynch_Accept_Result_Impl *create_asynch_accept_result (
ACE_Handler &handler,
ACE_HANDLE listen_handle,
ACE_HANDLE accept_handle,
ACE_Message_Block &message_block,
u_long bytes_to_read,
const void* act,
ACE_HANDLE event = ACE_INVALID_HANDLE,
int priority = 0,
int signal_number = ACE_SIGRTMIN
) = 0;
virtual ACE_Asynch_Transmit_File_Result_Impl *create_asynch_transmit_file_result (
ACE_Handler &handler,
ACE_HANDLE socket,
ACE_HANDLE file,
ACE_Asynch_Transmit_File::Header_And_Trailer *header_and_trailer,
u_long bytes_to_write,
u_long offset,
u_long offset_high,
u_long bytes_per_send,
u_long flags,
const void *act,
ACE_HANDLE event = ACE_INVALID_HANDLE,
int priority = 0,
int signal_number = ACE_SIGRTMIN
) = 0;
virtual ACE_Asynch_Result_Impl *create_asynch_timer (
ACE_Handler &handler,
const void *act,
const ACE_Time_Value &tv,
ACE_HANDLE event = ACE_INVALID_HANDLE,
int priority = 0,
int signal_number = 0
) = 0;
virtual int post_wakeup_completions (int how_many) = 0;
how_many
completions to the completion port so that all
threads can wake up. This is used in conjunction with the
run_event_loop
.
alex@cs.wustl.edu