How to use

clear

method

in

org.apache.commons.pool.impl.StackObjectPool

/**
 * <p>Close this pool, and free any resources associated with it. Invokes
 * {@link #clear()} to destroy and remove instances in the pool.</p>
 * 
 * <p>Calling {@link #addObject} or {@link #borrowObject} after invoking
 * this method on a pool will cause them to throw an
 * {@link IllegalStateException}.</p>
 *
 * @throws Exception never - exceptions clearing the pool are swallowed
 */
@Override
public void close() throws Exception {
  super.close();
  clear();
}

/**
 * Sets the {@link PoolableObjectFactory factory} this pool uses
 * to create new instances. Trying to change
 * the <code>factory</code> while there are borrowed objects will
 * throw an {@link IllegalStateException}.
 *
 * @param factory the {@link PoolableObjectFactory} used to create new instances.
 * @throws IllegalStateException when the factory cannot be set at this time
 * @deprecated to be removed in pool 2.0
 */
@Deprecated
@Override
public synchronized void setFactory(PoolableObjectFactory<T> factory) throws IllegalStateException {
  assertOpen();
  if(0 < getNumActive()) {
    throw new IllegalStateException("Objects are already active");
  } else {
    clear();
    _factory = factory;
  }
}

/**
 * <p>Close this pool, and free any resources associated with it. Invokes
 * {@link #clear()} to destroy and remove instances in the pool.</p>
 * 
 * <p>Calling {@link #addObject} or {@link #borrowObject} after invoking
 * this method on a pool will cause them to throw an
 * {@link IllegalStateException}.</p>
 *
 * @throws Exception never - exceptions clearing the pool are swallowed
 */
@Override
public void close() throws Exception {
  super.close();
  clear();
}

/**
 * <p>Close this pool, and free any resources associated with it. Invokes
 * {@link #clear()} to destroy and remove instances in the pool.</p>
 * 
 * <p>Calling {@link #addObject} or {@link #borrowObject} after invoking
 * this method on a pool will cause them to throw an
 * {@link IllegalStateException}.</p>
 *
 * @throws Exception never - exceptions clearing the pool are swallowed
 */
@Override
public void close() throws Exception {
  super.close();
  clear();
}

/**
 * Close this pool, and free any resources associated with it.
 * <p>
 * Calling {@link #addObject} or {@link #borrowObject} after invoking
 * this method on a pool will cause them to throw an
 * {@link IllegalStateException}.
 * </p>
 *
 * @throws Exception <strong>deprecated</strong>: implementations should silently fail if not all resources can be freed.
 */
public void close() throws Exception {
  super.close();
  clear();
}

/**
 * Close this pool, and free any resources associated with it.
 * <p>
 * Calling {@link #addObject} or {@link #borrowObject} after invoking
 * this method on a pool will cause them to throw an
 * {@link IllegalStateException}.
 * </p>
 *
 * @throws Exception <strong>deprecated</strong>: implementations should silently fail if not all resources can be freed.
 */
public void close() throws Exception {
  super.close();
  clear();
}

/**
 * Sets the {@link PoolableObjectFactory factory} this pool uses
 * to create new instances. Trying to change
 * the <code>factory</code> while there are borrowed objects will
 * throw an {@link IllegalStateException}.
 *
 * @param factory the {@link PoolableObjectFactory} used to create new instances.
 * @throws IllegalStateException when the factory cannot be set at this time
 * @deprecated to be removed in pool 2.0
 */
@Deprecated
@Override
public synchronized void setFactory(PoolableObjectFactory<T> factory) throws IllegalStateException {
  assertOpen();
  if(0 < getNumActive()) {
    throw new IllegalStateException("Objects are already active");
  } else {
    clear();
    _factory = factory;
  }
}

/**
 * Sets the {@link PoolableObjectFactory factory} this pool uses
 * to create new instances. Trying to change
 * the <code>factory</code> while there are borrowed objects will
 * throw an {@link IllegalStateException}.
 *
 * @param factory the {@link PoolableObjectFactory} used to create new instances.
 * @throws IllegalStateException when the factory cannot be set at this time
 * @deprecated to be removed in pool 2.0
 */
@Deprecated
@Override
public synchronized void setFactory(PoolableObjectFactory<T> factory) throws IllegalStateException {
  assertOpen();
  if(0 < getNumActive()) {
    throw new IllegalStateException("Objects are already active");
  } else {
    clear();
    _factory = factory;
  }
}

/**
 * Sets the {@link PoolableObjectFactory factory} this pool uses
 * to create new instances. Trying to change
 * the <code>factory</code> while there are borrowed objects will
 * throw an {@link IllegalStateException}.
 *
 * @param factory the {@link PoolableObjectFactory} used to create new instances.
 * @throws IllegalStateException when the factory cannot be set at this time
 */
public synchronized void setFactory(PoolableObjectFactory factory) throws IllegalStateException {
  assertOpen();
  if(0 < getNumActive()) {
    throw new IllegalStateException("Objects are already active");
  } else {
    clear();
    _factory = factory;
  }
}

/**
 * Sets the {@link PoolableObjectFactory factory} this pool uses
 * to create new instances. Trying to change
 * the <code>factory</code> while there are borrowed objects will
 * throw an {@link IllegalStateException}.
 *
 * @param factory the {@link PoolableObjectFactory} used to create new instances.
 * @throws IllegalStateException when the factory cannot be set at this time
 */
public synchronized void setFactory(PoolableObjectFactory factory) throws IllegalStateException {
  assertOpen();
  if(0 < getNumActive()) {
    throw new IllegalStateException("Objects are already active");
  } else {
    clear();
    _factory = factory;
  }
}