From seam-commits at lists.jboss.org Mon Oct 8 17:33:11 2012 Content-Type: multipart/mixed; boundary="===============6276844002243418512==" MIME-Version: 1.0 From: seam-commits at lists.jboss.org To: seam-commits at lists.jboss.org Subject: [seam-commits] Seam SVN: r15225 - branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US. Date: Mon, 08 Oct 2012 17:33:10 -0400 Message-ID: <201210082133.q98LXAca032326@svn01.web.mwc.hst.phx2.redhat.com> --===============6276844002243418512== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: manaRH Date: 2012-10-08 17:33:10 -0400 (Mon, 08 Oct 2012) New Revision: 15225 Modified: branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US/Tutor= ial.xml Log: JBSEAM-5051 doc issues Modified: branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-U= S/Tutorial.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US/Tuto= rial.xml 2012-10-08 15:33:24 UTC (rev 15224) +++ branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US/Tuto= rial.xml 2012-10-08 21:33:10 UTC (rev 15225) @@ -130,7 +130,7 @@
The entity bean: <literal>User.java</literal></titl= e> = - <para> We need an EJB entity bean for user data. This clas= s defines <emphasis>persistence</emphasis> and + <para> We need an JPA entity bean for user data. This clas= s defines <emphasis>persistence</emphasis> and <emphasis>validation</emphasis> declaratively, via= annotations. It also needs some extra annotations that define the class as a Seam component.= </para> <!-- Can't use code hightlighting with callouts --> @@ -204,7 +204,7 @@ }]]></programlisting> <calloutlist> <callout arearefs=3D"registration-entity-annot= ation"> - <para> The EJB3 standard <literal>@Entity<= /literal> annotation indicates that the + <para> The JPA standard <literal>@Entity</= literal> annotation indicates that the <literal>User</literal> class is a= n entity bean. </para> </callout> <callout arearefs=3D"registration-name-annotat= ion"> @@ -227,7 +227,7 @@ </para> </callout> <callout arearefs=3D"registration-table-annota= tion"> - <para> The EJB standard <literal>@Table</l= iteral> annotation indicates that the + <para> The JPA standard <literal>@Table</l= iteral> annotation indicates that the <literal>User</literal> class is m= apped to the <literal>users</literal> table. </para> </callout> @@ -239,7 +239,7 @@ render response and update model value= s phases. </para> </callout> <callout arearefs=3D"registration-empty-constr= uctor"> - <para> An empty constructor is both requir= ed by both the EJB specification and by Seam. + <para> An empty constructor is both requir= ed by both the JPA specification and by Seam. </para> </callout> <callout arearefs=3D"registration-notnull"> @@ -250,7 +250,7 @@ persistence). </para> </callout> <callout arearefs=3D"registration-id-annotatio= n"> - <para> The EJB standard <literal>@Id</lite= ral> annotation indicates the primary key + <para> The JPA standard <literal>@Id</lite= ral> annotation indicates the primary key attribute of the entity bean. </para> </callout> </calloutlist> @@ -340,21 +340,21 @@ </callout> <callout arearefs=3D"registration-persistencec= ontext-annotation"> <para> The EJB standard <literal>@Persiste= nceContext</literal> annotation is used to - inject the EJB3 entity manager. </para> + inject the JPA entity manager. </para> </callout> <callout arearefs=3D"registration-logger-annot= ation"> <para> The Seam <literal>@Logger</literal>= annotation is used to inject the component's <literal>Log</literal> instance. <= /para> </callout> <callout arearefs=3D"registration-action-liste= ner"> - <para> The action listener method uses the= standard EJB3 + <para> The action listener method uses the= standard JPA <literal>EntityManager</literal> API t= o interact with the database, and returns the JSF outcome. Note that, since this is = a session bean, a transaction is automatically begun when the <literal>register()</li= teral> method is called, and committed when it completes. </para> </callout> <callout arearefs=3D"registration-query"> - <para> Notice that Seam lets you use a JSF= EL expression inside EJB-QL. Under the + <para> Notice that Seam lets you use a JSF= EL expression inside JPQL. Under the covers, this results in an ordinary JP= A <literal>setParameter()</literal> call on the standard JPA <literal>Query</liter= al> object. Nice, huh? </para> </callout> @@ -657,9 +657,9 @@ </section> = <section> - <title>The EJB persistence deployment descriptor: <literal= >persistence.xml</literal> + The JPA persistence deployment descriptor: <literal= >persistence.xml</literal> = - The persistence.xml file tells t= he EJB persistence provider where to find the + The persistence.xml file tells t= he JPA persistence provider where to find the datasource, and contains some vendor-specific settings= . In this case, enables automatic schema export at startup time. = @@ -760,7 +760,7 @@ Clickable lists in Seam: the messages example = Clickable lists of database search results are such an impo= rtant part of any online application that Seam - provides special functionality on top of JSF to make it easier= to query data using EJB-QL or HQL and display + provides special functionality on top of JSF to make it easier= to query data using JPQL or HQL and display it as a clickable list using a JSF <h:dataTable>= ;. The messages example demonstrates this functionality. = @@ -942,7 +942,7 @@ named message. - This stateful bean has an EJB3 extended persistence context. + This stateful bean has an JPA extended persistence context. The messages retrieved in the query re= main in the managed state as long as the bean exists, so any subsequent method calls= to the stateful bean can update them without needing to make any explicit call to t= he EntityManager. @@ -1083,7 +1083,7 @@ = If the user clicks the <h:commandButton>= , JSF calls the delete() action listener. Seam inte= rcepts this call and injects the selected row - data into the message attribute of the = messageList component. The + data into the message attribute of the = messageManager component. The action listener fires, removing the selected Mess= age from the list, and also calling remove() on the EntityMana= ger. At the end of the call, Seam refreshes the messageList context varia= ble and clears the context variable named --===============6276844002243418512==--