[jboss-cvs] JBossAS SVN: r103804 - projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US.

jboss-cvs-commits at lists.jboss.org jboss-cvs-commits at lists.jboss.org
Mon Apr 12 02:41:07 EDT 2010


Author: laubai
Date: 2010-04-12 02:41:07 -0400 (Mon, 12 Apr 2010)
New Revision: 103804

Added:
   projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP08.ent
   projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP08.xml
Removed:
   projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP07.ent
   projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP07.xml
Modified:
   projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Book_Info.xml
Log:
Updated version number for CP08.

Modified: projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Book_Info.xml
===================================================================
--- projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Book_Info.xml	2010-04-12 06:40:38 UTC (rev 103803)
+++ projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Book_Info.xml	2010-04-12 06:41:07 UTC (rev 103804)
@@ -2,8 +2,8 @@
 <!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
 ]>
 <bookinfo id="Seam_Reference_Guide-Seam___Contextual_Components">
-	<title>Seam Reference Guide CP07</title>
-	<subtitle>for Use with JBoss Enterprise Application Platform 4.3 Cumulative Patch 7</subtitle>
+	<title>Seam Reference Guide CP08</title>
+	<subtitle>for Use with JBoss Enterprise Application Platform 4.3 Cumulative Patch 8</subtitle>
 	<edition>2.0</edition>
 	<pubsnumber>5</pubsnumber>
 	<productname>JBoss Enterprise Application Platform</productname>

Deleted: projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP07.ent
===================================================================
--- projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP07.ent	2010-04-12 06:40:38 UTC (rev 103803)
+++ projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP07.ent	2010-04-12 06:41:07 UTC (rev 103804)
@@ -1,2 +0,0 @@
-<!ENTITY HOLDER "Red Hat, Inc">
-<!ENTITY YEAR "2009">

