public class RMIConnectionImpl extends Object implements RMIConnection, Unreferenced
RMIConnection
インタフェースの実装です。通常、ユーザーコードはこのクラスを参照しません。
コンストラクタと説明 |
---|
RMIConnectionImpl(RMIServerImpl rmiServer, String connectionId, ClassLoader defaultClassLoader, Subject subject, Map<String,?> env)
新しい
RMIConnection を構築します。 |
public RMIConnectionImpl(RMIServerImpl rmiServer, String connectionId, ClassLoader defaultClassLoader, Subject subject, Map<String,?> env)
RMIConnection
を構築します。この接続は、JRMP または IIOP トランスポートで使用できます。このオブジェクトは自身をエクスポートしません。このオブジェクトは、呼び出し側によって適切にエクスポートされます (RMIJRMPServerImpl.makeClient(String,Subject)
および RMIIIOPServerImpl.makeClient(String,Subject)
を参照)。rmiServer
- RMIServerImpl オブジェクト。この接続は、このオブジェクト用に作成される。このパラメータが null の場合の動作は不定。connectionId
- この接続の ID。このパラメータが null の場合の動作は不定。defaultClassLoader
- 整列化オブジェクトの直列化復元時に使用されるデフォルトの ClassLoader。ブートストラップクラスローダを指定する場合は null も可。subject
- 承認に使用する認証済みの被認証者。認証済みの被認証者が存在しないことを指定する場合は null も可。env
- 新しい RMIServerImpl
の属性を含む環境。null の場合、空マップと同等。public String getConnectionId() throws IOException
RMIConnection
接続 ID を返します。この文字列は、指定の RMI コネクタサーバーへの開かれた接続ごとに異なります。
getConnectionId
、インタフェース: RMIConnection
IOException
- 一般的な通信例外が発生した場合。RMIConnector.connect
public void close() throws IOException
RMIConnection
この接続を終了します。このメソッドの終了時には、これ以上リモート呼び出しの失敗が起こらないように、このインタフェースを実装する RMI オブジェクトがアンエクスポートされます。
close
、インタフェース: Closeable
close
、インタフェース: AutoCloseable
close
、インタフェース: RMIConnection
IOException
- 接続を終了できなかった場合、Remote オブジェクトをアンエクスポートできなかった場合、またはリモート終了要求の転送時に通信障害が発生した場合。public void unreferenced()
Unreferenced
unreferenced
、インタフェース: Unreferenced
public ObjectInstance createMBean(String className, ObjectName name, Subject delegationSubject) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, IOException
RMIConnection
createMBean
、インタフェース: RMIConnection
className
- インスタンス化する MBean のクラス名。name
- MBean のオブジェクト名。null も可。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。ObjectName
と Java クラス名を含む ObjectInstance
。含まれる ObjectName
が n
の場合、含まれる Java クラス名は getMBeanInfo(n)
.getClassName()
。ReflectionException
- MBean のコンストラクタの呼び出し時に発行される java.lang.ClassNotFoundException
または java.lang.Exception
をラップする場合。InstanceAlreadyExistsException
- MBean がすでに MBean サーバーによって制御されている場合。MBeanRegistrationException
- MBean の preRegister
(MBeanRegistration
インタフェース) メソッドが例外をスローした場合。MBean は登録されない。MBeanException
- MBean のコンストラクタが例外をスローした場合。NotCompliantMBeanException
- このクラスが JMX 準拠の MBean でない場合。IOException
- 一般的な通信例外が発生した場合。public ObjectInstance createMBean(String className, ObjectName name, ObjectName loaderName, Subject delegationSubject) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, InstanceNotFoundException, IOException
RMIConnection
createMBean
、インタフェース: RMIConnection
className
- インスタンス化する MBean のクラス名。name
- MBean のオブジェクト名。null も可。loaderName
- 使用するクラスローダーのオブジェクト名。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。ObjectName
と Java クラス名を含む ObjectInstance
。含まれる ObjectName
が n
の場合、含まれる Java クラス名は getMBeanInfo(n)
.getClassName()
。ReflectionException
- MBean のコンストラクタの呼び出し時に発行される java.lang.ClassNotFoundException
または java.lang.Exception
をラップする場合。InstanceAlreadyExistsException
- MBean がすでに MBean サーバーによって制御されている場合。MBeanRegistrationException
- MBean の preRegister
(MBeanRegistration
インタフェース) メソッドが例外をスローした場合。MBean は登録されない。MBeanException
- MBean のコンストラクタが例外をスローした場合。NotCompliantMBeanException
- このクラスが JMX 準拠の MBean でない場合。InstanceNotFoundException
- 指定されたクラスローダーが MBean サーバーに登録されていない場合。IOException
- 一般的な通信例外が発生した場合。public ObjectInstance createMBean(String className, ObjectName name, MarshalledObject params, String[] signature, Subject delegationSubject) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, IOException
RMIConnection
MBeanServerConnection.createMBean(String, ObjectName, Object[], String[])
メソッドを処理します。Object[]
パラメータは、MarshalledObject
にラップされています。createMBean
、インタフェース: RMIConnection
className
- インスタンス化する MBean のクラス名。name
- MBean のオブジェクト名。null も可。params
- 呼び出されるコンストラクタのパラメータを含む配列。この配列は、MarshalledObject
にカプセル化されている。カプセル化された配列が null の場合、空配列と同じ意味になる。signature
- 呼び出されるコンストラクタのシグニチャーを含む配列。null の場合、空配列と同じ意味になる。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。ObjectName
と Java クラス名を含む ObjectInstance
。含まれる ObjectName
が n
の場合、含まれる Java クラス名は getMBeanInfo(n)
.getClassName()
。ReflectionException
- MBean のコンストラクタの呼び出し時に発行される java.lang.ClassNotFoundException
または java.lang.Exception
をラップする場合。InstanceAlreadyExistsException
- MBean がすでに MBean サーバーによって制御されている場合。MBeanRegistrationException
- MBean の preRegister
(MBeanRegistration
インタフェース) メソッドが例外をスローした場合。MBean は登録されない。MBeanException
- MBean のコンストラクタが例外をスローした場合。NotCompliantMBeanException
- このクラスが JMX 準拠の MBean でない場合。IOException
- 一般的な通信例外が発生した場合。public ObjectInstance createMBean(String className, ObjectName name, ObjectName loaderName, MarshalledObject params, String[] signature, Subject delegationSubject) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, InstanceNotFoundException, IOException
RMIConnection
MBeanServerConnection.createMBean(String, ObjectName, ObjectName, Object[], String[])
メソッドを処理します。Object[]
パラメータは、MarshalledObject
にラップされています。createMBean
、インタフェース: RMIConnection
className
- インスタンス化する MBean のクラス名。name
- MBean のオブジェクト名。null も可。loaderName
- 使用するクラスローダーのオブジェクト名。params
- 呼び出されるコンストラクタのパラメータを含む配列。この配列は、MarshalledObject
にカプセル化されている。カプセル化された配列が null の場合、空配列と同じ意味になる。signature
- 呼び出されるコンストラクタのシグニチャーを含む配列。null の場合、空配列と同じ意味になる。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。ObjectName
と Java クラス名を含む ObjectInstance
。含まれる ObjectName
が n
の場合、含まれる Java クラス名は getMBeanInfo(n)
.getClassName()
。ReflectionException
- MBean のコンストラクタの呼び出し時に発行される java.lang.ClassNotFoundException
または java.lang.Exception
をラップする場合。InstanceAlreadyExistsException
- MBean がすでに MBean サーバーによって制御されている場合。MBeanRegistrationException
- MBean の preRegister
(MBeanRegistration
インタフェース) メソッドが例外をスローした場合。MBean は登録されない。MBeanException
- MBean のコンストラクタが例外をスローした場合。NotCompliantMBeanException
- このクラスが JMX 準拠の MBean でない場合。InstanceNotFoundException
- 指定されたクラスローダーが MBean サーバーに登録されていない場合。IOException
- 一般的な通信例外が発生した場合。public void unregisterMBean(ObjectName name, Subject delegationSubject) throws InstanceNotFoundException, MBeanRegistrationException, IOException
RMIConnection
unregisterMBean
、インタフェース: RMIConnection
name
- 登録解除する MBean のオブジェクト名。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。InstanceNotFoundException
- 指定された MBean が MBean サーバーに登録されていない場合。MBeanRegistrationException
- MBean の preDeregister (MBeanRegistration
インタフェース) メソッドが例外をスローした場合。IOException
- 一般的な通信例外が発生した場合。public ObjectInstance getObjectInstance(ObjectName name, Subject delegationSubject) throws InstanceNotFoundException, IOException
RMIConnection
getObjectInstance
、インタフェース: RMIConnection
name
- MBean のオブジェクト名。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。ObjectInstance
。含まれる ObjectName
は name
で、含まれるクラス名は getMBeanInfo(name)
.getClassName()
。InstanceNotFoundException
- 指定された MBean が MBean サーバーに登録されていない場合。IOException
- 一般的な通信例外が発生した場合。public Set<ObjectInstance> queryMBeans(ObjectName name, MarshalledObject query, Subject delegationSubject) throws IOException
RMIConnection
MBeanServerConnection.queryMBeans(ObjectName, QueryExp)
メソッドを処理します。QueryExp
は、MarshalledObject
にラップされています。queryMBeans
、インタフェース: RMIConnection
name
- 取得する MBean を識別するオブジェクト名パターン。null の場合、またはドメインやキーのプロパティーが指定されていない場合は、登録されているすべての MBean が取得される。query
- MBean の選択に適用されるクエリー式。MarshalledObject
にカプセル化されている。MarshalledObject
に null 値がカプセル化されている場合、MBean の選択にクエリー式は適用されない。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。ObjectInstance
オブジェクトを含むセット。クエリーの条件を満たす MBean が存在しない場合、空のリストが返される。IOException
- 一般的な通信例外が発生した場合。public Set<ObjectName> queryNames(ObjectName name, MarshalledObject query, Subject delegationSubject) throws IOException
RMIConnection
MBeanServerConnection.queryNames(ObjectName, QueryExp)
メソッドを処理します。QueryExp
は、MarshalledObject
にラップされています。queryNames
、インタフェース: RMIConnection
name
- 取得する MBean 名を識別するオブジェクト名パターン。null の場合、またはドメインやキーのプロパティーが指定されていない場合は、登録されているすべての MBean の名前が取得される。query
- MBean の選択に適用されるクエリー式。MarshalledObject
にカプセル化されている。MarshalledObject
に null 値がカプセル化されている場合、MBean の選択にクエリー式は適用されない。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。IOException
- 一般的な通信例外が発生した場合。public boolean isRegistered(ObjectName name, Subject delegationSubject) throws IOException
RMIConnection
MBeanServerConnection.isRegistered(ObjectName)
メソッドを処理します。isRegistered
、インタフェース: RMIConnection
name
- チェック対象の MBean のオブジェクト名。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。IOException
- 一般的な通信例外が発生した場合。public Integer getMBeanCount(Subject delegationSubject) throws IOException
RMIConnection
MBeanServerConnection.getMBeanCount()
メソッドを処理します。getMBeanCount
、インタフェース: RMIConnection
delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。IOException
- 一般的な通信例外が発生した場合。public Object getAttribute(ObjectName name, String attribute, Subject delegationSubject) throws MBeanException, AttributeNotFoundException, InstanceNotFoundException, ReflectionException, IOException
RMIConnection
getAttribute
、インタフェース: RMIConnection
name
- MBean のオブジェクト名。この MBean の属性が取得される。attribute
- 取得される属性の名前を指定する String。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。MBeanException
- MBean の getter によってスローされる例外をラップする場合。AttributeNotFoundException
- MBean の指定された属性がアクセス不能である場合。InstanceNotFoundException
- 指定された MBean が MBean サーバーに登録されていない場合。ReflectionException
- 取得メソッドの呼び出し時にスローされる java.lang.Exception
をラップする場合。IOException
- 一般的な通信例外が発生した場合。RMIConnection.setAttribute(javax.management.ObjectName, java.rmi.MarshalledObject, javax.security.auth.Subject)
public AttributeList getAttributes(ObjectName name, String[] attributes, Subject delegationSubject) throws InstanceNotFoundException, ReflectionException, IOException
RMIConnection
getAttributes
、インタフェース: RMIConnection
name
- MBean のオブジェクト名。この MBean の属性が取得される。attributes
- 取得される属性のリスト。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。InstanceNotFoundException
- 指定された MBean が MBean サーバーに登録されていない場合。ReflectionException
- Dynamic MBean の getAttributes メソッドの呼び出し時に例外が発生した場合。IOException
- 一般的な通信例外が発生した場合。RMIConnection.setAttributes(javax.management.ObjectName, java.rmi.MarshalledObject, javax.security.auth.Subject)
public void setAttribute(ObjectName name, MarshalledObject attribute, Subject delegationSubject) throws InstanceNotFoundException, AttributeNotFoundException, InvalidAttributeValueException, MBeanException, ReflectionException, IOException
RMIConnection
MBeanServerConnection.setAttribute(ObjectName, Attribute)
メソッドを処理します。Attribute
パラメータは、MarshalledObject
にラップされています。setAttribute
、インタフェース: RMIConnection
name
- MBean 名。この MBean の属性が設定される。attribute
- 設定される属性と、設定後 MarshalledObject
にカプセル化される値の ID。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。InstanceNotFoundException
- 指定された MBean が MBean サーバーに登録されていない場合。AttributeNotFoundException
- MBean の指定された属性がアクセス不能である場合。InvalidAttributeValueException
- 指定された値が、属性に対する有効な値でない場合。MBeanException
- MBean の setter によってスローされる例外をラップする場合。ReflectionException
- setter の呼び出し時にスローされる java.lang.Exception
をラップする場合。IOException
- 一般的な通信例外が発生した場合。RMIConnection.getAttribute(javax.management.ObjectName, java.lang.String, javax.security.auth.Subject)
public AttributeList setAttributes(ObjectName name, MarshalledObject attributes, Subject delegationSubject) throws InstanceNotFoundException, ReflectionException, IOException
RMIConnection
MBeanServerConnection.setAttributes(ObjectName, AttributeList)
メソッドを処理します。AttributeList
パラメータは、MarshalledObject
にラップされています。setAttributes
、インタフェース: RMIConnection
name
- MBean のオブジェクト名。この MBean の属性が設定される。attributes
- 属性のリスト。設定される属性と、設定後 MarshalledObject
にカプセル化される値の ID。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。InstanceNotFoundException
- 指定された MBean が MBean サーバーに登録されていない場合。ReflectionException
- Dynamic MBean の getAttributes メソッドの呼び出し時に例外が発生した場合。IOException
- 一般的な通信例外が発生した場合。RMIConnection.getAttributes(javax.management.ObjectName, java.lang.String[], javax.security.auth.Subject)
public Object invoke(ObjectName name, String operationName, MarshalledObject params, String[] signature, Subject delegationSubject) throws InstanceNotFoundException, MBeanException, ReflectionException, IOException
RMIConnection
MBeanServerConnection.invoke(ObjectName, String, Object[], String[])
メソッドを処理します。Object[]
パラメータは、MarshalledObject
にラップされています。invoke
、インタフェース: RMIConnection
name
- メソッドの呼び出しが行われる MBean のオブジェクト名。operationName
- 呼び出されるオペレーションの名前。params
- オペレーションが呼び出され、MarshalledObject
にカプセル化されたとき設定されるパラメータを含む配列。カプセル化された配列が null の場合、空配列と同じ意味になる。signature
- オペレーションのシグニチャーを含む配列。クラスオブジェクトのロードには、オペレーションを呼び出した MBean をロードするときと同じクラスローダーが使用される。null の場合、空配列と同じ意味になる。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。InstanceNotFoundException
- 指定された MBean が MBean サーバーに登録されていない場合。MBeanException
- MBean の呼び出しメソッドによってスローされる例外をラップする場合。ReflectionException
- メソッドの呼び出し時にスローされる java.lang.Exception
をラップする場合。IOException
- 一般的な通信例外が発生した場合。public String getDefaultDomain(Subject delegationSubject) throws IOException
RMIConnection
MBeanServerConnection.getDefaultDomain()
メソッドを処理します。getDefaultDomain
、インタフェース: RMIConnection
delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。IOException
- 一般的な通信例外が発生した場合。public String[] getDomains(Subject delegationSubject) throws IOException
RMIConnection
MBeanServerConnection.getDomains()
メソッドを処理します。getDomains
、インタフェース: RMIConnection
delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。IOException
- 一般的な通信例外が発生した場合。public MBeanInfo getMBeanInfo(ObjectName name, Subject delegationSubject) throws InstanceNotFoundException, IntrospectionException, ReflectionException, IOException
RMIConnection
MBeanServerConnection.getMBeanInfo(ObjectName)
メソッドを処理します。getMBeanInfo
、インタフェース: RMIConnection
name
- 分析対象の MBean の名前delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。MBeanInfo
のインスタンス。この MBean のすべての属性とオペレーションの取得を許可する。InstanceNotFoundException
- 指定された MBean が見つからなかった場合。IntrospectionException
- イントロスペクション中に例外が発生した場合。ReflectionException
- Dynamic MBean の getMBeanInfo メソッドの呼び出し時に例外が発生した場合。IOException
- 一般的な通信例外が発生した場合。public boolean isInstanceOf(ObjectName name, String className, Subject delegationSubject) throws InstanceNotFoundException, IOException
RMIConnection
isInstanceOf
、インタフェース: RMIConnection
name
- MBean の ObjectName
。className
- クラスの名前。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。InstanceNotFoundException
- 指定された MBean が MBean サーバーに登録されていない場合。IOException
- 一般的な通信例外が発生した場合。public Integer[] addNotificationListeners(ObjectName[] names, MarshalledObject[] filters, Subject[] delegationSubjects) throws InstanceNotFoundException, IOException
RMIConnection
MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)
メソッドを処理します。
指定されたフィルタに一致する MBean からの通知を登録します。リモートクライアントは、その後、fetchNotifications
メソッドを使ってこれらの通知を取得できます。
クライアント側には、リスナーごとに元の NotificationListener
と handback
が保持されます。クライアントがこれらを識別できるように、サーバーは一意の listenerID
を生成し、返します。この listenerID
は Notifications
とともにリモートクライアントに転送されます。
指定されたペア (名前、フィルタ) のいずれかを登録できない場合、オペレーションは例外を発行して終了します。この場合、名前もフィルタも登録されません。
addNotificationListeners
、インタフェース: RMIConnection
names
- Notification の発行元 MBean を識別する ObjectNames
。filters
- NotificationFilters
の整列化された表現から成る配列。この配列の要素は null でもよい。delegationSubjects
- Subjects
。この Subject (複数可) の代わりにリスナーが追加される。この配列の要素は null でもよい。また、delegationSubjects
パラメータ自体が null であってもよい。この場合、この配列は、names
配列や filters
配列と同じサイズの null 値から成る配列と同等になる。listenerIDs
から成る配列。この配列はパラメータと同じ数の要素を持つ。InstanceNotFoundException
- names
のいずれかが登録済み MBean に対応していない場合。IOException
- 一般的な通信例外が発生した場合。public void addNotificationListener(ObjectName name, ObjectName listener, MarshalledObject filter, MarshalledObject handback, Subject delegationSubject) throws InstanceNotFoundException, IOException
RMIConnection
MBeanServerConnection.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)
メソッドを処理します。NotificationFilter
パラメータは、MarshalledObject
にラップされています。Object
(ハンドバック) パラメータも、MarshalledObject
にラップされています。addNotificationListener
、インタフェース: RMIConnection
name
- リスナーが追加される MBean の名前。listener
- 登録済み MBean が発行した通知を処理するリスナーのオブジェクト名。filter
- MarshalledObject
にカプセル化されたフィルタオブジェクト。MarshalledObject
にカプセル化されたフィルタが null 値を持つ場合、通知の処理前にフィルタリングは行われない。handback
- 通知が発行されたときリスナーに送信されるコンテキスト。MarshalledObject
にカプセル化されている。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。InstanceNotFoundException
- 登録済み MBean の中に、通知リスナーまたは通知ブロードキャスタの MBean 名がない場合。IOException
- 一般的な通信例外が発生した場合。RMIConnection.removeNotificationListener(ObjectName, ObjectName, Subject)
, RMIConnection.removeNotificationListener(ObjectName, ObjectName, MarshalledObject, MarshalledObject, Subject)
public void removeNotificationListeners(ObjectName name, Integer[] listenerIDs, Subject delegationSubject) throws InstanceNotFoundException, ListenerNotFoundException, IOException
RMIConnection
removeNotificationListener(ObjectName, NotificationListener)
および removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)
メソッドを処理します。
このメソッドは、MBean サーバー内の指定された MBean から、1 つ以上の NotificationListener
を削除します。
NotificationListeners
は、RMIConnection.addNotificationListeners(ObjectName[], MarshalledObject[], Subject[])
メソッドから返された ID によって識別されます。
removeNotificationListeners
、インタフェース: RMIConnection
name
- Notification の発行元 MBean を識別する ObjectName
。listenerIDs
- 削除するリスナーに対応する ID のリスト。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。InstanceNotFoundException
- 指定された name
が登録済み MBean に対応していない場合。ListenerNotFoundException
- サーバー側に見つからないリスナーがある場合。この例外は、MBean が、MBeanServer.removeNotificationListener
の呼び出し以外の何らかの理由でリスナーを破棄したとき発行される。IOException
- 一般的な通信例外が発生した場合。public void removeNotificationListener(ObjectName name, ObjectName listener, Subject delegationSubject) throws InstanceNotFoundException, ListenerNotFoundException, IOException
RMIConnection
removeNotificationListener
、インタフェース: RMIConnection
name
- リスナーが削除される MBean の名前。listener
- 削除されるリスナーのオブジェクト名。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。InstanceNotFoundException
- 登録済み MBean の中に、指定された MBean 名がない場合。ListenerNotFoundException
- リスナーが MBean に登録されていない場合。IOException
- 一般的な通信例外が発生した場合。RMIConnection.addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, java.rmi.MarshalledObject, java.rmi.MarshalledObject, javax.security.auth.Subject)
public void removeNotificationListener(ObjectName name, ObjectName listener, MarshalledObject filter, MarshalledObject handback, Subject delegationSubject) throws InstanceNotFoundException, ListenerNotFoundException, IOException
RMIConnection
MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)
メソッドを処理します。NotificationFilter
パラメータは、MarshalledObject
にラップされています。Object
パラメータも、MarshalledObject
にラップされています。removeNotificationListener
、インタフェース: RMIConnection
name
- リスナーが削除される MBean の名前。listener
- 以前にこの MBean に追加されたリスナー。filter
- リスナーの追加時に指定されたフィルタ。MarshalledObject
にカプセル化されている。handback
- リスナーの追加時に指定されたハンドバック。MarshalledObject
にカプセル化されている。delegationSubject
- 委譲プリンシパルを含む Subject
。認証プリンシパルが代わりに使用されている場合は null
。InstanceNotFoundException
- 登録済み MBean の中に、指定された MBean 名がない場合。ListenerNotFoundException
- リスナーが MBean に登録されていない場合、または指定されたフィルタおよびハンドバックで登録されていない場合。IOException
- 一般的な通信例外が発生した場合。RMIConnection.addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, java.rmi.MarshalledObject, java.rmi.MarshalledObject, javax.security.auth.Subject)
public NotificationResult fetchNotifications(long clientSequenceNumber, int maxNotifications, long timeout) throws IOException
RMIConnection
コネクタサーバーから通知を受信します。このメソッドは、1 つ以上通知が発行されるか、指定されたタイムアウトに達するまでブロックできます。また、通知が 0 であればいつでも終了できます。
シーケンス番号が clientSequenceNumber
以上で、このクライアントが通知を受け付けるフィルタを使って通知の発行元 MBean のリスナーを 1 つ以上登録している場合、この通知を結果に含めることができます。この通知を待機する各リスナーは、RMIConnection.addNotificationListeners(ObjectName[], MarshalledObject[], Subject[])
によって返された整数値の ID によって識別されます。
fetchNotifications
、インタフェース: RMIConnection
clientSequenceNumber
- クライアントが待機する最初のシーケンス番号。負の値の場合、次の通知のシーケンス番号と解釈される。maxNotifications
- 返される異なった通知の最大数。同じ通知が繰り返し発行される場合、返される NotificationResult
に含まれる TargetedNotification
配列は、この値より多くの要素を持つことができる。このパラメータの値が負の場合の動作は不定。timeout
- 通知の着信を待つ最大時間 (ミリ秒単位)。0 の場合、通知がないとメソッドは待機せず、ただちに終了する。Long.MAX_VALUE
の場合、タイムアウトは設定されない。このパラメータの値が負の場合の動作は不定。NotificationResult
。IOException
- 一般的な通信例外が発生した場合。 バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.