发送带有接缝的活动邀请

这些天来，我的一位同事在使用带有接缝（2.x版）的邮件模板发送事件邀请时遇到了问题。从根本上讲，这不是一个艰巨的任务，因此我将简要说明使用接缝邮件模板发送事件邀请需要做什么。

发送邮件邀请时，您需要发送带有附件的电子邮件，其中包含有关特定事件的信息。我将创建用于发送邀请的简单模板和发送者类。

Seam 2.x包含其他组件，这些组件负责发送邮件和创建模板。要使用此功能，我们需要在应用程序中包括接缝邮件组件，而使用maven时，我们可以这样做：

<dependency><groupId>org.jboss.seam</groupId><artifactId>jboss-seam-mail</artifactId>
</dependency>

接缝模板机制使我们可以像对标准jsp页面一样创建邮件模板。它很容易学习，并且还可以使用标准的jsp标记（如果使用的话是JSF）。在此示例中，我将不对接缝邮件模板化机制的使用做进一步的介绍。在下面，您可以找到用于发送邀请的模板的简单示例。

<!DOCTYPE composition PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<m:message xmlns="http://www.w3.org/1999/xhtml"xmlns:m="http://jboss.com/products/seam/mail"xmlns:h="http://java.sun.com/jsf/html"><m:header name="Content-Class" value="urn:content-classes:calendarmessage"/><m:from name="Test Mail" address="no-reply-mail@invitation.example" /><m:to name="Igor Madjeric">#{eventInvitation.recipient}</m:to><m:subject><h:outputText value="Test invitation" />
</m:subject><m:body><m:attachment contentType="text/calendar;method=CANCEL" fileName="invitation.ics">
BEGIN:VCALENDAR
METHOD:REQUEST
PRODID:-//Direct Scouts GmbH//INA//DE
VERSION:2.0
CALSCALE:GREGORIAN
BEGIN:VEVENT
DTSTAMP:#{eventInvitation.currentDateAsString}
DTSTART:#{eventInvitation.startAsString}
DTEND:#{eventInvitation.endAsString}
SUMMARY;CHARSET=UTF-8:Test invitation
UID:de827ded-5fc8-4ceb-af1b-b8d9cfbcbca8
ATTENDEE;ROLE=OWNER;PARTSTAT=NEEDS-ACTION;RSVP=FALSE:MAILTO:#{eventInvitation.recipient}
ORGANIZER:MAILTO:xxx@gmail.com
LOCATION;CHARSET=UTF-8:#{eventInvitation.location}
DESCRIPTION;CHARSET=UTF-8:#{eventInvitation.description}
SEQUENCE:0
PRIORITY:5
CLASS:PUBLIC
STATUS:CONFIRMED
TRANSP:OPAQUE
BEGIN:VALARM
ACTION:DISPLAY
DESCRIPTION:REMINDER
TRIGGER;RELATED=START:-PT00H15M00S
END:VALARM
END:VEVENT
END:VCALENDAR</m:attachment>
</m:body>
</m:message>

如您所见，它并不复杂，就像制作JSP页面一样。创建邀请时，您需要注意UID，它是为其创建邀请的事件的唯一标识符，因此，如果以后需要更改有关该事件的某些内容，则只需要使用相同的UID。在此示例中，我创建了EventInvitation模型类，其中包含事件所需的数据。它们不包含大量数据，但是如果您需要更多数据，则可以对其进行扩展。

package ba.codecentric.mail.sender.model;import java.text.SimpleDateFormat;
import java.util.Date;
import org.jboss.seam.ScopeType;
import org.jboss.seam.annotations.Name;
import org.jboss.seam.annotations.Scope;@Name("eventInvitation")
@Scope(ScopeType.PAGE)
public class EventInvitation {SimpleDateFormat iCalendarDateFormat = new SimpleDateFormat("yyyyMMdd'T'HHmm'00'");private String recipient;private String location;private String description;/* Start and stop dates */private Date start;private Date end;public String getRecipient() {return recipient;}public void setRecipient(String recipient) {this.recipient = recipient;}public String getLocation() {return location;}public void setLocation(String location) {this.location = location;}public String getDescription() {return description;}public void setDescription(String description) {this.description = description;}public String getStartAsString() {return iCalendarDateFormat.format(start);}public String getEndAsString() {return iCalendarDateFormat.format(end);}public Date getStart() {return start;}public void setStart(Date start) {this.start = start;}public Date getEnd() {return end;}public void setEnd(Date end) {this.end = end;}public String getCurrentDateAsString() {return iCalendarDateFormat.format(new Date());}@Overridepublic String toString() {return "EventInvitation [recipient=" + recipient + ", location="+ location + ", description=" + description + ", start=" + start + ", end=" + end + "]";}
}

