Author: bayard
Date: Thu Nov 30 14:30:31 2006
New Revision: 481096
URL: http://svn.apache.org/viewvc?view=rev&rev=481096
Log:
Adding the necessary import statements for the examples to underline that the
package is 'mail' and not 'email'
Modified:
jakarta/commons/proper/email/trunk/xdocs/userguide.xml
Modified: jakarta/commons/proper/email/trunk/xdocs/userguide.xml
URL:
http://svn.apache.org/viewvc/jakarta/commons/proper/email/trunk/xdocs/userguide.xml?view=diff&rev=481096&r1=481095&r2=481096
==============================================================================
--- jakarta/commons/proper/email/trunk/xdocs/userguide.xml (original)
+++ jakarta/commons/proper/email/trunk/xdocs/userguide.xml Thu Nov 30 14:30:31
2006
@@ -31,13 +31,16 @@
</p>
<source>
<![CDATA[
-SimpleEmail email = new SimpleEmail();
-email.setHostName("mail.myserver.com");
-email.addTo("[EMAIL PROTECTED]", "John Doe");
-email.setFrom("[EMAIL PROTECTED]", "Me");
-email.setSubject("Test message");
-email.setMsg("This is a simple test of commons-email");
-email.send();
+import org.apache.commons.mail.SimpleEmail;
+...
+
+ SimpleEmail email = new SimpleEmail();
+ email.setHostName("mail.myserver.com");
+ email.addTo("[EMAIL PROTECTED]", "John Doe");
+ email.setFrom("[EMAIL PROTECTED]", "Me");
+ email.setSubject("Test message");
+ email.setMsg("This is a simple test of commons-email");
+ email.send();
]]></source>
<p>
The call to setHostName("mail.myserver.com") sets the address of the
@@ -63,26 +66,29 @@
</p>
<source>
<![CDATA[
-// Create the attachment
-EmailAttachment attachment = new EmailAttachment();
-attachment.setPath("mypictures/john.jpg");
-attachment.setDisposition(EmailAttachment.ATTACHMENT);
-attachment.setDescription("Picture of John");
-attachment.setName("John");
-
-// Create the email message
-MultiPartEmail email = new MultiPartEmail();
-email.setHostName("mail.myserver.com");
-email.addTo("[EMAIL PROTECTED]", "John Doe");
-email.setFrom("[EMAIL PROTECTED]", "Me");
-email.setSubject("The picture");
-email.setMsg("Here is the picture you wanted");
+import org.apache.commons.mail.*;
+...
+
+ // Create the attachment
+ EmailAttachment attachment = new EmailAttachment();
+ attachment.setPath("mypictures/john.jpg");
+ attachment.setDisposition(EmailAttachment.ATTACHMENT);
+ attachment.setDescription("Picture of John");
+ attachment.setName("John");
+
+ // Create the email message
+ MultiPartEmail email = new MultiPartEmail();
+ email.setHostName("mail.myserver.com");
+ email.addTo("[EMAIL PROTECTED]", "John Doe");
+ email.setFrom("[EMAIL PROTECTED]", "Me");
+ email.setSubject("The picture");
+ email.setMsg("Here is the picture you wanted");
-// add the attachment
-email.attach(attachment);
+ // add the attachment
+ email.attach(attachment);
-// send the email
-email.send();
+ // send the email
+ email.send();
]]></source>
<p>
You can also use EmailAttachment to reference any valid URL for files
@@ -95,26 +101,29 @@
</p>
<source>
<![CDATA[
-// Create the attachment
-EmailAttachment attachment = new EmailAttachment();
-attachment.setURL(new URL("http://www.apache.org/images/asf_logo_wide.gif"));
-attachment.setDisposition(EmailAttachment.ATTACHMENT);
-attachment.setDescription("Apache logo");
-attachment.setName("Apache logo");
-
-// Create the email message
-MultiPartEmail email = new MultiPartEmail();
-email.setHostName("mail.myserver.com");
-email.addTo("[EMAIL PROTECTED]", "John Doe");
-email.setFrom("[EMAIL PROTECTED]", "Me");
-email.setSubject("The logo");
-email.setMsg("Here is Apache's logo");
+import org.apache.commons.mail.*;
+...
-// add the attachment
-email.attach(attachment);
+ // Create the attachment
+ EmailAttachment attachment = new EmailAttachment();
+ attachment.setURL(new URL("http://www.apache.org/images/asf_logo_wide.gif"));
+ attachment.setDisposition(EmailAttachment.ATTACHMENT);
+ attachment.setDescription("Apache logo");
+ attachment.setName("Apache logo");
+
+ // Create the email message
+ MultiPartEmail email = new MultiPartEmail();
+ email.setHostName("mail.myserver.com");
+ email.addTo("[EMAIL PROTECTED]", "John Doe");
+ email.setFrom("[EMAIL PROTECTED]", "Me");
+ email.setSubject("The logo");
+ email.setMsg("Here is Apache's logo");
+
+ // add the attachment
+ email.attach(attachment);
-// send the email
-email.send();
+ // send the email
+ email.send();
]]></source>
</section>
<section name="Sending HTML formatted email">
@@ -130,25 +139,28 @@
</p>
<source>
<![CDATA[
-// Create the email message
-HtmlEmail email = new HtmlEmail();
-email.setHostName("mail.myserver.com");
-email.addTo("[EMAIL PROTECTED]", "John Doe");
-email.setFrom("[EMAIL PROTECTED]", "Me");
-email.setSubject("Test email with inline image");
-
-// embed the image and get the content id
-URL url = new URL("http://www.apache.org/images/asf_logo_wide.gif");
-String cid = email.embed(url, "Apache logo");
+import org.apache.commons.mail.HtmlEmail;
+...
-// set the html message
-email.setHtmlMsg("<html>The apache logo - <img src=\"cid:"+cid+"\"></html>");
+ // Create the email message
+ HtmlEmail email = new HtmlEmail();
+ email.setHostName("mail.myserver.com");
+ email.addTo("[EMAIL PROTECTED]", "John Doe");
+ email.setFrom("[EMAIL PROTECTED]", "Me");
+ email.setSubject("Test email with inline image");
+
+ // embed the image and get the content id
+ URL url = new URL("http://www.apache.org/images/asf_logo_wide.gif");
+ String cid = email.embed(url, "Apache logo");
+
+ // set the html message
+ email.setHtmlMsg("<html>The apache logo - <img src=\"cid:"+cid+"\"></html>");
-// set the alternative message
-email.setTextMsg("Your email client does not support HTML messages");
+ // set the alternative message
+ email.setTextMsg("Your email client does not support HTML messages");
-// send the email
-email.send();
+ // send the email
+ email.send();
]]></source>
<p>
First, notice that the call to embed() returns a String. This String
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]