Deleted: projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP07.xml
===================================================================
--- projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP07.xml	2010-04-12 06:40:38 UTC (rev 103803)
+++ projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP07.xml	2010-04-12 06:41:07 UTC (rev 103804)
@@ -1,165 +0,0 @@
-<?xml version='1.0'?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-]>
-
-<book>
-	<xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<toc></toc><preface id="Seam_Reference_Guide-Introduction_to_JBoss_Seam">
-		<title>Introduction to JBoss Seam</title>
-		<para>
-			Seam is an application framework for Java EE 5. It is inspired by the following principles:
-		</para>
-		<variablelist>
-			<varlistentry>
-				<term><emphasis>Integrate JSF with EJB 3.0</emphasis></term>
-				<listitem>
-					<para>
-						JSF and EJB 3.0 are two of the best new features of Java EE 5. EJB3 is a brand new component model for server side business and persistence logic. Meanwhile, JSF is a great component model for the presentation tier. Unfortunately, neither component model is able to solve all problems in computing by itself. Indeed, JSF and EJB3 work best when used together. But the Java EE 5 specification provides no standard way to integrate the two component models. Fortunately, the creators of both models anticipated this situation and provided standard extension points to allow extension and integration of other solutions.
-					</para>
-					<para>
-						Seam unifies the component models of JSF and EJB3, allowing the developer to concentrate on the business problem.
-					</para>
-				</listitem>
-			</varlistentry>
-			<varlistentry>
-				<term><emphasis>Integrated AJAX</emphasis></term>
-				<listitem>
-					<para>
-						Seam supports two open source JSF-based AJAX solutions: ICEfaces and Ajax4JSF. These solutions let you add AJAX capability to your user interface without the need to write any JavaScript code.
-					</para>
-					<para>
-						Seam also provides a built-in JavaScript remoting layer for EJB3 components. AJAX clients can easily call server-side components and subscribe to JMS topics, without the need for an intermediate action layer.
-					</para>
-					<para>
-						Neither of these approaches would work well, were it not for Seam's built-in concurrency and state management, which ensures that many concurrent fine-grained, asynchronous AJAX requests are handled safely and efficiently on the server side.
-					</para>
-				</listitem>
-			</varlistentry>
-			<varlistentry>
-				<term><emphasis>Integrate Business Process as a First Class Construct</emphasis></term>
-				<listitem>
-					<para>
-						Optionally, Seam integrates transparent business process management via jBPM. This allows for complex workflows to easily be implemented using jBPM and Seam.
-					</para>
-					<para>
-						Seam even allows definition of presentation tier conversation flow by the same means.
-					</para>
-					<para>
-						JSF provides an incredibly rich event model for the presentation tier. Seam enhances this model by exposing jBPM's business process related events via exactly the same event handling mechanism, providing a uniform event model for Seam's uniform component model.
-					</para>
-				</listitem>
-			</varlistentry>
-			<varlistentry>
-				<term><emphasis>The uniform component model</emphasis></term>
-				<listitem>
-					<para>
-						Seam provides a uniform component model. A Seam component may be stateful, with the state associated to any one of a number of contexts, ranging from the long-running business process to a single web request.
-					</para>
-					<para>
-						There is no distinction between presentation tier components and business logic components in Seam. It is possible to write Seam applications where <emphasis>everything</emphasis> is an EJB. EJB 3.0 completely changes the nature of EJB from the point of view of the developer. An EJB is a fine-grained object, no more complex than an annotated JavaBean. Seam even encourages you to use session beans as JSF action listeners.
-					</para>
-					<para>
-						Unlike plain Java EE or J2EE components, Seam components may <emphasis>simultaneously</emphasis> access state associated with the web request and state held in transactional resources (without the need to propagate web request state manually via method parameters). You might object that the application layering imposed upon you by the old J2EE platform was a Good Thing. Well, nothing stops you creating an equivalent layered architecture using Seam - the difference is that <emphasis>you</emphasis> get to architect your own application and decide what the layers are and how they work together.
-					</para>
-				</listitem>
-			</varlistentry>
-			<varlistentry>
-				<term><emphasis>Declarative State Management</emphasis></term>
-				<listitem>
-					<para>
-						We are all used to the concept of declarative transaction management and J2EE declarative security from EJB 2.x. EJB 3.0 even introduces declarative persistence context management. These are three examples of a broader problem of managing state that is associated with a particular <emphasis>context</emphasis>, while ensuring that all needed cleanup occurs when the context ends. Seam takes the concept of declarative state management much further and applies it to <emphasis>application state</emphasis>. Traditionally, J2EE applications almost always implement state management manually, by getting and setting servlet session and request attributes. This approach to state management is the source of many bugs and memory leaks when applications fail to clean up session attributes, or when session data associated with different workflows collides in a multi-window application. Seam has the potential to almost entirely eliminate this class of bugs.
-					</para>
-					<para>
-						Declarative application state management is made possible by the richness of the <emphasis>context model</emphasis> defined by Seam. Seam extends the context model defined by the servlet spec&mdash;request, session, application&mdash;with two new contexts&mdash;conversation and business process&mdash;that are more meaningful from the point of view of the business logic.
-					</para>
-				</listitem>
-			</varlistentry>
-			<varlistentry>
-				<term><emphasis>Bijection</emphasis></term>
-				<listitem>
-					<para>
-						The notion of <emphasis>Inversion of Control</emphasis> or <emphasis>dependency injection</emphasis> exists in both JSF and EJB3, as well as in numerous simpler containers. Most of these containers emphasize injection of components that implement <emphasis>stateless services</emphasis>. Even when injection of stateful components is supported (such as in JSF), it is virtually useless for handling application state because the scope of the stateful component cannot be defined with sufficient flexibility.
-					</para>
-					<para>
-						<emphasis>Bijection</emphasis> differs from IoC in that it is <emphasis>dynamic</emphasis>, <emphasis>contextual</emphasis>, and <emphasis>bidirectional</emphasis>. You can think of it as a mechanism for aliasing contextual variables (names in the various contexts bound to the current thread) to attributes of the component. Bijection allows auto-assembly of stateful components by the container. It even allows a component to safely and easily manipulate the value of a context variable, just by assigning to an attribute of the component.
-					</para>
-				</listitem>
-			</varlistentry>
-			<varlistentry>
-				<term><emphasis>Workspace Management</emphasis></term>
-				<listitem>
-					<para>
-						Optionally, Seam applications may take advantage of <emphasis>workspace management</emphasis>, allowing users to freely switch between different conversations (workspaces) in a single browser window. Seam provides not only correct multi-window operation, but also multi-window-like operation in a single window!
-					</para>
-				</listitem>
-			</varlistentry>
-			<varlistentry>
-				<term><emphasis>Annotated POJOs Everywhere</emphasis></term>
-				<listitem>
-					<para>
-						EJB 3.0 embraces annotations and <emphasis>configuration by exception</emphasis> as the easiest way to provide information to the container in a declarative form. Unfortunately, JSF is still heavily dependent on verbose XML configuration files. Seam extends the annotations provided by EJB 3.0 with a set of annotations for declarative state management and declarative context demarcation. This lets you eliminate the noisy JSF managed bean declarations and reduce the required XML to just that information which truly belongs in XML (the JSF navigation rules).
-					</para>
-				</listitem>
-			</varlistentry>
-			<varlistentry>
-				<term><emphasis>Testability as a Core Feature</emphasis></term>
-				<listitem>
-					<para>
-						Seam components, being POJOs, are by nature unit testable. But for complex applications, unit testing alone is insufficient. Integration testing has traditionally been a messy and difficult task for Java web applications. Therefore, Seam provides for testability of Seam applications as a core feature of the framework. You can easily write JUnit or TestNG tests that reproduce a whole interaction with a user, exercising all components of the system apart from the view (the JSP or Facelets page). You can run these tests directly inside your IDE, where Seam will automatically deploy EJB components into the JBoss Embeddable EJB3 container.
-					</para>
-				</listitem>
-			</varlistentry>
-			<varlistentry>
-				<term><emphasis>Get started now!</emphasis></term>
-				<listitem>
-					<para>
-						Seam works in any application server that supports EJB 3.0. You can even use Seam in a servlet container like Tomcat, or in any J2EE application server, by leveraging the new JBoss Embeddable EJB3 container.
-					</para>
-					<para>
-						However, we realize that not everyone is ready to make the switch to EJB 3.0. So, in the interim, you can use Seam as a framework for applications that use JSF for presentation, Hibernate (or plain JDBC) for persistence and JavaBeans for application logic. Then, when you&#39;re ready to make the switch to EJB 3.0, migration will be straightforward.
-					</para>
-				</listitem>
-			</varlistentry>
-		</variablelist>
-		<mediaobject>
-			<imageobject role="fo">
-				<imagedata align="center" fileref="images/architecture.png" />
-			</imageobject>
-		</mediaobject>
-		<para>
-			It turns out that the combination of Seam, JSF and EJB3 is <emphasis>the</emphasis> simplest way to write a complex web application in Java. You won&#39;t believe how little code is required!
-		</para>
-	</preface>
-	<xi:include href="Tutorial.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<!-- Seam-gen is not included with the JBEAP 4.2 platform, so we're removing this chapter -->
-	<!-- <xi:include href="Gettingstarted.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -->
-	<xi:include href="Concepts.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Xml.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Events.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Conversations.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Jbpm.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Persistence.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Validation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Framework.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Drools.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Security.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="I18n.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Text.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Itext.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Mail.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Jms.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Cache.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Remoting.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Spring.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Configuration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Annotations.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Components.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Controls.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Elenhancements.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Testing.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="Tools.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Revision_History.xml"/>
-
-</book>
-

