[jboss-cvs] JBossAS SVN: r81341 - in projects/docs/enterprise: 4.2.5/Hibernate/Entity_Manager_User_Guide/en-US and 3 other directories.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Wed Nov 19 23:58:53 EST 2008
Author: irooskov at redhat.com
Date: 2008-11-19 23:58:53 -0500 (Wed, 19 Nov 2008)
New Revision: 81341
Modified:
projects/docs/enterprise/4.2.5/Getting_Started/en-US/Book_Info.xml
projects/docs/enterprise/4.2.5/Hibernate/Entity_Manager_User_Guide/en-US/Book_Info.xml
projects/docs/enterprise/4.2.5/Installation_Guide/en-US/Book_Info.xml
projects/docs/enterprise/4.2.5/Seam/Reference_Guide/en-US/Book_Info.xml
projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Author_Group.xml
projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Configuration.xml
projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Dependencies.xml
projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Events.xml
projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Framework.xml
projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Getting_Started_With_JBoss_Tools.xml
projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Gettingstarted.xml
projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Hsearch.xml
projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/I18n.xml
projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Migration.xml
projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP03_FP01.xml
projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Tutorial.xml
Log:
updated docs for 4.3.0.CP03FP01 and book info files for 4.2.5 release
Modified: projects/docs/enterprise/4.2.5/Getting_Started/en-US/Book_Info.xml
===================================================================
--- projects/docs/enterprise/4.2.5/Getting_Started/en-US/Book_Info.xml 2008-11-20 04:24:25 UTC (rev 81340)
+++ projects/docs/enterprise/4.2.5/Getting_Started/en-US/Book_Info.xml 2008-11-20 04:58:53 UTC (rev 81341)
@@ -7,7 +7,7 @@
<subtitle>for Use with JBoss Enterprise Application Platform 4.2 Cumulative Patch 5</subtitle>
<edition>1.0</edition>
<pubsnumber>6</pubsnumber>
- <productname>JBoss Application Server</productname>
+ <productname>JBoss Enterprise Application Platform</productname>
<productnumber>4.2</productnumber>
<pubdate>Sep, 2007</pubdate>
<isbn>N/A</isbn>
Modified: projects/docs/enterprise/4.2.5/Hibernate/Entity_Manager_User_Guide/en-US/Book_Info.xml
===================================================================
--- projects/docs/enterprise/4.2.5/Hibernate/Entity_Manager_User_Guide/en-US/Book_Info.xml 2008-11-20 04:24:25 UTC (rev 81340)
+++ projects/docs/enterprise/4.2.5/Hibernate/Entity_Manager_User_Guide/en-US/Book_Info.xml 2008-11-20 04:58:53 UTC (rev 81341)
@@ -7,7 +7,7 @@
<subtitle>for Use with JBoss Enterprise Application Platform 4.2 Cumulative Patch 5</subtitle>
<edition>1.0</edition>
<pubsnumber>1</pubsnumber>
- <productname>JBoss Enterprise Application</productname>
+ <productname>JBoss Enterprise Application Platform</productname>
<productnumber>4.2</productnumber>
<pubdate>June, 2007</pubdate>
<isbn>N/A</isbn>
Modified: projects/docs/enterprise/4.2.5/Installation_Guide/en-US/Book_Info.xml
===================================================================
--- projects/docs/enterprise/4.2.5/Installation_Guide/en-US/Book_Info.xml 2008-11-20 04:24:25 UTC (rev 81340)
+++ projects/docs/enterprise/4.2.5/Installation_Guide/en-US/Book_Info.xml 2008-11-20 04:58:53 UTC (rev 81341)
@@ -7,7 +7,7 @@
<subtitle>for Use with JBoss Enterprise Application Platform 4.2 Cumulative Patch 5</subtitle>
<edition>1.0</edition>
<pubsnumber>6</pubsnumber>
- <productname>JBoss Application Server</productname>
+ <productname>JBoss Enterprise Application Platform</productname>
<productnumber>4.2</productnumber>
<pubdate>Sep, 2007</pubdate>
<isbn>N/A</isbn>
Modified: projects/docs/enterprise/4.2.5/Seam/Reference_Guide/en-US/Book_Info.xml
===================================================================
--- projects/docs/enterprise/4.2.5/Seam/Reference_Guide/en-US/Book_Info.xml 2008-11-20 04:24:25 UTC (rev 81340)
+++ projects/docs/enterprise/4.2.5/Seam/Reference_Guide/en-US/Book_Info.xml 2008-11-20 04:58:53 UTC (rev 81341)
@@ -6,7 +6,7 @@
<subtitle>for Use with JBoss Enterprise Application Platform 4.2 Cumulative Patch 5</subtitle>
<edition>1.0</edition>
<pubsnumber>6</pubsnumber>
- <productname>Seam</productname>
+ <productname>JBoss Enterprise Application Platform</productname>
<productnumber>4.2</productnumber>
<pubdate>June, 2007</pubdate>
<isbn>N/A</isbn>
Modified: projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Author_Group.xml
===================================================================
--- projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Author_Group.xml 2008-11-20 04:24:25 UTC (rev 81340)
+++ projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Author_Group.xml 2008-11-20 04:58:53 UTC (rev 81341)
@@ -74,4 +74,12 @@
<firstname>Samson</firstname>
<surname>Kittoli</surname>
</editor>
+ <editor>
+ <firstname>Marek</firstname>
+ <surname>Novotny</surname>
+ </editor>
+ <editor>
+ <firstname>Isaac</firstname>
+ <surname>Rooskov</surname>
+ </editor>
</authorgroup>
Modified: projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Configuration.xml
===================================================================
--- projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Configuration.xml 2008-11-20 04:24:25 UTC (rev 81340)
+++ projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Configuration.xml 2008-11-20 04:58:53 UTC (rev 81341)
@@ -47,6 +47,24 @@
<programlisting role="XML"><![CDATA[<context-param>
<param-name>javax.faces.STATE_SAVING_METHOD</param-name>
<param-value>client</param-value>
+</context-param>]]></programlisting>
+
+ <para>
+ There is a minor gray area in the JSF specification regarding the mutability of view state values. Since
+ Seam uses the JSF view state to back its PAGE scope this can become an issue in some cases. If you're
+ using server side state saving with the JSF-RI and you want a PAGE scoped bean to keep its exact value
+ for a given view of a page you will need to specify the following context-param. Otherwise if a user
+ uses the "back" button a PAGE scoped component will have the latest value if it has changed not the
+ value of the "back" page. (see
+ <ulink url="https://javaserverfaces-spec-public.dev.java.net/issues/show_bug.cgi?id=295">
+ Spec Issue
+ </ulink>
+ ). This setting is not enabled by default because of the performance hit of serializing the JSF view
+ with every request.
+ </para>
+ <programlisting role="XML"><![CDATA[<context-param>
+ <param-name>com.sun.faces.serializeServerState</param-name>
+ <param-value>true</param-value>
</context-param>]]></programlisting>
</sect2>
@@ -933,8 +951,7 @@
</container-cache-conf>]]></programlisting>
<para> The default HTTP session timeout can be modified in
- <literal>server/default/deploy/jbossweb-tomcat55.sar/conf/web.xml</literal> for JBoss 4.0.x, or in
- <literal>server/default/deploy/jboss-web.deployer/conf/web.xml</literal> for JBoss 4.2.x. The following
+ <literal>server/<profile>/deploy/jboss-web.deployer/conf/web.xml</literal> for JBoss EAP 4.3. The following
entry in this file controls the default session timeout for all web applications: </para>
<programlisting role="XML"><![CDATA[<session-config>
Modified: projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Dependencies.xml
===================================================================
--- projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Dependencies.xml 2008-11-20 04:24:25 UTC (rev 81340)
+++ projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Dependencies.xml 2008-11-20 04:58:53 UTC (rev 81341)
@@ -4,6 +4,40 @@
<chapter id="dependencies">
<title>Dependencies</title>
+ <section id="jdk_dependencies">
+ <title>JDK Dependencies</title>
+
+ <para>
+ Seam does not work with JDK 1.4 and requires JDK 5 or above as it uses
+ annotations and other JDK 5.0 features.. Seam has been thoroughly tested
+ using Sun's JDKs. However there are no known issues specific to Seam with
+ other JDK's.
+ </para>
+
+ <section id="jdk6_dependencies">
+ <title>Sun's JDK 6 Considerations</title>
+ <para>
+ Earlier versions of Sun's JDK 6 contained an incompatible
+ version of JAXB and required overriding it using the "endorsed"
+ directory. Sun's JDK6 Update 4 release upgraded to JAXB 2.1 and
+ removed this requirement. When building, testing, or executing be
+ sure to use this version or higher.
+ </para>
+
+ <para>
+ Seam used JBoss Embedded in its unit and integration testing. This
+ has an additional requirement when using JDK 6. In order to run
+ JBoss Embedded with JDK 6 you need to set the following JVM argument:
+
+ <programlisting>-Dsun.lang.ClassLoader.allowArraySyntax=true</programlisting>
+
+ Seam's internal build system is setting this by default when it
+ executes Seam's test suite. However if you are also using JBoss
+ Embedded for your testing you will need to set this value.
+ </para>
+ </section>
+ </section>
+
<section>
<title>Project Dependencies</title>
@@ -14,7 +48,7 @@
type is listed as <literal>war</literal>, the library should be placed in
the <literal>/WEB-INF/lib</literal> directory of your application's war
file. The scope of the dependency is either all, runtime or provided (by
- JBoss AS 4.2).
+ JBoss EAP 4.3).
</para>
<para>
Modified: projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Events.xml
===================================================================
--- projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Events.xml 2008-11-20 04:24:25 UTC (rev 81340)
+++ projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Events.xml 2008-11-20 04:58:53 UTC (rev 81341)
@@ -1000,7 +1000,7 @@
also available, as <literal>org.jboss.seam.exception</literal>.
</para>
- <section>
+ <!-- <section>
<title>Suppressing exception logging</title>
<para>
@@ -1036,7 +1036,7 @@
configured, then it will default to <literal>error</literal>.
</para>
- </section>
+ </section> -->
</section>
Modified: projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Framework.xml
===================================================================
--- projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Framework.xml 2008-11-20 04:24:25 UTC (rev 81340)
+++ projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Framework.xml 2008-11-20 04:58:53 UTC (rev 81341)
@@ -78,7 +78,7 @@
A second advantage is that your classes may be EJB stateful
session beans, if you like. (They do not have to be, they
can be plain JavaBean components if you prefer.) If you are using
- JBoss AS, you'll need 4.2.2.GA or later:
+ JBoss EAP:
</para>
<programlisting role="JAVA"><![CDATA[@Stateful
Modified: projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Getting_Started_With_JBoss_Tools.xml
===================================================================
--- projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Getting_Started_With_JBoss_Tools.xml 2008-11-20 04:24:25 UTC (rev 81340)
+++ projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Getting_Started_With_JBoss_Tools.xml 2008-11-20 04:58:53 UTC (rev 81341)
@@ -27,14 +27,9 @@
<title>Before you start</title>
<para>
- Make sure you have JDK 5, JBoss AS 4.2, Eclipse 3.3, the JBoss Tools
- plugins (at least Seam Tools, the Visual Page Editor, jBPM Tools and
- JBoss AS Tools) and the TestNG plugin for Eclipse correctly installed
- before starting.
+ Make sure you have JBoss EAP 4.3 FP01 and JBDS installed.
</para>
- <para>TODO - detail where the update sites are.</para>
-
</section>
<section>
Modified: projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Gettingstarted.xml
===================================================================
--- projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Gettingstarted.xml 2008-11-20 04:24:25 UTC (rev 81340)
+++ projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Gettingstarted.xml 2008-11-20 04:58:53 UTC (rev 81341)
@@ -24,7 +24,7 @@
<section>
<title>Before you start</title>
- <para>Make sure you have JDK 5 or JDK 6, JBoss AS 4.2 and Ant 1.6, along with recent versions of Eclipse, the
+ <para>Make sure you have JDK 5 or JDK 6, JBoss EAP 4.3 CP03 and Ant 1.6, along with recent versions of Eclipse, the
JBoss IDE plugin for Eclipse and the TestNG plugin for Eclipse correctly installed before starting. Add your
JBoss installation to the JBoss Server View in Eclipse. Start JBoss in debug mode. Finally, start a command
prompt in the directory where you unzipped the Seam distribution.</para>
@@ -406,7 +406,7 @@
incremental hot deployment for EAR projects.</para>
</section>
- <section>
+<!-- <section>
<title>Using Seam with JBoss 4.0</title>
<para> Seam 2.0 was developed for JavaServer Faces 1.2. When using JBoss AS, we recommend using JBoss 4.2, which
@@ -441,6 +441,6 @@
- </section>
+ </section> -->
</chapter>
Modified: projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Hsearch.xml
===================================================================
--- projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Hsearch.xml 2008-11-20 04:24:25 UTC (rev 81340)
+++ projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Hsearch.xml 2008-11-20 04:58:53 UTC (rev 81341)
@@ -29,7 +29,7 @@
<note>
<title>Technology preview </title>
- <para>HIbernate Search integration in Seam is marked as technology preview,
+ <para>Hibernate Search integration in Seam is marked as technology preview,
so standard support is not guaranteed.</para>
</note>
@@ -60,7 +60,7 @@
</persistence-unit>]]></programlisting>
<para>If you plan to target Hibernate Annotations or EntityManager 3.2.x
- (embedded into JBoss AS 4.2.GA), you also need to configure the
+ (embedded into JBoss EAP AS 4.3), you also need to configure the
appropriate event listeners.</para>
<programlisting role="XML"><![CDATA[<persistence-unit name="sample">
Modified: projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/I18n.xml
===================================================================
--- projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/I18n.xml 2008-11-20 04:24:25 UTC (rev 81340)
+++ projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/I18n.xml 2008-11-20 04:58:53 UTC (rev 81341)
@@ -33,11 +33,11 @@
parameters in the correct encoding from client requests you have to
configure the tomcat connector. If you use Tomcat or JBoss AS, add
the <literal>URIEncoding="UTF-8"</literal> attribute to the
- connector configuration. For JBoss AS 4.2 change
- <literal>${JBOSS_HOME}/server/(default)/deploy/jboss-web.deployer/server.xml</literal>:
+ connector configuration. For JBoss EAP AS 4.3 change
+ <literal>${JBOSS_HOME}/server/production/deploy/jboss-web.deployer/server.xml</literal>:
</para>
- <programlisting role="XML"><Connector port="8080" URIEncoding="UTF-8"/></programlisting>
+ <programlisting language="XML"><Connector port="8080" URIEncoding="UTF-8"/></programlisting>
<para>
There is alternative which is probably better. You can tell JBoss AS
@@ -45,7 +45,7 @@
request:
</para>
- <programlisting role="XML"><Connector port="8080" useBodyEncodingForURI="true"/></programlisting>
+ <programlisting language="XML"><Connector port="8080" useBodyEncodingForURI="true"/></programlisting>
</section>
<section>
@@ -117,15 +117,14 @@
filter. Configure this in <literal>components.xml</literal>:
</para>
- <programlisting role="XML"><![CDATA[<web:character-encoding-filter encoding="UTF-8"
+ <programlisting language="XML"><![CDATA[<web:character-encoding-filter encoding="UTF-8"
override-client="true"
url-pattern="*.seam" />]]></programlisting>
</section>
</section>
-
<section>
- <title>Locales</title>
+ <title>Locales<!--<anchor id="locales" />--></title>
<para>Each user login session has an associated instance of
<literal>java.util.Locale</literal> (available to the application as a
@@ -165,7 +164,7 @@
to do is add the following fragment to a form in your JSP or Facelets
page:</para>
- <programlisting role="XHTML"><h:selectOneMenu value="#{localeSelector.language}">
+<programlisting language="XHTML"><h:selectOneMenu value="#{localeSelector.language}">
<f:selectItem itemLabel="English" itemValue="en"/>
<f:selectItem itemLabel="Deutsch" itemValue="de"/>
<f:selectItem itemLabel="Francais" itemValue="fr"/>
@@ -175,7 +174,7 @@
<para>Or, if you want a list of all supported locales from <literal>
faces-config.xml</literal>, just use:</para>
- <programlisting role="XHTML"><h:selectOneMenu value="#{localeSelector.localeString}">
+<programlisting language="XHTML"><h:selectOneMenu value="#{localeSelector.localeString}">
<f:selectItems value="#{localeSelector.supportedLocales}"/>
</h:selectOneMenu>
<h:commandButton action="#{localeSelector.select}" value="#{messages['ChangeLanguage']}"/></programlisting>
@@ -186,15 +185,14 @@
</section>
<section>
- <title>Labels</title>
+ <title>Labels<!--<anchor id="labels" />--></title>
<para>JSF supports internationalization of user interface labels and
- descriptive text via the use of <code><f:loadBundle /></code>.
+ descriptive text via the use of <literal><f:loadBundle /></literal>.
You can use this approach in Seam applications. Alternatively, you can
take advantage of the Seam <literal> messages</literal> component to
display templated labels with embedded EL expressions.</para>
-
<section>
<title>Defining labels</title>
@@ -223,7 +221,7 @@
specify a list of resource bundle names to be searched (depth first) for
messages.</para>
- <programlisting role="XML"><core:resource-loader>
+<programlisting language="XML"><core:resource-loader>
<core:bundle-names>
<value>mycompany_messages</value>
<value>standard_messages</value>
@@ -240,13 +238,13 @@
<para>You can even specify an explicit bundle name in <literal>
pages.xml</literal>:</para>
- <programlisting role="XML"><page view-id="/welcome/hello.jsp" bundle="HelloMessages"/></programlisting>
+<programlisting language="XML"><page view-id="/welcome/hello.jsp" bundle="HelloMessages"/></programlisting>
<para>Then we could use messages defined in <literal>
HelloMessages.properties</literal> on <literal>
/welcome/hello.jsp</literal>.</para>
</section>
-
+
<section>
<title>Displaying labels</title>
@@ -254,11 +252,11 @@
be able to use them without having to type <literal> <f:loadBundle
... /></literal> on every page. Instead, you can simply type:</para>
- <programlisting role="XHTML"><h:outputText value="#{messages['Hello']}"/></programlisting>
+<programlisting language="XHTML"><h:outputText value="#{messages['Hello']}"/></programlisting>
<para>or:</para>
- <programlisting role="XHTML"><h:outputText value="#{messages.Hello}"/></programlisting>
+ <programlisting language="XHTML"><h:outputText value="#{messages.Hello}"/></programlisting>
<para>Even better, the messages themselves may contain EL
expressions:</para>
@@ -269,11 +267,11 @@
<para>You can even use the messages in your code:</para>
- <programlisting role="JAVA">@In private Map<String, String> messages;</programlisting>
+ <programlisting language="JAVA">@In private Map<String, String> messages;</programlisting>
- <programlisting role="JAVA">@In("#{messages['Hello']}") private String helloMessage;</programlisting>
+ <programlisting language="JAVA">@In("#{messages['Hello']}") private String helloMessage;</programlisting>
</section>
-
+
<section>
<title>Faces messages</title>
@@ -282,7 +280,7 @@
The functionality we just described also works for faces
messages:</para>
- <programlisting role="JAVA">@Name("hello")
+<programlisting language="JAVA">@Name("hello")
@Stateless
public class HelloBean implements Hello {
@In FacesMessages facesMessages;
@@ -295,11 +293,9 @@
<para>This will display <literal>Hello, Gavin King</literal> or
<literal>G'day, Gavin</literal>, depending upon the user's
locale.</para>
-</section>
-
+ </section>
</section>
-
<section>
<title>Timezones</title>
@@ -319,7 +315,7 @@
<s:convertDateTime></literal> tag which always performs conversions
in the Seam timezone.</para>
</section>
-
+
<section>
<title>Themes</title>
@@ -330,7 +326,7 @@
<para>First, configure the set of supported themes:</para>
- <programlisting role="XML"><theme:theme-selector cookie-enabled="true">
+ <programlisting language="XML"><theme:theme-selector cookie-enabled="true">
<theme:available-themes>
<value>default</value>
<value>accessible</value>
@@ -355,17 +351,17 @@
<para>Now we can use these entries in our JSP or facelets pages. For
example, to theme the stylesheet in a facelets page:</para>
- <programlisting role="XHTML"><link href="#{theme.css}" rel="stylesheet" type="text/css" /></programlisting>
+<programlisting language="XHTML"><link href="#{theme.css}" rel="stylesheet" type="text/css" /></programlisting>
<para>Or, when the page definition resides in a subdirectory:</para>
- <programlisting role="XHTML"><link href="#{facesContext.externalContext.requestContextPath}#{theme.css}"
+ <programlisting language="XHTML"><link href="#{facesContext.externalContext.requestContextPath}#{theme.css}"
rel="stylesheet" type="text/css" /></programlisting>
<para>Most powerfully, facelets lets us theme the template used by a
<literal><ui:composition></literal>:</para>
- <programlisting role="XHTML"><ui:composition xmlns="http://www.w3.org/1999/xhtml"
+<programlisting language="XHTML"><ui:composition xmlns="http://www.w3.org/1999/xhtml"
xmlns:ui="http://java.sun.com/jsf/facelets"
xmlns:h="http://java.sun.com/jsf/html"
xmlns:f="http://java.sun.com/jsf/core"
@@ -374,12 +370,12 @@
<para>Just like the locale selector, there is a built-in theme selector to
allow the user to freely switch themes:</para>
- <programlisting role="XHTML"><h:selectOneMenu value="#{themeSelector.theme}">
+<programlisting language="XHTML"><h:selectOneMenu value="#{themeSelector.theme}">
<f:selectItems value="#{themeSelector.themes}"/>
</h:selectOneMenu>
<h:commandButton action="#{themeSelector.select}" value="Select Theme"/></programlisting>
</section>
-
+
<section>
<title>Persisting locale and theme preferences via cookies</title>
@@ -388,7 +384,7 @@
the <literal>cookie-enabled</literal> property in
<literal>components.xml</literal>:</para>
- <programlisting role="XML"><theme:theme-selector cookie-enabled="true">
+<programlisting language="XML"><theme:theme-selector cookie-enabled="true">
<theme:available-themes>
<value>default</value>
<value>accessible</value>
@@ -397,5 +393,5 @@
</theme:theme-selector>
<international:locale-selector cookie-enabled="true"/></programlisting>
- </section>
+ </section>
</chapter>
\ No newline at end of file
Modified: projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Migration.xml
===================================================================
--- projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Migration.xml 2008-11-20 04:24:25 UTC (rev 81340)
+++ projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Migration.xml 2008-11-20 04:58:53 UTC (rev 81341)
@@ -94,15 +94,28 @@
<para>
Due to an incompatibility between Seam and MyFaces, you had to
use client side state saving in Seam 1.2. Switching to the JSF RI
- 1.2 lifts this restriction.
+ 1.2 lifts this restriction. So remove the context param javax.faces.STATE_SAVING_METHOD.
</para>
</note>
-
</section>
<section>
- <title>Migrating <literal>web.xml</literal> and <literal>faces-config.xml</literal> to Seam 2</title>
+ <title>Migrating <literal>web.xml</literal> to Seam 2</title>
+ <para>
+ First change the <literal>web-app</literal> version from 2.4 to 2.5.
+ There is also change in j2ee to javaee in namespace URL. Declaration of the <literal>web.xml</literal>
+ should look like:</para>
+
+<programlisting role="XML"><![CDATA[<web-app xmlns="http://java.sun.com/xml/ns/javaee"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="
+ http://java.sun.com/xml/ns/javaee
+ http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
+ version="2.5">
+ ...
+</web-app>]]></programlisting>
+
<para>
In your Seam 1.2 app you may have specified some Seam specific
configuration in <literal>web.xml</literal>. First, we'll discuss
@@ -142,7 +155,7 @@
</para>
<para>
- Finally, you should have the Seam resouce servlet (just as you did
+ Finally, you should have the Seam resource servlet (just as you did
in Seam 1.2):
</para>
@@ -175,7 +188,6 @@
<url-pattern>*.seam</url-pattern>
</filter-mapping>-->]]></programlisting>
-
<para>
Next, we'll describe the changes you need to make to your JSF
<literal>ViewHandler</literal> configuration. Previously the
@@ -200,14 +212,23 @@
<param-value>org.jboss.seam.ui.facelet.SeamFaceletViewHandler</param-value>
</context-param>-->]]></programlisting>
- <para>
- And that <literal>FaceletViewHandler</literal> is set in
- <literal>faces-config.xml</literal>:
+
+ </section>
+
+ <section>
+ <title>Migrating <literal>faces-config.xml</literal> to Seam 2</title>
+
+ <para>Remove the DTD on the document and add the XML Schema declarations to the
+ root tag:
</para>
-
- <programlisting role="XML"><![CDATA[<application>
- <view-handler>com.sun.facelets.FaceletViewHandler</view-handler>
-</application>]]></programlisting>
+<programlisting role="XML"><![CDATA[<faces-config version="1.2"
+ xmlns="http://java.sun.com/xml/ns/javaee"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="
+ http://java.sun.com/xml/ns/javaee
+ http://java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd">
+ ...
+</faces-config>]]></programlisting>
<para>
Seam 1.2 required you to specify either the
@@ -230,13 +251,21 @@
</para>
<programlisting role="XML"><![CDATA[<core:init transaction-management-enabled="false"/>]]></programlisting>
-
+
<para>
To workaround a bug, you may have specified
<literal>SeamELResolver</literal> in
<literal>faces-config.xml</literal>. This is no longer required.
</para>
+ <para>
+ Finally remove <literal>FaceletViewHandler</literal> configuration:
+ </para>
+
+ <programlisting role="XML"><![CDATA[<application>
+ <view-handler>com.sun.facelets.FaceletViewHandler</view-handler>
+</application>]]></programlisting>
+
</section>
<section>
@@ -314,8 +343,8 @@
<para>
Don't forget to update the XSD's in <literal>pages.xml</literal> and
<literal>components.xml</literal> to point at the ones for Seam 2.
- Just change the suffix from <literal>-1.2.xml</literal> to
- <literal>-2.0.xml</literal>.
+ Just change the suffix from <literal>-1.2.xsd</literal> to
+ <literal>-2.0.xsd</literal>.
</para>
</important>
@@ -397,6 +426,13 @@
<table>
<title>Component's in Seam 2</title>
<tgroup cols="6">
+ <!-- <colspec colnum="1" colwidth="2*" />
+ <colspec colnum="2" colwidth="2*" />
+ <colspec colnum="3" colwidth="2*" />
+ <colspec colnum="4" colwidth="2*" />
+ <colspec colnum="5" colwidth="2*" />
+ <colspec colnum="6" colwidth="2*" /> -->
+
<thead>
<row>
<entry>
@@ -1267,7 +1303,7 @@
<para>
If you are using RichFaces or Ajax4jsf, a major reorganization of
- the project has occurred. <literal>ajax4jsf.jar</literal> and
+ the project has occurred. The jars <literal>ajax4jsf.jar</literal> and
<literal>richfaces.jar</literal> have been replaced by
<literal>richfaces-api.jar</literal> (which should go in your ear
<literal>lib/</literal> directory),
@@ -1277,6 +1313,11 @@
</para>
<para>
+ <s:selectDate> has been deprecated in favor of <rich:calendar>. No more
+ development will be done on <s:selectDate>. You can remove the styles related
+ to the data picker from your stylesheet to save on unnecessary bandwidth use.
+ </para>
+ <para>
You should check the RichFaces documentation for more information on
parameter name changes and namespace changes.
</para>
@@ -1288,20 +1329,80 @@
<para>
As most JSF component sets provide a date selector, the Seam date
- selector (<literal>s:selectDate</literal> has been deprecated. You
+ selector (<s:selectDate>) has been deprecated. You
should replace it with the date selector from the component set you
use.
</para>
<para>
- <literal><s:decorate/></literal> has become a naming container.
+ Selector <s:decorate/> has become a naming container.
Therefore client ids have changed from
<literal>fooForm:fooInput</literal> to
- <literal>fooForm:foo:fooInput</literal> (assuming your
- <literal><s:decorate></literal> has foo as an id).
- </para>
+ <literal>fooForm:foo:fooInput</literal>, assuming the following declaration:</para>
+
+ <programlisting role="XML"><![CDATA[<h:form id="fooForm">
+ <s:decorate id="foo">
+ <h:inputText id="fooInput" value="#{bean.property}"/>
+ </s:decorate>
+</h:form>]]></programlisting>
+
+ <para>If you don't provide an id to <s:decorate>, one will be generated by JSF.</para>
</section>
+
+ <section>
+ <title>Changes to seam-gen</title>
+
+ <para>There was a change in seam-gen regarding
+ how the generated classes are organized when generate-entities is
+ executed.</para>
+
+ <variablelist>
+ <varlistentry>
+ <term>Old way:</term>
+ <listitem><para>src/model/com/domain/projectname/model/EntityName.java</para><para>src/action/com/domain/projectname/model/EntityNameHome.java</para><para>src/action/com/domain/projectname/model/EntityNameList.java</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term>New way:</term>
+ <listitem><para>src/model/com/domain/projectname/model/EntityName.java</para><para>src/action/com/domain/projectname/action/EntityNameHome.java</para><para>src/action/com/domain/projectname/action/EntityNameList.java</para></listitem>
+ </varlistentry>
+ </variablelist>
+
+
+ <para>Home and Query objects are <quote>action</quote> components, not <quote>model</quote> components
+ and are therefore placed in the action package. This change makes the
+ conventions followed by generate-entities consistent with the conventions
+ used in the new-entity command.</para>
+
+ <para>Remember, model classes are kept separate because they cannot be hot reloaded.</para>
+
+ <para>Due to the change from JBoss Embeddable EJB3 to JBoss Embedded for testing,
+ it is recommended that you generate a project using seam-gen from Seam 2
+ and borrow the <literal>build.xml</literal> file from that project. If you have made
+ significant changes to the <literal>build.xml</literal> in your project, you may want to focus
+ on just migrating the test-related targets.</para>
+
+ <para>In order for tests to work under JBoss Embedded, you need to change the
+ value of the <datasource> element in <literal>resources/META-INF/persistence-test.xml</literal>
+ (or <literal>persistence-test-war.xml</literal>) to <literal>java:/DefaultDS</literal>. The alternative is to
+ deploy a <literal>*-ds.xml</literal> file to the <literal>bootstrap/deploy</literal> folder and use the JNDI name
+ defined by that file.</para>
+
+ <para>If you use the <literal>build.xml</literal> from a Seam 2 seam-gen project, you will also need
+ the <literal>deployed-*.list</literal> file(s). These files define which JAR files are packaged
+ in the EAR or WAR. They were introduced to externalize this set of JARS from
+ the <literal>build.xml</literal> file.</para>
+
+ <para>To accommodate a change in the RichFaces panel, you need to add the following
+ style to your stylesheet. Otherwise, you're search criteria block in pages
+ created by generate-entities will bleed into the table of results.</para>
+
+<programlisting><![CDATA[.rich-stglpanel-body {
+ overflow: auto;
+}]]></programlisting>
+
+
+ </section>
</section>
</chapter>
Modified: projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP03_FP01.xml
===================================================================
--- projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP03_FP01.xml 2008-11-20 04:24:25 UTC (rev 81340)
+++ projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Seam_Reference_Guide_CP03_FP01.xml 2008-11-20 04:58:53 UTC (rev 81341)
@@ -4,10 +4,10 @@
<book>
<xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Tutorial.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href= "Gettingstarted.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href= "Getting_Started_With_JBoss_Tools.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href= "Migration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Tutorial.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href= "Gettingstarted.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href= "Getting_Started_With_JBoss_Tools.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href= "Migration.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" />
@@ -16,10 +16,10 @@
<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= "Groovy.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= "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= "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" />
@@ -29,13 +29,13 @@
<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= "Hsearch.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= "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= "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 href= "Dependencies.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href= "Dependencies.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
</book>
Modified: projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Tutorial.xml
===================================================================
--- projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Tutorial.xml 2008-11-20 04:24:25 UTC (rev 81340)
+++ projects/docs/enterprise/4.3.3.1/Seam/Seam_Reference_Guide/en-US/Tutorial.xml 2008-11-20 04:58:53 UTC (rev 81341)
@@ -6,8 +6,7 @@
<section id="try-examples">
<title>Try the examples</title>
- <para> In this tutorial, we'll assume that you have downloaded JBoss AS 4.2. You should also have a copy of
- Seam downloaded and extracted to a work directory. </para>
+ <para> In this tutorial, we'll assume that you are using JBoss EAP 4.3.</para>
<para> The directory structure of each example in Seam follows this pattern: </para>
@@ -38,9 +37,10 @@
<title>Running the examples on JBoss AS</title>
<para> First, make sure you have Ant correctly installed, with <literal>$ANT_HOME</literal> and
- <literal>$JAVA_HOME</literal> set correctly. Next, make sure you set the location of your JBoss AS
- 4.2 installation in the <literal>build.properties</literal> file in the root folder of your Seam
- installation. If you haven't already done so, start JBoss AS now by typing <literal>bin/run.sh</literal>
+ <literal>$JAVA_HOME</literal> set correctly. Next, make sure you set the location of your EAP embedded JBoss AS
+ installation in the <literal>build.properties</literal> file in the root folder of your Seam
+ installation, predefined location is /var/lib/jboss-as. If you haven't already done so,
+ start JBoss AS now by typing <literal>bin/run.sh</literal>
or <literal>bin/run.bat</literal> in the root directory of your JBoss installation. </para>
<para> Now, build and deploy the example by typing <literal>ant deploy</literal> in the
More information about the jboss-cvs-commits
mailing list