javax.naming
클래스 CompositeName

java.lang.Object 
  javax.naming.CompositeName

모든 구현된 인터페이스:

Serializable, Cloneable, Comparable <Object >, Name

public class CompositeName
extends Object 
implements Name 

이 클래스는 컴퍼짓이름을 나타냅니다. 컴퍼짓이름이란 복수의 이름 공간에 걸치는 일련의 컴퍼넌트의 이름입니다. 각 컴퍼넌트는 네이밍 시스템의 이름 공간에 유래하는 캐릭터 라인명입니다. 컴퍼넌트가 계층 이름 공간으로부터 발생하는 경우, CompoundName 클래스를 사용하는 것으로 그 기본 부분에 구문 분석 할 수 있습니다 .

컴퍼짓이름의 컴퍼넌트에는 번호를 붙일 수 있습니다. N 컴퍼넌트의 컴퍼짓이름의 인덱스 범위는 0 으로부터 N 미만의 범위에서 번호를 붙일 수 있습니다. 이 범위는 [0, N]와 나타내집니다. 무엇보다 중요한 컴퍼넌트는 인덱스 0에 있습니다. 비어있는 컴퍼짓이름에는 컴퍼넌트는 없습니다.

JNDI 컴퍼짓이름의 구문

JNDI 에서는 컴퍼짓이름의 표준 캐릭터 라인 표기가 정의됩니다. 이 표기에서는 각 컴퍼넌트를 단락짓기 위한 컴퍼넌트 단락 문자 (slash (/))를 사용해, 왼쪽에서 오른쪽으로 컴퍼짓이름의 컴퍼넌트가 연결됩니다. JNDI 구문에서는 다음의 메타캐라크타가 정의됩니다.

