[jboss-cvs] jboss-seam/doc/reference/en/modules ...
Gavin King
gavin.king at jboss.com
Mon Nov 20 14:24:19 EST 2006
User: gavin
Date: 06/11/20 14:24:19
Modified: doc/reference/en/modules components.xml
concepts.xml configuration.xml conversations.xml
drools.xml framework.xml i18n.xml jbpm.xml jms.xml
tutorial.xml
Log:
updates
Revision Changes Path
1.47 +42 -42 jboss-seam/doc/reference/en/modules/components.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: components.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/components.xml,v
retrieving revision 1.46
retrieving revision 1.47
diff -u -b -r1.46 -r1.47
--- components.xml 10 Nov 2006 05:50:30 -0000 1.46
+++ components.xml 20 Nov 2006 19:24:19 -0000 1.47
@@ -25,7 +25,7 @@
<variablelist spacing="compact">
<varlistentry>
- <term><literal>eventContext</literal></term>
+ <term><literal>org.jboss.seam.core.eventContext</literal></term>
<listitem>
<para>
Manager component for the event context object
@@ -33,7 +33,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>pageContext</literal></term>
+ <term><literal>org.jboss.seam.core.pageContext</literal></term>
<listitem>
<para>
Manager component for the page context object
@@ -41,7 +41,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>conversationContext</literal></term>
+ <term><literal>org.jboss.seam.core.conversationContext</literal></term>
<listitem>
<para>
Manager component for the conversation context object
@@ -49,7 +49,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>sessionContext</literal></term>
+ <term><literal>org.jboss.seam.core.sessionContext</literal></term>
<listitem>
<para>
Manager component for the session context object
@@ -57,7 +57,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>applicationContext</literal></term>
+ <term><literal>org.jboss.seam.core.applicationContext</literal></term>
<listitem>
<para>
Manager component for the appication context object
@@ -65,7 +65,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>businessProcessContext</literal></term>
+ <term><literal>org.jboss.seam.core.businessProcessContext</literal></term>
<listitem>
<para>
Manager component for the business process context object
@@ -73,7 +73,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>facesContext</literal></term>
+ <term><literal>org.jboss.seam.core.facesContext</literal></term>
<listitem>
<para>
Manager component for the <literal>FacesContext</literal> context
@@ -97,7 +97,7 @@
<variablelist>
<varlistentry>
- <term><literal>facesMessages</literal></term>
+ <term><literal>org.jboss.seam.core.facesMessages</literal></term>
<listitem>
<para>
Allows faces success messages to propagate across a browser redirect.
@@ -147,7 +147,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>redirect</literal></term>
+ <term><literal>org.jboss.seam.core.redirect</literal></term>
<listitem>
<para>
A convenient API for performing redirects with parameters (this
@@ -192,7 +192,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>httpError</literal></term>
+ <term><literal>org.jboss.seam.core.httpError</literal></term>
<listitem>
<para>
A convenient API for sending HTTP errors.
@@ -200,7 +200,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>events</literal></term>
+ <term><literal>org.jboss.seam.core.events</literal></term>
<listitem>
<para>
An API for raising events that can be observed via
@@ -239,7 +239,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>interpolator</literal></term>
+ <term><literal>org.jboss.seam.core.interpolator</literal></term>
<listitem>
<para>
An API for interpolating the values of JSF EL expressions in
@@ -257,7 +257,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>expressions</literal></term>
+ <term><literal>org.jboss.seam.core.expressions</literal></term>
<listitem>
<para>
An API for creating value and method bindings.
@@ -279,7 +279,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>pojoCache</literal></term>
+ <term><literal>org.jboss.seam.core.pojoCache</literal></term>
<listitem>
<para>
Manager component for a JBoss Cache <literal>PojoCache</literal>
@@ -296,7 +296,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>uiComponent</literal></term>
+ <term><literal>org.jboss.seam.core.uiComponent</literal></term>
<listitem>
<para>
Allows access to a JSF <literal>UIComponent</literal> by its id
@@ -321,7 +321,7 @@
<variablelist spacing="compact">
<varlistentry>
- <term><literal>locale</literal></term>
+ <term><literal>org.jboss.seam.core.locale</literal></term>
<listitem>
<para>
The Seam locale. The locale is session scoped.
@@ -329,7 +329,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>timezone</literal></term>
+ <term><literal>org.jboss.seam.core.timezone</literal></term>
<listitem>
<para>
The Seam timezone. The timezone is session scoped.
@@ -337,7 +337,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>resourceBundle</literal></term>
+ <term><literal>org.jboss.seam.core.resourceBundle</literal></term>
<listitem>
<para>
The Seam resource bundle. The resource bundle is session scoped. The Seam
@@ -355,7 +355,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>localeSelector</literal></term>
+ <term><literal>org.jboss.seam.core.localeSelector</literal></term>
<listitem>
<para>
Supports selection of the locale either at configuration time,
@@ -414,7 +414,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>timezoneSelector</literal></term>
+ <term><literal>org.jboss.seam.core.timezoneSelector</literal></term>
<listitem>
<para>
Supports selection of the timezone either at configuration time,
@@ -448,7 +448,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>messages</literal></term>
+ <term><literal>org.jboss.seam.core.messages</literal></term>
<listitem>
<para>
A map containing internationalized messages rendered from message
@@ -457,7 +457,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>themeSelector</literal></term>
+ <term><literal>org.jboss.seam.theme.themeSelector</literal></term>
<listitem>
<para>
Supports selection of the theme either at configuration time,
@@ -498,7 +498,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>theme</literal></term>
+ <term><literal>org.jboss.seam.theme.theme</literal></term>
<listitem>
<para>
A map containing theme entries.
@@ -522,7 +522,7 @@
<variablelist spacing="compact">
<varlistentry>
- <term><literal>conversation</literal></term>
+ <term><literal>org.jboss.seam.core.conversation</literal></term>
<listitem>
<para>
API for application control of attributes of the current Seam conversation.
@@ -635,7 +635,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>conversationList</literal></term>
+ <term><literal>org.jboss.seam.core.conversationList</literal></term>
<listitem>
<para>
Manager component for the conversation list.
@@ -643,7 +643,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>conversationStack</literal></term>
+ <term><literal>org.jboss.seam.core.conversationStack</literal></term>
<listitem>
<para>
Manager component for the conversation stack (breadcrumbs).
@@ -651,7 +651,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>switcher</literal></term>
+ <term><literal>org.jboss.seam.core.switcher</literal></term>
<listitem>
<para>
The conversation switcher.
@@ -674,7 +674,7 @@
<variablelist spacing="compact">
<varlistentry>
- <term><literal>pageflow</literal></term>
+ <term><literal>org.jboss.seam.core.pageflow</literal></term>
<listitem>
<para>
API control of Seam pageflows.
@@ -708,7 +708,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>actor</literal></term>
+ <term><literal>org.jboss.seam.core.actor</literal></term>
<listitem>
<para>
API for application control of attributes of the jBPM actor associated
@@ -732,7 +732,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>transition</literal></term>
+ <term><literal>org.jboss.seam.core.transition</literal></term>
<listitem>
<para>
API for application control of the jBPM transition for the current
@@ -750,7 +750,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>businessProcess</literal></term>
+ <term><literal>org.jboss.seam.core.businessProcess</literal></term>
<listitem>
<para>
API for programmatic control of the association between the
@@ -822,7 +822,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>taskInstance</literal></term>
+ <term><literal>org.jboss.seam.core.taskInstance</literal></term>
<listitem>
<para>
Manager component for the jBPM <literal>TaskInstance</literal>.
@@ -830,7 +830,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>processInstance</literal></term>
+ <term><literal>org.jboss.seam.core.processInstance</literal></term>
<listitem>
<para>
Manager component for the jBPM <literal>ProcessInstance</literal>.
@@ -838,7 +838,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>jbpmContext</literal></term>
+ <term><literal>org.jboss.seam.core.jbpmContext</literal></term>
<listitem>
<para>
Manager component for an event-scoped <literal>JbpmContext</literal>.
@@ -846,7 +846,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>taskInstanceList</literal></term>
+ <term><literal>org.jboss.seam.core.taskInstanceList</literal></term>
<listitem>
<para>
Manager component for the jBPM task list.
@@ -854,7 +854,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>pooledTaskInstanceList</literal></term>
+ <term><literal>org.jboss.seam.core.pooledTaskInstanceList</literal></term>
<listitem>
<para>
Manager component for the jBPM pooled task list.
@@ -862,7 +862,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>taskInstanceListForType</literal></term>
+ <term><literal>org.jboss.seam.core.taskInstanceListForType</literal></term>
<listitem>
<para>
Manager component for the jBPM task lists.
@@ -870,7 +870,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>pooledTask</literal></term>
+ <term><literal>org.jboss.seam.core.pooledTask</literal></term>
<listitem>
<para>
Action handler for pooled task assignment.
@@ -894,7 +894,7 @@
<variablelist spacing="compact">
<varlistentry>
- <term><literal>userPrincipal</literal></term>
+ <term><literal>org.jboss.seam.core.userPrincipal</literal></term>
<listitem>
<para>
Manager component for the current user <literal>Principal</literal>.
@@ -902,7 +902,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>isUserInRole</literal></term>
+ <term><literal>org.jboss.seam.core.isUserInRole</literal></term>
<listitem>
<para>
Allows JSF pages to choose to render a control, depending upon
@@ -923,7 +923,7 @@
<variablelist>
<varlistentry>
- <term><literal>queueSession</literal></term>
+ <term><literal>org.jboss.seam.jms.queueSession</literal></term>
<listitem>
<para>
Manager component for a JMS <literal>QueueSession</literal> .
@@ -931,7 +931,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>topicSession</literal></term>
+ <term><literal>org.jboss.seam.jms.topicSession</literal></term>
<listitem>
<para>
Manager component for a JMS <literal>TopicSession</literal> .
1.39 +12 -0 jboss-seam/doc/reference/en/modules/concepts.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: concepts.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/concepts.xml,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -b -r1.38 -r1.39
--- concepts.xml 14 Nov 2006 00:50:40 -0000 1.38
+++ concepts.xml 20 Nov 2006 19:24:19 -0000 1.39
@@ -548,6 +548,18 @@
<programlisting><![CDATA[<h:commandButton type="submit" value="Login"
action="#{com$jboss$myapp$loginAction.login}"/>]]></programlisting>
+ <para>
+ Since this is ugly, Seam also provides a means of aliasing a qualified name to a simple
+ name. Add a line like this to the <literal>components.xml</literal> file:
+ </para>
+
+ <programlisting><![CDATA[<factory name="loginAction" scope="STATELESS" value="#{com$jboss$myapp$loginAction}"/>]]></programlisting>
+
+ <para>
+ All of the built-in Seam components have qualified names, but most of them are aliased
+ to a simple name by the <literal>components.xml</literal> file included in the Seam jar.
+ </para>
+
</sect2>
<sect2>
1.28 +4 -4 jboss-seam/doc/reference/en/modules/configuration.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: configuration.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/configuration.xml,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -b -r1.27 -r1.28
--- configuration.xml 22 Oct 2006 11:03:54 -0000 1.27
+++ configuration.xml 20 Nov 2006 19:24:19 -0000 1.28
@@ -529,7 +529,7 @@
<literal>components.xml</literal>, we can write:
</para>
- <programlisting><![CDATA[<component name="bookingDatabase"
+ <programlisting><![CDATA[<component name="bookingDatabase" auto-create="true"
class="org.jboss.seam.core.ManagedPersistenceContext">
<property name="persistenceUnitJndiName">java:/EntityManagerFactories/bookingData</property>
</component>]]></programlisting>
@@ -554,7 +554,7 @@
Now we can have our <literal>EntityManager</literal> injected using:
</para>
- <programlisting><![CDATA[@In(create=true) EntityManager bookingDatabase;]]></programlisting>
+ <programlisting><![CDATA[@In EntityManager bookingDatabase;]]></programlisting>
</sect2>
@@ -618,7 +618,7 @@
To configure our Seam component, as usual, we use <literal>components.xml</literal>:
</para>
- <programlisting><![CDATA[<component name="hibernateSessionFactory"
+ <programlisting><![CDATA[<component name="hibernateSessionFactory" auto-create="true"
class="org.jboss.seam.core.HibernateSessionFactory"/>
<component name="bookingDatabase"
@@ -652,7 +652,7 @@
JavaBean components using the following code:
</para>
- <programlisting><![CDATA[@In(create=true) Session bookingDatabase;]]></programlisting>
+ <programlisting><![CDATA[@In Session bookingDatabase;]]></programlisting>
</sect2>
1.17 +3 -3 jboss-seam/doc/reference/en/modules/conversations.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: conversations.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/conversations.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -b -r1.16 -r1.17
--- conversations.xml 14 Nov 2006 05:28:03 -0000 1.16
+++ conversations.xml 20 Nov 2006 19:24:19 -0000 1.17
@@ -483,9 +483,9 @@
<programlisting><![CDATA[@Name("editDocumentAction")
@Stateless
public class EditDocumentBean implements EditDocument {
- @In(create=true) EntityManager em;
+ @In EntityManager em;
@In Document document;
- @In(create=true) FacesMessages facesMessages;
+ @In FacesMessages facesMessages;
public String update() {
em.merge(document);
@@ -819,7 +819,7 @@
persistence provider, but we plan to support other equivalent vendor extensions.
</para>
- <programlisting><![CDATA[@In(create=true) EntityManager em; //a Seam-managed persistence context
+ <programlisting><![CDATA[@In EntityManager em; //a Seam-managed persistence context
@Begin(flushMode=MANUAL)
public void beginClaimWizard() {
1.11 +2 -3 jboss-seam/doc/reference/en/modules/drools.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: drools.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/drools.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -b -r1.10 -r1.11
--- drools.xml 16 Oct 2006 11:23:14 -0000 1.10
+++ drools.xml 20 Nov 2006 19:24:19 -0000 1.11
@@ -50,7 +50,7 @@
accumulates facts relating to the current conversation.)
</para>
- <programlisting><![CDATA[<component name="policyPricingWorkingMemory"
+ <programlisting><![CDATA[<component name="policyPricingWorkingMemory" auto-create="true"
class="org.jboss.seam.drools.ManagedWorkingMemory">
<property name="ruleBase">#{policyPricingRules}</property>
</component>]]></programlisting>
@@ -71,8 +71,7 @@
assert facts, and fire rules:
</para>
- <programlisting><![CDATA[@In(create=true)
-WorkingMemory policyPricingWorkingMemory;
+ <programlisting><![CDATA[@In WorkingMemory policyPricingWorkingMemory;
@In Policy policy;
@In Customer customer;
1.7 +1 -1 jboss-seam/doc/reference/en/modules/framework.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: framework.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/framework.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -b -r1.6 -r1.7
--- framework.xml 10 Nov 2006 16:12:45 -0000 1.6
+++ framework.xml 20 Nov 2006 19:24:19 -0000 1.7
@@ -55,7 +55,7 @@
@Name("personHome")
public class PersonHome extends EntityHome<Person> implements LocalPersonHome {
@RequestParameter Long personId;
- @In(create=true) EntityManager personDatabase;
+ @In EntityManager personDatabase;
public Object getId() { return personId; }
public EntityManager getEntityManager() { return personDatabase; }
1.12 +17 -18 jboss-seam/doc/reference/en/modules/i18n.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: i18n.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/i18n.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -b -r1.11 -r1.12
--- i18n.xml 16 Nov 2006 17:48:15 -0000 1.11
+++ i18n.xml 20 Nov 2006 19:24:19 -0000 1.12
@@ -38,10 +38,10 @@
<para>
It is <emphasis>possible</emphasis> to set the locale
manually via the Seam configuration properties
- <literal>localeSelector.language</literal>,
- <literal>localeSelector.country</literal> and
- <literal>localeSelector.variant</literal>, but we
- can't think of any good reason to ever do this.
+ <literal>org.jboss.seam.core.localeSelector.language</literal>,
+ <literal>org.jboss.seam.core.localeSelector.country</literal> and
+ <literal>org.jboss.seam.core.localeSelector.variant</literal>, but
+ we can't think of any good reason to ever do this.
</para>
<para>
@@ -94,9 +94,9 @@
Each login session has an associated instance of
<literal>java.util.ResourceBundle</literal> (available to the
application as a session-scoped component named
- <literal>resourceBundle</literal>). You'll need to make your
- internationalized labels available via this special resource bundle.
- By default, the resource bundle used by Seam is named
+ <literal>org.jboss.seam.core.resourceBundle</literal>). You'll need to
+ make your internationalized labels available via this special resource
+ bundle. By default, the resource bundle used by Seam is named
<literal>messages</literal> and so you'll need to define your labels
in files named <literal>messages.properties</literal>,
<literal>messages_en.properties</literal>,
@@ -120,12 +120,12 @@
<para>
You can select a different name for the resource bundle by setting
the Seam configuration property named
- <literal>resourceBundle.bundleNames</literal>. You can even specify
+ <literal>org.jboss.seam.core.resourceBundle.bundleNames</literal>. You can even specify
a list of resource bundle names to be searched (depth first) for
messages.
</para>
- <programlisting><![CDATA[<component name="resourceBundle">
+ <programlisting><![CDATA[<component name="org.jboss.seam.core.resourceBundle">
<property name="bundlenames">
<value>mycompany_messages</value>
<value>standard_messages</value>
@@ -181,7 +181,7 @@
You can even use the messages in your code:
</para>
- <programlisting><![CDATA[@In(create=true) private Map<String, String> messages;]]></programlisting>
+ <programlisting><![CDATA[@In private Map<String, String> messages;]]></programlisting>
<programlisting><![CDATA[@In("#{messages['Hello']}") private String helloMessage;]]></programlisting>
</section>
@@ -197,8 +197,7 @@
<programlisting><![CDATA[@Name("hello")
@Stateless
public class HelloBean implements Hello {
- @In(create=true)
- FacesMessages facesMessages;
+ @In FacesMessages facesMessages;
public String sayIt() {
facesMessages.addFromResourceBundle("Hello");
@@ -217,12 +216,12 @@
<title>Timezones</title>
<para>
There is also a session-scoped instance of <literal>java.util.Timezone</literal>,
- named <literal>timezone</literal>, and a Seam component for changing the timezone named
- <literal>timezoneSelector</literal>. By default, the timezone is the default timezone of
- the server. Unfortunately, the JSF specification says that all dates and times should be
- assumed to be UTC, and displayed as UTC, unless a timezone is explicitly specified using
- <literal><f:convertDateTime></literal>. This is an extremely inconvenient default
- behavior.
+ named <literal>org.jboss.seam.core.timezone</literal>, and a Seam component for changing
+ the timezone named <literal>org.jboss.seam.core.timezoneSelector</literal>. By default,
+ the timezone is the default timezone of the server. Unfortunately, the JSF specification
+ says that all dates and times should be assumed to be UTC, and displayed as UTC, unless
+ a timezone is explicitly specified using <literal><f:convertDateTime></literal>.
+ This is an extremely inconvenient default behavior.
</para>
<para>
Seam overrides this behavior, and defaults all dates and times to the Seam timezone.
1.23 +1 -1 jboss-seam/doc/reference/en/modules/jbpm.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: jbpm.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/jbpm.xml,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -b -r1.22 -r1.23
--- jbpm.xml 11 Nov 2006 02:46:29 -0000 1.22
+++ jbpm.xml 20 Nov 2006 19:24:19 -0000 1.23
@@ -623,7 +623,7 @@
<literal>actor</literal>:
</para>
- <programlisting><![CDATA[@In(create=true) Actor actor;
+ <programlisting><![CDATA[@In Actor actor;
public String login() {
...
1.9 +10 -10 jboss-seam/doc/reference/en/modules/jms.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: jms.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/jms.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -b -r1.8 -r1.9
--- jms.xml 30 Oct 2006 20:32:40 -0000 1.8
+++ jms.xml 20 Nov 2006 19:24:19 -0000 1.9
@@ -230,12 +230,12 @@
<literal>QueueSender</literal>s:
</para>
- <programlisting><![CDATA[<component name="stockTickerPublisher"
+ <programlisting><![CDATA[<component name="stockTickerPublisher" auto-create="true"
class="org.jboss.seam.jms.ManagedTopicPublisher">
<property name="topicJndiName">topic/stockTickerTopic</property>
</component>
-<component name="paymentQueueSender"
+<component name="paymentQueueSender" auto-create="true"
class="org.jboss.seam.jms.ManagedQueueSender">
<property name="queueJndiName">queue/paymentQueue</property>
</component>]]></programlisting>
@@ -249,10 +249,10 @@
<literal>TopicSession</literal> into any component:
</para>
- <programlisting><![CDATA[@In(create=true)
-private transient TopicPublisher stockTickerPublisher;
- at In(create=true)
-private transient TopicSession topicSession;
+ <programlisting><![CDATA[@In
+private TopicPublisher stockTickerPublisher;
+ at In
+private TopicSession topicSession;
public void publish(StockPrice price) {
try
@@ -267,10 +267,10 @@
<para>Or, for working with a queue:</para>
- <programlisting><![CDATA[@In(create=true)
-private transient QueueSender paymentQueueSender;
- at In(create=true)
-private transient QueueSession queueSession;
+ <programlisting><![CDATA[@In
+private QueueSender paymentQueueSender;
+ at In
+private QueueSession queueSession;
public void publish(Payment payment) {
try
1.72 +7 -8 jboss-seam/doc/reference/en/modules/tutorial.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: tutorial.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/tutorial.xml,v
retrieving revision 1.71
retrieving revision 1.72
diff -u -b -r1.71 -r1.72
--- tutorial.xml 14 Nov 2006 05:28:03 -0000 1.71
+++ tutorial.xml 20 Nov 2006 19:24:19 -0000 1.72
@@ -1365,7 +1365,7 @@
<programlisting><![CDATA[@Name("login")
public class Login {
- @In(create=true)
+ @In
private Actor actor;
private String user;
@@ -1387,9 +1387,8 @@
</example>
<para>
- Here we see the use of <literal>@In(create=true)</literal>, which tells
- Seam to create an instance of a component, in this case the component
- named <literal>actor</literal>, if none currently exists in the context.
+ Here we see the use of <literal>@In</literal> to inject the built-in
+ <literal>Actor</literal> component.
</para>
<para>
@@ -2495,10 +2494,10 @@
@Out(required=false)
private Booking booking;
- @In(create=true)
+ @In
private FacesMessages facesMessages;
- @In(create=true)
+ @In
private Events events;
@Logger
@@ -2855,7 +2854,7 @@
public class BlogService
{
- @In(create=true)
+ @In
private EntityManager entityManager;
@Unwrap
@@ -2999,7 +2998,7 @@
public class SearchService
{
- @In(create=true)
+ @In
private EntityManager entityManager;
private String searchPattern;
More information about the jboss-cvs-commits
mailing list