Class aglet.Aglet
All Packages Class Hierarchy This Package Previous Next Index
Class aglet.Aglet
java.lang.Object
|
+----aglet.Aglet
- public class Aglet
- extends Object
- implements Serializable
Agletクラスはアグレットの抽象クラスである.
個々のアグレットを記述する場合にこのクラスを継承する.
-
ACTIVE
- アグレットの状態.
-
INACTIVE
-
-
MAJOR_VERSION
-
-
MINOR_VERSION
-
-
Aglet()
- 初期化されていないagletを構築する.
-
addCloneListener(CloneListener)
- このagletの複製(clone)に関するイベントのlistenerを追加する.
-
addMobilityListener(MobilityListener)
- このagletの移動(mobility)に関するイベントのlistenerを追加する.
-
addPersistencyListener(PersistencyListener)
- このagletの永続性(persistency)に関するイベントのlistenerを追加する.
-
clone()
- agletとそのproxyを複製(clone)する.
-
deactivate(long)
- agletを非活性化(deactivate)する.
-
dispatch(URL)
- agletを引数destinationによって指定された場所(host)に
送る(dispatch).
-
dispose()
- カレントagletコンテキスト中のagletを消滅させ, 取り去る.
-
exitMonitor()
- 現在のmonitorを出る.
-
getAgletContext()
- agletのカレントコンテキストを返す.
-
getAgletID()
- agletのIDを返す.
-
getAgletInfo()
- agletの情報を収めたオブジェクト(AgletInfo)を返す.
-
getAudioData(URL)
- 音声データを得る.
-
getCodeBase()
- agletのコードベースURLを返す.
-
getIdentifier()
- agletのIDを返す.
-
getImage(URL)
- imageを得る.
-
getImage(URL, String)
- imageを得る.
-
getMessageManager()
- メッセージマネージャを返す.
-
getText()
- agletのメッセージラインのテキストを返す.
-
handleMessage(Message)
- 外部からのメッセージを取り扱う
-
notifyAllMessages()
- waitしているすべてのスレッドにnotifyする.
-
notifyMessage()
- waitしているどれか一つのスレッドにnotifyする.
-
onCreation(Object)
- 新たなagletの初期化を行う.
-
onDisposing()
- agletを消滅させる前に呼ばれるメソッド
agletへ消滅のリクエストが出された時に行う処理を記述するには,
このメソッドをオーバーライドする.
-
removeCloneListener(CloneListener)
- 指定されたclone listenerをagletから取り外す.
-
removeMobilityListener(MobilityListener)
- 指定されたmobility listenerをagletから取り外す.
-
removePersistencyListener(PersistencyListener)
- 指定されたpersistency listenerをagletから取り外す.
-
run()
- agletのスレッドの実行開始点.
-
setStub(AgletStub)
- agletのstubを設定する.
-
setText(String)
- agletのメッセージラインのテキストを設定する.
-
snapshot()
- [Preliminary]
agletのスナップショットを二次記憶装置に保存する.
-
subscribeMessage(String)
- 特定の名前のメッセージをサブスクライブする.
-
unsubscribeAllMessages()
- すべてのメッセージのサブスクライブを中止する.
-
unsubscribeMessage(String)
- 特定の名前のメッセージのサブスクライブを中止する.
-
waitMessage()
- notifyされるまでwaitする.
-
waitMessage(long)
- notifyされるか, タイムアウトするまでwaitする.
MAJOR_VERSION
public final static short MAJOR_VERSION
MINOR_VERSION
public final static short MINOR_VERSION
ACTIVE
public final static int ACTIVE
- アグレットの状態.
- See Also:
- getAgletProxies
INACTIVE
public final static int INACTIVE
Aglet
protected Aglet()
- 初期化されていないagletを構築する.
このメソッドはagletのライフサイクルのなかで一度だけ呼ばれる.
このコンストラクタをオーバーライドしてはならない.
agletの生成時に初期化するには,
onCreation()をオーバーライドし, そこに記述する.
- See Also:
- onCreation
clone
public final Object clone() throws CloneNotSupportedException
- agletとそのproxyを複製(clone)する.
返り値は複製されたproxyである.
- Returns:
- 複製されたproxy.
- Throws: CloneNotSupportedException
- 複製に失敗した.
- Overrides:
- clone in class Object
- See Also:
- onCloning, onClone
dispatch
public final void dispatch(URL destination) throws IOException, RequestRefusedException
- agletを引数destinationによって指定された場所(host)に
送る(dispatch).
- Parameters:
- destination - 送り先.
- Throws: ServerNotFoundException
- サーバーが見つからなかった.
- Throws: UnknownHostException
- 与えられたURLでアクセスできるホストがなかった.
- Throws: RequestRefusedException
- 送信(dispatch)要求がサーバーによって拒否された.
- Throws: NotSerializableException
- agletオブジェクトをシリアライズできない.
- See Also:
- onDispatching, onArrival
dispose
public final void dispose()
- カレントagletコンテキスト中のagletを消滅させ, 取り去る.
このメソッドの呼び出しが成功した場合, 指定したagletによって生成された
スレッドは全てkillされる.
- See Also:
- onDisposing
deactivate
public final void deactivate(long duration) throws IOException
- agletを非活性化(deactivate)する.
agletは一時的に停止し, カレントコンテキストから取り除かれる.
指定した時間がすぎるとそのagletはコンテキストに戻され, 実行を再開する.
- Parameters:
- duration - 非活性化している時間(ミリ秒単位)
- Throws: NotSerializableException
- agletオブジェクトをシリアライズできない.
- Throws: IOException
- I/Oに失敗.
- Throws: IllegalArgumentException
- 引数の値が負である.
snapshot
public final void snapshot() throws IOException
- [Preliminary]
agletのスナップショットを二次記憶装置に保存する.
システムクラッシュなどの不慮の原因で
agletがkillされた場合にだけこのスナップショットが活性化される.
agletが消滅(dispose), 発送(dispatch), 非活性化(deacitivate)される
場合には, 二次記憶装置上のスナップショットは消去される.
- Throws: NotSerializableException
- agletオブジェクトをシリアライズできない.
- Throws: IOException
- I/Oに失敗
run
public void run()
- agletのスレッドの実行開始点.
このメソッドは, agletの生成(creation), 発送(dispatch),
撤収(retraction), 活性化(activation)に成功した後に呼ばれる.
- See Also:
- onCreation, onClone, onArrival, onActivation
onCreation
public void onCreation(Object init)
- 新たなagletの初期化を行う.
このメソッドはagletの人生の中で一度だけ呼ばれる.
agletの初期値を設定するためには, このメソッドをオーバーライドする.
- Parameters:
- init - agletを初期化するための引数
- See Also:
- createAglet
addCloneListener
public final void addCloneListener(CloneListener listener)
- このagletの複製(clone)に関するイベントのlistenerを追加する.
- Parameters:
- listener - the clone listener
addMobilityListener
public final void addMobilityListener(MobilityListener listener)
- このagletの移動(mobility)に関するイベントのlistenerを追加する.
- Parameters:
- listener - the mobility listener
addPersistencyListener
public final void addPersistencyListener(PersistencyListener listener)
- このagletの永続性(persistency)に関するイベントのlistenerを追加する.
- Parameters:
- listener - the persistency listener
removeCloneListener
public final void removeCloneListener(CloneListener l)
- 指定されたclone listenerをagletから取り外す.
- Parameters:
- l - the clone listener
removeMobilityListener
public final void removeMobilityListener(MobilityListener l)
- 指定されたmobility listenerをagletから取り外す.
- Parameters:
- l - the mobility listener
removePersistencyListener
public final void removePersistencyListener(PersistencyListener l)
- 指定されたpersistency listenerをagletから取り外す.
- Parameters:
- l - the persistency listener
onDisposing
public void onDisposing()
- agletを消滅させる前に呼ばれるメソッド
agletへ消滅のリクエストが出された時に行う処理を記述するには,
このメソッドをオーバーライドする.
- Throws: SecurityException
- 消滅のリクエストが拒絶された.
- See Also:
- dispose, dispose
handleMessage
public boolean handleMessage(Message message)
- 外部からのメッセージを取り扱う
- Parameters:
- msg - agletへ送られてきたメッセージ
- Returns:
- このメソッドによってメッセージが処理された場合にtrue, そうでない場合はfalse.
もしfalseが返された場合, メソッドFutureReply.getReplyと
AgletProxy.sendMessageの呼び出しに対しては,
例外MessageNotHandledがthrowされる.
- See Also:
- getReply, sendReply, sendMessage
waitMessage
public void waitMessage()
- notifyされるまでwaitする.
- Throws: IllegalMonitorStateException
- カレントスレッドがmonitorの所有者ではない.
- See Also:
- waitMessage, notifyMessage, notifyAllMessage
waitMessage
public void waitMessage(long timeout)
- notifyされるか, タイムアウトするまでwaitする.
- Parameters:
- timeout - waitする最大の時間(ミリ秒単位)
- Throws: IllegalMonitorStateException
- カレントスレッドがmonitorの所有者ではない.
- See Also:
- waitMessage, notifyMessage, notifyAllMessage
notifyMessage
public void notifyMessage()
- waitしているどれか一つのスレッドにnotifyする.
- Throws: IllegalMonitorStateException
- カレントスレッドがmonitorの所有者ではない.
- See Also:
- notifyMessage, waitMessage, notifyAllMessage
notifyAllMessages
public void notifyAllMessages()
- waitしているすべてのスレッドにnotifyする.
- Throws: IllegalMonitorStateException
- カレントスレッドがmonitorの所有者ではない.
- See Also:
- notifyAllMessage, waitMessage, notifyMessage
exitMonitor
public void exitMonitor()
- 現在のmonitorを出る.
- Throws: IllegalMonitorStateException
- カレントスレッドがmonitorの所有者ではない.
- See Also:
- exitMonitor, waitMessage, notifyMessage, notifyAllMessages
getAgletContext
public final AgletContext getAgletContext()
- agletのカレントコンテキストを返す.
- Returns:
- the カレントコンテキスト
getMessageManager
public final MessageManager getMessageManager()
- メッセージマネージャを返す.
- Returns:
- メッセージマネージャ
getIdentifier
public final AgletIdentifier getIdentifier()
- agletのIDを返す.
- Throws: InvalidAgletException
- 正しいagletでない.
getAgletID
public final AgletID getAgletID()
- agletのIDを返す.
- Throws: InvalidAgletException
- 正しいagletでない.
getCodeBase
public final URL getCodeBase()
- agletのコードベースURLを返す.
getAgletInfo
public final AgletInfo getAgletInfo()
- agletの情報を収めたオブジェクト(AgletInfo)を返す.
getText
public final String getText()
- agletのメッセージラインのテキストを返す.
setText
public final void setText(String text)
- agletのメッセージラインのテキストを設定する.
これはウィンドウを開くことなくagletがメッセージを表示する方法である.
- Parameters:
- message - メッセージテキスト
subscribeMessage
public final void subscribeMessage(String name)
- 特定の名前のメッセージをサブスクライブする.
- Parameters:
- name - メッセージの名前
unsubscribeMessage
public final boolean unsubscribeMessage(String name)
- 特定の名前のメッセージのサブスクライブを中止する.
- Parameters:
- name - メッセージの名前
- Returns:
- 指定した名前のメッセージがサブスクライブされていた場合にtrue.
unsubscribeAllMessages
public final void unsubscribeAllMessages()
- すべてのメッセージのサブスクライブを中止する.
getImage
public final Image getImage(URL url) throws IOException
- imageを得る.
getImage
public final Image getImage(URL url,
String name) throws IOException
- imageを得る.
getAudioData
public final AudioClip getAudioData(URL url) throws IOException
- 音声データを得る.
setStub
public final synchronized void setStub(AgletStub stub)
- agletのstubを設定する.
このメソッドはシステムから呼ばれ, また同じagletに対して
二度以上呼び出すことはできない.
- Parameters:
- stub - 設定するstub
All Packages Class Hierarchy This Package Previous Next Index