Copied: projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP08.ent (from rev 103783, projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP07.ent)
===================================================================
--- projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP08.ent	                        (rev 0)
+++ projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP08.ent	2010-04-12 06:41:07 UTC (rev 103804)
@@ -0,0 +1,2 @@
+<!ENTITY HOLDER "Red Hat, Inc">
+<!ENTITY YEAR "2010">

Copied: projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP08.xml (from rev 103783, projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP07.xml)
===================================================================
--- projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP08.xml	                        (rev 0)
+++ projects/docs/enterprise/4.3.8/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP08.xml	2010-04-12 06:41:07 UTC (rev 103804)
@@ -0,0 +1,165 @@
+<?xml version='1.0'?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<book>
+	<xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<toc></toc><preface id="Seam_Reference_Guide-Introduction_to_JBoss_Seam">
+		<title>Introduction to JBoss Seam</title>
+		<para>
+			Seam is an application framework for Java EE 5. It is inspired by the following principles:
+		</para>
+		<variablelist>
+			<varlistentry>
+				<term><emphasis>Integrate JSF with EJB 3.0</emphasis></term>
+				<listitem>
+					<para>
+						JSF and EJB 3.0 are two of the best new features of Java EE 5. EJB3 is a brand new component model for server side business and persistence logic. Meanwhile, JSF is a great component model for the presentation tier. Unfortunately, neither component model is able to solve all problems in computing by itself. Indeed, JSF and EJB3 work best when used together. But the Java EE 5 specification provides no standard way to integrate the two component models. Fortunately, the creators of both models anticipated this situation and provided standard extension points to allow extension and integration of other solutions.
+					</para>
+					<para>
+						Seam unifies the component models of JSF and EJB3, allowing the developer to concentrate on the business problem.
+					</para>
+				</listitem>
+			</varlistentry>
+			<varlistentry>
+				<term><emphasis>Integrated AJAX</emphasis></term>
+				<listitem>
+					<para>
+						Seam supports two open source JSF-based AJAX solutions: ICEfaces and Ajax4JSF. These solutions let you add AJAX capability to your user interface without the need to write any JavaScript code.
+					</para>
+					<para>
+						Seam also provides a built-in JavaScript remoting layer for EJB3 components. AJAX clients can easily call server-side components and subscribe to JMS topics, without the need for an intermediate action layer.
+					</para>
+					<para>
+						Neither of these approaches would work well, were it not for Seam's built-in concurrency and state management, which ensures that many concurrent fine-grained, asynchronous AJAX requests are handled safely and efficiently on the server side.
+					</para>
+				</listitem>
+			</varlistentry>
+			<varlistentry>
+				<term><emphasis>Integrate Business Process as a First Class Construct</emphasis></term>
+				<listitem>
+					<para>
+						Optionally, Seam integrates transparent business process management via jBPM. This allows for complex workflows to easily be implemented using jBPM and Seam.
+					</para>
+					<para>
+						Seam even allows definition of presentation tier conversation flow by the same means.
+					</para>
+					<para>
+						JSF provides an incredibly rich event model for the presentation tier. Seam enhances this model by exposing jBPM's business process related events via exactly the same event handling mechanism, providing a uniform event model for Seam's uniform component model.
+					</para>
+				</listitem>
+			</varlistentry>
+			<varlistentry>
+				<term><emphasis>The uniform component model</emphasis></term>
+				<listitem>
+					<para>
+						Seam provides a uniform component model. A Seam component may be stateful, with the state associated to any one of a number of contexts, ranging from the long-running business process to a single web request.
+					</para>
+					<para>
+						There is no distinction between presentation tier components and business logic components in Seam. It is possible to write Seam applications where <emphasis>everything</emphasis> is an EJB. EJB 3.0 completely changes the nature of EJB from the point of view of the developer. An EJB is a fine-grained object, no more complex than an annotated JavaBean. Seam even encourages you to use session beans as JSF action listeners.
+					</para>
+					<para>
+						Unlike plain Java EE or J2EE components, Seam components may <emphasis>simultaneously</emphasis> access state associated with the web request and state held in transactional resources (without the need to propagate web request state manually via method parameters). You might object that the application layering imposed upon you by the old J2EE platform was a Good Thing. Well, nothing stops you creating an equivalent layered architecture using Seam - the difference is that <emphasis>you</emphasis> get to architect your own application and decide what the layers are and how they work together.
+					</para>
+				</listitem>
+			</varlistentry>
+			<varlistentry>
+				<term><emphasis>Declarative State Management</emphasis></term>
+				<listitem>
+					<para>
+						We are all used to the concept of declarative transaction management and J2EE declarative security from EJB 2.x. EJB 3.0 even introduces declarative persistence context management. These are three examples of a broader problem of managing state that is associated with a particular <emphasis>context</emphasis>, while ensuring that all needed cleanup occurs when the context ends. Seam takes the concept of declarative state management much further and applies it to <emphasis>application state</emphasis>. Traditionally, J2EE applications almost always implement state management manually, by getting and setting servlet session and request attributes. This approach to state management is the source of many bugs and memory leaks when applications fail to clean up session attributes, or when session data associated with different workflows collides in a multi-window application. Seam has the potential to almost entirely eliminate this class of bugs.
+					</para>
+					<para>
+						Declarative application state management is made possible by the richness of the <emphasis>context model</emphasis> defined by Seam. Seam extends the context model defined by the servlet spec&mdash;request, session, application&mdash;with two new contexts&mdash;conversation and business process&mdash;that are more meaningful from the point of view of the business logic.
+					</para>
+				</listitem>
+			</varlistentry>
+			<varlistentry>
+				<term><emphasis>Bijection</emphasis></term>
+				<listitem>
+					<para>
+						The notion of <emphasis>Inversion of Control</emphasis> or <emphasis>dependency injection</emphasis> exists in both JSF and EJB3, as well as in numerous simpler containers. Most of these containers emphasize injection of components that implement <emphasis>stateless services</emphasis>. Even when injection of stateful components is supported (such as in JSF), it is virtually useless for handling application state because the scope of the stateful component cannot be defined with sufficient flexibility.
+					</para>
+					<para>
+						<emphasis>Bijection</emphasis> differs from IoC in that it is <emphasis>dynamic</emphasis>, <emphasis>contextual</emphasis>, and <emphasis>bidirectional</emphasis>. You can think of it as a mechanism for aliasing contextual variables (names in the various contexts bound to the current thread) to attributes of the component. Bijection allows auto-assembly of stateful components by the container. It even allows a component to safely and easily manipulate the value of a context variable, just by assigning to an attribute of the component.
+					</para>
+				</listitem>
+			</varlistentry>
+			<varlistentry>
+				<term><emphasis>Workspace Management</emphasis></term>
+				<listitem>
+					<para>
+						Optionally, Seam applications may take advantage of <emphasis>workspace management</emphasis>, allowing users to freely switch between different conversations (workspaces) in a single browser window. Seam provides not only correct multi-window operation, but also multi-window-like operation in a single window!
+					</para>
+				</listitem>
+			</varlistentry>
+			<varlistentry>
+				<term><emphasis>Annotated POJOs Everywhere</emphasis></term>
+				<listitem>
+					<para>
+						EJB 3.0 embraces annotations and <emphasis>configuration by exception</emphasis> as the easiest way to provide information to the container in a declarative form. Unfortunately, JSF is still heavily dependent on verbose XML configuration files. Seam extends the annotations provided by EJB 3.0 with a set of annotations for declarative state management and declarative context demarcation. This lets you eliminate the noisy JSF managed bean declarations and reduce the required XML to just that information which truly belongs in XML (the JSF navigation rules).
+					</para>
+				</listitem>
+			</varlistentry>
+			<varlistentry>
+				<term><emphasis>Testability as a Core Feature</emphasis></term>
+				<listitem>
+					<para>
+						Seam components, being POJOs, are by nature unit testable. But for complex applications, unit testing alone is insufficient. Integration testing has traditionally been a messy and difficult task for Java web applications. Therefore, Seam provides for testability of Seam applications as a core feature of the framework. You can easily write JUnit or TestNG tests that reproduce a whole interaction with a user, exercising all components of the system apart from the view (the JSP or Facelets page). You can run these tests directly inside your IDE, where Seam will automatically deploy EJB components into the JBoss Embeddable EJB3 container.
+					</para>
+				</listitem>
+			</varlistentry>
+			<varlistentry>
+				<term><emphasis>Get started now!</emphasis></term>
+				<listitem>
+					<para>
+						Seam works in any application server that supports EJB 3.0. You can even use Seam in a servlet container like Tomcat, or in any J2EE application server, by leveraging the new JBoss Embeddable EJB3 container.
+					</para>
+					<para>
+						However, we realize that not everyone is ready to make the switch to EJB 3.0. So, in the interim, you can use Seam as a framework for applications that use JSF for presentation, Hibernate (or plain JDBC) for persistence and JavaBeans for application logic. Then, when you&#39;re ready to make the switch to EJB 3.0, migration will be straightforward.
+					</para>
+				</listitem>
+			</varlistentry>
+		</variablelist>
+		<mediaobject>
+			<imageobject role="fo">
+				<imagedata align="center" fileref="images/architecture.png" />
+			</imageobject>
+		</mediaobject>
+		<para>
+			It turns out that the combination of Seam, JSF and EJB3 is <emphasis>the</emphasis> simplest way to write a complex web application in Java. You won&#39;t believe how little code is required!
+		</para>
+	</preface>
+	<xi:include href="Tutorial.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<!-- Seam-gen is not included with the JBEAP 4.2 platform, so we're removing this chapter -->
+	<!-- <xi:include href="Gettingstarted.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -->
+	<xi:include href="Concepts.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Xml.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Events.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Conversations.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Jbpm.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Persistence.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Validation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Framework.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Drools.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Security.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="I18n.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Text.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Itext.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Mail.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Jms.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Cache.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Remoting.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Spring.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Configuration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Annotations.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Components.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Controls.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Elenhancements.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Testing.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Tools.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Revision_History.xml"/>
+
+</book>
+




More information about the jboss-cvs-commits mailing list