message

Description

This tag denotes reference to the current message bean within an enclosing <mail:messages> tag. A message bean may be created and/or referenced by the use of the id or name attributes. The body of this tag may contain get/set tags that will generate output derived from the contents of this bean tag.

Tag Body

JSP

Tag Parent

<mailPrefix:messages>

Restrictions

None.

Attributes

The tag has the following attributes for which the Required value is “No”:

id

Name of the bean to create.

name

Name of the bean to use.

index

Specifies the index into the current message list of the message bean to find.

Properties

The tag provides the following bean properties for which the Type values are “String”, “Boolean” and Access value is “Get/Set”:

from

Provides access to the full address specified in the "From:" header. (example: John Doe <jdoe@somedomain.com>)

fromAddress

Provides access to just the address specified in the "From:" header, excluding the comment field.

fromPersonal

Provides access to the comment specified in the "From:" header if there is one, excluding the actual address.

replyTo

Provides access to the "Reply-To:" header if the header exists. In the event that it doesn't, the same value as the "from" property is returned.

replyToAddress

Provides access to just the address portions of the "Reply-To:" header if the header exists. In the event that it doesn't, the same value as the "fromAddress" property is returned.

replyToPersonal

Provides access to just the comment portions of the "Reply-To:" header if the header exists and has a comment. In the event that it doesn't, the same value as the "fromPersonal" property is returned.

to

Provides access to the entire "To:" message header.

toAddress

Provides access to just the address portions of the "To:" header.

toAddressReply

Provides access to just the address portions of the "To:" header, exluding any address that matches the user's.

cc

Provides access to the entire "Cc:" message header.

ccAddress

Provides access to just the address portions of the "Cc:" header.

ccAddressReply

Provides access to just the address portions of the "Cc:" header, excluding any address that matches the user's.

bcc

Message bcc.

seen

A boolean that indicates if the message has been seen.

recent

A boolean that indicates if the message is recent.

deleted

A boolean that indicates if the message is deleted.

subject

Message subject.

date

Message date.

text

Message text.

Example(s)

<%-- message tag example --%>
...
<mail:context/>
...
<mail:fetch collection="messages" id="INBOX" sb="date" sd="down"/>
...
<mail:messages id="msgs">
	<mail:set property="start" value="$(start)"/>
	<mail:set property="count" value="5"/>
</mail:messages>
<mail:messages name="msgs" iterate="true">
	<mail:message>
		<p>Subject:  <mail:get property="subject"/>
	</mail:message>
</mail:messages>