它是具有页面范围的简单接缝组件，与页面停留时间相同。从模板中可以看到，我们使用方法..AsString设置日期值。这是因为，我们不能简单地使用原始日期来表示邀请中的日期，而是使用下一种格式“ yyyyMMdd'T'HHmm'00'”来格式化日期。

为了填写日期，我使用了下一个简单表格：

<!DOCTYPE composition PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<ui:composition xmlns="http://www.w3.org/1999/xhtml"
xmlns:ui="http://java.sun.com/jsf/facelets"
xmlns:h="http://java.sun.com/jsf/html"
xmlns:s="http://jboss.com/products/seam/taglib"
xmlns:rich="http://richfaces.org/rich"
xmlns:a4j="http://richfaces.org/a4j"
xmlns:f="http://java.sun.com/jsf/core"
template="/includes/template.xhtml"><!-- main content -->
<ui:define name="MainContent">
<div class="WelcomeContent">
<a4j:form>
<rich:panel header="Welcom To Seam Mail Invitation Sender" style="width: 315px">
Start:<rich:calendar value="#{eventInvitation.start}"
popup="true"
datePattern="dd/M/yy hh:mm a"
showApplyButton="true"
cellWidth="24px"
cellHeight="22px" 
style="width:200px"/>
<br />
End:<rich:calendar value="#{eventInvitation.end}"
popup="true"
datePattern="dd/M/yy hh:mm a"
showApplyButton="true"
cellWidth="24px" 
cellHeight="22px" 
style="width:200px"/>
<br />
Location:<h:inputText value="#{eventInvitation.location}" id="location"/>
<br />
Description:<h:inputText value="#{eventInvitation.description}" id="description"/>
<br />
Recipient:<h:inputText value="#{eventInvitation.recipient}" id="recipient"/>
<a4j:commandButton value="Send Invitation"
action="#{mailInvitationSender.sendInvitation}" reRender="info" />
<h:panelGroup id="info">
<h:outputText value="Status: #{mailInvitationSender.status} " rendered="#{not empty mailInvitationSender.status}" />
</h:panelGroup>
</rich:panel>
</a4j:form>
</div>
</ui:define>
</ui:composition>

填充数据的简单页面没有什么复杂的。最后，我们将研究发送者类。

package ba.codecentric.mail.sender.controller.impl;import javax.ejb.Remove;
import javax.ejb.Stateful;import org.jboss.seam.ScopeType;
import org.jboss.seam.annotations.In;
import org.jboss.seam.annotations.Logger;
import org.jboss.seam.annotations.Name;
import org.jboss.seam.annotations.Scope;
import org.jboss.seam.faces.Renderer;
import org.jboss.seam.log.Log;import ba.codecentric.mail.sender.controller.LocalMailInvitationSender;
import ba.codecentric.mail.sender.model.EventInvitation;@Name("mailInvitationSender")
@Scope(ScopeType.CONVERSATION)
@Stateful
public class StandardMailInvitationSender implements LocalMailInvitationSender {private static final String STATUS_SUCCESS = "SUCCESS";
private static final String STATUS_FAIL = "FAIL";private static String INVITATION_TEMPLATE = "/invitation.xhtml";@Logger
private static Log LOG;// Component used for rendering template.
@In(create = true)
private Renderer renderer;@In
private EventInvitation eventInvitation;private String status;public String getStatus() {
return status;
}public void setStatus(String status) {
this.status = status;
}@Override
public void sendInvitation() {
LOG.info("Send invitation method is called!");
try {
LOG.debug(eventInvitation);
renderer.render(INVITATION_TEMPLATE);
status = STATUS_SUCCESS;
} catch (Exception e) {
LOG.error(e);
status = STATUS_FAIL;
}
LOG.info("Invitation sending:" + status);
}@Remove
public void done() {
LOG.debug("Bean removed!");
}
}

这是简单的类，使用渲染器基于模板创建邮件。因此，没有什么特别的。当然，您需要在components.xml中配置邮件会话，但这是简单的配置。您需要在components.xml中添加下一行：

<mail:mail-session session-jndi-name="java:/Mail" />

就这样。您的应用程序已准备好发送邀请：)。注意：components.xml中的上述行将创建邮件会话组件，seam将使用该组件来发送邮件。例如，如果您使用JBoss 4.xx，则可以在“ mail-service.xml”文件中编辑配置。但是如何配置邮件会话不在本文的讨论范围内，如果您需要有关此主题的更多信息，可以查看我较早的文章“ Configure Seam Mail”。

参考：在Igor Madjeric博客上，从我们的JCG合作伙伴 Igor Madjeric 发送带有Seam的活动邀请。