org.lenskit.config

Class BindingDSL

java.lang.Object

org.grouplens.grapht.AbstractContext

org.lenskit.inject.AbstractConfigContext

org.lenskit.config.BindingDSL

All Implemented Interfaces:

Context, org.lenskit.LenskitConfigContext

Direct Known Subclasses:

LenskitConfigDSL

public class BindingDSL
extends org.lenskit.inject.AbstractConfigContext

Groovy DSL definition for configuring LensKit recommenders. This class is the base class of configuration scripts and the delegate against which configuration blocks are run.

The fact that this extends AbstractConfigContext is basically an implementation detail, to make sure that we always provide proxies for all the methods.

Since:

1.2

Method Summary

Modifier and Type	Method and Description
void	addComponent(Object obj)
org.lenskit.LenskitConfigContext	at(Annotation qualifier, Class<?> type)
org.lenskit.LenskitConfigContext	at(Annotation qualifier, Class<?> type, groovy.lang.Closure<?> block) Enclose a block of configuration in a context.
org.lenskit.LenskitConfigContext	at(Class<?> type)
org.lenskit.LenskitConfigContext	at(Class<?> type, groovy.lang.Closure<?> block) Configure inside an anchored context using a block.
org.lenskit.LenskitConfigContext	at(Class<? extends Annotation> qualifier, Class<?> type)
org.lenskit.LenskitConfigContext	at(Class<? extends Annotation> qualifier, Class<?> type, groovy.lang.Closure<?> block) Enclose a block of configuration in a context.
<T> org.lenskit.LenskitBinding<T>	bind(Class<? extends Annotation> qual, Class<T> type)
<T> org.lenskit.LenskitBinding<T>	bind(Class<T> type)
<T> org.lenskit.LenskitBinding<T>	bindAny(Class<T> type)
org.lenskit.data.ratings.PreferenceDomain	domain(Map<String,Object> args) Make and bind a preference domain.
org.lenskit.LenskitConfigContext	getContext() Get the LensKit context.
void	include(groovy.lang.Closure<?> cl) Use a closure as additional configuration
void	include(Module mod) Include a module in this configuration.
void	include(String file) Include another configuration file.
void	include(URI uri) Include another configuration file.
org.lenskit.LenskitConfigContext	matching(ContextPattern pattern)
Context	matching(ContextPattern pattern, groovy.lang.Closure<?> block)
org.lenskit.data.ratings.PreferenceDomain	prefDomain(Map<String,Object> args) Make a preference domain.
Binding	set(Class<? extends Annotation> param)
org.lenskit.LenskitConfigContext	within(Annotation qualifier, Class<?> type)
org.lenskit.LenskitConfigContext	within(Annotation qualifier, Class<?> type, groovy.lang.Closure<?> block) Enclose a block of configuration in a context.
org.lenskit.LenskitConfigContext	within(Class<?> type)
org.lenskit.LenskitConfigContext	within(Class<?> type, groovy.lang.Closure<?> block) Enclose a block of configuration in a context.
org.lenskit.LenskitConfigContext	within(Class<? extends Annotation> qualifier, Class<?> type)
org.lenskit.LenskitConfigContext	within(Class<? extends Annotation> qualifier, Class<?> type, groovy.lang.Closure<?> block) Enclose a block of configuration in a context.

Methods inherited from class org.lenskit.inject.AbstractConfigContext

addComponent, in, in, in, wrapContext

Methods inherited from class java.lang.Object

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

Method Detail

getContext

public org.lenskit.LenskitConfigContext getContext()

Get the LensKit context.

Returns:

The LensKit context.

include

public void include(groovy.lang.Closure<?> cl)

Use a closure as additional configuration

Parameters:

cl - A closure that is run on this context to do additional configuration.

include

public void include(URI uri)
             throws IOException,
                    org.lenskit.RecommenderConfigurationException

Include another configuration file.

Parameters:

uri - The URI of the configuration file.

Throws:

IOException - if an error is thrown loading the script.

org.lenskit.RecommenderConfigurationException - if there is an error running the script.

UnsupportedOperationException - if the current context does not support loading.

include

public void include(String file)
             throws IOException,
                    org.lenskit.RecommenderConfigurationException

Include another configuration file.

Parameters:

file - The configuration file name or URI.

Throws:

IOException

org.lenskit.RecommenderConfigurationException

See Also:

include(URI)

include

public void include(Module mod)

Include a module in this configuration.

Parameters:

mod - The module to include.

bind

public <T> org.lenskit.LenskitBinding<T> bind(Class<T> type)

See Also:

LenskitConfigContext.bind(Class)

bind

public <T> org.lenskit.LenskitBinding<T> bind(Class<? extends Annotation> qual,
                                              Class<T> type)

Specified by:

bind in interface Context

Specified by:

bind in interface org.lenskit.LenskitConfigContext

Overrides:

bind in class org.lenskit.inject.AbstractConfigContext

See Also:

LenskitConfigContext.bind(Class, Class)

bindAny

public <T> org.lenskit.LenskitBinding<T> bindAny(Class<T> type)

Specified by:

