org.grouplens.lenskit.config

Class ConfigHelpers

java.lang.Object

org.grouplens.lenskit.config.ConfigHelpers

public class ConfigHelpers
extends Object

LensKit configuration helper utilities.

Since:

1.2

Constructor Summary

Constructors

Constructor and Description
ConfigHelpers()

Method Summary

Modifier and Type	Method and Description
static void	configure(LenskitConfiguration config, groovy.lang.Closure<?> block) Modify a configuration from a closure.
static LenskitConfiguration	load(groovy.lang.Closure<?> block) Load a LensKit configuration from a Groovy closure.
static LenskitConfiguration	load(File script) Load a LensKit configuration from a script file.
static LenskitConfiguration	load(String script) Deprecated. Loading from Groovy source strings is confusing.
static LenskitConfiguration	load(URL script) Load a LensKit configuration from a script URL.

Methods inherited from class java.lang.Object

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

Constructor Detail

ConfigHelpers

public ConfigHelpers()

Method Detail

load

public static LenskitConfiguration load(groovy.lang.Closure<?> block)
                                 throws RecommenderConfigurationException

Load a LensKit configuration from a Groovy closure. This is useful for using the Groovy DSL in unit tests.

Parameters:

block - The block to evaluate. This block will be evaluated with a delegate providing the LensKit DSL and the Closure.DELEGATE_FIRST resolution strategy.

Returns:

The LensKit configuration.

Throws:

RecommenderConfigurationException

See Also:

ConfigurationLoader.load(groovy.lang.Closure)

load

@Deprecated
public static LenskitConfiguration load(String script)
                                             throws RecommenderConfigurationException

Deprecated. Loading from Groovy source strings is confusing.

Load a LensKit configuration from a script (as a string).

Parameters:

script - The script source text to evaluate.

Returns:

The LensKit configuration.

Throws:

RecommenderConfigurationException

load

public static LenskitConfiguration load(File script)
                                 throws IOException,
                                        RecommenderConfigurationException

Load a LensKit configuration from a script file.

Parameters:

script - The script source file to evaluate.

Returns:

The LensKit configuration.

Throws:

IOException

RecommenderConfigurationException

load

public static LenskitConfiguration load(URL script)
                                 throws IOException,
                                        RecommenderConfigurationException

Load a LensKit configuration from a script URL.

Parameters:

script - The script source URL to evaluate.

Returns:

The LensKit configuration.

Throws:

IOException

RecommenderConfigurationException

configure

public static void configure(LenskitConfiguration config,
                             @Nonnull
                             groovy.lang.Closure<?> block)
                      throws RecommenderConfigurationException

Modify a configuration from a closure. The class loader is not really consulted in this case.

Parameters:

block - The block to evaluate. This block will be evaluated with a delegate providing the LensKit DSL and the Closure.DELEGATE_FIRST resolution strategy.

Throws:

RecommenderConfigurationException