org.springframework.beans.factory.config

Class YamlProcessor

java.lang.Object

org.springframework.beans.factory.config.YamlProcessor

Direct Known Subclasses:

YamlMapFactoryBean, YamlPropertiesFactoryBean

public abstract class YamlProcessor
extends Object

Base class for YAML factories.

Since:

4.1

Author:

Dave Syer

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	YamlProcessor.DocumentMatcher Strategy interface used to test if properties match.
static interface	YamlProcessor.MatchCallback Callback interface used to process properties in a resulting map.
static class	YamlProcessor.MatchStatus Status returned from YamlProcessor.DocumentMatcher.matches(java.util.Properties)
static class	YamlProcessor.ResolutionMethod Method to use for resolving resources.
protected static class	YamlProcessor.StrictMapAppenderConstructor A specialized Constructor that checks for duplicate keys.

Constructor Summary

Constructors

Constructor and Description
YamlProcessor()

Method Summary

Modifier and Type	Method and Description
protected org.yaml.snakeyaml.Yaml	createYaml() Create the Yaml instance to use.
protected Map<String,Object>	getFlattenedMap(Map<String,Object> source) Return a flattened version of the given map, recursively following any nested Map or Collection values.
protected void	process(YamlProcessor.MatchCallback callback) Provide an opportunity for subclasses to process the Yaml parsed from the supplied resources.
void	setDocumentMatchers(YamlProcessor.DocumentMatcher... matchers) A map of document matchers allowing callers to selectively use only some of the documents in a YAML resource.
void	setMatchDefault(boolean matchDefault) Flag indicating that a document for which all the document matchers abstain will nevertheless match.
void	setResolutionMethod(YamlProcessor.ResolutionMethod resolutionMethod) Method to use for resolving resources.
void	setResources(Resource... resources) Set locations of YAML resources to be loaded.

Methods inherited from class java.lang.Object

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

Constructor Detail

YamlProcessor

public YamlProcessor()

Method Detail

setDocumentMatchers

public void setDocumentMatchers(YamlProcessor.DocumentMatcher... matchers)

A map of document matchers allowing callers to selectively use only some of the documents in a YAML resource. In YAML documents are separated by --- lines, and each document is converted to properties before the match is made. E.g.

 environment: dev
 url: http://dev.bar.com
 name: Developer Setup
 ---
 environment: prod
 url:http://foo.bar.com
 name: My Cool App
 

when mapped with documentMatchers = YamlProcessor.mapMatcher({"environment": "prod"}) would end up as

 environment=prod
 url=http://foo.bar.com
 name=My Cool App
 url=http://dev.bar.com
 

Parameters:

matchers - a map of keys to value patterns (regular expressions)

setMatchDefault

public void setMatchDefault(boolean matchDefault)

Flag indicating that a document for which all the document matchers abstain will nevertheless match.

Parameters:

matchDefault - the flag to set (default true)

setResolutionMethod

public void setResolutionMethod(YamlProcessor.ResolutionMethod resolutionMethod)

Method to use for resolving resources. Each resource will be converted to a Map, so this property is used to decide which map entries to keep in the final output from this factory.

Parameters:

resolutionMethod - the resolution method to set (defaults to YamlProcessor.ResolutionMethod.OVERRIDE).

setResources

public void setResources(Resource... resources)

Set locations of YAML resources to be loaded.

See Also:

YamlProcessor.ResolutionMethod

process

protected void process(YamlProcessor.MatchCallback callback)

Provide an opportunity for subclasses to process the Yaml parsed from the supplied resources. Each resource is parsed in turn and the documents inside checked against the matchers. If a document matches it is passed into the callback, along with its representation as Properties. Depending on the setResolutionMethod(ResolutionMethod) not all of the documents will be parsed.

Parameters:

callback - a callback to delegate to once matching documents are found

See Also:

createYaml()

createYaml

protected org.yaml.snakeyaml.Yaml createYaml()

Create the Yaml instance to use.

getFlattenedMap

protected final Map<String,Object> getFlattenedMap(Map<String,Object> source)

Return a flattened version of the given map, recursively following any nested Map or Collection values. Entries from the resulting map retain the same order as the source. When called with the Map from a YamlProcessor.MatchCallback the result will contain the same values as the YamlProcessor.MatchCallback Properties.

Parameters:

source - the source map

Returns:

a flattened map

Since:

4.1.3