[jboss-cvs] JBossAS SVN: r105449 - projects/docs/enterprise/EAP/releases/5.x/5.0.1/Seam_Reference_Guide/en-US.

[jboss-cvs-commits at lists.jboss.org]

Author: rebecca_newton
Date: 2010-06-01 00:35:01 -0400 (Tue, 01 Jun 2010)
New Revision: 105449

Modified:
   projects/docs/enterprise/EAP/releases/5.x/5.0.1/Seam_Reference_Guide/en-US/Mail.xml
Log:
Fixed JBPAPP-4139

Modified: projects/docs/enterprise/EAP/releases/5.x/5.0.1/Seam_Reference_Guide/en-US/Mail.xml
===================================================================
--- projects/docs/enterprise/EAP/releases/5.x/5.0.1/Seam_Reference_Guide/en-US/Mail.xml	2010-06-01 04:01:24 UTC (rev 105448)
+++ projects/docs/enterprise/EAP/releases/5.x/5.0.1/Seam_Reference_Guide/en-US/Mail.xml	2010-06-01 04:35:01 UTC (rev 105449)
@@ -271,62 +271,6 @@
 	</section>
 	
 	 <section>
-		<title>Receiving emails</title>
-		 <para>
-			If you use Enterprise JavaBeans (EJB), you can use a MDB (Message Driven Bean) to receive email. JBoss provides a JCA adaptor (<filename>mail-ra.rar</filename>), but the version distributed with the JBoss AS has a number of limitations, and is not bundled with all versions. Therefore, we recommend using the <filename>mail-ra.rar</filename> distributed with Seam. (You can find this in the <literal>extras/</literal> directory in the Seam bundle.)
-		</para>
-		 <para>
-			Place <filename>mail-ra.rar</filename> in <literal>$JBOSS_HOME/server/default/deploy</literal>. If your JBoss AS already contains this file, replace it with the version in the Seam bundle.
-		</para>
-		
-		 <para>
-			You can configure <filename>mail-ra.rar</filename> like so:
-		</para>
-		 
-<programlisting role="JAVA"><![CDATA[@MessageDriven(activationConfig={
-  @ActivationConfigProperty(propertyName="mailServer", 
-                            propertyValue="localhost"),
-  @ActivationConfigProperty(propertyName="mailFolder", 
-                            propertyValue="INBOX"),
-  @ActivationConfigProperty(propertyName="storeProtocol", 
-                            propertyValue="pop3"),
-  @ActivationConfigProperty(propertyName="userName", 
-                            propertyValue="seam"),
-  @ActivationConfigProperty(propertyName="password", 
-                            propertyValue="seam")
-})
- at ResourceAdapter("mail-ra.rar")
- at Name("mailListener")
-public class MailListenerMDB implements MailListener {
-
-  @In(create=true)
-  private OrderProcessor orderProcessor;
-
-  public void onMessage(Message message) {
-     // Process the message
-     orderProcessor.process(message.getSubject());
-  }
-   
-}]]>
-</programlisting>
-		 <para>
-			Each message received calls <literal>onMessage(Message message)</literal>. Most Seam annotations work inside a MDB, but you must not access the persistence context.
-		</para>
-		 <para>
-			You can find more information on <filename>mail-ra.rar</filename> at <ulink url="http://wiki.jboss.org/wiki/Wiki.jsp?page=InboundJavaMail">http://wiki. jboss.org/wiki/Wiki.jsp?page=InboundJavaMail</ulink>.
-		</para>
-		 <para>
-			You can still use <literal>mail-ra.rar</literal> if you are not using JBoss AS, but your application server may include a similar adapter file.
-		</para>
-		
-	<warning>
-	  <title>Distributed <filename>mail-ra.rar</filename> is a Technology Preview</title>    
- 	    <para>Technology Preview features are not fully supported under Red Hat subscription level agreements (SLAs), may not be functionally complete, and are not intended for production use. However, these features provide early access to upcoming product innovations, enabling customers to test functionality and provide feedback during the development process. As Red Hat considers making future iterations of Technology Preview features generally available, we will provide commercially reasonable efforts to resolve any reported issues that customers experience when using these features.</para>     
- 	</warning>
- 	 	
-	</section>
-	
-	 <section>
 		<title>Configuration</title>
 		 <para>
 			Include <filename>jboss-seam-mail.jar</filename> in your <literal>WEB-INF/lib</literal> directory to include email support in your application. If you use JBoss AS, no further configuration is required. If you do not use JBoss AS, make sure you have the JavaMail API and a copy of the Java Active Framework. The versions distributed with Seam are <filename>lib/mail.jar</filename> and <filename> lib/activation.jar</filename> respectively.)