|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Objectjavax.mail.Service
javax.mail.Store
com.sun.mail.pop3.POP3Store
public class POP3Store
POP3 Message Store です。 一つの "INBOX" フォルダだけを含んでいます。 POP3 プロトコルプロバイダの詳細については、 jp.sourceforge.livez.mail.pop3 パッケージドキュメンテーションを参照して下さい。
フィールドの概要 |
---|
クラス javax.mail.Service から継承されたフィールド |
---|
debug, session, url |
コンストラクタの概要 | |
---|---|
POP3Store(Session session,
URLName url)
コンストラクタです。 |
|
POP3Store(Session session,
URLName url,
String name,
int port,
boolean isSSL)
コンストラクタです。 |
メソッドの概要 | |
---|---|
void |
close()
このサービスを閉じ、接続を終了させます。 |
protected void |
finalize()
キューがガベージコレクト可能になるように、イベントディスパッチャスレッドを停止します。 |
Folder |
getDefaultFolder()
Store によりユーザに提示されるデフォルトの名前空間の 'root' を表す Folder オブジェクトを返します。 |
Folder |
getFolder(String name)
"INBOX" という名前のみサポートします。 |
Folder |
getFolder(URLName url)
指定された URLName に対応する、閉じた Folder オブジェクトを返します。 |
boolean |
isConnected()
Check whether this store is connected. |
protected boolean |
protocolConnect(String host,
int portNum,
String user,
String passwd)
サービス実装はこのメソッドをオーバーライドし、 実際のプロトコル固有の接続を試行しなければなりません。 |
クラス javax.mail.Service から継承されたメソッド |
---|
addConnectionListener, connect, connect, connect, connect, getURLName, notifyConnectionListeners, queueEvent, removeConnectionListener, setConnected, setURLName, toString |
クラス java.lang.Object から継承されたメソッド |
---|
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
コンストラクタの詳細 |
---|
public POP3Store(Session session, URLName url)
public POP3Store(Session session, URLName url, String name, int port, boolean isSSL)
メソッドの詳細 |
---|
protected boolean protocolConnect(String host, int portNum, String user, String passwd) throws MessagingException
Service
の記述: connect
メソッドのデフォルトの実装は、
必要に応じてこのメソッドを呼び出します。
認証の為にユーザ名またはパスワードが必要だが、
対応するパラメータが null の場合、protocolConnect
メソッドは false
を返さなければなりません。
connect
メソッドは必要に応じてユーザに入力を要求し、
不足した情報を供給します。
又、供給されたユーザ名又はパスワードの為に認証が失敗した場合、
このメソッドは false を返すことがあります。
認証の障害時に、このメソッドは AuthenticationFailedException をスローする事もあります。
この例外には、障害に関する詳細記述した String メッセージが含まれる事があります。
protocolConnect
メソッドは例外をスローし、
認証に関連しない障害を報告しなければなりません。
例として、無効なホスト名又はポート番号、認証処理中の接続切断、
サーバの停止等があります。
Service
内の protocolConnect
host
- 接続先のホスト名portNum
- 使用するポート (-1 はデフォルトポートの使用を意味する)user
- ログインするユーザ名passwd
- ユーザのパスワード
AuthenticationFailedException
- 認証の障害の場合
MessagingException
- 認証以外の障害の場合public boolean isConnected()
Service
内の isConnected
public void close() throws MessagingException
Service
の記述:
この実装は setConnected(false)
を使用して、
このサービスの接続状態を false
に設定します。
その後、クローズの ConnectionEvent を全ての登録済み ConnectionListener に送信します。
実装固有の終了処理を行う為にこのメソッドをオーバーライドするサブクラスは、
最後の手順としてこのメソッドを呼び出し、イベント通知を確実にしなければなりません。
恐らく finally
節に super.close()
への呼び出しを含める事が考えられます。
Service
内の close
MessagingException
- クローズ中のエラーの場合ConnectionEvent
public Folder getDefaultFolder() throws MessagingException
Store
の記述:
Store
内の getDefaultFolder
MessagingException
public Folder getFolder(String name) throws MessagingException
Store
内の getFolder
name
- Folder の名前。
一部の Store において、名前が階層区切り文字で始まる場合、絶対パスとなることがあります。
そうでない場合は、名前はこの名前空間の 'ルート' への相対名と解釈されます。
MessagingException
Folder.exists()
,
Folder.create(int)
public Folder getFolder(URLName url) throws MessagingException
Store
の記述:
このメソッドの実装は、URLName 上で getFile()
メソッドを使用して
実際のフォルダの名前を取得し、その名前を使用してフォルダを作成する事ができます。
Store
内の getFolder
url
- フォルダを示す URLName
MessagingException
URLName
protected void finalize() throws Throwable
Service
の記述:
Service
内の finalize
Throwable
|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |