isc::http::HttpClientImpl Class Reference

HttpClient implementation. More...

Public Member Functions
	HttpClientImpl (IOService &io_service, size_t thread_pool_size=0, bool defer_thread_start=false)
	Constructor. More...
	~HttpClientImpl ()
	Destructor. More...
uint16_t	getThreadCount ()
	Fetches the number of threads in the pool. More...
asiolink::IOServicePtr	getThreadIOService ()
	Fetches the internal IOService used in multi-threaded mode. More...
uint16_t	getThreadPoolSize ()
	Fetches the maximum size of the thread pool. More...
bool	isPaused ()
	Indicates if the thread pool is paused. More...
bool	isRunning ()
	Indicates if the thread pool is running. More...
bool	isStopped ()
	Indicates if the thread pool is stopped. More...
void	pause ()
	Pauses the client's thread pool. More...
void	resume ()
	Resumes running the client's thread pool. More...
void	start ()
	Starts running the client's thread pool, if multi-threaded. More...
void	stop ()
	Close all connections, and if multi-threaded, stops the client's thread pool. More...

Public Attributes
ConnectionPoolPtr	conn_pool_
	Holds a pointer to the connection pool. More...

Detailed Description

HttpClient implementation.

Definition at line 1725 of file client.cc.

Constructor & Destructor Documentation

isc::http::HttpClientImpl::HttpClientImpl ( IOService &  io_service, size_t  thread_pool_size = 0, bool  defer_thread_start = false  )

inline

Constructor.

If single-threading:

• Creates the connection pool passing in the caller's IOService and a maximum number of connections per URL value of 1. If multi-threading:
• Creates a private IOService
• Creates a thread pool with the thread_pool_size threads
• Creates the connection pool passing the private IOService and the thread_pool_size as the maximum number of connections per URL.

Parameters

io_service	IOService that will drive connection IO in single threaded mode. (Currently ignored in multi-threaded mode)
thread_pool_size	maximum number of concurrent threads Internally this also sets the maximum number of concurrent connections per URL.
defer_thread_start	When true, starting of the pool threads is deferred until a subsequent call to start(). In this case the pool's operational state after construction is STOPPED. Otherwise, the thread pool threads will be created and started, with the operational state being RUNNING. Applicable only when thread-pool size is greater than zero.

Definition at line 1750 of file client.cc.

References conn_pool_, isc::log::DBGLVL_TRACE_BASIC, getThreadCount(), isc::http::HTTP_CLIENT_MT_STARTED, isc::http::http_logger, and LOG_DEBUG.

Here is the call graph for this function:

isc::http::HttpClientImpl::~HttpClientImpl ( )

inline

Destructor.

Calls stop().

Definition at line 1777 of file client.cc.

References stop().

Here is the call graph for this function:

Member Function Documentation

uint16_t isc::http::HttpClientImpl::getThreadCount ( )

inline

Fetches the number of threads in the pool.

Returns

the number of running threads.

Definition at line 1880 of file client.cc.

Referenced by HttpClientImpl().

asiolink::IOServicePtr isc::http::HttpClientImpl::getThreadIOService ( )

inline

Fetches the internal IOService used in multi-threaded mode.

Returns

A pointer to the IOService, or an empty pointer when in single-threaded mode.

Definition at line 1866 of file client.cc.

uint16_t isc::http::HttpClientImpl::getThreadPoolSize ( )

inline

Fetches the maximum size of the thread pool.

Returns

the maximum size of the thread pool.

Definition at line 1873 of file client.cc.

bool isc::http::HttpClientImpl::isPaused ( )

inline

Indicates if the thread pool is paused.

Returns

True if the thread pool exists and it is in the PAUSED state, false otherwise.

Definition at line 1854 of file client.cc.

bool isc::http::HttpClientImpl::isRunning ( )

inline

Indicates if the thread pool is running.

Returns

True if the thread pool exists and it is in the RUNNING state, false otherwise.

Definition at line 1830 of file client.cc.

bool isc::http::HttpClientImpl::isStopped ( )

inline

Indicates if the thread pool is stopped.

Returns

True if the thread pool exists and it is in the STOPPED state, false otherwise.

Definition at line 1842 of file client.cc.

void isc::http::HttpClientImpl::pause ( )

inline

Pauses the client's thread pool.

Suspends thread pool event processing.

Exceptions

InvalidOperation

if the thread pool does not exist.

Definition at line 1804 of file client.cc.

References isc_throw.

void isc::http::HttpClientImpl::resume ( )

inline

Resumes running the client's thread pool.

Resumes thread pool event processing.

Exceptions

InvalidOperation

if the thread pool does not exist.

Definition at line 1817 of file client.cc.

References isc_throw.

void isc::http::HttpClientImpl::start ( )

inline

Starts running the client's thread pool, if multi-threaded.

Definition at line 1782 of file client.cc.

void isc::http::HttpClientImpl::stop ( )

inline

Close all connections, and if multi-threaded, stops the client's thread pool.

Definition at line 1790 of file client.cc.

References conn_pool_.

Referenced by ~HttpClientImpl().

Member Data Documentation

ConnectionPoolPtr isc::http::HttpClientImpl::conn_pool_

Holds a pointer to the connection pool.

Definition at line 1888 of file client.cc.

Referenced by HttpClientImpl(), and stop().

---

The documentation for this class was generated from the following file:

• client.cc