org.opengion.fukurou.mail

## クラス MailRX

- java.lang.Object
- - org.opengion.fukurou.mail.MailRX

-     public class MailRX
      extends Object

  MailRX は、POP3プロトコルによるメール受信プログラムです。 メールへの接続条件(host,user,passwd など)と、選択条件(matchTermなど)を指定し、 MailReceiveListener をセットして、start() メソッドを呼びます。 実際のメール処理は、MailReceiveListener を介して、１メールずつ処理します。 添付ファイルを処理する場合は、MailAttachFiles クラスを使用します。 host メールサーバー(必須) user メールを取得するログインユーザー(必須) passwd メールを取得するログインパスワード(必須) protocol 受信サーバーのプロトコル[imap/pop3]を指定(初期値:pop3) port 受信サーバーのポートを指定(初期値:-1) mbox 受信サーバーのメールボックスを指定(初期値:INBOX) maxRowCount 受信メールの最大取り込み件数(初期値:100)(0:[無制限]) charset メールのデフォルトエンコード(初期値:ISO-2022-JP) matchTerm 受信メールを選択する条件のMINEntryオブジェクト delete 検索後、メールをサーバーから削除するかどうかを、true/falseで指定(初期値:false)。
  バージョン
    4.0
  作成者
    Kazuhiko Hasegawa
  導入されたバージョン:
    JDK5.0,

