Package com.google.inject.internal

Class InternalProvisionException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.google.inject.internal.InternalProvisionException

All Implemented Interfaces:

java.io.Serializable

public final class InternalProvisionException
extends java.lang.Exception

A checked exception for provisioning errors.

This is the internal dual of ProvisionException, similar to the relationship between ConfigurationException and ErrorsException. This is useful for several reasons:

• Since it is a checked exception, we get some assistance from the java compiler in ensuring that we correctly handle it everywhere. ProvisionException is unchecked.
• Since this is an internal package, we can add useful construction and mutation APIs that would be undesirable in a public supported API.

This exception will be thrown when errors are encountered during provisioning, ErrorsException will continue to be used for errors that are encountered during provisioning and both make use of the Message as the core model.

NOTE: this object stores a list of messages but in the most common case the cardinality will be 1. The only time that multiple errors might be reported via this mechanism is when errorInUserCode(com.google.inject.internal.ErrorId, java.lang.Throwable, java.lang.String, java.lang.Object...) is called with an exception that holds multiple errors (like ProvisionException).

See Also:

Serialized Form

Method Summary

Modifier and Type	Method	Description
static InternalProvisionException	cannotProxyClass(java.lang.Class<?> expectedType)
static InternalProvisionException	circularDependenciesDisabled(java.lang.Class<?> expectedType)
static InternalProvisionException	create(ErrorId errorId, java.lang.String format, java.lang.Object... arguments)
static InternalProvisionException	errorInjectingConstructor(java.lang.Throwable cause)
static InternalProvisionException	errorInjectingMethod(java.lang.Throwable cause)
static InternalProvisionException	errorInProvider(java.lang.Throwable cause)
static InternalProvisionException	errorInUserCode(ErrorId errorId, java.lang.Throwable cause, java.lang.String messageFormat, java.lang.Object... arguments)
static InternalProvisionException	errorInUserInjector(MembersInjector<?> listener, TypeLiteral<?> type, java.lang.RuntimeException cause)
static InternalProvisionException	errorNotifyingInjectionListener(InjectionListener<?> listener, TypeLiteral<?> type, java.lang.RuntimeException cause)
static InternalProvisionException	jitDisabled(Key<?> key)
static InternalProvisionException	subtypeNotProvided(java.lang.Class<? extends javax.inject.Provider<?>> providerType, java.lang.Class<?> type)
ProvisionException	toProvisionException()	Returns this exception convered to a ProvisionException.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

circularDependenciesDisabled

public static InternalProvisionException circularDependenciesDisabled(java.lang.Class<?> expectedType)

cannotProxyClass

public static InternalProvisionException cannotProxyClass(java.lang.Class<?> expectedType)

create

public static InternalProvisionException create(ErrorId errorId,
                                                java.lang.String format,
                                                java.lang.Object... arguments)

errorInUserCode

public static InternalProvisionException errorInUserCode(ErrorId errorId,
                                                         java.lang.Throwable cause,
                                                         java.lang.String messageFormat,
                                                         java.lang.Object... arguments)

subtypeNotProvided

public static InternalProvisionException subtypeNotProvided(java.lang.Class<? extends javax.inject.Provider<?>> providerType,
                                                            java.lang.Class<?> type)

errorInProvider

public static InternalProvisionException errorInProvider(java.lang.Throwable cause)

errorInjectingMethod

public static InternalProvisionException errorInjectingMethod(java.lang.Throwable cause)

errorInjectingConstructor

public static InternalProvisionException errorInjectingConstructor(java.lang.Throwable cause)

errorInUserInjector

public static InternalProvisionException errorInUserInjector(MembersInjector<?> listener,
                                                             TypeLiteral<?> type,
                                                             java.lang.RuntimeException cause)

jitDisabled

public static InternalProvisionException jitDisabled(Key<?> key)

errorNotifyingInjectionListener

public static InternalProvisionException errorNotifyingInjectionListener(InjectionListener<?> listener,
                                                                         TypeLiteral<?> type,
                                                                         java.lang.RuntimeException cause)

toProvisionException

public ProvisionException toProvisionException()

Returns this exception convered to a ProvisionException.