|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Objectjavax.mail.Service
javax.mail.Store
public abstract class Store
メッセージの格納と取得の為に、メッセージストアとその アクセスプロトコルをモデル化する abstract クラスです。 サブクラスは実際の実装を提供します。
Store
は Service
クラスを拡張します。
ストアの命名、ストアへの接続、接続イベントのリスニングの為の
多数の共通メソッドを提供します。
Service
,
ConnectionEvent
,
StoreEvent
フィールドの概要 |
---|
クラス javax.mail.Service から継承されたフィールド |
---|
debug, session, url |
コンストラクタの概要 | |
---|---|
protected |
Store(Session session,
URLName urlname)
コンストラクタです。 |
メソッドの概要 | |
---|---|
void |
addFolderListener(FolderListener l)
Folder イベントのリスナーを、この Store から取得された任意の Folder オブジェクトに追加します。 |
void |
addStoreListener(StoreListener l)
StoreEvents のリスナーを、この Store 上に追加します。 |
abstract Folder |
getDefaultFolder()
Store によりユーザに提示されるデフォルトの名前空間の 'root' を表す Folder オブジェクトを返します。 |
abstract Folder |
getFolder(String name)
指定された名前に対応する Folder オブジェクトを返します。 |
abstract Folder |
getFolder(URLName url)
指定された URLName に対応する、閉じた Folder オブジェクトを返します。 |
Folder[] |
getPersonalNamespaces()
現在のユーザの個人的な名前空間を表す一連のフォルダを返します。 |
Folder[] |
getSharedNamespaces()
共有される名前空間を表す一連のフォルダを返します。 |
Folder[] |
getUserNamespaces(String user)
user の名前空間を表す一連のフォルダを返します。 |
protected void |
notifyFolderListeners(int type,
Folder folder)
全ての FolderListener に通知します。 |
protected void |
notifyFolderRenamedListeners(Folder oldF,
Folder newF)
フォルダの名前変更について、全ての FolderListener に通知します。 |
protected void |
notifyStoreListeners(int type,
String message)
全ての StoreListener に通知します。 |
void |
removeFolderListener(FolderListener l)
Folder イベントのリスナーを削除します。 |
void |
removeStoreListener(StoreListener l)
Store イベントのリスナーを削除します。 |
クラス javax.mail.Service から継承されたメソッド |
---|
addConnectionListener, close, connect, connect, connect, finalize, getURLName, isConnected, notifyConnectionListeners, protocolConnect, queueEvent, removeConnectionListener, setConnected, setURLName, toString |
クラス java.lang.Object から継承されたメソッド |
---|
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
コンストラクタの詳細 |
---|
protected Store(Session session, URLName urlname)
session
- この Store の Session オブジェクトurlname
- この Store に使用される URLName オブジェクトメソッドの詳細 |
---|
public abstract Folder getDefaultFolder() throws MessagingException
IllegalStateException
- この Store が接続されていない場合
MessagingException
public abstract Folder getFolder(String name) throws MessagingException
exists()
メソッドは、このフォルダが実在するかどうかを示します。Folder オブジェクトは Store によりキャッシュされないので、 同じ名前でこのメソッドを複数回呼び出すと、多くの異なる Folder オブジェクトが返されます。
name
- Folder の名前。
一部の Store において、名前が階層区切り文字で始まる場合、絶対パスとなることがあります。
そうでない場合は、名前はこの名前空間の 'ルート' への相対名と解釈されます。
IllegalStateException
- この Store が接続されていない場合
MessagingException
Folder.exists()
,
Folder.create(int)
public abstract Folder getFolder(URLName url) throws MessagingException
このメソッドの実装は、URLName 上で getFile()
メソッドを使用して
実際のフォルダの名前を取得し、その名前を使用してフォルダを作成する事ができます。
url
- フォルダを示す URLName
IllegalStateException
- この Store が接続されていない場合
MessagingException
URLName
public Folder[] getPersonalNamespaces() throws MessagingException
この実装は、getDefaultFolder
メソッドの戻り値を含む単一エントリを持つ配列を返します。
サブクラスはこのメソッドをオーバーライドし、適切な情報を返す必要があります。
IllegalStateException
- この Store が接続されていない場合
MessagingException
public Folder[] getUserNamespaces(String user) throws MessagingException
user
の名前空間を表す一連のフォルダを返します。
返される名前空間は、そのユーザの個人名前空間を表します。
他のユーザの名前空間にあるメールフォルダにアクセスする為には、
現在認証されているユーザは、明示的にアクセス権を付与される必要があります。
例えば、マネージャが秘書にメールフォルダのアクセス権を与えるのは一般的です。この実装は空の配列を返します。 サブクラスはこのメソッドをオーバーライドし、適切な情報を返す必要があります。
IllegalStateException
- この Store が接続されていない場合
MessagingException
public Folder[] getSharedNamespaces() throws MessagingException
この実装は空の配列を返します。 サブクラスはこのメソッドをオーバーライドし、適切な情報を返す必要があります。
IllegalStateException
- この Store が接続されていない場合
MessagingException
public void addStoreListener(StoreListener l)
ここで提供されるデフォルトの実装は、このリスナーを内部の StoreListener リストに追加します。
l
- Store イベントの ListenerStoreEvent
public void removeStoreListener(StoreListener l)
ここで提供されるデフォルトの実装は、このリスナーを内部の StoreListener リストから削除します。
l
- リスナーaddStoreListener(javax.mail.event.StoreListener)
protected void notifyStoreListeners(int type, String message)
提供されるデフォルトの実装は、イベントを内部イベントキューに入れます。 イベントディスパッチャスレッドはキューからイベントを出し、 登録された StoreListener にディスパッチします。 イベントのディスパッチは別個のスレッドで起こる為、デッドロック問題を防ぎます。
public void addFolderListener(FolderListener l)
ここで提供されるデフォルトの実装は、このリスナーを内部の FolderListener リストに追加します。
l
- Folder イベントの ListenerFolderEvent
public void removeFolderListener(FolderListener l)
ここで提供されるデフォルトの実装は、このリスナーを内部の FolderListener リストから削除します。
l
- リスナーaddFolderListener(javax.mail.event.FolderListener)
protected void notifyFolderListeners(int type, Folder folder)
提供されるデフォルトの実装は、イベントを内部イベントキューに入れます。 イベントディスパッチャスレッドはキューからイベントを出し、 登録された FolderListener にディスパッチします。 イベントのディスパッチは別個のスレッドで起こる為、デッドロック問題を防ぎます。
type
- FolderEvent の型folder
- 影響を受ける FoldernotifyFolderRenamedListeners(javax.mail.Folder, javax.mail.Folder)
protected void notifyFolderRenamedListeners(Folder oldF, Folder newF)
提供されるデフォルトの実装は、イベントを内部イベントキューに入れます。 イベントディスパッチャスレッドはキューからイベントを出し、 登録された FolderListener にディスパッチします。 イベントのディスパッチは別個のスレッドで起こる為、デッドロック問題を防ぎます。
oldF
- 名前変更されるフォルダnewF
- 新しい名前を表すフォルダ
|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |