New unit test format

persistence-modules/apache-cayenne/README.md

@@ -0,0 +1,4 @@
+## Relevant articles:
+
+- [Advanced Querying in Apache Cayenne](http://www.baeldung.com/apache-cayenne-query)
+- [Introduction to Apache Cayenne ORM](http://www.baeldung.com/apache-cayenne-orm)

persistence-modules/apache-cayenne/pom.xml

@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>apache-cayenne</artifactId>
+    <version>0.0.1-SNAPSHOT</version>
+    <name>apache-cayenne</name>
+    <packaging>jar</packaging>
+    <description>Introduction to Apache Cayenne</description>
+
+    <parent>
+        <groupId>com.baeldung</groupId>
+        <artifactId>parent-modules</artifactId>
+        <version>1.0.0-SNAPSHOT</version>
+        <relativePath>../../</relativePath>
+    </parent>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.cayenne</groupId>
+            <artifactId>cayenne-server</artifactId>
+            <version>${cayenne.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>mysql</groupId>
+            <artifactId>mysql-connector-java</artifactId>
+            <version>${mysql.connector.version}</version>
+            <scope>runtime</scope>
+        </dependency>
+
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.cayenne.plugins</groupId>
+                <artifactId>cayenne-modeler-maven-plugin</artifactId>
+                <version>${cayenne.version}</version>
+            </plugin>
+        </plugins>
+    </build>
+
+    <properties>
+        <mysql.connector.version>5.1.44</mysql.connector.version>
+        <cayenne.version>4.0.M5</cayenne.version>
+    </properties>
+
+</project>

persistence-modules/apache-cayenne/src/main/java/com/baeldung/apachecayenne/persistent/Article.java

@@ -0,0 +1,9 @@
+package com.baeldung.apachecayenne.persistent;
+
+import com.baeldung.apachecayenne.persistent.auto._Article;
+
+public class Article extends _Article {
+
+    private static final long serialVersionUID = 1L; 
+
+}

persistence-modules/apache-cayenne/src/main/java/com/baeldung/apachecayenne/persistent/Author.java

@@ -0,0 +1,9 @@
+package com.baeldung.apachecayenne.persistent;
+
+import com.baeldung.apachecayenne.persistent.auto._Author;
+
+public class Author extends _Author {
+
+    private static final long serialVersionUID = 1L; 
+
+}

persistence-modules/apache-cayenne/src/main/java/com/baeldung/apachecayenne/persistent/auto/_Article.java

@@ -0,0 +1,47 @@
+package com.baeldung.apachecayenne.persistent.auto;
+
+import org.apache.cayenne.CayenneDataObject;
+import org.apache.cayenne.exp.Property;
+
+import com.baeldung.apachecayenne.persistent.Author;
+
+/**
+ * Class _Article was generated by Cayenne.
+ * It is probably a good idea to avoid changing this class manually,
+ * since it may be overwritten next time code is regenerated.
+ * If you need to make any customizations, please use subclass.
+ */
+public abstract class _Article extends CayenneDataObject {
+
+    private static final long serialVersionUID = 1L; 
+
+    public static final String ID_PK_COLUMN = "id";
+
+    public static final Property<String> CONTENT = Property.create("content", String.class);
+    public static final Property<String> TITLE = Property.create("title", String.class);
+    public static final Property<Author> AUTHOR = Property.create("author", Author.class);
+
+    public void setContent(String content) {
+        writeProperty("content", content);
+    }
+    public String getContent() {
+        return (String)readProperty("content");
+    }
+
+    public void setTitle(String title) {
+        writeProperty("title", title);
+    }
+    public String getTitle() {
+        return (String)readProperty("title");
+    }
+
+    public void setAuthor(Author author) {
+        setToOneTarget("author", author, true);
+    }
+
+    public Author getAuthor() {
+        return (Author)readProperty("author");
+    }
+
+
+}

persistence-modules/apache-cayenne/src/main/java/com/baeldung/apachecayenne/persistent/auto/_Author.java

@@ -0,0 +1,44 @@
+package com.baeldung.apachecayenne.persistent.auto;
+
+import java.util.List;
+
+import org.apache.cayenne.CayenneDataObject;
+import org.apache.cayenne.exp.Property;
+
+import com.baeldung.apachecayenne.persistent.Article;
+
+/**
+ * Class _Author was generated by Cayenne.
+ * It is probably a good idea to avoid changing this class manually,
+ * since it may be overwritten next time code is regenerated.
+ * If you need to make any customizations, please use subclass.
+ */
+public abstract class _Author extends CayenneDataObject {
+
+    private static final long serialVersionUID = 1L; 
+
+    public static final String ID_PK_COLUMN = "id";
+
+    public static final Property<String> NAME = Property.create("name", String.class);
+    public static final Property<List<Article>> ARTICLES = Property.create("articles", List.class);
+
+    public void setName(String name) {
+        writeProperty("name", name);
+    }
+    public String getName() {
+        return (String)readProperty("name");
+    }
+
+    public void addToArticles(Article obj) {
+        addToManyTarget("articles", obj, true);
+    }
+    public void removeFromArticles(Article obj) {
+        removeToManyTarget("articles", obj, true);
+    }
+    @SuppressWarnings("unchecked")
+    public List<Article> getArticles() {
+        return (List<Article>)readProperty("articles");
+    }
+
+
+}

persistence-modules/apache-cayenne/src/main/resources/cayenne-project.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8"?>
+<domain project-version="9">
+	<map name="datamap"/>
+
+	<node name="datanode"
+		 factory="org.apache.cayenne.configuration.server.XMLPoolingDataSourceFactory"
+		 schema-update-strategy="org.apache.cayenne.access.dbsync.CreateIfNoSchemaStrategy"
+		>
+		<map-ref name="datamap"/>
+		<data-source>
+			<driver value="com.mysql.jdbc.Driver"/>
+			<url value="jdbc:mysql://localhost:3306/intro_cayenne"/>
+			<connectionPool min="1" max="1"/>
+			<login userName="root" password="root"/>
+		</data-source>
+	</node>
+</domain>

persistence-modules/apache-cayenne/src/main/resources/datamap.map.xml

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="utf-8"?>
+<data-map xmlns="http://cayenne.apache.org/schema/9/modelMap"
+	 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	 xsi:schemaLocation="http://cayenne.apache.org/schema/9/modelMap http://cayenne.apache.org/schema/9/modelMap.xsd"
+	 project-version="9">
+	<property name="defaultPackage" value="com.baeldung.apachecayenne.persistent"/>
+	<db-entity name="article" catalog="intro_cayenne">
+		<db-attribute name="author_id" type="INTEGER" isMandatory="true" length="10"/>
+		<db-attribute name="content" type="VARCHAR" isMandatory="true" length="254"/>
+		<db-attribute name="id" type="INTEGER" isPrimaryKey="true" isGenerated="true" isMandatory="true" length="10"/>
+		<db-attribute name="title" type="VARCHAR" isMandatory="true" length="254"/>
+	</db-entity>
+	<db-entity name="author" catalog="intro_cayenne">
+		<db-attribute name="id" type="INTEGER" isPrimaryKey="true" isGenerated="true" isMandatory="true" length="10"/>
+		<db-attribute name="name" type="VARCHAR" isMandatory="true" length="254"/>
+	</db-entity>
+	<obj-entity name="Article" className="com.baeldung.apachecayenne.persistent.Article" dbEntityName="article">
+		<obj-attribute name="content" type="java.lang.String" db-attribute-path="content"/>
+		<obj-attribute name="title" type="java.lang.String" db-attribute-path="title"/>
+	</obj-entity>
+	<obj-entity name="Author" className="com.baeldung.apachecayenne.persistent.Author" dbEntityName="author">
+		<obj-attribute name="name" type="java.lang.String" db-attribute-path="name"/>
+	</obj-entity>
+	<db-relationship name="author" source="article" target="author" toMany="false">
+		<db-attribute-pair source="author_id" target="id"/>
+	</db-relationship>
+	<db-relationship name="articles" source="author" target="article" toMany="true">
+		<db-attribute-pair source="id" target="author_id"/>
+	</db-relationship>
+	<obj-relationship name="author" source="Article" target="Author" deleteRule="Nullify" db-relationship-path="author"/>
+	<obj-relationship name="articles" source="Author" target="Article" deleteRule="Deny" db-relationship-path="articles"/>
+</data-map>

persistence-modules/apache-cayenne/src/main/resources/logback.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
+        <encoder>
+            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n
+            </pattern>
+        </encoder>
+    </appender>
+
+    <root level="INFO">
+        <appender-ref ref="STDOUT" />
+    </root>
+</configuration>

persistence-modules/apache-cayenne/src/test/java/com/baeldung/apachecayenne/CayenneAdvancedOperationLiveTest.java

@@ -0,0 +1,256 @@
+package com.baeldung.apachecayenne;
+
+import com.baeldung.apachecayenne.persistent.Author;
+import org.apache.cayenne.ObjectContext;
+import org.apache.cayenne.QueryResponse;
+import org.apache.cayenne.configuration.server.ServerRuntime;
+import org.apache.cayenne.exp.Expression;
+import org.apache.cayenne.exp.ExpressionFactory;
+import org.apache.cayenne.query.*;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.BeforeClass;
+import org.junit.Test;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static junit.framework.Assert.assertEquals;
+import static org.junit.Assert.assertNotNull;
+
+public class CayenneAdvancedOperationLiveTest {
+    private static ObjectContext context = null;
+
+    @BeforeClass
+    public static void setupTheCayenneContext() {
+        ServerRuntime cayenneRuntime = ServerRuntime.builder()
+          .addConfig("cayenne-project.xml")
+          .build();
+        context = cayenneRuntime.newContext();
+    }
+
+    @Before
+    public void saveThreeAuthors() {
+        Author authorOne = context.newObject(Author.class);
+        authorOne.setName("Paul Xavier");
+        Author authorTwo = context.newObject(Author.class);
+        authorTwo.setName("pAuL Smith");
+        Author authorThree = context.newObject(Author.class);
+        authorThree.setName("Vicky Sarra");
+        context.commitChanges();
+    }
+
+    @After
+    public void deleteAllAuthors() {
+        SQLTemplate deleteAuthors = new SQLTemplate(Author.class, "delete from author");
+        context.performGenericQuery(deleteAuthors);
+    }
+
+    @Test
+    public void givenAuthors_whenFindAllSQLTmplt_thenWeGetThreeAuthors() {
+        SQLTemplate select = new SQLTemplate(Author.class, "select * from Author");
+        List<Author> authors = context.performQuery(select);
+
+        assertEquals(authors.size(), 3);
+    }
+
+    @Test
+    public void givenAuthors_whenFindByNameSQLTmplt_thenWeGetOneAuthor() {
+        SQLTemplate select = new SQLTemplate(Author.class, "select * from Author where name = 'Vicky Sarra'");
+        List<Author> authors = context.performQuery(select);
+        Author author = authors.get(0);
+
+        assertEquals(authors.size(), 1);
+        assertEquals(author.getName(), "Vicky Sarra");
+    }
+
+    @Test
+    public void givenAuthors_whenLikeSltQry_thenWeGetOneAuthor() {
+        Expression qualifier = ExpressionFactory.likeExp(Author.NAME.getName(), "Paul%");
+        SelectQuery query = new SelectQuery(Author.class, qualifier);
+        List<Author> authorsTwo = context.performQuery(query);
+
+        assertEquals(authorsTwo.size(), 1);
+    }
+
+    @Test
+    public void givenAuthors_whenCtnsIgnorCaseSltQry_thenWeGetTwoAuthors() {
+        Expression qualifier = ExpressionFactory.containsIgnoreCaseExp(Author.NAME.getName(), "Paul");
+        SelectQuery query = new SelectQuery(Author.class, qualifier);
+        List<Author> authors = context.performQuery(query);
+
+        assertEquals(authors.size(), 2);
+    }
+
+    @Test
+    public void givenAuthors_whenCtnsIgnorCaseEndsWSltQry_thenWeGetTwoAuthors() {
+        Expression qualifier = ExpressionFactory.containsIgnoreCaseExp(Author.NAME.getName(), "Paul")
+                .andExp(ExpressionFactory.endsWithExp(Author.NAME.getName(), "h"));
+        SelectQuery query = new SelectQuery(Author.class, qualifier);
+        List<Author> authors = context.performQuery(query);
+
+        Author author = authors.get(0);
+
+        assertEquals(authors.size(), 1);
+        assertEquals(author.getName(), "pAuL Smith");
+    }
+
+    @Test
+    public void givenAuthors_whenAscOrderingSltQry_thenWeGetOrderedAuthors() {
+        SelectQuery query = new SelectQuery(Author.class);
+        query.addOrdering(Author.NAME.asc());
+
+        List<Author> authors = query.select(context);
+        Author firstAuthor = authors.get(0);
+
+        assertEquals(authors.size(), 3);
+        assertEquals(firstAuthor.getName(), "Paul Xavier");
+    }
+
+    @Test
+    public void givenAuthors_whenDescOrderingSltQry_thenWeGetOrderedAuthors() {
+        SelectQuery query = new SelectQuery(Author.class);
+        query.addOrdering(Author.NAME.desc());
+
+        List<Author> authors = query.select(context);
+        Author firstAuthor = authors.get(0);
+
+        assertEquals(authors.size(), 3);
+        assertEquals(firstAuthor.getName(), "pAuL Smith");
+    }
+
+    @Test
+    public void givenAuthors_onContainsObjS_thenWeGetOneRecord() {
+        List<Author> authors = ObjectSelect.query(Author.class)
+          .where(Author.NAME.contains("Paul"))
+          .select(context);
+
+        assertEquals(authors.size(), 1);
+    }
+
+    @Test
+    public void givenAuthors_whenLikeObjS_thenWeGetTwoAuthors() {
+        List<Author> authors = ObjectSelect.query(Author.class)
+          .where(Author.NAME.likeIgnoreCase("Paul%"))
+          .select(context);
+
+        assertEquals(authors.size(), 2);
+    }
+
+    @Test
+    public void givenTwoAuthor_whenEndsWithObjS_thenWeGetOrderedAuthors() {
+        List<Author> authors = ObjectSelect.query(Author.class)
+          .where(Author.NAME.endsWith("Sarra"))
+          .select(context);
+        Author firstAuthor = authors.get(0);
+
+        assertEquals(authors.size(), 1);
+        assertEquals(firstAuthor.getName(), "Vicky Sarra");
+    }
+
+    @Test
+    public void givenTwoAuthor_whenInObjS_thenWeGetAuthors() {
+        List<String> names = Arrays.asList("Paul Xavier", "pAuL Smith", "Vicky Sarra");
+        List<Author> authors = ObjectSelect.query(Author.class)
+                .where(Author.NAME.in(names))
+                .select(context);
+
+        assertEquals(authors.size(), 3);
+    }
+
+    @Test
+    public void givenTwoAuthor_whenNinObjS_thenWeGetAuthors() {
+        List<String> names = Arrays.asList("Paul Xavier", "pAuL Smith");
+        List<Author> authors = ObjectSelect.query(Author.class)
+                .where(Author.NAME.nin(names))
+                .select(context);
+        Author author = authors.get(0);
+
+        assertEquals(authors.size(), 1);
+        assertEquals(author.getName(), "Vicky Sarra");
+    }
+
+    @Test
+    public void givenTwoAuthor_whenIsNotNullObjS_thenWeGetAuthors() {
+        List<Author> authors = ObjectSelect.query(Author.class)
+          .where(Author.NAME.isNotNull())
+          .select(context);
+
+        assertEquals(authors.size(), 3);
+    }
+
+    @Test
+    public void givenAuthors_whenFindAllEJBQL_thenWeGetThreeAuthors() {
+        EJBQLQuery query = new EJBQLQuery("select a FROM Author a");
+        List<Author> authors = context.performQuery(query);
+
+        assertEquals(authors.size(), 3);
+    }
+
+    @Test
+    public void givenAuthors_whenFindByNameEJBQL_thenWeGetOneAuthor() {
+        EJBQLQuery query = new EJBQLQuery("select a FROM Author a WHERE a.name = 'Vicky Sarra'");
+        List<Author> authors = context.performQuery(query);
+        Author author = authors.get(0);
+
+        assertEquals(authors.size(), 1);
+        assertEquals(author.getName(), "Vicky Sarra");
+    }
+
+    @Test
+    public void givenAuthors_whenUpdadingByNameEJBQL_thenWeGetTheUpdatedAuthor() {
+        EJBQLQuery query = new EJBQLQuery("UPDATE Author AS a SET a.name = 'Vicky Edison' WHERE a.name = 'Vicky Sarra'");
+        QueryResponse queryResponse = context.performGenericQuery(query);
+
+        EJBQLQuery queryUpdatedAuthor = new EJBQLQuery("select a FROM Author a WHERE a.name = 'Vicky Edison'");
+        List<Author> authors = context.performQuery(queryUpdatedAuthor);
+        Author author = authors.get(0);
+
+        assertNotNull(author);
+    }
+
+    @Test
+    public void givenAuthors_whenSeletingNamesEJBQL_thenWeGetListWithSizeThree() {
+        String [] args = {"Paul Xavier", "pAuL Smith", "Vicky Sarra"};
+        List<String> names = Arrays.asList(args);
+        EJBQLQuery query = new EJBQLQuery("select a.name FROM Author a");
+        List<String> nameList = context.performQuery(query);
+
+        Collections.sort(names);
+        Collections.sort(nameList);
+
+        assertEquals(names.size(), 3);
+        assertEquals(nameList.size(), 3);
+        assertEquals(names, nameList);
+    }
+
+    @Test
+    public void givenAuthors_whenDeletingAllWithEJB_thenWeGetNoAuthor() {
+        EJBQLQuery deleteQuery = new EJBQLQuery("delete FROM Author");
+        EJBQLQuery findAllQuery = new EJBQLQuery("select a FROM Author a");
+
+        context.performQuery(deleteQuery);
+        List<Author> objects = context.performQuery(findAllQuery);
+
+        assertEquals(objects.size(), 0);
+    }
+
+    @Test
+    public void givenAuthors_whenInsertingSQLExec_thenWeGetNewAuthor() {
+        int inserted = SQLExec
+          .query("INSERT INTO Author (name) VALUES ('Baeldung')")
+          .update(context);
+
+        assertEquals(inserted, 1);
+    }
+
+    @Test
+    public void givenAuthors_whenUpdatingSQLExec_thenItsUpdated() {
+        int updated = SQLExec
+          .query("UPDATE Author SET name = 'Baeldung' WHERE name = 'Vicky Sarra'")
+          .update(context);
+
+        assertEquals(updated, 1);
+    }
+}

persistence-modules/apache-cayenne/src/test/java/com/baeldung/apachecayenne/CayenneOperationLiveTest.java

@@ -0,0 +1,131 @@
+package com.baeldung.apachecayenne;
+
+import com.baeldung.apachecayenne.persistent.Article;
+import com.baeldung.apachecayenne.persistent.Author;
+import org.apache.cayenne.ObjectContext;
+import org.apache.cayenne.configuration.server.ServerRuntime;
+import org.apache.cayenne.query.ObjectSelect;
+import org.apache.cayenne.query.SQLTemplate;
+import org.junit.After;
+import org.junit.BeforeClass;
+import org.junit.Test;
+
+import java.util.List;
+
+import static junit.framework.Assert.assertEquals;
+import static org.junit.Assert.assertNull;
+
+
+public class CayenneOperationLiveTest {
+    private static ObjectContext context = null;
+
+    @BeforeClass
+    public static void setupTheCayenneContext() {
+        ServerRuntime cayenneRuntime = ServerRuntime.builder()
+                .addConfig("cayenne-project.xml")
+                .build();
+        context = cayenneRuntime.newContext();
+    }
+
+    @After
+    public void deleteAllRecords() {
+        SQLTemplate deleteArticles = new SQLTemplate(Article.class, "delete from article");
+        SQLTemplate deleteAuthors = new SQLTemplate(Author.class, "delete from author");
+
+        context.performGenericQuery(deleteArticles);
+        context.performGenericQuery(deleteAuthors);
+    }
+
+    @Test
+    public void givenAuthor_whenInsert_thenWeGetOneRecordInTheDatabase() {
+        Author author = context.newObject(Author.class);
+        author.setName("Paul");
+
+        context.commitChanges();
+
+        long records = ObjectSelect.dataRowQuery(Author.class).selectCount(context);
+        assertEquals(1, records);
+    }
+
+    @Test
+    public void givenAuthor_whenInsert_andQueryByFirstName_thenWeGetTheAuthor() {
+        Author author = context.newObject(Author.class);
+        author.setName("Paul");
+
+        context.commitChanges();
+
+        Author expectedAuthor = ObjectSelect.query(Author.class)
+                .where(Author.NAME.eq("Paul"))
+                .selectOne(context);
+
+        assertEquals("Paul", expectedAuthor.getName());
+    }
+
+    @Test
+    public void givenTwoAuthor_whenInsert_andQueryAll_thenWeGetTwoAuthors() {
+        Author firstAuthor = context.newObject(Author.class);
+        firstAuthor.setName("Paul");
+
+        Author secondAuthor = context.newObject(Author.class);
+        secondAuthor.setName("Ludovic");
+
+        context.commitChanges();
+
+        List<Author> authors = ObjectSelect.query(Author.class).select(context);
+        assertEquals(2, authors.size());
+    }
+
+    @Test
+    public void givenAuthor_whenUpdating_thenWeGetAnUpatedeAuthor() {
+        Author author = context.newObject(Author.class);
+        author.setName("Paul");
+        context.commitChanges();
+
+        Author expectedAuthor = ObjectSelect.query(Author.class)
+                .where(Author.NAME.eq("Paul"))
+                .selectOne(context);
+        expectedAuthor.setName("Garcia");
+        context.commitChanges();
+
+        assertEquals(author.getName(), expectedAuthor.getName());
+    }
+
+    @Test
+    public void givenAuthor_whenDeleting_thenWeLostHisDetails() {
+        Author author = context.newObject(Author.class);
+        author.setName("Paul");
+        context.commitChanges();
+
+        Author savedAuthor = ObjectSelect.query(Author.class)
+                .where(Author.NAME.eq("Paul")).selectOne(context);
+        if(savedAuthor != null) {
+            context.deleteObjects(author);
+            context.commitChanges();
+        }
+
+        Author expectedAuthor = ObjectSelect.query(Author.class)
+                .where(Author.NAME.eq("Paul")).selectOne(context);
+        assertNull(expectedAuthor);
+    }
+
+    @Test
+    public void givenAuthor_whenAttachingToArticle_thenTheRelationIsMade() {
+        Author author = context.newObject(Author.class);
+        author.setName("Paul");
+
+        Article article = context.newObject(Article.class);
+        article.setTitle("My post title");
+        article.setContent("The content");
+        article.setAuthor(author);
+
+        context.commitChanges();
+
+        Author expectedAuthor = ObjectSelect.query(Author.class)
+                .where(Author.NAME.eq("Paul"))
+                .selectOne(context);
+
+        Article expectedArticle = (expectedAuthor.getArticles()).get(0);
+        assertEquals(article.getTitle(), expectedArticle.getTitle());
+    }
+
+}