Skip to content

Added javadoc for jpa criteria project. #195

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
aslakknutsen merged 1 commit into from
Jan 13, 2014
Merged

Added javadoc for jpa criteria project. #195

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions jpa/criteria/pom.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,4 +10,6 @@

<artifactId>criteria</artifactId>
<packaging>war</packaging>
<name>JPA Criteria API</name>
<description>Using the Criteria API to create queries</description>
</project>
53 changes: 45 additions & 8 deletions jpa/criteria/src/test/java/org/javaee7/jpa/criteria/JpaCriteriaTest.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,46 @@
import static org.junit.Assert.*;

/**
* In this sample we're going to query a simple +JPA Entity+, using the +JPA Criteria API+ and perform a select,
* update and delete operations.
*
* The following +JPA Entity+, represents a Movie which has a name and a comma separated list of actors:
*
* include::Movie[]
*
* The select, update and delete operations are exposed using a simple stateless ejb.
*
* Select every movie:
* include::MovieBean#listMovies[]
*
* Update all the name of the movies to "INCEPTION" where the name of the movie is "Inception":
* include::MovieBean#updateMovie[]
*
* Delete all movies where the name of the movie is "Matrix":
* include::MovieBean#deleteMovie[]
*
* @author Roberto Cortez
*/
@RunWith(Arquillian.class)
public class JpaCriteriaTest {
@Inject
private MovieBean movieBean;

/**
* We're just going to deploy the application as a +web archive+. Note the inclusion of the following files:
*
* [source,file]
* ----
* /META-INF/persistence.xml
* /META-INF/create.sql
* /META-INF/drop.sql
* /META-INF/load.sql
* ----
*
* The +persistence.xml+ file is needed of course for the persistence unit definition. A datasource is not
* needed, since we can now use the new default datasource available in +JEE7+. We're also using the new
* +javax.persistence.schema-generation.*+ propertires to create, populate and drop the database.
*/
@Deployment
public static WebArchive createDeployment() {
WebArchive war = ShrinkWrap.create(WebArchive.class)
Expand All @@ -32,24 +65,28 @@ public static WebArchive createDeployment() {
return war;
}

/**
* In the test, we're just going to invoke the different operations in sequence keeping in mind that each
* invocation might be dependent of the previous invoked operation.
*/
@Test
public void testCriteria() {
List<Movie> movies = movieBean.listMovies();
assertEquals(4, movies.size());
List<Movie> movies = movieBean.listMovies(); // <1> Get a list of all the movies in the database.
assertEquals(4, movies.size()); // <2> 4 movies loaded on the db, so the size shoud be 4.
assertTrue(movies.contains(new Movie(1)));
assertTrue(movies.contains(new Movie(2)));
assertTrue(movies.contains(new Movie(3)));
assertTrue(movies.contains(new Movie(4)));

movieBean.updateMovie();
movieBean.updateMovie(); // <3> Update name to "INCEPTION" where name is "Inception"
movies = movieBean.listMovies();
assertEquals(4, movies.size());
assertEquals("INCEPTION", movies.get(2).getName());
assertEquals(4, movies.size()); // <4> Size of movies should still be 4.
assertEquals("INCEPTION", movies.get(2).getName()); // <5> Verify the movie name change.

movieBean.deleteMovie();
movieBean.deleteMovie(); // <6> Now delete the movie "Matrix"
movies = movieBean.listMovies();
assertFalse(movies.isEmpty());
assertEquals(3, movies.size());
assertFalse(movies.contains(new Movie(1)));
assertEquals(3, movies.size()); // <7> Size of movies should be 3 now.
assertFalse(movies.contains(new Movie(1))); // <8> Check if the movie "Matrix" is not on the list.
}
}