pqian/httpclient-jmx

A set of self (un)registerable MBeans to manage instances of ClientConnectionManager and HttpClient.

httpclient-jmx

A set of self (un)registerable MBeans to manage instances of ClientConnectionManager and HttpClient.

Dependencies

• httpclient 4.2, use new PoolingClientConnectionManager instead of deprecated ThreadSafeClientConnManager
• slf4j-api

Features

• A global settings Mbean.
• Each ClientConnectionManager instance(i.e. PoolingClientConnectionManager at the moment) created with ClientConnMgrFactory has a settings MBean for it.
• Each HttpClient instance created with HttpClientFactory has a settings Mbean for it.
• Once an instance is collected by Java GC, its settings MBean will be be self unregistered automaticly.

Examples

// create a connMgr, and register a setting Mbean for it
ClientConnectionManager mgr = ClientConnMgrFactory.newInstance();

// reuse connMgr created above
mgr2 = ClientConnMgrFactory.newInstance(true);
assertSame(mgr, mg2);

// create a httpClient by default with an EXISTING connMgr, and register a settings Mbean for it
HttpClient clt = HttpClientFactory.newInstance();
assertSame(mgr, clt.getConnectionManager());

// create a httpClient with a NEW connMgr that is implicitly created
HttpClient clt2 = HttpClientFactory.newInstance(false);
assertNotSame(mgr, clt2.getConnectionManager());

// create a connMgr explicitly, maybe it comes from a legacy system
ClientConnectionManager pmgr = new PoolingClientConnectionManager();
// create httpClient using a specified connMgr, 
// if the connMgr is an instance of PoolingClientConnectionManager, register a Mbean for it. 
HttpClient clt3 = HttpClientFactory.newInstance(pmgr);