Package com.yahoo.jdisc

Interface Container

All Superinterfaces:

SharedResource, Timer

public interface Container
extends SharedResource, Timer

This is the immutable Container. An instance of this class is attached to every Request, and as long as the AbstractResource.release() method has not been called, that Container instance is actively kept alive to prevent any race conditions during reconfiguration or shutdown. At any time there is only a single active Container in the running Application, and the only way to retrieve a reference to that Container is by calling CurrentContainer.newReference(URI). Instead of holding a local Container object inside a ServerProvider (which will eventually become stale), use the appropriate Request constructor instead.

The only way to create a new instance of this class is to 1) create and configure a ContainerBuilder, and 2) pass that to the ContainerActivator.activateContainer(ContainerBuilder) method.

Author:

Simon Thoresen Hult

Nested Class Summary

Nested classes/interfaces inherited from interface com.yahoo.jdisc.SharedResource

SharedResource.Debug

Nested classes/interfaces inherited from interface com.yahoo.jdisc.Timer

Timer.ClockAdapter

Field Summary

Fields inherited from interface com.yahoo.jdisc.SharedResource

DEBUG, SYSTEM_PROPERTY_NAME_DEBUG

Method Summary

Modifier and Type	Method	Description
default <T> T	getInstance(com.google.inject.Key<T> key)	Deprecated, for removal: This API element is subject to removal in a future version. Use getInstance(Class) instead.
<T> T	getInstance(Class<T> type)	Returns the appropriate instance for the given injection type.
RequestHandler	resolveHandler(Request request)	Attempts to find a RequestHandler in the current server- (if Request.isServerRequest() is true) or client- (if Request.isServerRequest() is false) BindingSet that matches the given URI.

Methods inherited from interface com.yahoo.jdisc.SharedResource

refer, refer, release

Methods inherited from interface com.yahoo.jdisc.Timer

currentTime, currentTimeMillis, toUtcClock

Method Detail

resolveHandler

RequestHandler resolveHandler(Request request)

Attempts to find a RequestHandler in the current server- (if Request.isServerRequest() is true) or client- (if Request.isServerRequest() is false) BindingSet that matches the given URI. If no match can be found, this method returns null.

Parameters:

request - The Request to match against the bound RequestHandlers.

Returns:

The matching RequestHandler, or null if there is no match.

getInstance

@Deprecated(forRemoval=true,
            since="7")
default <T> T getInstance(com.google.inject.Key<T> key)

Deprecated, for removal: This API element is subject to removal in a future version.

Use getInstance(Class) instead.

Returns the appropriate instance for the given injection key. When feasible, avoid using this method in favor of having Guice inject your dependencies ahead of time.

Type Parameters:

T - The class of the instance to return.

Parameters:

key - The key of the instance to return.

Returns:

The appropriate instance of the given class.

Throws:

com.google.inject.ConfigurationException - If this injector cannot find or create the provider.

com.google.inject.ProvisionException - If there was a runtime failure while providing an instance.

getInstance

<T> T getInstance(Class<T> type)

Returns the appropriate instance for the given injection type. When feasible, avoid using this method in favor of having Guice inject your dependencies ahead of time.

Type Parameters:

T - The class of the instance to return.

Parameters:

type - The class object of the instance to return.

Returns:

The appropriate instance of the given class.

Throws:

com.google.inject.ConfigurationException - If this injector cannot find or create the provider.

com.google.inject.ProvisionException - If there was a runtime failure while providing an instance.