hk2 4.0.1 · org.glassfish.hk2.api.ValidationService · APIdia, the JavaDoc alternative

This service can be used to add validation points to Descriptors.

An implementation of ValidationService must be in the Singleton scope. Implementations of ValidationService will be instantiated as soon as they are added to HK2 in order to avoid deadlocks and circular references. Therefore it is recommended that implementations of ValidationService make liberal use of jakarta.inject.Provider or IterableProvider when injecting dependent services so that these services are not instantiated when the ValidationService is created

Method Summary

Modifier and Type	Method and Description
public Filter	Returns: The filter to be used to determine if the validators associated with this service should be called when the passed in `Descriptor` is looked up getLookupFilter() This filter will be run at least once per descriptor at the point that the descriptor is being looked up, either with the `ServiceLocator` API or due to an @Inject resolution.
public Validator	Returns: A non-null validator getValidator() Returns the `Validator` that will be run whenever a `Descriptor` that passed the filter is to be looked up with the API or injected into an injection point, or on any bind or unbind operation.

Method Detail

getLookupFilter back to summary

getLookupFilter	back to summary
public Filter getLookupFilter() This filter will be run at least once per descriptor at the point that the descriptor is being looked up, either with the `ServiceLocator` API or due to an @Inject resolution. The decision made by this filter will be cached and used every time that Descriptor is subsequently looked up. No validation checks should be done in the returned filter, it is purely meant to limit the `Descriptor`s that are passed into the validator. Descriptors passed to this filter may or may not be reified. The filter should try as much as possible to do its work without reifying the descriptor. The filter may be run more than once on a descriptor if some condition caused the cache of results per descriptor to become invalidated. Returns:Filter The filter to be used to determine if the validators associated with this service should be called when the passed in `Descriptor` is looked up

public Filter getLookupFilter()

This filter will be run at least once per descriptor at the point that the descriptor is being looked up, either with the ServiceLocator API or due to an @Inject resolution. The decision made by this filter will be cached and used every time that Descriptor is subsequently looked up. No validation checks should be done in the returned filter, it is purely meant to limit the Descriptors that are passed into the validator.

Descriptors passed to this filter may or may not be reified. The filter should try as much as possible to do its work without reifying the descriptor.

The filter may be run more than once on a descriptor if some condition caused the cache of results per descriptor to become invalidated.

Returns:Filter: The filter to be used to determine if the validators associated with this service should be called when the passed in Descriptor is looked up

getValidator back to summary

getValidator	back to summary
public Validator getValidator() Returns the `Validator` that will be run whenever a `Descriptor` that passed the filter is to be looked up with the API or injected into an injection point, or on any bind or unbind operation. If this method returns false then the operation will not proceed. Returns:Validator A non-null validator

public Validator getValidator()

Returns the Validator that will be run whenever a Descriptor that passed the filter is to be looked up with the API or injected into an injection point, or on any bind or unbind operation. If this method returns false then the operation will not proceed.

Returns:Validator: A non-null validator

public Interface ValidationService

Method Summary

Method Detail