• 이스케이프 (backslash \)
• 인용부호 문자 (단일 인용부호 (') 및 이중 인용부호 ("))
• 컴퍼넌트 단락 문자 (slash (/))

선행하는 인용부호, 메타캐라크타에 선행하는 이스케이프, 컴퍼넌트의 말미의 이스케이프, 또는 인용부호가 없는 컴퍼넌트의 컴퍼넌트 단락 문자에는 그 컴퍼넌트가 합성 명문자열에 변환될 때, 전에 이스케이프 문자를 붙일 필요가 있습니다. 또는 이러한 이스케이프 문자를 추가하지 않는 경우는 단일 인용부호 또는 이중 인용부호를 대로 사용해, 컴퍼넌트 전체를 인용부호로 둘러쌉니다. 이중 인용부호로 둘러싸인 컴퍼넌트의 단일 인용부호는 메타캐라크타라고는 보이지 못하고, 이스케이프 되는 일도 없습니다. 또 역의 경우도 같습니다.

2개의 컴퍼짓이름을 비교하는 경우는 대문자와 소문자의 구별이 중요하게 됩니다.

선행하는 컴퍼넌트 단락 문자 (단락 문자로 시작되는 컴퍼짓이름의 캐릭터 라인)는 선행하는 비어있는 컴퍼넌트 (비어있는 캐릭터 라인으로 구성되는 컴퍼넌트)를 나타냅니다. 말미의 컴퍼넌트 단락 문자 (단락 문자로 끝나는 컴퍼짓이름의 캐릭터 라인)는 말미의 비어있는 컴퍼넌트를 나타냅니다. 인접하는 복합 단락 문자는 비어있는 컴퍼넌트를 나타냅니다.

컴퍼짓이름의 례

차의 겉(표)에 컴퍼짓이름의 예를 나타냅니다. 각 행은 컴퍼짓이름의 캐릭터 라인 형식 및 대응하는 구조 형식 (CompositeName)을 나타내고 있습니다.

캐릭터 라인명	CompositeName
""	{} (비어있는 이름 == 새로운 CompositeName("") == 새로운 CompositeName())
"x"	{"x"}
"x/y"	{"x", "y"}
"x/"	{"x", ""}
"/x"	{"", "x"}
"/"	{""}
"//"	{"", ""}
"/x/"	{"", "x", ""}
"x//y"	{"x", "", "y"}

변환의 예

변환의 예를 나타냅니다. 우측의 열에 캐릭터 라인의 컴퍼짓이름의 변환을 좌측의 열에 대응하는 CompositeName 변환을 나타냅니다. 2개의 컴퍼짓이름을 가지는 캐릭터 라인 형식의 변환은 캐릭터 라인 형식을 연결할 뿐입니다.

캐릭터 라인명	CompositeName
"x/y" + "/" = x/y/	{"x", "y"} + {""} = {"x", "y", ""}
"" + "x" = "x"	{} + {"x"} = {"x"}
"/" + "x" = "/x"	{""} + {"x"} = {"", "x"}
"x" + "" + "" = "x"	{"x"} + {} + {} = {"x"}

multi-thread 액세스

CompositeName 인스턴스는 병행 multi-thread 액세스에 대해서는 동기화 되지 않습니다. 복수의 thread로부터 CompositeName에 접속해 변경하는 경우는 객체를 잠글 필요가 있습니다.

도입된 버전 :

1.3

관련 항목:

직렬화 된 형식

생성자 개요

	CompositeName () 새로운 비어있는 컴퍼짓이름을 구축합니다.
protected	CompositeName (Enumeration <String > comps) 'comps'로 지정되는 컴퍼넌트를 사용해, 새로운 컴퍼짓이름 인스턴스를 구축합니다.
	CompositeName (String n) 컴퍼짓이름의 구문 (왼쪽에서 오른쪽, slash로 단락지어진다)을 사용해, 캐릭터 라인 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) CompositeName와 지정된 Object 순서를 비교합니다.
boolean	endsWith (Name n) 컴퍼짓이름이 이 컴퍼짓이름의 접미말일지가 판정됩니다.
boolean	equals (Object obj) 2개의 컴퍼짓이름이 동일한가를 판정합니다.
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

생성자 상세

CompositeName

protected CompositeName(Enumeration <String > comps)

'comps'로 지정되는 컴퍼넌트를 사용해, 새로운 컴퍼짓이름 인스턴스를 구축합니다. 이 protected 메서드는 clone(), getPrefix(), getSuffix()등의 메서드를 오버라이드(override) 할 경우에 CompositeName 서브 클래스에서 사용됩니다.

파라미터:

comps - 새로운 컴퍼짓이름의 컴퍼넌트를 포함하는 null 이외의 열거. 각 요소의 클래스는 String. 열거는 요소의 추출에 사용된다

CompositeName

public CompositeName(String  n)
              throws InvalidNameException 

컴퍼짓이름의 구문 (왼쪽에서 오른쪽, slash로 단락지어진다)을 사용해, 캐릭터 라인 n를 구문 분석 하는 것으로 새로운 컴퍼짓이름 인스턴스를 구축합니다. 컴퍼짓이름의 구문은 클래스의 설명 때에 자세하게 설명합니다.

파라미터:

n - 구문 분석 하는 null 이외의 캐릭터 라인

예외:

InvalidNameException - n에 무효인 컴퍼짓이름의 구문이 있는 경우

CompositeName

public CompositeName()

새로운 비어있는 컴퍼짓이름을 구축합니다. isEmpty()가 불려가 면, true를 리턴합니다.

메서드의 상세

toString

public String  toString()

이 컴퍼짓이름의 캐릭터 라인 표기를 생성합니다. 캐릭터 라인 표기에서는 컴퍼짓이름의 각 컴퍼넌트가 열거되어 각 컴퍼넌트가 slash 문자로 단락지어집니다. 인용과 이스케이프 문자는 JNDI 구문에 따를 필요가 있는 장소에 적용됩니다. 이것에 대해서는 클래스의 설명 때에 설명합니다. 비어있는 컴퍼넌트는 비어있는 캐릭터 라인으로 나타내집니다.이와 같이 생성된 캐릭터 라인 표기를 CompositeName 생성자에 인도하면, 새로운 같은 컴퍼짓이름을 작성할 수 있습니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 컴퍼짓이름의 null 이외의 캐릭터 라인 표기

equals

public boolean equals(Object  obj)

2개의 컴퍼짓이름이 동일한가를 판정합니다. obj가 null 인지, 또는 컴퍼짓이름이 아닌 경우는 false를 리턴합니다. 한편의 각 컴퍼넌트가 이제(이미 ) 한편의 대응하는 컴퍼넌트와 동일한 경우는 2개의 컴퍼짓이름은 동일해집니다. 이것은 양쪽 모두의 컴퍼짓이름에 같은 수의 컴퍼넌트가 있어, 각 컴퍼넌트의 equals() 테스트로 이제(이미 ) 한편의 이름의 대응하는 컴퍼넌트를 조사하면 true가 리턴된 것을 나타내고 있습니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - null 가능성이 있는 비교 대조 객체

반환값:

obj가 이 컴퍼짓이름으로 동일한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

hashCode()

hashCode

public int hashCode()

이 컴퍼짓이름의 해시 코드를 계산합니다. 해시 코드란 이 컴퍼짓이름의 각 컴퍼넌트의 해시 코드의 집합입니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 이름의 해시 코드를 나타내는 int

관련 항목:

equals(java.lang.Object)

compareTo

public int compareTo(Object  obj)

CompositeName와 지정된 Object 순서를 비교합니다. 이 Name가 지정된 Object 보다 작은 경우는 부의 정수, 동일한 경우는 0, 큰 경우는 정의 정수를 각각 리턴합니다.

obj가 null, 또는 CompositeName 인스턴스가 아닌 경우는 ClassCastException가 발생 됩니다.

2개의 컴퍼짓이름이 동일하다고는 어떠한 미인가에 대해서는 equals()를 참조하십시오. 2개의 컴퍼짓이름이 동일한 경우는 0을 리턴합니다.

컴퍼짓이름의 순서부는 캐릭터 라인 비교의 사전 규칙에 따르고 있습니다. 컴퍼짓이름의 모든 컴퍼넌트에 적용되는 확장 기능도 있습니다. 그 결과, 모든 컴퍼넌트가 지정한 순서로 2개의 라인 업에 적용된 사전 규칙에 따라 늘어놓을 수 있던 것처럼 됩니다. 이 컴퍼짓이름이 「사전 규칙에 따르며」obj 보다 작은 경우는 부의 수가 리턴됩니다 . 이 컴퍼짓이름이 「사전 규칙에 따르며」obj 보다 큰 경우는 정의 수가 리턴됩니다 .

정의:

인터페이스 Comparable <Object > 내의 compareTo

정의:

인터페이스 Name 내의 compareTo

파라미터:

obj - 비교되는 null 이외의 객체

반환값:

이 Name가 지정된 Object 보다 작은 경우는 부의 정수, 동일한 경우는 0, 큰 경우는 정의 정수

예외:

ClassCastException - obj가 CompositeName가 아닌 경우

관련 항목:

Comparable.compareTo(Object)

clone

public Object  clone()

이 컴퍼짓이름의 복사본을 생성합니다. 이 컴퍼짓이름의 컴퍼넌트를 변경해도, 새로운 카피에는 영향을 주지 않습니다. 또 역의 경우도 같습니다.

정의:

인터페이스 Name 내의 clone

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 컴퍼짓이름의 null 이외의 카피

관련 항목:

Cloneable

size

public int size()

이 컴퍼짓이름의 컴퍼넌트의 수를 취득합니다.

정의:

인터페이스 Name 내의 size

반환값:

이 컴퍼짓이름의 컴퍼넌트의 수의 부 이외의 값

isEmpty

public boolean isEmpty()

이 컴퍼짓이름이 비어있는지 판정합니다. 컴퍼넌트가 제로의 경우, 컴퍼짓이름은 비어있습니다.

정의:

인터페이스 Name 내의 isEmpty

반환값:

이 컴퍼짓이름이 비어있는 경우는 true, 그렇지 않은 경우는 false

getAll

public Enumeration <String > getAll()

이 컴퍼짓이름의 컴퍼넌트를, 캐릭터 라인의 열거로서 취득합니다. 이 열거로 이 컴퍼짓이름을 갱신하는 영향에 대해서는 정의되지 않습니다.

정의:

인터페이스 Name 내의 getAll

반환값:

이 컴퍼짓이름의 컴퍼넌트의 null 이외의 열거. 열거의 각 요소의 클래스는 String

get

public String  get(int posn)

이 컴퍼짓이름의 컴퍼넌트를 취득합니다.

정의:

인터페이스 Name 내의 get

파라미터:

posn - 얻는 컴퍼넌트의 0 으로부터 시작되는 인덱스. 범위는 [0, size()]가 아니면 안된다

반환값:

인덱스 위치의 null 이외의 컴퍼넌트

예외:

ArrayIndexOutOfBoundsException - 위값이 지정한 범위에 없는 경우

getPrefix

public Name  getPrefix(int posn)

컴퍼넌트가 이 컴퍼짓이름의 컴퍼넌트의 접두사로 구성되는 컴퍼짓이름을 작성합니다. 그 후 이 컴퍼짓이름을 변경해도, 리턴된 이름에는 영향을 주지 않습니다.

정의:

인터페이스 Name 내의 getPrefix

파라미터:

posn - 정지하는 컴퍼넌트의 0 으로부터 시작되는 인덱스. 범위는 [0, size()]가 아니면 안된다

반환값:

범위가 [0, posn] 인덱스의 컴퍼넌트로 구성되는 컴퍼짓이름

예외:

ArrayIndexOutOfBoundsException - 위값이 지정한 범위에 없는 경우

getSuffix

public Name  getSuffix(int posn)

컴퍼넌트가 이 컴퍼짓이름의 컴퍼넌트의 접미말로 구성되는 컴퍼짓이름을 작성합니다. 그 후 이 컴퍼짓이름을 변경해도, 리턴된 이름에는 영향을 주지 않습니다.

정의:

인터페이스 Name 내의 getSuffix

파라미터:

posn - 개시하는 컴퍼넌트의 0 으로부터 시작되는 인덱스. 범위는 [0, size()]가 아니면 안된다

반환값:

범위가 [posn, size()] 인덱스의 컴퍼넌트로 구성되는 컴퍼짓이름. 위값이 size()와 동일한 경우는 비어있는 컴퍼짓이름이 리턴된다

예외:

ArrayIndexOutOfBoundsException - 위값이 지정한 범위에 없는 경우

startsWith

public boolean startsWith(Name  n)

컴퍼짓이름이 이 컴퍼짓이름의 접두사일지가 판정됩니다. 컴퍼짓이름 'n'는 getPrefix(n.size())와 동일한 경우에 접두사가 됩니다. 즉, 이 컴퍼짓이름은 'n'로 시작됩니다. 'n'가 null 인지, 또는 컴퍼짓이름이 아닌 경우는 false가 리턴됩니다 .

정의:

인터페이스 Name 내의 startsWith

파라미터:

n - null 가능성이 있는 판정 대상의 이름

반환값:

n가 CompositeName 로 이 컴퍼짓이름의 접두사인 경우는 true, 그렇지 않은 경우는 false

endsWith

public boolean endsWith(Name  n)

컴퍼짓이름이 이 컴퍼짓이름의 접미말일지가 판정됩니다. 컴퍼짓이름 'n'는 getSuffix(size() -n.size())와 동일한 경우에 접미말이 됩니다. 즉, 이 컴퍼짓이름은 'n'로 종료합니다. n가 null 인지, 또는 컴퍼짓이름이 아닌 경우는 false가 리턴됩니다 .

정의:

인터페이스 Name 내의 endsWith

파라미터:

n - null 가능성이 있는 판정 대상의 이름

반환값:

n가 CompositeName 로 이 컴퍼짓이름의 접미말인 경우는 true, 그렇지 않은 경우는 false

addAll

public Name  addAll(Name  suffix)
            throws InvalidNameException 

컴퍼짓이름의 컴퍼넌트를, 이 컴퍼짓이름의 말미에 순서에 추가합니다.

정의:

인터페이스 Name 내의 addAll

파라미터:

suffix - 추가하는 null 이외의 컴퍼넌트

반환값:

새로운 CompositeName는 아니고, 갱신된 CompositeName. null은 불가

예외:

InvalidNameException - 접미말이 컴퍼짓이름이 아닌 경우

addAll

public Name  addAll(int posn,
                   Name  n)
            throws InvalidNameException 

컴퍼짓이름의 컴퍼넌트를, 이 컴퍼짓이름의 지정한 위치에 순서에 추가합니다. 최초의 새로운 컴퍼넌트의 인덱스, 또는 그 뒤에 있는 이 컴퍼짓이름의 컴퍼넌트는 새로운 컴퍼넌트를 수중에 넣기 위해서 위에 이동 (인덱스 0 으로부터 멀어진다)합니다.

정의:

인터페이스 Name 내의 addAll

파라미터:

n - 추가하는 null 이외의 컴퍼넌트

posn - 새로운 컴퍼넌트가 추가되는 이 이름의 인덱스. 범위는 [0, size()]가 아니면 안된다

반환값:

새로운 CompositeName는 아니고, 갱신된 CompositeName. null은 불가

예외:

InvalidNameException - n가 컴퍼짓이름이 아닌 경우

ArrayIndexOutOfBoundsException - 위값이 지정한 범위에 없는 경우

add

public Name  add(String  comp)
         throws InvalidNameException 

단일의 컴퍼넌트를 이 컴퍼짓이름의 마지막에 추가합니다.

정의:

인터페이스 Name 내의 add

파라미터:

comp - 추가하는 null 이외의 컴퍼넌트

반환값:

새로운 CompositeName는 아니고, 갱신된 CompositeName. null은 불가

예외:

InvalidNameException - 이름의 마지막에 컴퍼넌트를 추가하면, 이름의 구문에 위반하는 경우

add

public Name  add(int posn,
                String  comp)
         throws InvalidNameException 

단일의 컴퍼넌트를, 이 컴퍼짓이름의 지정한 위치에 추가합니다. 새로운 컴퍼넌트의 인덱스, 또는 그 뒤에 있는 이 컴퍼짓이름의 컴퍼넌트는 새로운 컴퍼넌트를 수중에 넣기 위해서 1개 상에 이동 (인덱스 0 으로부터 멀어진다)합니다.

정의:

인터페이스 Name 내의 add

파라미터:

comp - 추가하는 null 이외의 컴퍼넌트

posn - 새로운 컴퍼넌트가 추가되는 인덱스. 범위는 [0, size()]가 아니면 안된다

반환값:

새로운 CompositeName는 아니고, 갱신된 CompositeName. null은 불가

예외:

ArrayIndexOutOfBoundsException - 위값이 지정한 범위에 없는 경우

InvalidNameException - 지정한 위치에 컴퍼넌트를 추가하면, 이름의 구문에 위반하는 경우

remove

public Object  remove(int posn)
              throws InvalidNameException 

이 컴퍼짓이름에서 컴퍼넌트를 삭제합니다. 위치 'posn'에 있는 컴퍼짓이름의 컴퍼넌트가 삭제되어'posn'보다 큰 인덱스의 컴퍼넌트는 1개 하 (인덱스 0 (분)편)로 이동합니다.

정의:

인터페이스 Name 내의 remove

파라미터:

posn - 삭제하는 컴퍼넌트의 인덱스. 범위는 [0, size()]가 아니면 안된다

반환값:

삭제된 컴퍼넌트 (String)

예외:

ArrayIndexOutOfBoundsException - 위값이 지정한 범위에 없는 경우 (컴퍼짓이름이 비어있는 경우를 포함한다)

InvalidNameException - 컴퍼넌트를 삭제하면, 이름의 구문에 위반하는 경우