发送邮件

在ActFramework发送邮件是非常简单的工作。如果你的某个类具有邮件发送方法，你需要：

  1. 使用act.mail.Mailer注解标记该类

  2. 让该类继承Mailer.Util类或者使用静态引入

    import static act.mail.Mailer.Util.*

创建邮件发送方法

  1. package com.mycom.myprj;
  3. import act.conf.AppConfig;
  4. import act.job.Every;
  5. import act.mail.Mailer;
  6. import org.osgl.logging.*;
  7. import org.osgl.util.E;
  8. import org.osgl.util.S;
  10. import javax.inject.Inject;
  12. /**
  13.  * This class demonstrate how to write an email sender
  14.  * in act framework.
  15.  */
  16. @Mailer
  17. public class PostOffice extends Mailer.Util {
  19.     public void sendWelcome(Contact who) {
  20.         to(who.getEmail());
  21.         subject("Welcome letter");
  22.         send(who);
  23.     }
  25.     public void sendBye(Contact who) {
  26.         to(who.getEmail());
  27.         send(who);
  28.     }
  30. }

创建邮件模板

为每一个邮件发送方法创建对应的模板。模板的位置和控制器响应方法模板位置依照同样规则，对于上例中的sendWelcome和sendBye方法，对应的模板文件分别为:

  1. src/main/resources/rythm/com/mycom/myprj/PostOffice/sendWelcome.html:

    1.  <html>
    2.  <head></head>
    3.  <body>
    4.  @args com.mycom.myprj.Contact who
    5.  <h1>Welcome @who.getFirstName()!</h1>
    6.  <p>Blah Blah</p>
    7.  </body>
    8.  </html>

  2. src/main/resources/rythm/com/mycom/myprj/PostOffice/sendBye.html:

    1.  <html>
    2.  <head></head>
    3.  <body>
    4.  @args com.mycom.myprj.Contact who
    5.  <h1>Good bye @who.getFirstName()!</h1>
    6.  </body>
    7.  </html>

调用邮件发送方法

你可以简单地通过方法调用发送邮件

  1. public class MyController {
  3.     @Inject
  4.     private PostOffice postOffice;
  6.     @PostAction("/contact")
  7.     public void createContact(Contact contact) {
  8.         contactDao.save(contact);
  9.         postOffice.sendWelcome(contact);
  10.     }
  12.     @PutAction("/contact/{contactId}/signOff")
  13.     public void signOff(String contactId) {
  14.         Contact contact = contactDao.findById(contactId);
  15.         contact.signOff();
  16.         contactDao.save(contact);
  17.         postOffice.sendBye(contact);
  18.     }
  19. }

异步调用邮件发送方法

因为涉及远程通信，邮件发送通常来讲是比较耗时的操作。如果在控制器中调用邮件发送会造成结果返回延时。通常的做法是采用异步方式发送邮件，在ActFramework中，你可以通过事件分派来实现:

  1. 使用act.event.On注解将邮件发送方法标注为异步事件响应器

    1.  @On(value = "contact-created", async = true)
    2.  public void sendWelcome(Contact who) {
    3.      to(who.getEmail());
    4.      subject("Welcome letter");
    5.      send(who);
    6.  }
    8.  @On(value = "contact-signed-off", async = true)
    9.  public void sendBye(Contact who) {
    10.      to(who.getEmail());
    11.      send(who);
    12.  }

  2. 在需要调用邮件发送方法的时候触发事件

    1.  public class MyController {
    3.      @Inject
    4.      EventBus eventBus;
    6.      @PostAction("/contact")
    7.      public void createContact(Contact contact) {
    8.          contactDao.save(contact);
    9.          eventBus.trigger("contact-created", contact);
    10.      }
    12.      @PutAction("/contact/{contactId}/signOff")
    13.      public void signOff(String contactId) {
    14.          Contact contact = contactDao.findById(contactId);
    15.          contact.signOff();
    16.          contactDao.save(contact);
    17.          eventBus.trigger("contact-signed-off", contact);
    18.      }
    19.  }

返回目录