- - ### フィールドの概要

    フィールド
    修飾子とタイプ | フィールドと説明
    --- | ---
    `static String` | `CHARSET` メールのデフォルトエンコード "ISO-2022-JP" Windwos-31J , MS932 , ISO-2022-JP を指定します。
    `static boolean` | `DELETE_MESSAGE` 検索後、メールをサーバーから削除するかどうかを、true/falseで指定します。
    `static int` | `MAX_ROW_COUNT` 受信メールの最大取り込み件数を指定します。
    `static String` | `MBOX` メールサーバーのデフォルトメールボックス "INBOX"
    `static int` | `PORT` メールサーバーのデフォルトポート番号 -1
    `static String` | `PROTOCOL` メールサーバーのデフォルトプロトコル "pop3"

  - ### コンストラクタの概要

    コンストラクタ
    コンストラクタと説明
    `MailRX()`

  - ### メソッドの概要

    メソッド
    修飾子とタイプ | メソッドと説明
    --- | ---
    `void` | `addMatchTerm(HybsEntry matchTerm)` メール検索する場合のマッチ条件のキーと値の HybsEntry をセットします。
    `static void` | `main(String[] args)` コマンドから実行できる、テスト用の main メソッドです。
    `void` | `setCharset(String charset)` 文字エンコーディングをセットします。
    `void` | `setDebug(boolean debug)` デバッグ情報の表示を行うかどうかをセットします。
    `void` | `setDelete(boolean deleteFlag)` メッセージをメールサーバーから削除するかどうかをセットします。
    `void` | `setHost(String host)` メールサーバーをセットします。
    `void` | `setMailReceiveListener(MailReceiveListener listener)` メール受信毎に発生するイベントを伝えるリスナーをセットします。
    `void` | `setMaxRowCount(int maxRowCount)` 最大取り込み件数をセットします(初期値:100)(0:[無制限])。
    `void` | `setMbox(String mbox)` 受信メイルボックスをセットします。
    `void` | `setPasswd(String passwd)` パスワードをセットします。
    `void` | `setPort(int port)` ポート番号をセットします。
    `void` | `setProtocol(String protocol)` 受信プロトコルをセットします。
    `void` | `setUser(String user)` 受信ユーザーをセットします。
    `void` | `start()` レシーバーを開始します。

    - ### クラスから継承されたメソッド java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### フィールドの詳細

    - #### MAX_ROW_COUNT

          public static final int MAX_ROW_COUNT

      受信メールの最大取り込み件数を指定します。 100
      関連項目:
        定数フィールド値

    - #### DELETE_MESSAGE

          public static final boolean DELETE_MESSAGE

      検索後、メールをサーバーから削除するかどうかを、true/falseで指定します。 false
      関連項目:
        定数フィールド値

    - #### PROTOCOL

          public static final String PROTOCOL

      メールサーバーのデフォルトプロトコル "pop3"
      関連項目:
        定数フィールド値

    - #### PORT

          public static final int PORT

      メールサーバーのデフォルトポート番号 -1
      関連項目:
        定数フィールド値

    - #### MBOX

          public static final String MBOX

      メールサーバーのデフォルトメールボックス "INBOX"
      関連項目:
        定数フィールド値

    - #### CHARSET

          public static final String CHARSET

      メールのデフォルトエンコード "ISO-2022-JP" Windwos-31J , MS932 , ISO-2022-JP を指定します。
      関連項目:
        定数フィールド値

  - ### コンストラクタの詳細

    - #### MailRX

          public MailRX()

  - ### メソッドの詳細

    - #### start

          public void start()
                     throws MessagingException,
                            NoSuchProviderException

      レシーバーを開始します。
      例外:
        `MessagingException` - レシーバー処理中に、なんらかのエラーが発生した場合。
        `NoSuchProviderException` - なんらかのエラーが発生した場合。

    - #### setHost

          public void setHost(String host)

      メールサーバーをセットします。
      パラメータ:
        `host` - メールサーバー
      例外:
        `IllegalArgumentException` - 引数が null の場合。

    - #### setUser

          public void setUser(String user)

      受信ユーザーをセットします。
      パラメータ:
        `user` - 受信ユーザー
      例外:
        `IllegalArgumentException` - 引数が null の場合。

    - #### setPasswd

          public void setPasswd(String passwd)

      パスワードをセットします。
      パラメータ:
        `passwd` - パスワード
      例外:
        `IllegalArgumentException` - 引数が null の場合。

    - #### setProtocol

          public void setProtocol(String protocol)

      受信プロトコルをセットします。
      パラメータ:
        `protocol` - 受信プロトコル名
      例外:
        `IllegalArgumentException` - 引数が null の場合。

    - #### setPort

          public void setPort(int port)

      ポート番号をセットします。
      パラメータ:
        `port` - ポート番号

    - #### setMbox

          public void setMbox(String mbox)

      受信メイルボックスをセットします。
      パラメータ:
        `mbox` - 受信メイルボックス名
      例外:
        `IllegalArgumentException` - 引数が null の場合。

    - #### setMailReceiveListener

          public void setMailReceiveListener(MailReceiveListener listener)

      メール受信毎に発生するイベントを伝えるリスナーをセットします。
      パラメータ:
        `listener` - MailReceiveリスナー

    - #### setDelete

          public void setDelete(boolean deleteFlag)

      メッセージをメールサーバーから削除するかどうかをセットします。
      パラメータ:
        `deleteFlag` - 削除するかどうか[true:行う/false:行わない]

    - #### setCharset

          public void setCharset(String charset)

      文字エンコーディングをセットします。 文字エンコーディングには、Windwos-31J , MS932 , ISO-2022-JP を指定できます。 初期値は、SystemResource.properties ファイルの MAIL_DEFAULT_CHARSET 属性で 設定できます。
      パラメータ:
        `charset` - 文字エンコーディング
      例外:
        `IllegalArgumentException` - 引数が null の場合。

    - #### setMaxRowCount

          public void setMaxRowCount(int maxRowCount)

      最大取り込み件数をセットします(初期値:100)(0:[無制限])。
      パラメータ:
        `maxRowCount` - 最大取り込み件数
      変更履歴:

        5.5.8.5 (2012/11/27) 0を無制限として処理します。

    - #### addMatchTerm

          public void addMatchTerm(HybsEntry matchTerm)

      メール検索する場合のマッチ条件のキーと値の HybsEntry をセットします。 Subject,From,Body,それ以外は、Header 文字列をキーにします。
      パラメータ:
        `matchTerm` - HybsEntryオブジェクト

    - #### setDebug

          public void setDebug(boolean debug)

      デバッグ情報の表示を行うかどうかをセットします。
      パラメータ:
        `debug` - 有無[true/false]

    - #### main

          public static void main(String[] args)
                           throws Exception

      コマンドから実行できる、テスト用の main メソッドです。 Usage: java org.opengion.fukurou.mail.MailTX MailRX host user passwd [saveDir] で、複数の添付ファイルを送付することができます。
      パラメータ:
        `args` - 引数配列
      例外:
        `Exception` - なんらかのエラーが発生した場合。

Webアプリケーションフレームワーク openGion
Copyright (c) 2009 The openGion Project.