Top Description Methods
org.glassfish.hk2.api

public Interface Validator

Known Direct Implementers
org.glassfish.hk2.internal.ImmediateHelper

This method is called when it determined that a type that is annotated with a Validating annotation is to be injected into any other class.
Author
jwells

Method Summary

Modifier and TypeMethod and Description
public boolean

Returns:

true if this injection should succeed, false if this candidate should not be returned
validate
(ValidationInformation
Information about the operation being performed
info
)

This method is called whenever it has been determined that a validating class is to be injected into an injection point, or when a descriptor is being looked up explicitly with the API, or a descriptor is being bound or unbound into the registry.

Method Detail

validateback to summary
public boolean validate(ValidationInformation info)

This method is called whenever it has been determined that a validating class is to be injected into an injection point, or when a descriptor is being looked up explicitly with the API, or a descriptor is being bound or unbound into the registry.

The candidate descriptor being passed in may not have yet been reified. If possible, this method should do its work without reifying the descriptor. However, if it is necessary to reify the descriptor, it should be done with the ServiceLocator.reifyDescriptor method.

The operation will determine what operation is being performed. In the BIND or UNBIND cases the Injectee will be null. In the LOOKUP case the Injectee will be non-null if this is being done as part of an injection point. In the LOOKUP case the Injectee will be null if this is being looked up directly from the ServiceLocator API, in which case the caller of the lookup method will be on the call frame.

Parameters
info:ValidationInformation

Information about the operation being performed

Returns:boolean

true if this injection should succeed, false if this candidate should not be returned

Exceptions
RuntimeException:
This method should not throw an exception. If it does the ErrorService will be called with the ErrorType#VALIDATE_FAILURE. Even if the ErrorService#onFailure(ErrorInformation) rethrows the exception that exception will not be thrown up the stack, instead the system will always behave as if false had been returned from this method