diff --git a/libraries/.gitignore b/libraries/.gitignore
index ac45fafa62..e594daf27a 100644
--- a/libraries/.gitignore
+++ b/libraries/.gitignore
@@ -6,3 +6,4 @@
# Packaged files #
*.jar
+/bin/
diff --git a/libraries/pom.xml b/libraries/pom.xml
index 163f5872ce..a9b8f45c52 100644
--- a/libraries/pom.xml
+++ b/libraries/pom.xml
@@ -771,6 +771,12 @@
${hamcrest-all.version}
test
+
+ org.yaml
+ snakeyaml
+ ${snakeyaml.version}
+
+
@@ -909,6 +915,7 @@
+ 1.21
1.23.0
0.1.0
0.7.0
diff --git a/libraries/src/main/java/com/baeldung/snakeyaml/Address.java b/libraries/src/main/java/com/baeldung/snakeyaml/Address.java
new file mode 100644
index 0000000000..83c327a4ed
--- /dev/null
+++ b/libraries/src/main/java/com/baeldung/snakeyaml/Address.java
@@ -0,0 +1,41 @@
+package com.baeldung.snakeyaml;
+
+public class Address {
+ private String line;
+ private String city;
+ private String state;
+ private Integer zip;
+
+ public String getLine() {
+ return line;
+ }
+
+ public void setLine(String line) {
+ this.line = line;
+ }
+
+ public String getCity() {
+ return city;
+ }
+
+ public void setCity(String city) {
+ this.city = city;
+ }
+
+ public String getState() {
+ return state;
+ }
+
+ public void setState(String state) {
+ this.state = state;
+ }
+
+ public Integer getZip() {
+ return zip;
+ }
+
+ public void setZip(Integer zip) {
+ this.zip = zip;
+ }
+
+}
diff --git a/libraries/src/main/java/com/baeldung/snakeyaml/Contact.java b/libraries/src/main/java/com/baeldung/snakeyaml/Contact.java
new file mode 100644
index 0000000000..5559c2c339
--- /dev/null
+++ b/libraries/src/main/java/com/baeldung/snakeyaml/Contact.java
@@ -0,0 +1,25 @@
+package com.baeldung.snakeyaml;
+
+public class Contact {
+
+ private String type;
+
+ private Integer number;
+
+ public String getType() {
+ return type;
+ }
+
+ public void setType(String type) {
+ this.type = type;
+ }
+
+ public Integer getNumber() {
+ return number;
+ }
+
+ public void setNumber(Integer number) {
+ this.number = number;
+ }
+
+}
diff --git a/libraries/src/main/java/com/baeldung/snakeyaml/Customer.java b/libraries/src/main/java/com/baeldung/snakeyaml/Customer.java
new file mode 100644
index 0000000000..da35976d37
--- /dev/null
+++ b/libraries/src/main/java/com/baeldung/snakeyaml/Customer.java
@@ -0,0 +1,53 @@
+package com.baeldung.snakeyaml;
+
+import java.util.List;
+
+public class Customer {
+
+ private String firstName;
+ private String lastName;
+ private Integer age;
+ private List contactDetails;
+ private Address homeAddress;
+
+ public String getFirstName() {
+ return firstName;
+ }
+
+ public void setFirstName(String firstName) {
+ this.firstName = firstName;
+ }
+
+ public String getLastName() {
+ return lastName;
+ }
+
+ public void setLastName(String lastName) {
+ this.lastName = lastName;
+ }
+
+ public Integer getAge() {
+ return age;
+ }
+
+ public void setAge(Integer age) {
+ this.age = age;
+ }
+
+ public List getContactDetails() {
+ return contactDetails;
+ }
+
+ public void setContactDetails(List contactDetails) {
+ this.contactDetails = contactDetails;
+ }
+
+ public Address getHomeAddress() {
+ return homeAddress;
+ }
+
+ public void setHomeAddress(Address homeAddress) {
+ this.homeAddress = homeAddress;
+ }
+
+}
diff --git a/libraries/src/test/java/com/baeldung/snakeyaml/JavaToYAMLSerializationUnitTest.java b/libraries/src/test/java/com/baeldung/snakeyaml/JavaToYAMLSerializationUnitTest.java
new file mode 100644
index 0000000000..c1b6c80353
--- /dev/null
+++ b/libraries/src/test/java/com/baeldung/snakeyaml/JavaToYAMLSerializationUnitTest.java
@@ -0,0 +1,56 @@
+package com.baeldung.snakeyaml;
+
+import static org.junit.Assert.assertEquals;
+
+import java.io.StringWriter;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+import org.junit.Test;
+import org.yaml.snakeyaml.Yaml;
+import org.yaml.snakeyaml.nodes.Tag;
+
+import com.baeldung.snakeyaml.Customer;
+
+public class JavaToYAMLSerializationUnitTest {
+
+ @Test
+ public void whenDumpMap_thenGenerateCorrectYAML() {
+ Map data = new LinkedHashMap();
+ data.put("name", "Silenthand Olleander");
+ data.put("race", "Human");
+ data.put("traits", new String[] { "ONE_HAND", "ONE_EYE" });
+ Yaml yaml = new Yaml();
+ StringWriter writer = new StringWriter();
+ yaml.dump(data, writer);
+ System.out.println(writer.toString());
+ String expectedYaml = "name: Silenthand Olleander\nrace: Human\ntraits: [ONE_HAND, ONE_EYE]\n";
+ assertEquals(expectedYaml, writer.toString());
+ }
+
+ @Test
+ public void whenDumpACustomType_thenGenerateCorrectYAML() {
+ Customer customer = new Customer();
+ customer.setAge(45);
+ customer.setFirstName("Greg");
+ customer.setLastName("McDowell");
+ Yaml yaml = new Yaml();
+ StringWriter writer = new StringWriter();
+ yaml.dump(customer, writer);
+ String expectedYaml = "!!com.baeldung.snakeyaml.Customer {age: 45, contactDetails: null, firstName: Greg,\n homeAddress: null, lastName: McDowell}\n";
+ assertEquals(expectedYaml, writer.toString());
+ }
+
+ @Test
+ public void whenDumpAsCustomType_thenGenerateCorrectYAML() {
+ Customer customer = new Customer();
+ customer.setAge(45);
+ customer.setFirstName("Greg");
+ customer.setLastName("McDowell");
+ Yaml yaml = new Yaml();
+ System.out.println(yaml.dumpAs(customer, Tag.MAP, null));
+ String expectedYaml = "{age: 45, contactDetails: null, firstName: Greg, homeAddress: null, lastName: McDowell}\n";
+ assertEquals(expectedYaml, yaml.dumpAs(customer, Tag.MAP, null));
+ }
+
+}
diff --git a/libraries/src/test/java/com/baeldung/snakeyaml/YAMLToJavaDeserialisationUnitTest.java b/libraries/src/test/java/com/baeldung/snakeyaml/YAMLToJavaDeserialisationUnitTest.java
new file mode 100644
index 0000000000..0b9cd860f9
--- /dev/null
+++ b/libraries/src/test/java/com/baeldung/snakeyaml/YAMLToJavaDeserialisationUnitTest.java
@@ -0,0 +1,132 @@
+package com.baeldung.snakeyaml;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertNotNull;
+import static org.junit.Assert.assertTrue;
+
+import java.io.InputStream;
+import java.util.Date;
+import java.util.Map;
+
+import org.junit.Test;
+import org.yaml.snakeyaml.TypeDescription;
+import org.yaml.snakeyaml.Yaml;
+import org.yaml.snakeyaml.constructor.Constructor;
+
+import com.baeldung.snakeyaml.Contact;
+import com.baeldung.snakeyaml.Customer;
+
+public class YAMLToJavaDeserialisationUnitTest {
+
+ @Test
+ public void whenLoadYAMLDocument_thenLoadCorrectMap() {
+ Yaml yaml = new Yaml();
+ InputStream inputStream = this.getClass()
+ .getClassLoader()
+ .getResourceAsStream("yaml/customer.yaml");
+ Map obj = yaml.load(inputStream);
+ System.out.println(obj);
+ }
+
+ @Test
+ public void whenLoadYAMLDocumentWithTopLevelClass_thenLoadCorrectJavaObject() {
+ Yaml yaml = new Yaml(new Constructor(Customer.class));
+ InputStream inputStream = this.getClass()
+ .getClassLoader()
+ .getResourceAsStream("yaml/customer.yaml");
+ Customer customer = yaml.load(inputStream);
+ System.out.println(customer);
+ }
+
+ @Test
+ public void whenLoadYAMLDocumentWithAssumedClass_thenLoadCorrectJavaObject() {
+ Yaml yaml = new Yaml();
+ InputStream inputStream = this.getClass()
+ .getClassLoader()
+ .getResourceAsStream("yaml/customer_with_type.yaml");
+ Customer customer = yaml.load(inputStream);
+ System.out.println(customer);
+ }
+
+ @Test
+ public void whenLoadYAML_thenLoadCorrectImplicitTypes() {
+ Yaml yaml = new Yaml();
+ Map document = yaml.load("3.0: 2018-07-22");
+ assertNotNull(document);
+ assertTrue(document.size() == 1);
+ assertTrue(document.containsKey(Double.valueOf(3.0)));
+ assertTrue(document.get(Double.valueOf(3.0)) instanceof Date);
+ }
+
+ @Test
+ public void whenLoadYAMLDocumentWithTopLevelClass_thenLoadCorrectJavaObjectWithNestedObjects() {
+ Yaml yaml = new Yaml(new Constructor(Customer.class));
+ InputStream inputStream = this.getClass()
+ .getClassLoader()
+ .getResourceAsStream("yaml/customer_with_contact_details_and_address.yaml");
+ Customer customer = yaml.load(inputStream);
+ assertNotNull(customer);
+ assertEquals("John", customer.getFirstName());
+ assertEquals("Doe", customer.getLastName());
+ assertTrue(customer.getAge() == 31);
+ assertNotNull(customer.getContactDetails());
+ assertTrue(customer.getContactDetails()
+ .size() == 2);
+ assertEquals("mobile", customer.getContactDetails()
+ .get(0)
+ .getType());
+ assertTrue(customer.getContactDetails()
+ .get(0)
+ .getNumber() == 123456789);
+ assertEquals("landline", customer.getContactDetails()
+ .get(1)
+ .getType());
+ assertTrue(customer.getContactDetails()
+ .get(1)
+ .getNumber() == 456786868);
+ assertNotNull(customer.getHomeAddress());
+ assertEquals("Xyz, DEF Street", customer.getHomeAddress()
+ .getLine());
+ }
+
+ @Test
+ public void whenLoadYAMLDocumentWithTypeDescription_thenLoadCorrectJavaObjectWithCorrectGenericType() {
+ Constructor constructor = new Constructor(Customer.class);
+ TypeDescription customTypeDescription = new TypeDescription(Customer.class);
+ customTypeDescription.addPropertyParameters("contactDetails", Contact.class);
+ constructor.addTypeDescription(customTypeDescription);
+ Yaml yaml = new Yaml(constructor);
+ InputStream inputStream = this.getClass()
+ .getClassLoader()
+ .getResourceAsStream("yaml/customer_with_contact_details.yaml");
+ Customer customer = yaml.load(inputStream);
+ assertNotNull(customer);
+ assertEquals("John", customer.getFirstName());
+ assertEquals("Doe", customer.getLastName());
+ assertTrue(customer.getAge() == 31);
+ assertNotNull(customer.getContactDetails());
+ assertTrue(customer.getContactDetails()
+ .size() == 2);
+ assertEquals("mobile", customer.getContactDetails()
+ .get(0)
+ .getType());
+ assertEquals("landline", customer.getContactDetails()
+ .get(1)
+ .getType());
+ }
+
+ @Test
+ public void whenLoadMultipleYAMLDocuments_thenLoadCorrectJavaObjects() {
+ Yaml yaml = new Yaml(new Constructor(Customer.class));
+ InputStream inputStream = this.getClass()
+ .getClassLoader()
+ .getResourceAsStream("yaml/customers.yaml");
+ int count = 0;
+ for (Object object : yaml.loadAll(inputStream)) {
+ count++;
+ assertTrue(object instanceof Customer);
+ }
+ assertTrue(count == 2);
+ }
+
+}
diff --git a/libraries/src/test/resources/yaml/customer.yaml b/libraries/src/test/resources/yaml/customer.yaml
new file mode 100644
index 0000000000..aa76141c7d
--- /dev/null
+++ b/libraries/src/test/resources/yaml/customer.yaml
@@ -0,0 +1,3 @@
+firstName: "John"
+lastName: "Doe"
+age: 20
\ No newline at end of file
diff --git a/libraries/src/test/resources/yaml/customer_with_contact_details.yaml b/libraries/src/test/resources/yaml/customer_with_contact_details.yaml
new file mode 100644
index 0000000000..34563cbd21
--- /dev/null
+++ b/libraries/src/test/resources/yaml/customer_with_contact_details.yaml
@@ -0,0 +1,7 @@
+firstName: "John"
+lastName: "Doe"
+age: 31
+contactDetails:
+ - { type: "mobile", number: 123456789}
+ - { type: "landline", number: 456786868}
+
\ No newline at end of file
diff --git a/libraries/src/test/resources/yaml/customer_with_contact_details_and_address.yaml b/libraries/src/test/resources/yaml/customer_with_contact_details_and_address.yaml
new file mode 100644
index 0000000000..664afe8594
--- /dev/null
+++ b/libraries/src/test/resources/yaml/customer_with_contact_details_and_address.yaml
@@ -0,0 +1,13 @@
+firstName: "John"
+lastName: "Doe"
+age: 31
+contactDetails:
+ - type: "mobile"
+ number: 123456789
+ - type: "landline"
+ number: 456786868
+homeAddress:
+ line: "Xyz, DEF Street"
+ city: "City Y"
+ state: "State Y"
+ zip: 345657
diff --git a/libraries/src/test/resources/yaml/customer_with_contact_details_and_tags.yaml b/libraries/src/test/resources/yaml/customer_with_contact_details_and_tags.yaml
new file mode 100644
index 0000000000..145da256d9
--- /dev/null
+++ b/libraries/src/test/resources/yaml/customer_with_contact_details_and_tags.yaml
@@ -0,0 +1,6 @@
+firstName: "John"
+lastName: "Doe"
+age: 31
+contactDetails:
+ - !contact { type: "mobile", number: 123456789}
+ - !contact { type: "landline", number: 456786868}
diff --git a/libraries/src/test/resources/yaml/customer_with_type.yaml b/libraries/src/test/resources/yaml/customer_with_type.yaml
new file mode 100644
index 0000000000..6e13c26cea
--- /dev/null
+++ b/libraries/src/test/resources/yaml/customer_with_type.yaml
@@ -0,0 +1,4 @@
+!!com.baeldung.snakeyaml.Customer
+firstName: "John"
+lastName: "Doe"
+age: 20
\ No newline at end of file
diff --git a/libraries/src/test/resources/yaml/customers.yaml b/libraries/src/test/resources/yaml/customers.yaml
new file mode 100644
index 0000000000..23b9039c2e
--- /dev/null
+++ b/libraries/src/test/resources/yaml/customers.yaml
@@ -0,0 +1,8 @@
+---
+firstName: "John"
+lastName: "Doe"
+age: 20
+---
+firstName: "Jack"
+lastName: "Jones"
+age: 25
\ No newline at end of file
diff --git a/pom.xml b/pom.xml
index 263e4df637..506a94b0a0 100644
--- a/pom.xml
+++ b/pom.xml
@@ -549,7 +549,7 @@
apache-meecrowave
spring-reactive-kotlin
jnosql
- testing-modules/junit-abstract
+ testing-modules/junit-abstract
@@ -669,7 +669,7 @@
spring-amqp-simple
spring-apache-camel
spring-batch
- testing-modules/junit-abstract
+ testing-modules/junit-abstract
@@ -1075,7 +1075,7 @@
antlr
maven-archetype
apache-meecrowave
- testing-modules/junit-abstract
+ testing-modules/junit-abstract