public class MailSenderTag extends CommonTagSupport
メールを送信するための簡易タグです。 Body 部に、メッセージを記述します。
●形式:<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】送信先(BCC)アドレスを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 返信先先(複数登録可能) useLDAP = false/true メールアドレスをLDAPを利用して取得するかどうか ldapKey = "uid" アドレスを検索するキー(初期値:システムリソース C社員番号) ldapVals = "cn,mail" LDAP検索時の属性名。ひとつならアドレス。2つなら名前とアドレス 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 属性が初期値で設定されます。
BR, BUFFER_MIDDLE, CR
コンストラクタと説明 |
---|
MailSenderTag()
デフォルトコンストラクター
|
修飾子とタイプ | メソッドと説明 |
---|---|
int |
doAfterBody()
Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。
|
int |
doEndTag()
Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
|
int |
doStartTag()
Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
|
java.lang.String[] |
getAddressArray(java.lang.String[] src)
引数のアドレス配列を社員マスタ(GE35)で変換して返します。
|
protected void |
release2()
タグリブオブジェクトをリリースします。
|
void |
setAuthPass(java.lang.String pass)
【TAG】メール送信認証パスワードをセットします
(初期値:システム定数のMAIL_SEND_AUTH_PASSWORD[=password])。
|
void |
setAuthPort(java.lang.String port)
【TAG】メール送信時認証ポートをセットします
(初期値:システム定数のMAIL_SEND_AUTH_PORT[=])。
|
void |
setAuthType(java.lang.String type)
【TAG】メール送信時認証方式をセットします
(初期値:システム定数のMAIL_SEND_AUTH[=])。
|
void |
setAuthUser(java.lang.String user)
【TAG】メール送信認証ユーザをセットします
(初期値:システム定数のMAIL_SEND_AUTH_USER[=opengion])。
|
void |
setBcc(java.lang.String bccAdrs)
【TAG】送信先(BCC)アドレスをCSV形式で指定します。
|
void |
setCc(java.lang.String ccAdrs)
【TAG】送信先(CC)アドレスをCSV形式で指定します。
|
void |
setCharset(java.lang.String chset)
【TAG】文字エンコーディングを指定します
(初期値:MAIL_DEFAULT_CHARSET[=ISO-2022-JP])。
|
void |
setFilename(java.lang.String fname)
【TAG】添付ファイル名をCSV形式で指定します。
|
void |
setFileURL(java.lang.String url)
【TAG】添付ファイルのセーブディレクトリを指定します
(初期値:FILE_URL[=filetemp/])。
|
void |
setFrom(java.lang.String fromAdrs)
【TAG】送信元(FROM)アドレスを指定します。
|
void |
setHost(java.lang.String hst)
【TAG】メールサーバーを指定します
(初期値:COMMON_MAIL_SERVER[=])。
|
void |
setLdapKey(java.lang.String ldapKey)
【TAG】アドレスを検索するキーを指定します(初期値:uid C社員番号)。
|
void |
setLdapVals(java.lang.String ldapVals)
【TAG】LDAP検索時の属性名を指定します(初期値:cn,mail)。
|
void |
setReplyTo(java.lang.String replyToAdrs)
【TAG】返信先(replyTo)アドレスをCSV形式で指定します。
|
void |
setSmtpPort(java.lang.String port)
【TAG】メール送信ポート番号をセットします
(初期値:システム定数のSMTP_PORT[=])。
|
void |
setSubject(java.lang.String subjct)
【TAG】タイトルを指定します。
|
void |
setTo(java.lang.String toAdrs)
【TAG】送信先(TO)アドレスをCSV形式で指定します。
|
void |
setUseDB(java.lang.String flag)
【TAG】メールアドレスをGE35を利用して取得するかどうか[true/false]を指定します(初期値:false)。
|
void |
setUseHistory(java.lang.String flag)
【TAG】履歴に残すかどうかをセットします
(初期値:システム定数のUSE_MAILSENDER_HISTORY[=false])。
|
void |
setUseLDAP(java.lang.String useLDAP)
【TAG】メールアドレスをLDAPを利用して取得するかどうか[true/false]を指定します(初期値:false)。
|
void |
setUseSSL(java.lang.String isSSL)
【TAG】SSL接続するかどうかをセットします
(初期値:システム定数のMAIL_SEND_USE_SSL[=false])。
|
java.lang.String |
toString()
このオブジェクトの文字列表現を返します。
|
add, add, addEventColumn, addEventColumn, check, commitTableObject, debugPrint, doCatch, doFinally, get, getApplicationInfo, getAttributes, getBodyRawString, getBodyString, getContextAttribute, getContextPath, getCookie, getCSVParameter, getCSVParameter, getDataCondition, getDateFormat, getDBColumn, getDBFunctionName, getDocumentLink, getGUIInfo, getGUIInfoAttri, getHostName, getLabel, getLabelInterface, getLanguage, getLASTAttri, getLongLabel, getMsg, getMsglbl, getNVLAttri, getObject, getParameterNames, getParameterRows, getRequest, getRequestAttribute, getRequestCacheData, getRequestMethod, getRequestParameter, getRequestParameterValues, getRequestValue, getRequestValue, getRequestValues, getReservedParameter, getReservedValue, getResource, getSanitizedBodyString, getScope, getSessionAttribute, getSumRequestValue, getTagName, getTransaction, getUser, getUserEditInfo, getUserInfo, isAjaxSubmitRequest, isDebug, isNoTransitionRequest, isNull, jspPrint, makeUrl, removeContextAttribute, removeObject, removeRequestAttribute, removeSessionAttribute, set, setAjaxSubmitRequest, setCaseIf, setCaseKey, setCaseNN, setCaseNull, setCaseVal, setContextAttribute, setCookie, setDebug, setLanguage, setLbl, setNoTransitionRequest, setObject, setObject, setParameterNames, setParameterRows, setRequestAttribute, setRequestCacheData, setScope, setSessionAttribute, setUserInfo, startQueryTransaction, sys, sysBool, sysInt, useMainTrans, useQuotCheck, useTag, useXssCheck
doInitBody, getBodyContent, getPreviousOut, release, setBodyContent
findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue
public MailSenderTag()
6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor. |
public int doStartTag()
doStartTag
インタフェース内 javax.servlet.jsp.tagext.Tag
doStartTag
クラス内 CommonTagSupport
6.3.8.0 (2015/09/11) SSL接続するかどうかを指定するパラメータを追加します。 |
public int doAfterBody()
doAfterBody
インタフェース内 javax.servlet.jsp.tagext.IterationTag
doAfterBody
クラス内 CommonTagSupport
3.1.1.0 (2003/03/28) ボディの内容を取得する処理を、CommonTagSupport で行う。 |
5.9.2.3 (2015/11/27) messageをインスタンス変数に変更。 |
public int doEndTag()
doEndTag
インタフェース内 javax.servlet.jsp.tagext.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対応 |
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追加)。 |
public void setFrom(java.lang.String fromAdrs)
fromAdrs
- 送信元(FROM)アドレス送信元(FROM)アドレスを指定します。
public void setTo(java.lang.String toAdrs)
toAdrs
- 送信先(TO)アドレス(CSV形式)複数アドレスをCSV形式でセットできます。
3.5.6.2 (2004/07/05) 先に配列に分解してからリクエスト変数の値を取得 |
3.5.6.4 (2004/07/16) 先にリクエスト変数の値を取得してから配列に分解 |
public void setCc(java.lang.String ccAdrs)
ccAdrs
- 送信先(CC)アドレス(CSV形式)複数アドレスをCSV形式でセットできます。
3.5.6.2 (2004/07/05) 先に配列に分解してからリクエスト変数の値を取得 |
3.5.6.4 (2004/07/16) 先にリクエスト変数の値を取得してから配列に分解 |
public void setBcc(java.lang.String bccAdrs)
bccAdrs
- 送信先(BCC)アドレス(CSV形式)複数アドレスをCSV形式でセットできます。
3.5.6.2 (2004/07/05) 先に配列に分解してからリクエスト変数の値を取得 |
3.5.6.4 (2004/07/16) 先にリクエスト変数の値を取得してから配列に分解 |
public void setReplyTo(java.lang.String replyToAdrs)
replyToAdrs
- 返信先(replyTo)アドレス(CSV形式)複数アドレスをCSV形式でセットできます。
3.5.6.6 (2004/08/23) 新規追加 |
public void setHost(java.lang.String hst)
hst
- メールサーバーSystemData.COMMON_MAIL_SERVER
メールサーバーを指定します。 (初期値:システム定数のCOMMON_MAIL_SERVER[=])。
3.5.6.6 (2004/08/23) 初期値を考慮するように変更。 |
public void setSubject(java.lang.String subjct)
subjct
- タイトルタイトルを指定します。
public void setFilename(java.lang.String fname)
fname
- 添付ファイル名(CSV形式)複数ファイルをセットできます。 設定方法は、カンマで区切って並べ複数指定できます。
3.5.6.6 (2004/08/23) 複数ファイル指定方法を、重複リクエストからCSV形式に変更 |
public void setCharset(java.lang.String chset)
chset
- 文字エンコーディングSystemData.MAIL_DEFAULT_CHARSET
文字エンコーディングは、メール本文に対するエンコーディング指定です。 これは、Windows-31J 、MS932、Shift_JIS のどれかが指定された場合、 『指定の文字コード + 8bit 送信』します。 それ以外の指定は、『ISO-2022-JP に独自変換 + 7bit 送信』になります。 (初期値:システム定数のMAIL_DEFAULT_CHARSET[=ISO-2022-JP])。
public void setFileURL(java.lang.String url)
url
- 添付ファイルのセーブディレクトリSystemData.FILE_URL
この属性で指定されるディレクトリに、添付ファイルが存在すると仮定します。 指定方法は、通常の fileURL 属性と同様に、先頭が、'/' (UNIX) または、2文字目が、 ":" (Windows)の場合は、指定のURLそのままのディレクトリに、そうでない場合は、 fileURL = "{@USER.ID}" と指定すると、FILE_URL 属性で指定のフォルダの下に、 さらに、各個人ID別のフォルダを作成して、そこを使用します。 (初期値:システム定数のFILE_URL[=filetemp/])。
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の最後に、"/" を追加する処理を廃止。 |
public void setUseLDAP(java.lang.String useLDAP)
useLDAP
- メールアドレスのLDAP利用 [true:利用する/false:利用しない]LDAP のメールアドレスを取得する場合は、true をセットします。false の場合は、 from,to,cc,bcc,replyTo の設定値がそのまま使用されます。 上記アドレスに、@ を含む場合は、LDAP を検索せず、メールアドレスとして そのまま使用します。LDAP の検索結果が存在しない場合は、不正なアドレスとして、 エラーとします。 初期値は、false です。
3.7.1.0 (2005/04/15) LDAP検索 新規追加 |
public void setLdapKey(java.lang.String ldapKey)
ldapKey
- アドレスを検索するキーLDAP のメールアドレスを取得する場合の、検索するキーを指定します。 from,to,cc,bcc,replyTo の設定値を、このキーにセットして、検索します。 uid C社員番号 、employeeNumber 社員番号 などが考えられます。 初期値は、uid(C社員番号)です。 このキーで複数の検索結果が得られた場合は、エラーとします。
3.7.1.0 (2005/04/15) LDAP検索 新規追加 |
public void setLdapVals(java.lang.String ldapVals)
ldapVals
- LDAP検索時の属性名LDAPを検索する場合、"担当者名"<メールアドレス>形式のメールアドレスを作成する 場合、検索する属性値を指定します。 ひとつならアドレス。2つなら名前とアドレスの順で指定されたと認識します。
3.7.1.0 (2005/04/15) LDAP検索 新規追加 |
public void setUseDB(java.lang.String flag)
flag
- メールアドレスのGE35利用 [true:利用する/false:利用しない]GE35からメールアドレスを取得する場合は、true をセットします。false の場合は、 from,to,cc,bcc,replyTo の設定値がそのまま使用されます。 上記アドレスに、@ を含む場合は、DB を検索せず、メールアドレスとして そのまま使用します。DB の検索結果が存在しない場合は、不正なアドレスとして、 エラーとします。 useLDAPと同時に設定されている場合は、LDAP設定が優先されます。 初期値は、false です。
5.6.9.3 (2013/10/25) 新規追加 |
public void setSmtpPort(java.lang.String port)
port
- SMTPポート初期値は、システム定数のSMTP_PORT を使用します。 (初期値:システム定数のSMTP_PORT[=])。
5.8.1.1 (2014/11/14) メール送信時認証「POP_BEFORE_SMTP」追加 |
public void setAuthType(java.lang.String type)
type
- 認証方式認証を行う場合は「POP_BEFORE_SMTP」または、「SMTP_AUTH」が指定できます。 認証時には認証ユーザと認証パスワードを設定する必要があります。 初期値は、システム定数のMAIL_SEND_AUTH を使用します。 (初期値:システム定数のMAIL_SEND_AUTH[=])。
5.8.1.1 (2014/11/14) メール送信時認証「POP_BEFORE_SMTP」追加 |
6.2.4.1 (2015/05/22) SMTP_AUTH 対応。「SMTP_AUTH」追加(コメントのみ修正) |
public void setAuthPort(java.lang.String port)
port
- 認証ポート「POP_BEFORE_SMTP」認証を行う場合に、POPサーバーに接続するポート番号を指定します。 指定しない場合は、POP3デフォルトポートを使用します。 初期値は、システム定数のMAIL_SEND_AUTH_PORT を使用します。 (初期値:システム定数のMAIL_SEND_AUTH_PORT[=])。
5.8.1.1 (2014/11/14) メール送信時認証「POP_BEFORE_SMTP」追加 |
public void setAuthUser(java.lang.String user)
user
- 認証ユーザ初期値は、システム定数のMAIL_SEND_AUTH_USER を使用します。 (初期値:システム定数のMAIL_SEND_AUTH_USER[=opengion])。
5.8.1.1 (2014/11/14) メール送信時認証「POP_BEFORE_SMTP」追加 |
public void setAuthPass(java.lang.String pass)
pass
- 認証パスワード初期値は、システム定数のMAIL_SEND_AUTH_PASSWORD を使用します。 (初期値:システム定数のMAIL_SEND_AUTH_PASSWORD[=password])。
5.8.1.1 (2014/11/14) メール送信時認証「POP_BEFORE_SMTP」追加 |
public void setUseHistory(java.lang.String flag)
flag
- 履歴に残すかどうか [true:残す/false:残さない]初期値は、システム定数のUSE_MAILSENDER_HISTORY を使用します。 trueを設定した場合、システムID、送信元アドレス、送信先アドレス、タイトル、本文について GE32,34に履歴として保存されます。 (初期値:システム定数のUSE_MAILSENDER_HISTORY[=false])。
5.9.2.3 (2015/11/27) 追加 |
public void setUseSSL(java.lang.String isSSL)
isSSL
- SSL接続するかどうか [true:する/false:しない]SSL接続する場合は、true を設定します。 (初期値:システム定数のMAIL_SEND_USE_SSL[=false])。
6.3.8.0 (2015/09/11) SSL接続するかどうか |
public java.lang.String[] getAddressArray(java.lang.String[] src)
src
- 引数配列(可変長引数)5.6.9.3 (2013/10/25) 新規追加 |
public java.lang.String toString()
toString
クラス内 CommonTagSupport
5.6.9.3 (2013/10/25) useDBの対応 |
Webアプリケーションフレームワーク openGionCopyright (c) 2009 The openGion Project.