[POOL-64] [pool] proposed ObjectPools.getNum{Active,Idle} JavaDoc changes for 2.0

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: 1.3

Environment

Operating System: All
Platform: All

• Bugzilla Id: 38666
• Assignee: Unassigned
• Reporter: Sandy McArthur (from Bugzilla import)
• Created: 16/Feb/06 07:06
• Updated: 12/Sep/10 17:42
• Resolved: 12/Sep/10 17:42

Description

Attached are the pool 2.0 changes I'd like to see to the ObjectPool and the
KeyedObjectPool interfaces for the getNumActive and the getNumIdle methods. The
noteworthy changes are:

• those methods are declared to return a negative value to indicate they do not
  support the requested operation. Currently they throw an
  UnsupportedOperationException. The throwing of UOE is documented at deprecated
  and I hope to remove that in Pool 3.0. Since UOE is a RuntimeException removing
  it will not cause any API compatibility problems.