Constructor Detail

• Errors

  public Errors()

• Errors

  public Errors(Object source)

Method Detail

• withSource

  public Errors withSource(Object source)

  Returns an instance that uses source as a reference point for newly added errors.

• missingImplementation

  public Errors missingImplementation(Key key)

  We use a fairly generic error message here. The motivation is to share the same message for both bind time errors:

  Guice.createInjector(new AbstractModule() {
     public void configure() {
       bind(Runnable.class);
     }
   }

  ...and at provide-time errors:

  Guice.createInjector().getInstance(Runnable.class);

  Otherwise we need to know who's calling when resolving a just-in-time binding, which makes things unnecessarily complex.

• jitDisabled

  public Errors jitDisabled(Key key)

• jitDisabledInParent

  public Errors jitDisabledInParent(Key<?> key)

• atInjectRequired

  public Errors atInjectRequired(Class clazz)

• converterReturnedNull

  public Errors converterReturnedNull(String stringValue,
                             Object source,
                             TypeLiteral<?> type,
                             TypeConverterBinding typeConverterBinding)

• conversionTypeError

  public Errors conversionTypeError(String stringValue,
                           Object source,
                           TypeLiteral<?> type,
                           TypeConverterBinding typeConverterBinding,
                           Object converted)

• conversionError

  public Errors conversionError(String stringValue,
                       Object source,
                       TypeLiteral<?> type,
                       TypeConverterBinding typeConverterBinding,
                       RuntimeException cause)

• ambiguousTypeConversion

  public Errors ambiguousTypeConversion(String stringValue,
                               Object source,
                               TypeLiteral<?> type,
                               TypeConverterBinding a,
                               TypeConverterBinding b)

• bindingToProvider

  public Errors bindingToProvider()

• subtypeNotProvided

  public Errors subtypeNotProvided(Class<? extends Provider<?>> providerType,
                          Class<?> type)

• notASubtype

  public Errors notASubtype(Class<?> implementationType,
                   Class<?> type)

• recursiveImplementationType

  public Errors recursiveImplementationType()

• recursiveProviderType

  public Errors recursiveProviderType()

• missingRuntimeRetention

  public Errors missingRuntimeRetention(Class<? extends Annotation> annotation)

• missingScopeAnnotation

  public Errors missingScopeAnnotation(Class<? extends Annotation> annotation)

• optionalConstructor

  public Errors optionalConstructor(Constructor constructor)

• cannotBindToGuiceType

  public Errors cannotBindToGuiceType(String simpleName)

• scopeNotFound

  public Errors scopeNotFound(Class<? extends Annotation> scopeAnnotation)

• scopeAnnotationOnAbstractType

  public Errors scopeAnnotationOnAbstractType(Class<? extends Annotation> scopeAnnotation,
                                     Class<?> type,
                                     Object source)

• misplacedBindingAnnotation

  public Errors misplacedBindingAnnotation(Member member,
                                  Annotation bindingAnnotation)

• missingConstructor

  public Errors missingConstructor(Class<?> implementation)

• tooManyConstructors

  public Errors tooManyConstructors(Class<?> implementation)

• constructorNotDefinedByType

  public Errors constructorNotDefinedByType(Constructor<?> constructor,
                                   TypeLiteral<?> type)

• duplicateScopes

  public Errors duplicateScopes(ScopeBinding existing,
                       Class<? extends Annotation> annotationType,
                       Scope scope)

• voidProviderMethod

  public Errors voidProviderMethod()

• missingConstantValues

  public Errors missingConstantValues()

• cannotInjectInnerClass

  public Errors cannotInjectInnerClass(Class<?> type)

• duplicateBindingAnnotations

  public Errors duplicateBindingAnnotations(Member member,
                                   Class<? extends Annotation> a,
                                   Class<? extends Annotation> b)

• staticInjectionOnInterface

  public Errors staticInjectionOnInterface(Class<?> clazz)

• cannotInjectFinalField

  public Errors cannotInjectFinalField(Field field)

• cannotInjectAbstractMethod

  public Errors cannotInjectAbstractMethod(Method method)

• cannotInjectNonVoidMethod

  public Errors cannotInjectNonVoidMethod(Method method)

• cannotInjectMethodWithTypeParameters

  public Errors cannotInjectMethodWithTypeParameters(Method method)

• duplicateScopeAnnotations

  public Errors duplicateScopeAnnotations(Class<? extends Annotation> a,
                                 Class<? extends Annotation> b)

• recursiveBinding

  public Errors recursiveBinding()

• bindingAlreadySet

  public Errors bindingAlreadySet(Key<?> key,
                         Object source)

• jitBindingAlreadySet

  public Errors jitBindingAlreadySet(Key<?> key)

• childBindingAlreadySet

  public Errors childBindingAlreadySet(Key<?> key,
                              Set<Object> sources)

• errorCheckingDuplicateBinding

  public Errors errorCheckingDuplicateBinding(Key<?> key,
                                     Object source,
                                     Throwable t)

• errorInjectingMethod

  public Errors errorInjectingMethod(Throwable cause)

• errorNotifyingTypeListener

  public Errors errorNotifyingTypeListener(TypeListenerBinding listener,
                                  TypeLiteral<?> type,
                                  Throwable cause)

• errorInjectingConstructor

  public Errors errorInjectingConstructor(Throwable cause)

• errorInProvider

  public Errors errorInProvider(RuntimeException runtimeException)

• errorInUserInjector

  public Errors errorInUserInjector(MembersInjector<?> listener,
                           TypeLiteral<?> type,
                           RuntimeException cause)

• errorNotifyingInjectionListener

  public Errors errorNotifyingInjectionListener(InjectionListener<?> listener,
                                       TypeLiteral<?> type,
                                       RuntimeException cause)

• exposedButNotBound

  public Errors exposedButNotBound(Key<?> key)

• keyNotFullySpecified

  public Errors keyNotFullySpecified(TypeLiteral<?> typeLiteral)

• errorEnhancingClass

  public Errors errorEnhancingClass(Class<?> clazz,
                           Throwable cause)

• getMessagesFromThrowable

  public static Collection<Message> getMessagesFromThrowable(Throwable throwable)

• errorInUserCode

  public Errors errorInUserCode(Throwable cause,
                       String messageFormat,
                       Object... arguments)

• cannotInjectRawProvider

  public Errors cannotInjectRawProvider()

• cannotInjectRawMembersInjector

  public Errors cannotInjectRawMembersInjector()

• cannotInjectTypeLiteralOf

  public Errors cannotInjectTypeLiteralOf(Type unsupportedType)

• cannotInjectRawTypeLiteral

  public Errors cannotInjectRawTypeLiteral()

• cannotSatisfyCircularDependency

  public Errors cannotSatisfyCircularDependency(Class<?> expectedType)

• circularProxiesDisabled

  public Errors circularProxiesDisabled(Class<?> expectedType)

• throwCreationExceptionIfErrorsExist

  public void throwCreationExceptionIfErrorsExist()

• throwConfigurationExceptionIfErrorsExist

  public void throwConfigurationExceptionIfErrorsExist()

• throwProvisionExceptionIfErrorsExist

  public void throwProvisionExceptionIfErrorsExist()

• merge

  public Errors merge(Collection<Message> messages)

• merge

  public Errors merge(Errors moreErrors)

• getSources

  public List<Object> getSources()

• throwIfNewErrors

  public void throwIfNewErrors(int expectedSize)
                        throws ErrorsException

  Throws:

  ErrorsException

• toException

  public ErrorsException toException()

• hasErrors

  public boolean hasErrors()

• addMessage

  public Errors addMessage(String messageFormat,
                  Object... arguments)

• addMessage

  public Errors addMessage(Message message)

• format

  public static String format(String messageFormat,
              Object... arguments)

• getMessages

  public List<Message> getMessages()

• format

  public static String format(String heading,
              Collection<Message> errorMessages)

  Returns the formatted message for an exception with the specified messages.

• checkForNull

  public <T> T checkForNull(T value,
                   Object source,
                   Dependency<?> dependency)
                 throws ErrorsException

  Returns value if it is non-null allowed to be null. Otherwise a message is added and an ErrorsException is thrown.

  Throws:

  ErrorsException

• getOnlyCause

  public static Throwable getOnlyCause(Collection<Message> messages)

  Returns the cause throwable if there is exactly one cause in messages. If there are zero or multiple messages with causes, null is returned.

• size

  public int size()

• convert

  public static Object convert(Object o)

• convert

  public static Object convert(Object o,
               ElementSource source)

• formatSource

  public static void formatSource(Formatter formatter,
                  Object source)

• formatSource

  public static void formatSource(Formatter formatter,
                  Object source,
                  ElementSource elementSource)

• formatInjectionPoint

  public static void formatInjectionPoint(Formatter formatter,
                          Dependency<?> dependency,
                          InjectionPoint injectionPoint,
                          ElementSource elementSource)