Author: norman.richards(a)jboss.com Date: 2008-10-14 20:23:15 -0400 (Tue, 14 Oct 2008) New Revision: 9326 Modified: trunk/doc/Seam_Reference_Guide/en-US/Components.xml trunk/doc/Seam_Reference_Guide/en-US/Concepts.xml Log: JBSEAM-2563 Modified: trunk/doc/Seam_Reference_Guide/en-US/Components.xml =================================================================== --- trunk/doc/Seam_Reference_Guide/en-US/Components.xml 2008-10-14 23:41:26 UTC (rev 9325) +++ trunk/doc/Seam_Reference_Guide/en-US/Components.xml 2008-10-15 00:23:15 UTC (rev 9326) @@ -17,15 +17,7 @@ of the built in components on your own class using <literal>@Name</literal>. </para> - - <para> - Note also that even though all the built in components use a - qualified name, most of them are aliased to unqualified names by - default. These aliases specify <literal>auto-create="true"</literal>, - so you do not need to use <literal>create=true</literal> when - injecting built-in components by their unqualified name. - </para> - + <section> <title>Context injection components</title> <para> Modified: trunk/doc/Seam_Reference_Guide/en-US/Concepts.xml =================================================================== --- trunk/doc/Seam_Reference_Guide/en-US/Concepts.xml 2008-10-14 23:41:26 UTC (rev 9325) +++ trunk/doc/Seam_Reference_Guide/en-US/Concepts.xml 2008-10-15 00:23:15 UTC (rev 9326) @@ -545,10 +545,40 @@ <programlisting role="XML"><![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. + All of the built-in Seam components have qualified names but can be accessed through + their unqualified names due to the namespace import feature of Seam. + The <literal>components.xml</literal> file included in the Seam JAR defines the following + namespaces. </para> - + +<programlisting>&lt;components xmlns=&quot;http://jboss.com/products/seam/components&quot;&gt; + + &lt;import&gt;org.jboss.seam.core&lt;/import&gt; + &lt;import&gt;org.jboss.seam.cache&lt;/import&gt; + &lt;import&gt;org.jboss.seam.transaction&lt;/import&gt; + &lt;import&gt;org.jboss.seam.framework&lt;/import&gt; + &lt;import&gt;org.jboss.seam.web&lt;/import&gt; + &lt;import&gt;org.jboss.seam.faces&lt;/import&gt; + &lt;import&gt;org.jboss.seam.international&lt;/import&gt; + &lt;import&gt;org.jboss.seam.theme&lt;/import&gt; + &lt;import&gt;org.jboss.seam.pageflow&lt;/import&gt; + &lt;import&gt;org.jboss.seam.bpm&lt;/import&gt; + &lt;import&gt;org.jboss.seam.jms&lt;/import&gt; + &lt;import&gt;org.jboss.seam.mail&lt;/import&gt; + &lt;import&gt;org.jboss.seam.security&lt;/import&gt; + &lt;import&gt;org.jboss.seam.security.management&lt;/import&gt; + &lt;import&gt;org.jboss.seam.security.permission&lt;/import&gt; + &lt;import&gt;org.jboss.seam.captcha&lt;/import&gt; + &lt;import&gt;org.jboss.seam.excel.exporter&lt;/import&gt; + &lt;!-- ... ---&gt; +&lt;/components&gt; +</programlisting> + + <para> + When attempting to resolve an unqualified name, Seam will check each of those namespaces, in order. + You can include additional namespaces in your application's <literal>components.xml</literal> file + for application-specific namespaces. + </para> </sect2> <sect2>