bindAny in interface Context

Specified by:

bindAny in interface org.lenskit.LenskitConfigContext

Overrides:

bindAny in class org.lenskit.inject.AbstractConfigContext

See Also:

LenskitConfigContext.bindAny(Class)

set

public Binding set(@Nonnull
                   Class<? extends Annotation> param)

Specified by:

set in interface org.lenskit.LenskitConfigContext

Overrides:

set in class org.lenskit.inject.AbstractConfigContext

See Also:

LenskitConfigContext.set(Class)

addComponent

public void addComponent(@Nonnull
                         Object obj)

Specified by:

addComponent in interface org.lenskit.LenskitConfigContext

Overrides:

addComponent in class org.lenskit.inject.AbstractConfigContext

within

public org.lenskit.LenskitConfigContext within(Class<?> type)

See Also:

LenskitConfigContext.within(Class)

within

public org.lenskit.LenskitConfigContext within(Class<?> type,
                                               groovy.lang.Closure<?> block)

Enclose a block of configuration in a context. The block is invoked with a delegate that adds bindings within the specified context.

Parameters:

type - The type to match for the context.

block - The configuration block.

Returns:

The configuration context.

See Also:

LenskitConfigContext.within(Class)

within

public org.lenskit.LenskitConfigContext within(@Nullable
                                               Class<? extends Annotation> qualifier,
                                               Class<?> type)

See Also:

LenskitConfigContext.within(Class, Class)

within

public org.lenskit.LenskitConfigContext within(@Nullable
                                               Class<? extends Annotation> qualifier,
                                               Class<?> type,
                                               groovy.lang.Closure<?> block)

Enclose a block of configuration in a context.

Parameters:

qualifier - The qualifier.

type - The type to match for the context.

block - The configuration block.

Returns:

The configuration context.

See Also:

LenskitConfigContext.within(Class, Class), within(Class, Closure)

within

public org.lenskit.LenskitConfigContext within(@Nullable
                                               Annotation qualifier,
                                               Class<?> type)

See Also:

LenskitConfigContext.within(Annotation, Class)

within

public org.lenskit.LenskitConfigContext within(@Nullable
                                               Annotation qualifier,
                                               Class<?> type,
                                               groovy.lang.Closure<?> block)

Enclose a block of configuration in a context.

Parameters:

qualifier - The qualifier.

type - The type to match for the context.

block - The configuration block.

Returns:

The configuration context.

See Also:

LenskitConfigContext.within(Annotation, Class), within(Class, Closure)

matching

public org.lenskit.LenskitConfigContext matching(ContextPattern pattern)

matching

public Context matching(ContextPattern pattern,
                        groovy.lang.Closure<?> block)

at

public org.lenskit.LenskitConfigContext at(Class<?> type)

See Also:

LenskitConfigContext.at(Class)

at

public org.lenskit.LenskitConfigContext at(Class<?> type,
                                           groovy.lang.Closure<?> block)

Configure inside an anchored context using a block.

Parameters:

type - The type.

block - The configuration block.

Returns:

The context.

See Also:

within(Class, Closure)

at

public org.lenskit.LenskitConfigContext at(@Nullable
                                           Class<? extends Annotation> qualifier,
                                           Class<?> type)

See Also:

LenskitConfigContext.at(Class, Class)

at

public org.lenskit.LenskitConfigContext at(@Nullable
                                           Class<? extends Annotation> qualifier,
                                           Class<?> type,
                                           groovy.lang.Closure<?> block)

Enclose a block of configuration in a context.

Parameters:

qualifier - The qualifier.

type - The type to match for the context.

block - The configuration block.

Returns:

The configuration context.

See Also:

LenskitConfigContext.at(Class, Class), at(Class, Closure)

at

public org.lenskit.LenskitConfigContext at(@Nullable
                                           Annotation qualifier,
                                           Class<?> type)

See Also:

LenskitConfigContext.at(Annotation, Class)

at

public org.lenskit.LenskitConfigContext at(@Nullable
                                           Annotation qualifier,
                                           Class<?> type,
                                           groovy.lang.Closure<?> block)

Enclose a block of configuration in a context.

Parameters:

qualifier - The qualifier.

type - The type to match for the context.

block - The configuration block.

Returns:

The configuration context.

See Also:

LenskitConfigContext.at(Annotation, Class), at(Class, Closure)

domain

public org.lenskit.data.ratings.PreferenceDomain domain(Map<String,Object> args)

Make and bind a preference domain. With this method, this:

  domain minimum: 1, maximum: 5 

is equivalent to:

  bind PreferenceDomain to prefDomain(minimum: 1, maximum: 5) 

Parameters:

args - The arguments.

Returns:

The preference domain.

See Also:

prefDomain(java.util.Map)

prefDomain

public org.lenskit.data.ratings.PreferenceDomain prefDomain(Map<String,Object> args)

Make a preference domain. This method takes three named arguments:

minimum

The minimum rating

maximum

The maximum rating

precision (optional)

The preference precision.

Parameters:

args - The arguments.

Returns:

The preference domain.

See Also:

PreferenceDomain