パッケージ org.opengion.hayabusa.taglib

クラス MailSenderTag

java.lang.Object
jakarta.servlet.jsp.tagext.TagSupport
jakarta.servlet.jsp.tagext.BodyTagSupport
org.opengion.hayabusa.taglib.CommonTagSupport
org.opengion.hayabusa.taglib.MailSenderTag
すべての実装されたインタフェース:
BodyTag, IterationTag, JspTag, Tag, TryCatchFinally, Serializable
public class MailSenderTag extends CommonTagSupport
ﾒｰﾙを送信するための簡易ﾀｸﾞです。 Body 部に、ﾒｯｾｰｼﾞを記述します。
関連項目:
変更履歴:
8.5.2.0 (2023/07/14) 一部の機能廃止による修正(問合・ﾄﾗﾌﾞﾙ 0200010980)
機能分類
その他出力
形式ｻﾝﾌﾟﾙ:
●形式:<og:mailSender from="…" to="…" subject="･･･"/> ●body:あり(EVAL_BODY_BUFFERED:BODYを評価し、{@XXXX} を解析します) ●Tag定義: <og:mailSender subject 【TAG】ﾀｲﾄﾙを指定します from 【TAG】送信元(FROM)ｱﾄﾞﾚｽを指定します to 【TAG】送信先(TO)ｱﾄﾞﾚｽをCSV形式で指定します cc 【TAG】送信先(CC)ｱﾄﾞﾚｽをCSV形式で指定します bcc 【TAG】送信先(ＢCC)ｱﾄﾞﾚｽをCSV形式で指定します replyTo 【TAG】返信先(replyTo)ｱﾄﾞﾚｽをCSV形式で指定します host 【TAG】ﾒｰﾙｻｰﾊﾞｰを指定します (初期値:COMMON_MAIL_SERVER[=]) smtpPort 【TAG】SMTPﾎﾟｰﾄをCSV形式で指定します(初期値:SMTP_PORT) // 5.8.1.1 (2014/11/14) authType 【TAG】認証方式 初期値:MAIL_SEND_AUTH // 5.8.1.1 (2014/11/14) authPort 【TAG】認証ﾎﾟｰﾄ 初期値:MAIL_SEND_AUTH_PORT // 5.8.1.1 (2014/11/14) authUser 【TAG】認証ﾕｰｻﾞｰ 初期値:MAIL_SEND_AUTH_USER // 5.8.1.1 (2014/11/14) authPass 【TAG】認証ﾊﾟｽﾜｰﾄﾞ 初期値:MAIL_SEND_AUTH_PASSWORD // 5.8.1.1 (2014/11/14) useSSL 【TAG】SSL接続[false/true] 初期値:MAIL_SEND_USE_SSL // 6.3.8.0 (2015/09/11) charset 【TAG】文字ｴﾝｺｰﾃﾞｨﾝｸﾞを指定します(初期値:MAIL_DEFAULT_CHARSET[=ISO-2022-JP]) fileURL 【TAG】添付ﾌｧｲﾙのｾｰﾌﾞﾃﾞｨﾚｸﾄﾘを指定します(初期値:FILE_URL[=filetemp/]) filename 【TAG】添付ﾌｧｲﾙ名をCSV形式で指定します useLDAP 【TAG】ﾒｰﾙｱﾄﾞﾚｽをLDAPを利用して取得するかどうか[true/false]を指定します(初期値:false) ldapKey 【TAG】ｱﾄﾞﾚｽを検索するｷｰを指定します(初期値:LDAP_MAILSEND_KEY[=uid] C社員番号) ldapVals 【TAG】LDAP検索時の属性名を指定します(初期値:LDAP_MAILSEND_VALS[=cn,mail]) useDB 【TAG】ﾒｰﾙｱﾄﾞﾚｽをDB(GE35)を利用して取得するかどうか[true/false]を指定します(初期値:false) useHistory 【TAG】GE32,34に送信履歴を保存するかどうか[true/false]を指定します(初期値:USE_MAILSENDER_HISTORY) debug 【TAG】ﾃﾞﾊﾞｯｸﾞ情報を出力するかどうか[true/false]を指定します(初期値:false) > ... Body ... </og:mailSender> ●使用例 <og:mailSender from="C00000" to="C99999" subject="{@SUBJECT}" > ﾒｰﾙ内容 </og:mailSender > charset = ｷｬﾗｸﾀｾｯﾄ (例:Windows-31J , ISO-2022-JP) from = From 送信元 to = To 送信先(複数登録可能) cc = Cc 送信先(複数登録可能) bcc = Bcc 送信先(複数登録可能) replyTo = ReplyTo 返信先先(複数登録可能) host = SMTPｻｰﾊﾞｰ名 smtpPort = SMTPﾎﾟｰﾄ 初期値:SMTP_PORT // 5.8.1.1 (2014/11/14) authType = 認証方式 初期値:MAIL_SEND_AUTH // 5.8.1.1 (2014/11/14) authPort = 認証ﾎﾟｰﾄ 初期値:MAIL_SEND_AUTH_PORT // 5.8.1.1 (2014/11/14) authUser = 認証ﾕｰｻﾞｰ 初期値:MAIL_SEND_AUTH_USER // 5.8.1.1 (2014/11/14) authPass = 認証ﾊﾟｽﾜｰﾄﾞ 初期値:MAIL_SEND_AUTH_PASSWORD // 5.8.1.1 (2014/11/14) useSSL = SSL接続[false/true] 初期値:MAIL_SEND_USE_SSL // 6.3.8.0 (2015/09/11) subject = ﾀｲﾄﾙ fileURL = 添付ﾌｧｲﾙのｾｰﾌﾞﾃﾞｨﾚｸﾄﾘ filename = 添付ﾌｧｲﾙ名(ﾛｰｶﾙにｾｰﾌﾞされたﾌｧｲﾙ名)(複数登録可能) debug = true/false; 複数登録可能な個所は、CSV形式で、複数登録できます。 ｱﾄﾞﾚｽ(from,to,cc,bcc,replyTo)は、『"名称" <ﾒｰﾙｱﾄﾞﾚｽ>』形式が 指定できます。< と > で囲まれた範囲がﾒｰﾙｱﾄﾞﾚｽになります。 名称には、漢字が使用できます。 host は、ｼｽﾃﾑﾊﾟﾗﾒｰﾀ の COMMON_MAIL_SERVER 属性が初期値で設定されます。 charset は、ｼｽﾃﾑﾊﾟﾗﾒｰﾀ の MAIL_DEFAULT_CHARSET 属性が初期値で設定されます。
導入されたバージョン:
JDK5.0,

  • コンストラクタの詳細

    • MailSenderTag

      public MailSenderTag()
      ﾃﾞﾌｫﾙﾄｺﾝｽﾄﾗｸﾀｰ
      変更履歴:
      6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.

  • メソッドの詳細

    • doStartTag

      public int doStartTag()
      Taglibの開始ﾀｸﾞが見つかったときに処理する doStartTag() を ｵｰﾊﾞｰﾗｲﾄﾞします。
      定義:
      doStartTag インタフェース内 Tag
      オーバーライド:
      doStartTag クラス内 CommonTagSupport
      戻り値:
      後続処理の指示( EVAL_BODY_BUFFERED )
      変更履歴:
      6.3.8.0 (2015/09/11) SSL接続するかどうかを指定するﾊﾟﾗﾒｰﾀを追加します。, 5.9.29.2 (2018/02/16) STARTTLS対応(ｷｰﾜｰﾄﾞをVer5 にあわせます)

    • doAfterBody

      public int doAfterBody()
      Taglibのﾀｸﾞ本体を処理する doAfterBody() を ｵｰﾊﾞｰﾗｲﾄﾞします。
      定義:
      doAfterBody インタフェース内 IterationTag
      オーバーライド:
      doAfterBody クラス内 CommonTagSupport
      戻り値:
      後続処理の指示(SKIP_BODY)
      変更履歴:
      3.1.1.0 (2003/03/28) ﾎﾞﾃﾞｨの内容を取得する処理を、CommonTagSupport で行う。, 5.9.2.3 (2015/11/27) messageをｲﾝｽﾀﾝｽ変数に変更。

    • doEndTag

      public int doEndTag()
      Taglibの終了ﾀｸﾞが見つかったときに処理する doEndTag() を ｵｰﾊﾞｰﾗｲﾄﾞします。
      定義:
      doEndTag インタフェース内 Tag
      オーバーライド:
      doEndTag クラス内 CommonTagSupport
      戻り値:
      後続処理の指示
      変更履歴:
      3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。, 3.7.1.0 (2005/04/15) LDAP検索 新規追加, 5.6.9.3 (2013/10/25) 送信後に履歴を残す(history追加)。mailSender2同様、ここがｴﾗｰでもﾒｰﾙ送信は完了しているので注意。, 5.9.3.0 (2015/12/04) useHistory対応, 8.5.2.0 (2023/07/14) 一部の機能廃止による修正(問合・ﾄﾗﾌﾞﾙ 0200010980)

    • release2

      protected void release2()
      ﾀｸﾞﾘﾌﾞｵﾌﾞｼﾞｪｸﾄをﾘﾘｰｽします。 ｷｬｯｼｭされて再利用されるので、ﾌｨｰﾙﾄﾞの初期設定を行います。
      オーバーライド:
      release2 クラス内 CommonTagSupport
      変更履歴:
      2.0.0.4 (2002/09/27) ｶｽﾀﾑﾀｸﾞの release() ﾒｿｯﾄﾞを、追加, 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。, 3.7.1.0 (2005/04/15) LDAP検索 useLDAP,ldapKey,ldapVals 属性追加, 5.6.7.0 (2013/07/27) ldapKey,ldapValsの取得をﾘｿｰｽに変更, 5.6.9.3 (2013/10/25) useDB追加, 5.8.1.1 (2014/11/14) ﾒｰﾙ送信時認証追加。smtpPort,authPort,authType,authUser,authPass, 6.3.8.0 (2015/09/11) SSL接続するかどうかを指定するﾊﾟﾗﾒｰﾀを追加します。, 5.6.9.3 (2013/10/25) 送信後に履歴を残す(history追加)。, 5.9.29.2 (2018/02/16) STARTTLS対応(ｷｰﾜｰﾄﾞをVer5 にあわせます), 8.5.2.0 (2023/07/14) 一部の機能廃止による修正(問合・ﾄﾗﾌﾞﾙ 0200010980)

    • setFrom

      public void setFrom(String fromAdrs)
      【TAG】送信元(FROM)アドレスを指定します。
      パラメータ:
      fromAdrs - 送信元(FROM)アドレス
      説明:
      送信元(FROM)アドレスを指定します。

    • setTo

      public void setTo(String toAdrs)
      【TAG】送信先(TO)ｱﾄﾞﾚｽをCSV形式で指定します。
      パラメータ:
      toAdrs - 送信先(TO)ｱﾄﾞﾚｽ(CSV形式)
      変更履歴:
      3.5.6.2 (2004/07/05) 先に配列に分解してからﾘｸｴｽﾄ変数の値を取得, 3.5.6.4 (2004/07/16) 先にﾘｸｴｽﾄ変数の値を取得してから配列に分解
      説明:
      複数ｱﾄﾞﾚｽをCSV形式でｾｯﾄできます。

    • setCc

      public void setCc(String ccAdrs)
      【TAG】送信先(CC)ｱﾄﾞﾚｽをCSV形式で指定します。
      パラメータ:
      ccAdrs - 送信先(CC)ｱﾄﾞﾚｽ(CSV形式)
      変更履歴:
      3.5.6.2 (2004/07/05) 先に配列に分解してからﾘｸｴｽﾄ変数の値を取得, 3.5.6.4 (2004/07/16) 先にﾘｸｴｽﾄ変数の値を取得してから配列に分解
      説明:
      複数ｱﾄﾞﾚｽをCSV形式でｾｯﾄできます。

    • setBcc

      public void setBcc(String bccAdrs)
      【TAG】送信先(BCC)ｱﾄﾞﾚｽをCSV形式で指定します。
      パラメータ:
      bccAdrs - 送信先(BCC)ｱﾄﾞﾚｽ(CSV形式)
      変更履歴:
      3.5.6.2 (2004/07/05) 先に配列に分解してからﾘｸｴｽﾄ変数の値を取得, 3.5.6.4 (2004/07/16) 先にﾘｸｴｽﾄ変数の値を取得してから配列に分解
      説明:
      複数ｱﾄﾞﾚｽをCSV形式でｾｯﾄできます。

    • setReplyTo

      public void setReplyTo(String replyToAdrs)
      【TAG】返信先(replyTo)ｱﾄﾞﾚｽをCSV形式で指定します。
      パラメータ:
      replyToAdrs - 返信先(replyTo)ｱﾄﾞﾚｽ(CSV形式)
      変更履歴:
      3.5.6.6 (2004/08/23) 新規追加
      説明:
      複数ｱﾄﾞﾚｽをCSV形式でｾｯﾄできます。

    • setHost

      public void setHost(String hst)
      【TAG】ﾒｰﾙｻｰﾊﾞｰを指定します (初期値:COMMON_MAIL_SERVER[=])。
      パラメータ:
      hst - ﾒｰﾙｻｰﾊﾞｰ
      関連項目:
      変更履歴:
      3.5.6.6 (2004/08/23) 初期値を考慮するように変更。
      説明:
      ﾒｰﾙｻｰﾊﾞｰを指定します。 (初期値:ｼｽﾃﾑ定数のCOMMON_MAIL_SERVER[=])。

    • setSubject

      public void setSubject(String subjct)
      【TAG】ﾀｲﾄﾙを指定します。
      パラメータ:
      subjct - ﾀｲﾄﾙ
      説明:
      ﾀｲﾄﾙを指定します。

    • setFilename

      public void setFilename(String fname)
      【TAG】添付ﾌｧｲﾙ名をCSV形式で指定します。
      パラメータ:
      fname - 添付ﾌｧｲﾙ名(CSV形式)
      変更履歴:
      3.5.6.6 (2004/08/23) 複数ﾌｧｲﾙ指定方法を、重複ﾘｸｴｽﾄからCSV形式に変更
      説明:
      複数ﾌｧｲﾙをｾｯﾄできます。 設定方法は、ｶﾝﾏで区切って並べ複数指定できます。

    • setCharset

      public void setCharset(String chset)
      【TAG】文字ｴﾝｺｰﾃﾞｨﾝｸﾞを指定します (初期値:MAIL_DEFAULT_CHARSET[=])。
      パラメータ:
      chset - 文字ｴﾝｺｰﾃﾞｨﾝｸﾞ
      関連項目:
      説明:
      文字ｴﾝｺｰﾃﾞｨﾝｸﾞは、ﾒｰﾙ本文に対するｴﾝｺｰﾃﾞｨﾝｸﾞ指定です。 これは、Windows-31J、MS932、Shift_JIS のどれかが指定された場合、 『指定の文字ｺｰﾄﾞ + 8bit 送信』します。 それ以外の指定は、『ISO-2022-JP に独自変換 + 7bit 送信』になります。 (初期値:ｼｽﾃﾑ定数のMAIL_DEFAULT_CHARSET[=])。

    • setFileURL

      public void setFileURL(String url)
      【TAG】添付ﾌｧｲﾙのｾｰﾌﾞﾃﾞｨﾚｸﾄﾘを指定します (初期値:FILE_URL[=])。
      パラメータ:
      url - 添付ﾌｧｲﾙのｾｰﾌﾞﾃﾞｨﾚｸﾄﾘ
      関連項目:
      変更履歴:
      4.0.0.0 (2005/01/31) StringUtil.urlAppend ﾒｿｯﾄﾞの利用, 4.0.0.0 (2007/11/20) 指定されたﾃﾞｨﾚｸﾄﾘ名の最後が"\"or"/"で終わっていない場合に、"/"を付加する。, 6.4.2.1 (2016/02/05) URLの最後に、"/" を追加する処理を廃止。
      説明:
      この属性で指定されるﾃﾞｨﾚｸﾄﾘに、添付ﾌｧｲﾙが存在すると仮定します。 指定方法は、通常の fileURL 属性と同様に、先頭が、'/' (UNIX) または、2文字目が、 ":" (Windows)の場合は、指定のURLそのままのﾃﾞｨﾚｸﾄﾘに、そうでない場合は、 fileURL = "{@USER.ID}" と指定すると、FILE_URL 属性で指定のﾌｫﾙﾀﾞの下に、 さらに、各個人ID別のﾌｫﾙﾀﾞを作成して、そこを使用します。 (初期値:ｼｽﾃﾑ定数のFILE_URL[=])。

    • setUseDB

      public void setUseDB(String flag)
      【TAG】ﾒｰﾙｱﾄﾞﾚｽをGE35を利用して取得するかどうか[true/false]を指定します(初期値:false)。
      パラメータ:
      flag - ﾒｰﾙｱﾄﾞﾚｽのGE35利用 [true:利用する/false:利用しない]
      変更履歴:
      5.6.9.3 (2013/10/25) 新規追加
      説明:
      GE35からﾒｰﾙｱﾄﾞﾚｽを取得する場合は、true をｾｯﾄします。false の場合は、 from,to,cc,bcc,replyTo の設定値がそのまま使用されます。 上記ｱﾄﾞﾚｽに、@ を含む場合は、DB を検索せず、ﾒｰﾙｱﾄﾞﾚｽとして そのまま使用します。DB の検索結果が存在しない場合は、不正なｱﾄﾞﾚｽとして、 ｴﾗｰとします。 // * useLDAPと同時に設定されている場合は、LDAP設定が優先されます。 初期値は、false です。

    • setSmtpPort

      public void setSmtpPort(String port)
      【TAG】ﾒｰﾙ送信ﾎﾟｰﾄ番号をｾｯﾄします (初期値:ｼｽﾃﾑ定数のSMTP_PORT[=])。
      パラメータ:
      port - SMTPﾎﾟｰﾄ
      変更履歴:
      5.8.1.1 (2014/11/14) ﾒｰﾙ送信時認証｢POP_BEFORE_SMTP｣追加
      説明:
      初期値は、ｼｽﾃﾑ定数のSMTP_PORT を使用します。 (初期値:ｼｽﾃﾑ定数のSMTP_PORT[=])。

    • setAuthType

      public void setAuthType(String type)
      【TAG】ﾒｰﾙ送信時認証方式をｾｯﾄします (初期値:ｼｽﾃﾑ定数のMAIL_SEND_AUTH[=])。
      パラメータ:
      type - 認証方式
      変更履歴:
      5.8.1.1 (2014/11/14) ﾒｰﾙ送信時認証｢POP_BEFORE_SMTP｣追加, 6.2.4.1 (2015/05/22) SMTP_AUTH 対応。｢SMTP_AUTH｣追加(ｺﾒﾝﾄのみ修正)
      説明:
      認証を行う場合は｢POP_BEFORE_SMTP｣または、｢SMTP_AUTH｣が指定できます。 認証時には認証ﾕｰｻﾞと認証ﾊﾟｽﾜｰﾄﾞを設定する必要があります。 初期値は、ｼｽﾃﾑ定数のMAIL_SEND_AUTH を使用します。 (初期値:ｼｽﾃﾑ定数のMAIL_SEND_AUTH[=])。

    • setAuthPort

      public void setAuthPort(String port)
      【TAG】ﾒｰﾙ送信時認証ﾎﾟｰﾄをｾｯﾄします (初期値:ｼｽﾃﾑ定数のMAIL_SEND_AUTH_PORT[=])。
      パラメータ:
      port - 認証ﾎﾟｰﾄ
      変更履歴:
      5.8.1.1 (2014/11/14) ﾒｰﾙ送信時認証｢POP_BEFORE_SMTP｣追加
      説明:
      ｢POP_BEFORE_SMTP｣認証を行う場合に、POPｻｰﾊﾞｰに接続するﾎﾟｰﾄ番号を指定します。 指定しない場合は、POP3ﾃﾞﾌｫﾙﾄﾎﾟｰﾄを使用します。 初期値は、ｼｽﾃﾑ定数のMAIL_SEND_AUTH_PORT を使用します。 (初期値:ｼｽﾃﾑ定数のMAIL_SEND_AUTH_PORT[=])。

    • setAuthUser

      public void setAuthUser(String user)
      【TAG】ﾒｰﾙ送信認証ﾕｰｻﾞをｾｯﾄします (初期値:ｼｽﾃﾑ定数のMAIL_SEND_AUTH_USER[=])。
      パラメータ:
      user - 認証ﾕｰｻﾞ
      変更履歴:
      5.8.1.1 (2014/11/14) ﾒｰﾙ送信時認証｢POP_BEFORE_SMTP｣追加
      説明:
      初期値は、ｼｽﾃﾑ定数のMAIL_SEND_AUTH_USER を使用します。 (初期値:ｼｽﾃﾑ定数のMAIL_SEND_AUTH_USER[=])。

    • setAuthPass

      public void setAuthPass(String pass)
      【TAG】ﾒｰﾙ送信認証ﾊﾟｽﾜｰﾄﾞをｾｯﾄします (初期値:ｼｽﾃﾑ定数のMAIL_SEND_AUTH_PASSWORD[=])。
      パラメータ:
      pass - 認証ﾊﾟｽﾜｰﾄﾞ
      変更履歴:
      5.8.1.1 (2014/11/14) ﾒｰﾙ送信時認証｢POP_BEFORE_SMTP｣追加
      説明:
      初期値は、ｼｽﾃﾑ定数のMAIL_SEND_AUTH_PASSWORD を使用します。 (初期値:ｼｽﾃﾑ定数のMAIL_SEND_AUTH_PASSWORD[=])。

    • setUseTLS

      public void setUseTLS(String flag)
      【TAG】ﾒｰﾙ送信時のSTARTTLS利用の設定。
      パラメータ:
      flag - TLS利用有無
      変更履歴:
      5.9.29.2 (2018/02/16) STARTTLS対応(ｷｰﾜｰﾄﾞをVer5 にあわせます)
      説明:
      初期値は、ｼｽﾃﾑ定数のMAIL_SEND_USE_STARTTLSを使用します。 (初期値:ｼｽﾃﾑ定数のMAIL_SEND_AUTH_USER[=])。

    • setUseSSL

      public void setUseSSL(String isSSL)
      【TAG】SSL接続するかどうかをｾｯﾄします (初期値:ｼｽﾃﾑ定数のMAIL_SEND_USE_SSL[=])。
      パラメータ:
      isSSL - SSL接続するかどうか [true:する/false:しない]
      変更履歴:
      6.3.8.0 (2015/09/11) SSL接続するかどうか
      説明:
      SSL接続する場合は、true を設定します。 (初期値:ｼｽﾃﾑ定数のMAIL_SEND_USE_SSL[=])。

    • setUseHistory

      public void setUseHistory(String flag)
      【TAG】履歴に残すかどうかをｾｯﾄします (初期値:ｼｽﾃﾑ定数のUSE_MAILSENDER_HISTORY[=])。
      パラメータ:
      flag - 履歴に残すかどうか [true:残す/false:残さない]
      変更履歴:
      5.9.2.3 (2015/11/27) 追加
      説明:
      初期値は、ｼｽﾃﾑ定数のUSE_MAILSENDER_HISTORY を使用します。 trueを設定した場合、ｼｽﾃﾑID、送信元ｱﾄﾞﾚｽ、送信先ｱﾄﾞﾚｽ、ﾀｲﾄﾙ、本文について GE32,34に履歴として保存されます。 (初期値:ｼｽﾃﾑ定数のUSE_MAILSENDER_HISTORY[=])。

    • getAddressArray

      public String[] getAddressArray(String... src)
      引数のｱﾄﾞﾚｽ配列を社員ﾏｽﾀ（GE35)で変換して返します。 ｸﾞﾙｰﾌﾟIDは利用しません。
      パラメータ:
      src - 引数配列(可変長引数)
      戻り値:
      変換後ｱﾄﾞﾚｽ配列
      変更履歴:
      5.6.9.3 (2013/10/25) 新規追加
      このﾒｿｯﾄﾞは、nullを返しません

    • toString

      public String toString()
      このｵﾌﾞｼﾞｪｸﾄの文字列表現を返します。 基本的にﾃﾞﾊﾞｯｸﾞ目的に使用します。
      オーバーライド:
      toString クラス内 CommonTagSupport
      戻り値:
      このｸﾗｽの文字列表現
      変更履歴:
      5.6.9.3 (2013/10/25) useDBの対応
      このﾒｿｯﾄﾞは、nullを返しません