Author: gavin.king(a)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>&#064;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 {