svn commit: r1021752 - /commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/WhenExhaustedAction.java

[si...@apache.org]

Author: simonetripodi
Date: Tue Oct 12 12:01:38 2010
New Revision: 1021752

URL: http://svn.apache.org/viewvc?rev=1021752&view=rev
Log:
first checkin of WhenExhaustedAction enumeration
implemented as separate class since it's shared between all Generic(Keyed)?ObjectPool(Factory)? components

Added:
    commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/WhenExhaustedAction.java   (with props)

Added: commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/WhenExhaustedAction.java
URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/WhenExhaustedAction.java?rev=1021752&view=auto
==============================================================================
--- commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/WhenExhaustedAction.java (added)
+++ commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/WhenExhaustedAction.java Tue Oct 12 12:01:38 2010
@@ -0,0 +1,49 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.pool.impl;
+
+import java.util.NoSuchElementException;
+
+/**
+ * A "when exhausted action" type indicating that when the pool is
+ * exhausted (i.e., the maximum number of active objects has
+ * been reached).
+ *
+ * @version $Revision$ $Date$
+ * @since Pool 2.0
+ */
+public enum WhenExhaustedAction {
+
+    /**
+     * The {@code borrowObject()} method should fail, throwing a
+     * {@link NoSuchElementException}.
+     */
+    FAIL,
+
+    /**
+     * The {@code borrowObject()} method should block until a new
+     * object is available, or the {@link #getMaxWait maximum wait time}
+     * has been reached.
+     */
+    BLOCK,
+
+    /**
+     * The {@code borrowObject()} method should simply create a
+     * new object anyway.
+     */
+    GROW
+}

Propchange: commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/WhenExhaustedAction.java
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/WhenExhaustedAction.java
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Propchange: commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/WhenExhaustedAction.java
------------------------------------------------------------------------------
    svn:mime-type = text/plain