org.glassfish.jersey.internal.inject
Interface ServiceBindingBuilder<T>

Type Parameters:

T - service type.

All Superinterfaces:

BindingBuilder<T>

public interface ServiceBindingBuilder<T>
extends BindingBuilder<T>

Service binding builder.

Author:

Marek Potociar (marek.potociar at oracle.com)

Method Summary

ScopedBindingBuilder<T>	in(Class<? extends Annotation> scopeAnnotation) Scope a binding.
ServiceBindingBuilder<T>	loadedBy(HK2Loader loader) Custom HK2 loader to be used when service class is about to be loaded.
NamedBindingBuilder<T>	named(String name) Name the binding.
ServiceBindingBuilder<T>	qualifiedBy(Annotation annotation) Add a binging qualifier annotation.
void	ranked(int rank) Rank the binding.
ServiceBindingBuilder<T>	to(Class<? super T> contract) Bind a new contract to a service.
ServiceBindingBuilder<T>	to(TypeLiteral<?> contract) Bind a new contract to a service.
ServiceBindingBuilder<T>	withMetadata(String key, List<String> values) Add binding descriptor metadata.
ServiceBindingBuilder<T>	withMetadata(String key, String value) Add binding descriptor metadata.

Method Detail

to

ServiceBindingBuilder<T> to(Class<? super T> contract)

Bind a new contract to a service.

Parameters:

contract - contract type.

Returns:

updated binder.

to

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

Bind a new contract to a service.

Parameters:

contract - contract type.

Returns:

updated binder.

loadedBy

ServiceBindingBuilder<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

ServiceBindingBuilder<T> withMetadata(String key,
                                      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

ServiceBindingBuilder<T> withMetadata(String key,
                                      List<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

ServiceBindingBuilder<T> qualifiedBy(Annotation annotation)

Add a binging qualifier annotation.

Parameters:

annotation - qualifier annotation.

Returns:

updated binder.

in

ScopedBindingBuilder<T> in(Class<? extends Annotation> scopeAnnotation)

Scope a binding.

Parameters:

scopeAnnotation - scope annotation.

Returns:

updated binding.

named

NamedBindingBuilder<T> named(String name)

Name the binding.

Parameters:

name - new name value.

Returns:

updated binding.

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.