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クラスはアグレットの抽象クラスである. 個々のアグレットを記述する場合にこのクラスを継承する.

Variable Index

 o ACTIVE
アグレットの状態.
 o INACTIVE
 o MAJOR_VERSION
 o MINOR_VERSION

Constructor Index

 o Aglet()
初期化されていないagletを構築する.

Method Index

 o addCloneListener(CloneListener)
このagletの複製(clone)に関するイベントのlistenerを追加する.
 o addMobilityListener(MobilityListener)
このagletの移動(mobility)に関するイベントのlistenerを追加する.
 o addPersistencyListener(PersistencyListener)
このagletの永続性(persistency)に関するイベントのlistenerを追加する.
 o clone()
agletとそのproxyを複製(clone)する.
 o deactivate(long)
agletを非活性化(deactivate)する.
 o dispatch(URL)
agletを引数destinationによって指定された場所(host)に 送る(dispatch).
 o dispose()
カレントagletコンテキスト中のagletを消滅させ, 取り去る.
 o exitMonitor()
現在のmonitorを出る.
 o getAgletContext()
agletのカレントコンテキストを返す.
 o getAgletID()
agletのIDを返す.
 o getAgletInfo()
agletの情報を収めたオブジェクト(AgletInfo)を返す.
 o getAudioData(URL)
音声データを得る.
 o getCodeBase()
agletのコードベースURLを返す.
 o getIdentifier()
agletのIDを返す.
 o getImage(URL)
imageを得る.
 o getImage(URL, String)
imageを得る.
 o getMessageManager()
メッセージマネージャを返す.
 o getText()
agletのメッセージラインのテキストを返す.
 o handleMessage(Message)
外部からのメッセージを取り扱う
 o notifyAllMessages()
waitしているすべてのスレッドにnotifyする.
 o notifyMessage()
waitしているどれか一つのスレッドにnotifyする.
 o onCreation(Object)
新たなagletの初期化を行う.
 o onDisposing()
agletを消滅させる前に呼ばれるメソッド agletへ消滅のリクエストが出された時に行う処理を記述するには, このメソッドをオーバーライドする.
 o removeCloneListener(CloneListener)
指定されたclone listenerをagletから取り外す.
 o removeMobilityListener(MobilityListener)
指定されたmobility listenerをagletから取り外す.
 o removePersistencyListener(PersistencyListener)
指定されたpersistency listenerをagletから取り外す.
 o run()
agletのスレッドの実行開始点.
 o setStub(AgletStub)
agletのstubを設定する.
 o setText(String)
agletのメッセージラインのテキストを設定する.
 o snapshot()
[Preliminary] agletのスナップショットを二次記憶装置に保存する.
 o subscribeMessage(String)
特定の名前のメッセージをサブスクライブする.
 o unsubscribeAllMessages()
すべてのメッセージのサブスクライブを中止する.
 o unsubscribeMessage(String)
特定の名前のメッセージのサブスクライブを中止する.
 o waitMessage()
notifyされるまでwaitする.
 o waitMessage(long)
notifyされるか, タイムアウトするまでwaitする.

Variables

 o MAJOR_VERSION
  public final static short MAJOR_VERSION
 o MINOR_VERSION
  public final static short MINOR_VERSION
 o ACTIVE
  public final static int ACTIVE
アグレットの状態.
See Also:
getAgletProxies
 o INACTIVE
  public final static int INACTIVE

Constructors

 o Aglet
  protected Aglet()
初期化されていないagletを構築する. このメソッドはagletのライフサイクルのなかで一度だけ呼ばれる. このコンストラクタをオーバーライドしてはならない. agletの生成時に初期化するには, onCreation()をオーバーライドし, そこに記述する.
See Also:
onCreation

Methods

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

All Packages  Class Hierarchy  This Package  Previous  Next  Index