- すべての実装されたインタフェース:
Serializable
public final class ObjID extends Object implements Serializable
ObjID
は、RMIランタイムにエクスポートされたリモート・オブジェクトを識別するために使用します。 エクスポートしたリモート・オブジェクトには、エクスポートに使用したAPIに応じて暗黙的または明示的にオブジェクト識別子が割り当てられます。
ObjID()
コンストラクタを使用すると、一意のオブジェクト識別子を生成できます。 そのようなObjID
は、それが生成されたホスト上で常に一意になります。 ObjID(int)
コンストラクタを使用すると、「既知の」オブジェクト識別子を生成できます。 既知のObjID
のスコープは、エクスポート先のRMIランタイムによって異なります。
ObjID
のインスタンスには、オブジェクト番号(long
型)とアドレス空間識別子(UID
型)が含まれます。 一意のObjID
では、アドレス空間識別子は特定のホスト上で常に一意です。 よく知られているObjID
では、アドレス空間識別子は、UID(short)
コンストラクタを値0で呼び出すことによって返されるものと同等です。
システム・プロパティjava.rmi.server.randomIDs
が文字列"true"
(大文字小文字を区別しません)と等しいと定義されている場合、ObjID()
コンストラクタは暗号として強力なランダム・ナンバー・ジェネレータを使用して、返されるObjID
のオブジェクト番号を選択します。
- 導入されたバージョン:
- 1.1
- 関連項目:
- 直列化された形式
-
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 static int
ACTIVATOR_ID
アクティベータの既知のObjID
に使用するオブジェクト番号です。static int
DGC_ID
分散ガベージ・コレクタの既知のObjID
に使用するオブジェクト番号です。static int
REGISTRY_ID
レジストリの既知のObjID
に使用するオブジェクト番号です。 -
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型 メソッド 説明 boolean
equals(Object obj)
指定されたオブジェクトがこのObjID
と同じかどうかを比較します。int
hashCode()
このオブジェクト識別子のハッシュ・コード値をオブジェクト番号として返します。static ObjID
read(ObjectInput in)
ObjectInput
インスタンスのバイナリ表現を非整列化することで、新しいObjID
インスタンスを構築して返します。String
toString()
このオブジェクト識別子の文字列表現を返します。void
write(ObjectOutput out)
このObjID
のバイナリ表現を整列化して、ObjectOutput
インスタンスに書き込みます。
-
フィールド詳細
-
REGISTRY_ID
public static final int REGISTRY_IDレジストリの既知のObjID
に使用するオブジェクト番号です。- 関連項目:
- 定数フィールド値
-
ACTIVATOR_ID
public static final int ACTIVATOR_IDアクティベータの既知のObjID
に使用するオブジェクト番号です。- 関連項目:
- 定数フィールド値
-
DGC_ID
public static final int DGC_ID分散ガベージ・コレクタの既知のObjID
に使用するオブジェクト番号です。- 関連項目:
- 定数フィールド値
-
-
コンストラクタの詳細
-
ObjID
public ObjID()一意のオブジェクト識別子を生成します。システム・プロパティ
java.rmi.server.randomIDs
が文字列"true"
(大文字と小文字は区別されない)と定義されている場合、このコンストラクタは強力な暗号乱数ジェネレータを使用して、返されるObjID
のオブジェクト番号を選択します。 -
ObjID
public ObjID(int objNum)「既知の」オブジェクト識別子を生成します。このコンストラクタを使用して生成した
ObjID
は、引数を指定しないで生成したObjID
と重複することはありません。- パラメータ:
objNum
- 既知のオブジェクト識別子に使用するオブジェクト番号
-
-
メソッドの詳細
-
write
public void write(ObjectOutput out) throws IOExceptionこのObjID
のバイナリ表現を整列化して、ObjectOutput
インスタンスに書き込みます。具体的には、このメソッドはまず、このオブジェクト識別子のオブジェクト番号を使用して、指定されたストリームの
DataOutput.writeLong(long)
メソッドを呼び出します。次に、そのストリームを使用してUID.write(DataOutput)
メソッドを呼び出し、アドレス空間識別子を書き込みます。- パラメータ:
out
- このObjID
の書込み先のObjectOutput
インスタンス- 例外:
IOException
- この操作の実行中に入出力エラーが発生した場合
-
read
public static ObjID read(ObjectInput in) throws IOExceptionObjectInput
インスタンスのバイナリ表現を非整列化することで、新しいObjID
インスタンスを構築して返します。具体的には、このメソッドはまず、指定されたストリームの
DataInput.readLong()
メソッドを呼び出して、オブジェクト番号を読み込みます。次に、そのストリームを使用してUID.read(DataInput)
を呼び出し、アドレス空間識別子を読み込みます。さらに、ストリームから読み込んだオブジェクト番号とアドレス空間識別子を含む新しいObjID
インスタンスを作成し、そのインスタンスを返します。- パラメータ:
in
-ObjID
の読取り元のObjectInput
インスタンス- 戻り値:
- 非整列化された
ObjID
インスタンス - 例外:
IOException
- この操作の実行中に入出力エラーが発生した場合
-
hashCode
public int hashCode()このオブジェクト識別子のハッシュ・コード値をオブジェクト番号として返します。- オーバーライド:
hashCode
、クラス:Object
- 戻り値:
- このオブジェクト識別子のハッシュ・コード値
- 関連項目:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
equals
public boolean equals(Object obj)指定されたオブジェクトがこのObjID
と同じかどうかを比較します。 このメソッドがtrue
を返すのは、指定されたオブジェクトがObjID
インスタンスであり、かつこのオブジェクトと同じオブジェクト番号とアドレス空間識別子を持つ場合だけです。- オーバーライド:
equals
、クラス:Object
- パラメータ:
obj
- このObjID
と比較するオブジェクト- 戻り値:
- 指定されたオブジェクトがこのオブジェクトと一致する場合は
true
、一致しない場合はfalse
- 関連項目:
Object.hashCode()
、HashMap
-
toString
public String toString()このオブジェクト識別子の文字列表現を返します。
-