|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object javax.naming.CompoundName
public class CompoundName
このクラスは複合名を表します。 複合名とは、階層名前空間から取得される名前です。複合名の各コンポーネントは、不可分な名前です。
複合名のコンポーネントには、番号が付けられます。N コンポーネントの複合名のインデックス範囲は、0 から N 未満の範囲で番号が付けられます。 この範囲は、[0,N] と表されます。もっとも重要なコンポーネントは、インデックス 0 にあります。 空の複合名にはコンポーネントはありません。
複合名の文字列形式は、上記の構文に従います。複合名のコンポーネントが文字列表記に変換される場合は、上記の予約された構文規則が適用されます (埋め込まれた区切り文字はエスケープまたは引用されるなど)。 そのため、同じ文字列が構文解析される場合、元の複合名と同じコンポーネントが作成されます。
フィールドの概要 | |
---|---|
protected javax.naming.NameImpl |
impl
この複合名の実装です。 |
protected Properties |
mySyntax
この複合名の構文プロパティーです。 |
コンストラクタの概要 | |
---|---|
protected |
CompoundName(Enumeration<String> comps,
Properties syntax)
comps に指定されたコンポーネントと syntax を使用して、新しい複合名インスタンスを構築します。 |
|
CompoundName(String n,
Properties syntax)
指定した構文プロパティーで指定される構文を使用して、文字列 n を構文解析することで、新しい複合名インスタンスを構築します。 |
メソッドの概要 | |
---|---|
Name |
add(int posn,
String comp)
単一のコンポーネントを、この複合名の指定した位置に追加します。 |
Name |
add(String comp)
単一のコンポーネントをこの複合名の最後に追加します。 |
Name |
addAll(int posn,
Name n)
複合名のコンポーネントを、この複合名の指定した位置に順に追加します。 |
Name |
addAll(Name suffix)
複合名のコンポーネントを、この複合名の末尾に順に追加します。 |
Object |
clone()
この複合名のコピーを作成します。 |
int |
compareTo(Object obj)
CompoundName と、指定された Object の順序を比較します。 |
boolean |
endsWith(Name n)
複合名がこの複合名の接尾辞であるかどうかが判定されます。 |
boolean |
equals(Object obj)
obj がこの複合名と構文的に等しいかを判定します。 |
String |
get(int posn)
この複合名のコンポーネントを取得します。 |
Enumeration<String> |
getAll()
この複合名のコンポーネントを、文字列の列挙として取得します。 |
Name |
getPrefix(int posn)
コンポーネントがこの複合名のコンポーネントの接頭辞となる複合名を作成します。 |
Name |
getSuffix(int posn)
コンポーネントがこの複合名のコンポーネントの接尾辞を構成する複合名を作成します。 |
int |
hashCode()
この複合名のハッシュコードを計算します。 |
boolean |
isEmpty()
この複合名が空かどうかを判定します。 |
Object |
remove(int posn)
この複合名からコンポーネントを削除します。 |
int |
size()
この複合名のコンポーネント数を取得します。 |
boolean |
startsWith(Name n)
複合名がこの複合名の接頭辞であるかどうかが判定されます。 |
String |
toString()
複合名の構文規則を使用する、この複合名の文字列表記を生成します。 |
クラス java.lang.Object から継承されたメソッド |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
フィールドの詳細 |
---|
protected transient javax.naming.NameImpl impl
protected transient Properties mySyntax
コンストラクタの詳細 |
---|
protected CompoundName(Enumeration<String> comps, Properties syntax)
comps
- 追加するコンポーネントの null 以外の列挙
列挙された各要素のクラスは String
列挙は要素の抽出に使用されるsyntax
- この複合名の構文を指定する null 以外のプロパティー
プロパティーの内容は、クラスの説明を参照public CompoundName(String n, Properties syntax) throws InvalidNameException
n
- 構文解析する null 以外の文字列syntax
- この複合名の構文を指定する null 以外のプロパティーのリスト
プロパティーの内容は、クラスの説明を参照
InvalidNameException
- 'n' が syntax
で指定される構文に違反する場合メソッドの詳細 |
---|
public String toString()
Object
内の toString
public boolean equals(Object obj)
等しいかどうかは、この複合名の構文によっても定義されます。CompoundName のデフォルトの実装では、2 つのコンポーネントが等しいかどうかを比較するときに、構文プロパティー jndi.syntax.ignorecase および jndi.syntax.trimblanks が使用されます。大文字と小文字が区別されない場合、同じ文字のシーケンスを持ち、大文字と小文字どちらでも文字列が等しいとみなされます。空白が削除される場合は、比較のために最初の空白と末尾の空白は無視されます。
2 つの複合名には、同じ数のコンポーネントが必要です。
実装上の注意:現在、2 つの複合名の構文プロパティーが等しいかどうかは比較されていません。今後使用または確認される可能性があります。
Object
内の equals
obj
- null の可能性がある比較対照オブジェクト
compareTo(java.lang.Object obj)
public int hashCode()
Object
内の hashCode
Object.equals(java.lang.Object)
,
Hashtable
public Object clone()
Name
内の clone
Object
内の clone
Cloneable
public int compareTo(Object obj)
obj が null、または CompoundName のインスタンスではない場合は、ClassCastException がスローされます。
2 つの複合名が等しいとはどのような意味かについては、equals() を参照してください。2 つの複合名が等しい場合は、0 を返します。
複合名の順序付けは、複合名の構文によります。デフォルトでは、文字列比較の辞書規則に準拠します。 この規則は、複合名に含まれるすべてのコンポーネントに適用されます。 ただし、コンポーネントが比較されるときは、equals() の場合と同様に、jndi.syntax.ignorecase プロパティーと jndi.syntax.trimblanks プロパティーが適用されます。この複合名が「辞書規則に従って」 obj より小さい場合は、負の数が返されます。この複合名が「辞書規則に従って」 obj より大きい場合は、正の数が返されます。
実装上の注意:現在、2 つの複合名の構文プロパティーが等しいかどうかは、順序の確認時には比較されていません。今後比較される可能性があります。
Comparable<Object>
内の compareTo
Name
内の compareTo
obj
- 比較される null 以外のオブジェクト
ClassCastException
- obj が CompoundName ではない場合equals(java.lang.Object)
public int size()
Name
内の size
public boolean isEmpty()
Name
内の isEmpty
public Enumeration<String> getAll()
Name
内の getAll
public String get(int posn)
Name
内の get
posn
- 取得するコンポーネントの 0 から始まるインデックス
範囲は [0,size()] でなければならない
ArrayIndexOutOfBoundsException
- 位置が指定した範囲にない場合public Name getPrefix(int posn)
Name
内の getPrefix
posn
- 停止するコンポーネントの 0 から始まるインデックス
範囲は [0,size()] でなければならない
ArrayIndexOutOfBoundsException
- 位置が指定した範囲にない場合public Name getSuffix(int posn)
Name
内の getSuffix
posn
- 開始するコンポーネントの 0 から始まるインデックス
範囲は [0,size()] でなければならない
ArrayIndexOutOfBoundsException
- 位置が指定した範囲にない場合public boolean startsWith(Name n)
実装上の注意:現在、n の構文プロパティーは比較時に使用されていません。今後比較される可能性があります。
Name
内の startsWith
n
- null の可能性がある判定対象の複合名
public boolean endsWith(Name n)
実装上の注意:現在、n の構文プロパティーは比較時に使用されていません。今後比較される可能性があります。
Name
内の endsWith
n
- null の可能性がある判定対象の複合名
public Name addAll(Name suffix) throws InvalidNameException
実装上の注意:現在、接尾辞の構文プロパティーは使用または確認されていません。今後比較される可能性があります。
Name
内の addAll
suffix
- 追加する null 以外のコンポーネント
InvalidNameException
- 接尾辞が複合名ではない、
またはコンポーネントの追加がこの複合名の構文に違反する場合
(コンポーネントの数を超えるなど)public Name addAll(int posn, Name n) throws InvalidNameException
実装上の注意:現在、接尾辞の構文プロパティーは使用または確認されていません。今後比較される可能性があります。
Name
内の addAll
n
- 追加する null 以外のコンポーネントposn
- 新しいコンポーネントが追加されるこの名前のインデックス
範囲は [0,size()] でなければならない
ArrayIndexOutOfBoundsException
- 位置が指定した範囲にない場合
InvalidNameException
- n が複合名ではない場合、
またはコンポーネントの追加がこの複合名の構文に違反する場合
(コンポーネントの数を超えるなど)public Name add(String comp) throws InvalidNameException
Name
内の add
comp
- 追加する null 以外のコンポーネント
InvalidNameException
- 名前の最後にコンポーネントを追加すると、 複合名の構文に違反する場合public Name add(int posn, String comp) throws InvalidNameException
Name
内の add
comp
- 追加する null 以外のコンポーネントposn
- 新しいコンポーネントが追加されるインデックス。
範囲は [0,size()] でなければならない
ArrayIndexOutOfBoundsException
- 位置が指定した範囲にない場合
InvalidNameException
- 指定した位置にコンポーネントを追加すると
複合名の構文に違反する場合public Object remove(int posn) throws InvalidNameException
Name
内の remove
posn
- 削除するコンポーネントのインデックス
範囲は [0,size()] でなければならない
ArrayIndexOutOfBoundsException
- 位置が指定した範囲にない場合 (複合名が空の場合を含む)
InvalidNameException
- コンポーネントを削除すると、複合名の構文に違反する場合
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。