bayou.od

Class OD

java.lang.Object

bayou.od.OD

public class OD
extends Object

A Service Locator library.

See package doc.

This class (OD) is a namespace containing some interfaces and static methods.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	OD.Predicate<T> Similar to Predicate in Java 8.
static interface	OD.Supplier<T> Similar to Supplier in Java 8.
static class	OD.NotFoundException Binding is not found for (type,tags).
static interface	OD.Binding Binding of (type,tags)->supplier.
static class	OD.Local Thread-local bindings.
static class	OD.BindingBuilder<T> Builder for creating bindings.

Method Summary

Static Methods
<T> T	get(Class<T> type, Object... tags) Lookup an object by (type,tags).
<T> T	get(ClassType<T> type, Object... tags) Lookup an object by (type,tags).
<T> OD.BindingBuilder<T>	bind(Class<T> clazz) To add a global binding.
<T> OD.BindingBuilder<T>	bind(ClassType<T> type) To add a global binding.
void	bind(OD.Binding binding) Add the binding to the global binding list.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

get

public static <T> T get(Class<T> type,
                        Object... tags)
                 throws OD.NotFoundException

Lookup an object by (type,tags).

This method is equivalent to get(ClassType, Object...) by wrapping the `Class` as `ClassType`; see ClassType.of(Class).

Throws:

OD.NotFoundException

get

public static <T> T get(ClassType<T> type,
                        Object... tags)
                 throws OD.NotFoundException

Lookup an object by (type,tags).

The local binding list is searched before the global binding list. If a binding is found to match (type,tags), the supplier is invoked to return a `T` value. Otherwise, `NotFoundException` is thrown.

Throws:

OD.NotFoundException - if binding is not found for (type,tags)

See Also:

get(Class, Object...)

bind

public static <T> OD.BindingBuilder<T> bind(Class<T> clazz)

To add a global binding.

This method is equivalent to bind(ClassType) by wrapping the `Class` as `ClassType`; see ClassType.of(Class).

Example usage:

     OD.bind(Foo.class).to(foo);
 

bind

public static <T> OD.BindingBuilder<T> bind(ClassType<T> type)

To add a global binding.

This method return a builder; when the builder finishes, a binding is created and added to the global binding list.

Example usage:

     OD.bind( ClassType.of(Foo.class) ).to(foo);
 

See Also:

bind(Class), ClassType

bind

public static void bind(OD.Binding binding)

Add the binding to the global binding list.