5:29 p.m.
Author: pete.muir(a)jboss.org
Date: 2008-01-18 11:29:50 -0500 (Fri, 18 Jan 2008)
New Revision: 7148
Modified:
trunk/doc/reference/en/modules/testing.xml
Log:
JBSEAM-2506
Modified: trunk/doc/reference/en/modules/testing.xml
===================================================================
--- trunk/doc/reference/en/modules/testing.xml 2008-01-18 12:37:49 UTC (rev 7147)
+++ trunk/doc/reference/en/modules/testing.xml 2008-01-18 16:29:50 UTC (rev 7148)
@@ -21,108 +21,70 @@
environment.
</para>
<para>
- Consider the following Seam component:
+ Consider the following Seam Component which creates a statement of
+ account for a customer:
</para>
<programlisting><![CDATA[@Stateless
@Scope(EVENT)
-@Name("register")
-public class RegisterAction implements Register
-{
- private User user;
- private EntityManager em;
-
+@Name("statementOfAccount")
+public class StatementOfAccount {
+
+ @In(create=true) EntityManager entityManager
+
+ private double statementTotal;
+
@In
- public void setUser(User user) {
- this.user = user;
- }
+ private Customer customer;
- @PersistenceContext
- public void setBookingDatabase(EntityManager em) {
- this.em = em;
+ @Create
+ public void create() {
+ List<Invoice> invoices = entityManager
+ .createQuery("select invoice from Invoice invoice where invoice.customer =
:customer")
+ .setParameter("customer", customer)
+ .getResultList();
+ statementTotal = calculateTotal(invoices);
}
- public String register()
- {
- List existing = em.createQuery("select username from User where
username=:username")
- .setParameter("username", user.getUsername())
- .getResultList();
- if (existing.size()==0)
+ public double calculateTotal(List<Invoice> invoices) {
+ double total = 0.0;
+ for (Invoice invoice: invoices)
{
- em.persist(user);
- return "success";
+ double += invoice.getTotal();
}
- else
- {
- return null;
- }
+ return total;
}
-
+
+ // getter and setter for statementTotal
+
}]]></programlisting>
<para>
- We could write a TestNG test for this component as follows:
+ We could write a unit test for the calculateTotal method (which tests
+ the business logic of the component) as follows:
</para>
- <programlisting><![CDATA[public class RegisterActionTest
-{
-
- @Test
- public testRegisterAction()
- {
- EntityManager em = getEntityManagerFactory().createEntityManager();
- em.getTransaction().begin();
-
- User gavin = new User();
- gavin.setName("Gavin King");
- gavin.setUserName("1ovthafew");
- gavin.setPassword("secret");
-
- RegisterAction action = new RegisterAction();
- action.setUser(gavin);
- action.setBookingDatabase(em);
-
- assert "success".equals( action.register() );
-
- em.getTransaction().commit();
- em.close();
- }
+ <programlisting><![CDATA[public class StatementOfAccountTest {
-
- private EntityManagerFactory emf;
-
- public EntityManagerFactory getEntityManagerFactory()
- {
- return emf;
- }
-
- @BeforeClass
- public void init()
- {
- emf =
Persistence.createEntityManagerFactory("myResourceLocalEntityManager");
- }
-
- @AfterClass
- public void destroy()
- {
- emf.close();
- }
-
+ @Test
+ public testCalculateTotal {
+ List<Invoice> invoices = generateTestInvoices(); // A test data generator
+ double statementTotal = new StatementOfAccount().calculateTotal(invoices);
+ assert statementTotal = 123.45;
+ }
}
]]></programlisting>
<para>
- The Java Persistence API can be used with both Java SE and Java EE
—
- when the above component is used inside an Application Server (Java
- EE) the container is responsible for transaction management, however
- in the unit test (Java SE) the transaction must be managed
- explicitly using a resource local entity manager. This requires
- configuration in <literal>persistence.xml</literal>.
+ You'll notice we aren't testing retrieving data from or persisting
+ data to the database; nor are we testing any functionality
+ provided by Seam. We are just testing the logic of our POJOs. Seam
+ components don't usually depend directly upon container infrastructure,
+ so most unit testing as as easy as that!
</para>
<para>
- Seam components don't usually depend directly upon container
infrastructure,
- so most unit testing as as easy as that!
- </para>
+ However, if you want to test the entire application, read on.
+ </para>
</section>