[weld-commits] Weld SVN: r4321 - in api/trunk/cdi/src/main/java/javax/enterprise: event and 1 other directories.
weld-commits at lists.jboss.org
weld-commits at lists.jboss.org
Mon Oct 26 00:59:00 EDT 2009
Author: gavin.king at jboss.com
Date: 2009-10-26 00:59:00 -0400 (Mon, 26 Oct 2009)
New Revision: 4321
Modified:
api/trunk/cdi/src/main/java/javax/enterprise/context/ContextException.java
api/trunk/cdi/src/main/java/javax/enterprise/event/ObserverException.java
api/trunk/cdi/src/main/java/javax/enterprise/inject/AmbiguousResolutionException.java
api/trunk/cdi/src/main/java/javax/enterprise/inject/CreationException.java
api/trunk/cdi/src/main/java/javax/enterprise/inject/IllegalProductException.java
api/trunk/cdi/src/main/java/javax/enterprise/inject/InjectionException.java
api/trunk/cdi/src/main/java/javax/enterprise/inject/Instance.java
api/trunk/cdi/src/main/java/javax/enterprise/inject/ResolutionException.java
api/trunk/cdi/src/main/java/javax/enterprise/inject/UnproxyableResolutionException.java
api/trunk/cdi/src/main/java/javax/enterprise/inject/UnsatisfiedResolutionException.java
Log:
doc remaining exceptions
Modified: api/trunk/cdi/src/main/java/javax/enterprise/context/ContextException.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/context/ContextException.java 2009-10-26 02:55:21 UTC (rev 4320)
+++ api/trunk/cdi/src/main/java/javax/enterprise/context/ContextException.java 2009-10-26 04:59:00 UTC (rev 4321)
@@ -19,12 +19,11 @@
/**
- * The base type for any context-related exceptions.
+ * <p>Indicates a problem relating to context management.</p>
*
* @author Pete Muir
* @author Shane Bryzak
*/
-
public class ContextException extends RuntimeException
{
Modified: api/trunk/cdi/src/main/java/javax/enterprise/event/ObserverException.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/event/ObserverException.java 2009-10-26 02:55:21 UTC (rev 4320)
+++ api/trunk/cdi/src/main/java/javax/enterprise/event/ObserverException.java 2009-10-26 04:59:00 UTC (rev 4321)
@@ -18,14 +18,12 @@
package javax.enterprise.event;
/**
- * <p>Wraps checked exceptions thrown by observer methods
- * during event notification, allowing them to be rethrown
- * by the container.</p>
+ * <p>Indicates that a checked exception was thrown by an
+ * observer method during event notification.</p>
*
* @author Pete Muir
* @author Gavin King
*/
-
public class ObserverException extends RuntimeException
{
Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/AmbiguousResolutionException.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/AmbiguousResolutionException.java 2009-10-26 02:55:21 UTC (rev 4320)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/AmbiguousResolutionException.java 2009-10-26 04:59:00 UTC (rev 4321)
@@ -14,15 +14,16 @@
* See the License for the specific language governing permissions and
* limitations under the License.
*/
-
package javax.enterprise.inject;
/**
- * Thrown when the set of enabled beans with the required bean type and
- * qualifiers contains multiple beans.
+ * <p>Indicates that multiple beans match a certain combination of required
+ * type and required qualifiers and are eligible for injection into a
+ * certain class.</p>
*
* @author Pete Muir
+ * @author Gavin King
*/
public class AmbiguousResolutionException extends ResolutionException
{
Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/CreationException.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/CreationException.java 2009-10-26 02:55:21 UTC (rev 4320)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/CreationException.java 2009-10-26 04:59:00 UTC (rev 4321)
@@ -19,9 +19,11 @@
/**
- * Wraps any checked exceptions which occur during creation of a bean.
+ * <p>Indicates that a checked exception was thrown during
+ * creation of a bean.</p>
*
* @author Pete Muir
+ * @author Gavin King
*/
public class CreationException extends InjectionException
{
Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/IllegalProductException.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/IllegalProductException.java 2009-10-26 02:55:21 UTC (rev 4320)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/IllegalProductException.java 2009-10-26 04:59:00 UTC (rev 4321)
@@ -18,9 +18,9 @@
/**
- * Thrown if a producer method returns a null value or a producer
- * field contains a null value, and the scope of the method or
- * field is not <tt>@Dependent</tt>.
+ * <p>Indicates that a producer method returned a null value or a producer
+ * field contained a null value, and the scope of the producer method
+ * or field was not {@link javax.enterprise.context.Dependent}.</p>
*/
public class IllegalProductException extends InjectionException
{
Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/InjectionException.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/InjectionException.java 2009-10-26 02:55:21 UTC (rev 4320)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/InjectionException.java 2009-10-26 04:59:00 UTC (rev 4321)
@@ -19,9 +19,8 @@
/**
- * Indicates a problem relating to dependency injection.
+ * <t>Indicates a problem relating to dependency injection.</t>
*
- *
* @author Pete Muir
*/
public class InjectionException extends RuntimeException
Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/Instance.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/Instance.java 2009-10-26 02:55:21 UTC (rev 4320)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/Instance.java 2009-10-26 04:59:00 UTC (rev 4321)
@@ -79,9 +79,9 @@
*
* <p>The inherited {@link javax.inject.Provider#get()} method returns a
* contextual references for the unique bean that matches the required
- * type and required qualifiers and is eligible for injection into the class
- * into which the parent <tt>Instance</tt> was injected, or throws an
- * {@link javax.enterprise.inject.UnsatisfiedResolutionException} or
+ * type and required qualifiers and is eligible for injection into the
+ * class into which the parent <tt>Instance</tt> was injected, or throws
+ * an {@link javax.enterprise.inject.UnsatisfiedResolutionException} or
* {@link javax.enterprise.inject.AmbiguousResolutionException}.</p>
*
* <pre>PaymentProcessor pp = chequePaymentProcessor.get();</pre>
Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/ResolutionException.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/ResolutionException.java 2009-10-26 02:55:21 UTC (rev 4320)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/ResolutionException.java 2009-10-26 04:59:00 UTC (rev 4321)
@@ -18,7 +18,9 @@
/**
- * Thrown if resolution fails
+ * <t>Indicates a problem relating to typesafe resolution.</t>
+ *
+ * @author Gavin King
*/
public class ResolutionException extends InjectionException
{
Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/UnproxyableResolutionException.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/UnproxyableResolutionException.java 2009-10-26 02:55:21 UTC (rev 4320)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/UnproxyableResolutionException.java 2009-10-26 04:59:00 UTC (rev 4321)
@@ -25,6 +25,7 @@
* be proxied by the container.</p>
*
* @author Pete Muir
+ * @author Gavin King
*/
public class UnproxyableResolutionException extends ResolutionException
{
Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/UnsatisfiedResolutionException.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/UnsatisfiedResolutionException.java 2009-10-26 02:55:21 UTC (rev 4320)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/UnsatisfiedResolutionException.java 2009-10-26 04:59:00 UTC (rev 4321)
@@ -14,16 +14,15 @@
* See the License for the specific language governing permissions and
* limitations under the License.
*/
-
-
package javax.enterprise.inject;
-
/**
- * Thrown when the set of enabled beans with the required bean type
- * and qualifiers is empty.
+ * <p>Indicates that no bean matches a certain combination of required
+ * type and required qualifiers and is eligible for injection into a
+ * certain class.</p>
*
* @author Pete Muir
+ * @author Gavin King
*/
public class UnsatisfiedResolutionException extends ResolutionException
{
More information about the weld-commits
mailing list