sendmail

説明

マルチパートの電子メールメッセージを構築し、それを指定のメールサーバに送信します。

sendmail タグ内でフロー制御タグを使用して、電子メール本文を動的に構築できます。sendmail タグを mailparam タグと併用すると、電子メールの添付ファイルが組み込めます。

sendmail タグでは、2 種類の構文がサポートされます。1 つめのタイプでは、ユーザがメールサーバ情報を指定できます。2 つめのタイプでは、Web アプリケーションで使用する JavaMail セッションオブジェクトを JRun 管理者があらかじめ定義しておく必要があります。詳細については、"前提条件"セクションを参照してください。

構文 1

指定されたメールサーバプロパティを使用して電子メールメッセージを送信します。

<jrun:sendmail

  host="host name"
  sender="e-mail address"
  recipient="e-mail address"
  [contentType="MIME type;charset=valid character set"]
  [port="port number"]
  [timeout="3000|timeout in milliseconds"]
  [cc="e-mail address"]
  [bcc="e-mail address"]
  [subject="message subject"]>
  オプション <jrun:mailparam/> のある電子メール メッセージ本文
</jrun:sendmail>

属性

host

必須。属性として java.lang.String を取ります。

メールサーバホスト名。

sender

必須。java.lang.String または javax.mail.internet.InternetAddress を取ります。

送信者の電子メールアドレス。

recipient

必須。java.lang.String、java.lang.String[]、java.util.Enumeration、 java.util.Iterator、javax.mail.internet.InternetAddress、または
javax.mail.internet.InternetAddress[] を取ります。

受信者の電子メールアドレス。文字列を指定すると、sendmail によって、文字列がカンマ区切りの電子メールアドレス一覧であるかどうかが確認されます。

contentType

オプション。java.lang.String を取ります。

電子メールメッセージコンテンツの MIME タイプおよび文字セット。

port

オプション。java.lang.String、java.lang.Integer、または int を取ります。

メールサーバのポート番号。文字列を指定した場合は、整数値に解析されます。既定値は 25 です。

timeout

オプション。java.lang.String、java.lang.Integer、または int を取ります。

メールサーバのミリ秒単位のタイムアウト値。文字列を指定した場合は、整数値に解析されます。既定値は 3000 です。

cc

オプション。java.lang.String、java.lang.String[]、 java.util.Enumeration、java.util.Iterator、 javax.mail.internet.InternetAddress、または javax.mail.internet.InternetAddress[] を取ります。

カーボンコピー (cc) 受信者の電子メールアドレス。文字列を指定すると、 sendmail によって、文字列がカンマ区切りの電子メールアドレス一覧であるかどうかが確認されます。

bcc

ブラインドカーボンコピー (bcc) 受信者の電子メールアドレス。文字列を指定すると、sendmail によって、文字列がカンマ区切りの電子メールアドレス一覧であるかどうかが確認されます。

subject

オプション。java.lang.String を取ります。

電子メールの件名。

構文 2

指定された JavaMail セッションオブジェクトを使用して電子メールメッセージを送信します。

<jrun:sendmail

  session="JavaMail session object"
  sender="e-mail address"
  recipient="e-mail address"
  [contentType="mime type;charset=valid character set"]
  [cc="e-mail address"]
  [bcc="e-mail address"]
  [subject="message subject"]>
  オプション <jrun:mailparam/> のある電子メール メッセージ本文
</jrun:sendmail>

属性

session

必須。java.lang.String または javax.mail.Session を取ります。

JavaMail セッションオブジェクト。文字列を指定すると、"java:comp/env/mail/ [session]" で JNDI 検索 (ルックアップ) を実行することにより、メールセッションオブジェクトが取得できると仮定されます。セッションオブジェクトを既定の InitialContext から取得できない場合は、jndi タグを使用して別の
InitialContext からセッションを検索します。詳細については、jndiセクションを参照してください。通常、JRun 管理者によって、JavaMail セッションオブジェクトがあらかじめインストールされています。

sender

必須。java.lang.String または javax.mail.internet.InternetAddress を取ります。

送信者の電子メールアドレス。

recipient

必須。java.lang.String、java.lang.String[]、java.util.Enumeration、 java.util.Iterator、javax.mail.internet.InternetAddress、または javax.mail.internet.InternetAddress[] を取ります。

contentType

オプション。java.lang.String を取ります。

電子メールメッセージコンテンツの MIME タイプおよび文字セット。

cc

bcc

subject

オプション。java.lang.String を取ります。

電子メールの件名。

前提条件

sendmail タグおよび getmail タグで JavaMail セッション属性を使用するには、JRun サーバの local.properties ファイルを編集して、次のエントリを加えます。

mail.[session name].description=[JavaMail session description]

mail.[session name].display-name=[JavaMail session display name in JMC]
mail.[session name].store.protocol=[pop3|imap (message store protocol]
mail.[session name].transport.protocol=smtp (transport protocol)
mail.[session name].host =[Mail server host name]
mail.[session name].user =[Default user name]
mail.[session name].smtp.host=[Default SMTP server host name]
mail.[session name].smtp.user=[Default SMTP user name]
mail.[session name].imap.host=[Default IMAP server host name]
mail.[session name].imap.user=[Default IMAP server user name]
mail.[session name].pop3.host=[Default POP3 server host name]
mail.[session name].pop3.user=[Default POP3 server user name]
mail.[session name].from=[Default sender email address]
mail.[session name].debug=[true|false (enable debug messages)]

例

この JSP は、sendmail タグを使用して電子メールメッセージを送信する 2 種類の方法を示しています。電子メールの添付ファイル送信の例については、mailparamセクションを参照してください。

<%@ page import="allaire.taglib.*" %>

<%@ taglib uri="jruntags" prefix="jrun" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><title>sendmail Tag Example</title></head><body>
<%--
(sendmail 構文 1) メール サーバ プロパティを指定してメールを送信します。
--%>
<jrun:sendmail host="company1.com"
sender="someone@somewhere.com"
recipient="someone@somewhere.com">
Hello world.
</jrun:sendmail>
<%--
(sendmail 構文 2) JavaMail セッション オブジェクトを使用してメールを送信します。
--%>
<jrun:sendmail session="session1"
sender="someone@somewhere.com"
recipient="someoneelse@somewherelse.com">
Hello world.
</jrun:sendmail>
</body></html>

JRun タグライブラリリファレンス
JRun タグ