org.glassfish.hk2.utilities.binding
Interface ScopedNamedBindingBuilder<T>

Type Parameters:

T - service type.

All Superinterfaces:

BindingBuilder<T>

public interface ScopedNamedBindingBuilder<T>
extends BindingBuilder<T>

Scoped and named service binding builder.

Author:

Marek Potociar (marek.potociar at oracle.com)

Method Summary

ScopedNamedBindingBuilder<T>	loadedBy(HK2Loader loader) Custom HK2 loader to be used when service class is about to be loaded.
ScopedNamedBindingBuilder<T>	qualifiedBy(java.lang.annotation.Annotation annotation) Add a binging qualifier annotation.
void	ranked(int rank) Rank the binding.
ScopedNamedBindingBuilder<T>	to(java.lang.Class<? super T> contract) Bind a new contract to a service.
ScopedNamedBindingBuilder<T>	to(TypeLiteral<?> contract) Bind a new contract to a service.
ScopedNamedBindingBuilder<T>	withMetadata(java.lang.String key, java.util.List<java.lang.String> values) Add binding descriptor metadata.
ScopedNamedBindingBuilder<T>	withMetadata(java.lang.String key, java.lang.String value) Add binding descriptor metadata.

Method Detail

to

ScopedNamedBindingBuilder<T> to(java.lang.Class<? super T> contract)

Bind a new contract to a service.

Parameters:

contract - contract type.

Returns:

updated binder.

to

ScopedNamedBindingBuilder<T> to(TypeLiteral<?> contract)

Bind a new contract to a service.

Parameters:

contract - contract type.

Returns:

updated binder.

loadedBy

ScopedNamedBindingBuilder<T> loadedBy(HK2Loader loader)

Custom HK2 loader to be used when service class is about to be loaded.

Parameters:

loader - custom service loader.

Returns:

updated binder.

withMetadata

ScopedNamedBindingBuilder<T> withMetadata(java.lang.String key,
                                          java.lang.String value)

Add binding descriptor metadata. The metadata can be later used to e.g. filter binding descriptors.

Parameters:

key - metadata key.

value - metadata value.

Returns:

updated binder.

withMetadata

ScopedNamedBindingBuilder<T> withMetadata(java.lang.String key,
                                          java.util.List<java.lang.String> values)

Add binding descriptor metadata. The metadata can be later used to e.g. filter binding descriptors.

Parameters:

key - metadata key.

values - metadata values.

Returns:

updated binder.

qualifiedBy

ScopedNamedBindingBuilder<T> qualifiedBy(java.lang.annotation.Annotation annotation)

Add a binging qualifier annotation.

Parameters:

annotation - qualifier annotation.

Returns:

updated binder.

ranked

void ranked(int rank)

Rank the binding. The higher rank, the more prominent position in an injected iterable provider for a contract.

Parameters:

rank - binding rank to be used to resolve ordering in case of multiple services are bound to the same contract.