Class Yaml
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionprivate static class
private static class
private static class
private static class
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected BaseConstructor
protected DumperOptions
protected LoaderOptions
private String
protected Representer
protected final Resolver
-
Constructor Summary
ConstructorsConstructorDescriptionYaml()
Create Yaml instance.Yaml
(BaseConstructor constructor) Create Yaml instance.Yaml
(BaseConstructor constructor, Representer representer) Create Yaml instance.Yaml
(BaseConstructor constructor, Representer representer, DumperOptions dumperOptions) Create Yaml instance.Yaml
(BaseConstructor constructor, Representer representer, DumperOptions dumperOptions, LoaderOptions loadingConfig) Create Yaml instance.Yaml
(BaseConstructor constructor, Representer representer, DumperOptions dumperOptions, LoaderOptions loadingConfig, Resolver resolver) Create Yaml instance.Yaml
(BaseConstructor constructor, Representer representer, DumperOptions dumperOptions, Resolver resolver) Create Yaml instance.Yaml
(DumperOptions dumperOptions) Create Yaml instance.Yaml
(LoaderOptions loadingConfig) Create Yaml instance.Yaml
(Representer representer) Create Yaml instance.Yaml
(Representer representer, DumperOptions dumperOptions) Create Yaml instance. -
Method Summary
Modifier and TypeMethodDescriptionvoid
addImplicitResolver
(Tag tag, Pattern regexp, String first) Add an implicit scalar detector.void
Parse the first YAML document in a stream and produce the corresponding representation tree.composeAll
(Reader yaml) Parse all YAML documents in a stream and produce corresponding representation trees.Serialize a Java object into a YAML String.void
Serialize a Java object into a YAML stream.Serialize a sequence of Java objects into a YAML String.void
Serialize a sequence of Java objects into a YAML stream.private void
dumpAs
(Object data, Tag rootTag, DumperOptions.FlowStyle flowStyle) Serialize a Java object into a YAML string.Serialize a Java object into a YAML string.getName()
Get a meaningful name.private static DumperOptions
initDumperOptions
(Representer representer) <T> T
load
(InputStream io) Parse the only YAML document in a stream and produce the corresponding Java object.<T> T
Parse the only YAML document in a stream and produce the corresponding Java object.<T> T
Parse the only YAML document in a String and produce the corresponding Java object.loadAll
(InputStream yaml) Parse all YAML documents in a stream and produce corresponding Java objects.Parse all YAML documents in the Reader and produce corresponding Java objects.Parse all YAML documents in a String and produce corresponding Java objects.<T> T
loadAs
(InputStream input, Class<T> type) Parse the only YAML document in a stream and produce the corresponding Java object.<T> T
Parse the only YAML document in a stream and produce the corresponding Java object.<T> T
Parse the only YAML document in a String and produce the corresponding Java object.private Object
loadFromReader
(StreamReader sreader, Class<?> type) Parse a YAML stream and produce parsing events.Produce the corresponding representation tree for a given Object.Serialize the representation tree into Events.void
Serialize a YAML node into a YAML stream.void
setBeanAccess
(BeanAccess beanAccess) void
Set a meaningful name to be shown in toString()toString()
-
Field Details
-
resolver
-
name
-
constructor
-
representer
-
dumperOptions
-
loadingConfig
-
-
Constructor Details
-
Yaml
public Yaml()Create Yaml instance. -
Yaml
Create Yaml instance.- Parameters:
dumperOptions
- DumperOptions to configure outgoing objects
-
Yaml
Create Yaml instance.- Parameters:
loadingConfig
- LoadingConfig to control load behavior
-
Yaml
Create Yaml instance.- Parameters:
representer
- Representer to emit outgoing objects
-
Yaml
Create Yaml instance.- Parameters:
constructor
- BaseConstructor to construct incoming documents
-
Yaml
Create Yaml instance.- Parameters:
constructor
- BaseConstructor to construct incoming documentsrepresenter
- Representer to emit outgoing objects
-
Yaml
Create Yaml instance. It is safe to create a few instances and use them in different Threads.- Parameters:
representer
- Representer to emit outgoing objectsdumperOptions
- DumperOptions to configure outgoing objects
-
Yaml
Create Yaml instance. It is safe to create a few instances and use them in different Threads.- Parameters:
constructor
- BaseConstructor to construct incoming documentsrepresenter
- Representer to emit outgoing objectsdumperOptions
- DumperOptions to configure outgoing objects
-
Yaml
public Yaml(BaseConstructor constructor, Representer representer, DumperOptions dumperOptions, LoaderOptions loadingConfig) Create Yaml instance. It is safe to create a few instances and use them in different Threads.- Parameters:
constructor
- BaseConstructor to construct incoming documentsrepresenter
- Representer to emit outgoing objectsdumperOptions
- DumperOptions to configure outgoing objectsloadingConfig
- LoadingConfig to control load behavior
-
Yaml
public Yaml(BaseConstructor constructor, Representer representer, DumperOptions dumperOptions, Resolver resolver) Create Yaml instance. It is safe to create a few instances and use them in different Threads.- Parameters:
constructor
- BaseConstructor to construct incoming documentsrepresenter
- Representer to emit outgoing objectsdumperOptions
- DumperOptions to configure outgoing objectsresolver
- Resolver to detect implicit type
-
Yaml
public Yaml(BaseConstructor constructor, Representer representer, DumperOptions dumperOptions, LoaderOptions loadingConfig, Resolver resolver) Create Yaml instance. It is safe to create a few instances and use them in different Threads.- Parameters:
constructor
- BaseConstructor to construct incoming documentsrepresenter
- Representer to emit outgoing objectsdumperOptions
- DumperOptions to configure outgoing objectsloadingConfig
- LoadingConfig to control load behaviorresolver
- Resolver to detect implicit type
-
-
Method Details
-
initDumperOptions
-
dump
Serialize a Java object into a YAML String.- Parameters:
data
- Java object to be Serialized to YAML- Returns:
- YAML String
-
represent
Produce the corresponding representation tree for a given Object.- Parameters:
data
- instance to build the representation tree for- Returns:
- representation tree
- See Also:
-
dumpAll
Serialize a sequence of Java objects into a YAML String.- Parameters:
data
- Iterator with Objects- Returns:
- YAML String with all the objects in proper sequence
-
dump
Serialize a Java object into a YAML stream.- Parameters:
data
- Java object to be serialized to YAMLoutput
- stream to write to
-
dumpAll
Serialize a sequence of Java objects into a YAML stream.- Parameters:
data
- Iterator with Objectsoutput
- stream to write to
-
dumpAll
-
dumpAs
Serialize a Java object into a YAML string. Override the default root tag with
rootTag
.This method is similar to
Yaml.dump(data)
except that the root tag for the whole document is replaced with the given tag. This has two main uses.First, if the root tag is replaced with a standard YAML tag, such as
Tag.MAP
, then the object will be dumped as a map. The root tag will appear as!!map
, or blank (implicit !!map).Second, if the root tag is replaced by a different custom tag, then the document appears to be a different type when loaded. For example, if an instance of MyClass is dumped with the tag !!YourClass, then it will be handled as an instance of YourClass when loaded.
- Parameters:
data
- Java object to be serialized to YAMLrootTag
- the tag for the whole YAML document. The tag should be Tag.MAP for a JavaBean to make the tag disappear (to use implicit tag !!map). Ifnull
is provided then the standard tag with the full class name is used.flowStyle
- flow style for the whole document. See Chapter 10. Collection Styles http://yaml.org/spec/1.1/#id930798. Ifnull
is provided then the flow style from DumperOptions is used.- Returns:
- YAML String
-
dumpAsMap
Serialize a Java object into a YAML string. Override the default root tag with
Tag.MAP
.This method is similar to
Yaml.dump(data)
except that the root tag for the whole document is replaced withTag.MAP
tag (implicit !!map).Block Mapping is used as the collection style. See 10.2.2. Block Mappings (http://yaml.org/spec/1.1/#id934537)
- Parameters:
data
- Java object to be serialized to YAML- Returns:
- YAML String
-
serialize
Serialize a YAML node into a YAML stream.- Parameters:
node
- YAML node to be serialized to YAMLoutput
- stream to write to
-
serialize
Serialize the representation tree into Events.- Parameters:
data
- representation tree- Returns:
- Event list
- See Also:
-
load
Parse the only YAML document in a String and produce the corresponding Java object. (Because the encoding in known BOM is not respected.)- Type Parameters:
T
- the class of the instance to be created- Parameters:
yaml
- YAML data to load from (BOM must not be present)- Returns:
- parsed object
-
load
Parse the only YAML document in a stream and produce the corresponding Java object.- Type Parameters:
T
- the class of the instance to be created- Parameters:
io
- data to load from (BOM is respected to detect encoding and removed from the data)- Returns:
- parsed object
-
load
Parse the only YAML document in a stream and produce the corresponding Java object.- Type Parameters:
T
- the class of the instance to be created- Parameters:
io
- data to load from (BOM must not be present)- Returns:
- parsed object
-
loadAs
Parse the only YAML document in a stream and produce the corresponding Java object.- Type Parameters:
T
- Class is defined by the second argument- Parameters:
io
- data to load from (BOM must not be present)type
- Class of the object to be created- Returns:
- parsed object
-
loadAs
Parse the only YAML document in a String and produce the corresponding Java object. (Because the encoding in known BOM is not respected.)- Type Parameters:
T
- Class is defined by the second argument- Parameters:
yaml
- YAML data to load from (BOM must not be present)type
- Class of the object to be created- Returns:
- parsed object
-
loadAs
Parse the only YAML document in a stream and produce the corresponding Java object.- Type Parameters:
T
- Class is defined by the second argument- Parameters:
input
- data to load from (BOM is respected to detect encoding and removed from the data)type
- Class of the object to be created- Returns:
- parsed object
-
loadFromReader
-
loadAll
Parse all YAML documents in the Reader and produce corresponding Java objects. The documents are parsed only when the iterator is invoked.- Parameters:
yaml
- YAML data to load from (BOM must not be present)- Returns:
- an Iterable over the parsed Java objects in this String in proper sequence
-
loadAll
Parse all YAML documents in a String and produce corresponding Java objects. (Because the encoding in known BOM is not respected.) The documents are parsed only when the iterator is invoked.- Parameters:
yaml
- YAML data to load from (BOM must not be present)- Returns:
- an Iterable over the parsed Java objects in this String in proper sequence
-
loadAll
Parse all YAML documents in a stream and produce corresponding Java objects. The documents are parsed only when the iterator is invoked.- Parameters:
yaml
- YAML data to load from (BOM is respected to detect encoding and removed from the data)- Returns:
- an Iterable over the parsed Java objects in this stream in proper sequence
-
compose
Parse the first YAML document in a stream and produce the corresponding representation tree. (This is the opposite of the represent() method)- Parameters:
yaml
- YAML document- Returns:
- parsed root Node for the specified YAML document
- See Also:
-
composeAll
Parse all YAML documents in a stream and produce corresponding representation trees.- Parameters:
yaml
- stream of YAML documents- Returns:
- parsed root Nodes for all the specified YAML documents
- See Also:
-
addImplicitResolver
Add an implicit scalar detector. If an implicit scalar value matches the given regexp, the corresponding tag is assigned to the scalar.- Parameters:
tag
- tag to assign to the noderegexp
- regular expression to match againstfirst
- a sequence of possible initial characters or null (which means any).
-
toString
-
getName
Get a meaningful name. It simplifies debugging in a multi-threaded environment. If nothing is set explicitly the address of the instance is returned.- Returns:
- human readable name
-
setName
Set a meaningful name to be shown in toString()- Parameters:
name
- human readable name
-
parse
Parse a YAML stream and produce parsing events.- Parameters:
yaml
- YAML document(s)- Returns:
- parsed events
- See Also:
-
setBeanAccess
-
addTypeDescription
-