javax.naming.directory
클래스 BasicAttribute

java.lang.Object 
  javax.naming.directory.BasicAttribute

모든 구현된 인터페이스:

Serializable, Cloneable, Attribute

public class BasicAttribute
extends Object 
implements Attribute 

이 클래스는 Attribute 인터페이스의 기본적인 구현을 제공합니다.

이 구현은 schema 메서드 getAttributeDefinition() 및 getAttributeSyntaxDefinition()를 지원 하지 않습니다. 이러한 메서드는 다만 OperationNotSupportedException을 Throw 합니다. BasicAttribute 서브 클래스가 이러한 메서드를 지원 하고 있는 경우, BasicAttribute가 이러한 메서드를 오버라이드(override) 합니다.

BasicAttribute 클래스는 디폴트에서는 Object.equals()를 사용해 동일성의 테스트시나 값의 검색시의 속성값의 동일성을 판정합니다만, 값이 배열인 경우는 「예외」입니다. 배열의 경우, Object.equals()를 사용해 배열의 각 요소가 확인됩니다. schema의 이러한 사용법이 유효한 메서드를 오버라이드(override) 하는 것에 의해 같은 동일성 체크를 실시하는 경우, BasicAttribute 서브 클래스가 schema 정보를 이용할 수 있습니다. 같이BasicAttribute 클래스는 디폴트에서는 생성자에게 건네진 값 또는 추가 삭제 메서드를 사용해 처리된 값, 혹은 그 양쪽 모두를 리턴합니다. BasicAttribute 서브 클래스는 get() 및 getAll()를 오버라이드(override)의해 디렉토리로부터 직접치를 취득할 수 있습니다 (또는 BasicAttribute를 상속하는 대신에 Attribute 인터페이스를 직접 구현한다).

BasicAttribute 변경 (값의 추가 삭제등)은 해당하는 디렉토리의 속성의 표시에는 영향을 주지 않습니다. 디렉토리의 변경은, DirContext 인터페이스의 조작을 사용했을 경우에 한정해, 유효하게 됩니다.

BasicAttribute 인스턴스는 병행 multi-thread 액세스에 대해서는 동기화 되지 않습니다. BasicAttribute로 액세스 및 변경하려고 하는 복수의 thread에의해 객체는 락 됩니다.

도입된 버전 :

1.3

관련 항목:

직렬화 된 형식

필드 개요

protected String	attrID 속성의 ID를 보관 유지합니다.
protected boolean	ordered 이 속성의 값이 정렬 될지 어떨지를 기록하는 플래그입니다.
protected Vector <Object >	values 속성의 값을 보관 유지합니다.

생성자 개요

BasicAttribute (String id)
정렬되어 있지 않은 속성의 인스턴스를 값없이 새롭게 구축합니다.

BasicAttribute (String id, boolean ordered)
정렬 될 가능성이 있는 속성의 인스턴스를 값없이 새롭게 구축합니다.

BasicAttribute (String id, Object value)
정렬되어 있지 않은 속성의 인스턴스를 단일의 값으로 새롭게 구축합니다.

BasicAttribute (String id, Object value, boolean ordered)
정렬 될 가능성이 있는 속성의 인스턴스를 단일의 값으로 새롭게 구축합니다.

메서드 개요

void	add (int ix, Object attrVal) 속성값을 속성값의 순서를 갖는 리스트에 추가합니다.
boolean	add (Object attrVal) 이 속성에 새로운 값을 추가합니다.
void	clear () 이 속성으로부터 모든 값을 삭제합니다.
Object	clone () 이 객체의 복사본을 작성해 리턴합니다.
boolean	contains (Object attrVal) 값이 이 속성에 있을지 어떨지를 판정합니다.
boolean	equals (Object obj) obj가 이 속성과 동일한가 어떤가를 판별합니다.
Object	get () 이 속성의 값의 1개를 검출합니다.
Object	get (int ix) 속성값의 순서를 갖는 리스트로부터 속성값을 꺼냅니다.
NamingEnumeration <? >	getAll () 이 속성의 값의 열거를 검출합니다.
DirContext	getAttributeDefinition () 이 속성의 schema 정의를 검출합니다.
DirContext	getAttributeSyntaxDefinition () 이 속성에 관련된 구문의 정의를 검색합니다.
String	getID () 이 속성의 ID를 꺼냅니다.
int	hashCode () 이 속성의 해시 코드를 계산합니다.
boolean	isOrdered () 속성값이 순서부등이라고 있을지 어떨지를 판별합니다.
Object	remove (int ix) 속성값의 순서를 갖는 리스트로부터 속성값을 삭제합니다.
boolean	remove (Object attrval) 지정된 값을 이 속성으로부터 삭제합니다.
Object	set (int ix, Object attrVal) 속성값의 순서를 갖는 리스트의 속성값을 설정합니다.
int	size () 이 속성의 크기를 꺼냅니다.
String	toString () 이 속성의 캐릭터 라인 표기를 생성합니다.

클래스 java.lang. Object 로부터 상속된 메서드

finalize, getClass, notify, notifyAll, wait, wait, wait

필드의 상세

attrID

protected String  attrID

속성의 ID를 보관 유지합니다. ID는 public 생성자에 의해 초기화되어 attrID를 사용하고 있는 BasicAttribute 메서드가 오버라이드(override)되어 있지 않은 한, null 로 할 수 없습니다.

values

protected transient Vector <Object > values

속성의 값을 보관 유지합니다. public 생성자에 의해 초기화됩니다. 값을 사용하는 BasicAttribute 메서드가 오버라이드(override)되어 있지 않은 한, null 로 할 수 없습니다.

ordered

protected boolean ordered

이 속성의 값이 정렬 될지 어떨지를 기록하는 플래그입니다.

생성자 상세

BasicAttribute

public BasicAttribute(String  id)

정렬되어 있지 않은 속성의 인스턴스를 값없이 새롭게 구축합니다.

파라미터:

id - 속성의 ID. null은 불가

BasicAttribute

public BasicAttribute(String  id,
                      Object  value)

정렬되어 있지 않은 속성의 인스턴스를 단일의 값으로 새롭게 구축합니다.

파라미터:

id - 속성의 ID. null은 불가

value - 속성의 값. null인 경우, null 값이 속성에 추가된다

BasicAttribute

public BasicAttribute(String  id,
                      boolean ordered)

정렬 될 가능성이 있는 속성의 인스턴스를 값없이 새롭게 구축합니다.

파라미터:

id - 속성의 ID. null은 불가

ordered - 속성값이 정렬 되는 경우는 true, 그렇지 않은 경우는 false

BasicAttribute

public BasicAttribute(String  id,
                      Object  value,
                      boolean ordered)

정렬 될 가능성이 있는 속성의 인스턴스를 단일의 값으로 새롭게 구축합니다.

파라미터:

id - 속성의 ID. null은 불가

value - 속성의 값. null인 경우, null 값이 속성에 추가되는

ordered - 속성값이 정렬 되는 경우는 true, 그렇지 않은 경우는 false

메서드의 상세

clone

public Object  clone()

클래스 Object 기술:

이 객체의 복사본을 작성해 리턴합니다. 「카피」의 정확한 이유는 객체의 클래스에 의해 다릅니다. 일반적으로는 임의의 객체 x에 대해, 다음의 식

 x.clone() ! = x

하지만 true 이며, 다음의 식

 x.clone(). getClass() == x.getClass()

도 true 인 것입니다만, 이것들도 절대적인 요건이 아닙니다. 또 다음의 식

 x.clone(). equals(x)

도 보통 true가 됩니다만, 이것도 절대적인 요건이 아닙니다.

보통, super.clone를 호출하는 것으로 리턴된 객체를 취득할 수 있습니다. 클래스 및 그 슈퍼 클래스 모든 것 (Object를 제외한다)이 이 규칙에 따르는 경우, x.clone(). getClass() == x.getClass()가 성립합니다.

보통, 이 메서드에 의해 리턴된 객체는 이 객체 (복제되고 있다)로부터 독립하고 있을 필요가 있습니다. 이 독립성을 달성하기 위해, super.clone가 돌려주는 객체의 필드를 1개 이상 (객체가 돌려주기 전에) 변경하는 것이 필요하게 되는 경우가 있습니다. 이것은 보통, 복제하는 객체의 내부 「심층 구조」를 구성하는 가변 객체의 카피 및 이러한 객체에의 참조를 카피에의 참조에 옮겨놓는 것을의미합니다. 클래스에 원시적 필드 또는 불변 객체에의 참조만이 포함되는 경우, 보통, super.clone에 의해 리턴된 객체내의 필드를 변경할 필요는 없습니다.

Object 클래스의 clone 메서드는 특정의 복제 처리를 실행합니다. 우선, 이 객체의 클래스가 Cloneable 인터페이스를 구현하고 있지 않는 경우는 CloneNotSupportedException이 발생 됩니다. 배열은 모두, 인터페이스 Cloneable를 구현하고 있는 것이라고 보여지는 것에 주의해 주세요. 구현하고 있지 않는 경우, 이 메서드는 이 객체의 클래스의 새로운 인스턴스를 생성해, 그 필드를 모두, 이 객체의 대응하는 각 필드의 내용으로 초기화합니다. 이것은 대입과 같아, 필드의 내용 자신이 복제되는 것은 아닙니다. 즉 이 메서드는 객체의 「샤로코피」를 생성합니다만, 「딥 카피」는 생성하지 않습니다.

클래스 Object 자체는 Cloneable 인터페이스를 구현하지 않기 때문에 클래스가 Object 인 clone 메서드를 호출하면, 실행시에 예외가 발생 됩니다.

정의:

인터페이스 Attribute 내의 clone

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 인스턴스의 복제

관련 항목:

Cloneable

equals

public boolean equals(Object  obj)

obj가 이 속성과 동일한가 어떤가를 판별합니다. 2개의 속성의 속성 ID, 구문 및 값이 동일한 경우, 2개의 속성은 동일합니다. 2개의 속성의 값이 정렬되어 있지 않은 경우, 값이 추가된 순서는 관계 없습니다. 속성값이 정렬 되고 있는 경우, 값의 순서는 일치할 필요가 있습니다. obj가 null 인지, 또는 Attribute가 아닌 경우, false가 리턴됩니다 .

디폴트에서는 값이 배열인 경우를 제외해, Object.equals()를 사용해 속성 ID 및 속성의 값을 비교합니다. 배열의 경우, Object.equals()를 사용해 배열의 각 요소가 확인됩니다. 서브 클래스는 Object.equals()를 오버라이드(override) 해, schema 구문 정보 및 2개의 속성에 있어 동일이 무엇을의미하는지를 정의하는 일치 규칙을 사용할 수 있습니다. 서브 클래스가 schema 정보를 사용할지 어떨지, 또 어떻게 사용할까는 서브 클래스가 결정됩니다. 서브 클래스가 equals()를 오버라이드(override) 했을 경우, 서브 클래스는 hashCode()도 오버라이드(override) 해, 동일한 2개의 속성이 같은 해시 코드를 가지도록 합니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - null 가능성이 있는 체크 대상 객체

반환값:

obj가 이 속성과 동일한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

hashCode(), contains(java.lang.Object)

hashCode

public int hashCode()

이 속성의 해시 코드를 계산합니다.

해시 코드는 속성의 ID 해시 코드 및 값이 배열인 경우를 제외한 속성의 값 모든 해시 코드를 가산하는 것에 의해 계산됩니다. 배열의 경우는 배열의 각 요소의 해시 코드가 합계됩니다. 서브 클래스가 hashCode()를 오버라이드(override) 했을 경우, 서브 클래스는 equals()도 똑같이 오버라이드(override) 해, 동일한 2개의 속성이 같은 해시 코드를 가지도록 합니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

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

관련 항목:

equals(java.lang.Object)

toString

public String  toString()

이 속성의 캐릭터 라인 표기를 생성합니다. 캐릭터 라인은 속성의 ID 및 속성의 값으로부터 구성됩니다. 이 캐릭터 라인은 디버그용으로 사용됩니다만, 프로그램에 의해 해석될 것은 없습니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 속성의 null 이외의 캐릭터 라인 표현

getAll

public NamingEnumeration <? > getAll()
                            throws NamingException 

이 속성의 값의 열거를 검출합니다.

디폴트에서는 반환값은 생성자에게 건네진 값, 또는 추가 치환 삭제 메서드를 사용해 처리된 값, 혹은 그 양쪽 모두입니다. 서브 클래스는 이 값을 오버라이드(override) 해, 디렉토리로부터 직접치를 검출할 수 있습니다.

정의:

인터페이스 Attribute 내의 getAll

반환값:

속성값의 null 이외의 열거. 열거의 각 요소는 null 객체의 가능성이 있다. 객체의 클래스는 속성값의 클래스이다. 속성값이 null인 경우는 요소는 null이 된다. 속성에 제로값이 포함되는 경우는 비어있는 열거가 리턴된다

예외:

NamingException - 치를 바쁜와 중에 네이밍 예외가 발생했을 경우

관련 항목:

Attribute.isOrdered()

get

public Object  get()
           throws NamingException 

이 속성의 값의 1개를 검출합니다.

디폴트에서는 반환값은 생성자에게 건네진 값, 또는 추가 치환 삭제 메서드를 사용해 처리된 값, 혹은 그 양쪽 모두 가운데 1개 입니다. 서브 클래스는 이 값을 오버라이드(override) 해, 디렉토리로부터 직접치를 검출할 수 있습니다.

정의:

인터페이스 Attribute 내의 get

반환값:

null 가능성이 있는 속성값의 1개를 나타내는 객체. 속성값이 null인 경우는 null

예외:

NamingException - 치의 취득중에 네이밍 예외가 발생했을 경우

size

public int size()

인터페이스 Attribute 기술:

이 속성의 크기를 꺼냅니다.

정의:

인터페이스 Attribute 내의 size

반환값:

이 속성의 부가 아닌 크기

getID

public String  getID()

인터페이스 Attribute 기술:

이 속성의 ID를 꺼냅니다.

정의:

인터페이스 Attribute 내의 getID

반환값:

이 속성의 ID. null은 불가

contains

public boolean contains(Object  attrVal)

값이 이 속성에 있을지 어떨지를 판정합니다.

디폴트에서는 Object.equals()는 attrVal가 배열인 경우를 제외해 attrVal를 이 속성값와 비교할 때에 사용됩니다. 배열의 경우, Object.equals()를 사용해 배열의 각 요소가 확인됩니다. 서브 클래스가 schema 정보를 사용해 동일성을 판정하는 경우가 있습니다.

정의:

인터페이스 Attribute 내의 contains

파라미터:

attrVal - null 가능성이 있다, 확인 대상의 값. null인 경우는 속성에 값이 null 속성값이 포함되어 있는지 확인한다

반환값:

attrVal가 이 속성값의 1개 인 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.equals(java.lang.Object), equals(java.lang.Object)

add

public boolean add(Object  attrVal)

이 속성에 새로운 값을 추가합니다.

디폴트에서는 Object.equals()는 attrVal가 배열인 경우를 제외해 attrVal를 이 속성값와 비교할 때에 사용됩니다. 배열의 경우, Object.equals()를 사용해 배열의 각 요소가 확인됩니다. 서브 클래스가 schema 정보를 사용해 동일성을 판정하는 경우가 있습니다.

정의:

인터페이스 Attribute 내의 add

파라미터:

attrVal - null 가능성이 있는 추가하는 새로운 값. null인 경우, null이 속성값으로 추가된다

반환값:

값이 추가되었을 경우는 true, 그렇지 않은 경우는 false

remove

public boolean remove(Object  attrval)

지정된 값을 이 속성으로부터 삭제합니다.

디폴트에서는 Object.equals()는 attrVal가 배열인 경우를 제외해 attrVal를 이 속성값와 비교할 때에 사용됩니다. 배열의 경우, Object.equals()를 사용해 배열의 각 요소가 확인됩니다. 서브 클래스가 schema 정보를 사용해 동일성을 판정하는 경우가 있습니다.

정의:

인터페이스 Attribute 내의 remove

파라미터:

attrval - null 가능성이 있는 이 속성으로부터 삭제하는 값. null인 경우, null 속성값이 삭제된다

반환값:

값이 삭제되었을 경우는 true, 그렇지 않은 경우는 false

clear

public void clear()

인터페이스 Attribute 기술:

이 속성으로부터 모든 값을 삭제합니다.

정의:

인터페이스 Attribute 내의 clear

isOrdered

public boolean isOrdered()

인터페이스 Attribute 기술:

속성값이 순서부등이라고 있을지 어떨지를 판별합니다. 속성값이 순서부등이라고 있는 경우는 복제값이 허가됩니다. 속성값이 순서부등이라고 없는 경우는 값은 임의의 순서로 표시되어 복제치는 없습니다.

정의:

인터페이스 Attribute 내의 isOrdered

반환값:

이 속성값이 순서 붙일 수 있는인 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Attribute.get(int), Attribute.remove(int), Attribute.add(int, java.lang.Object), Attribute.set(int, java.lang.Object)

get

public Object  get(int ix)
           throws NamingException 

인터페이스 Attribute 기술:

속성값의 순서를 갖는 리스트로부터 속성값을 꺼냅니다. 이 메서드는 속성값의 리스트의 ix 인덱스에 있는 값을 리턴합니다. 속성값이 순서 붙일 수 있지 않은 경우, 이 메서드는 그 인덱스의 위치에 있는 값을 리턴합니다.

정의:

인터페이스 Attribute 내의 get

파라미터:

ix - 속성값의 순서를 갖는 리스트의 값의 인덱스. 0 <= ix < size()

반환값:

null 가능성이 있는 인덱스 ix에 있는 속성값. 속성값이 null인 경우는 null

예외:

NamingException - 치의 취득중에 네이밍 예외가 발생했을 경우

remove

public Object  remove(int ix)

인터페이스 Attribute 기술:

속성값의 순서를 갖는 리스트로부터 속성값을 삭제합니다. 이 메서드는 속성값의 리스트의 ix 인덱스에 있는 값을 삭제합니다. 속성값이 순서 붙일 수 있지 않은 경우는 이 메서드는 그 인덱스에 있던 값을 삭제합니다. ix 보다 큰 인덱스에 있는 값은 리스트의 전면 방향으로 위에 쉬프트 되어 그 인덱스는 1개 씩 줄여집니다.

정의:

인터페이스 Attribute 내의 remove

파라미터:

ix - 삭제하는 값의 인덱스. 0 <= ix < size()

반환값:

null 가능성이 있는 삭제한 인덱스 ix에 있는 속성값. 속성값이 null인 경우는 null

add

public void add(int ix,
                Object  attrVal)

인터페이스 Attribute 기술:

속성값을 속성값의 순서를 갖는 리스트에 추가합니다. 이 메서드는 인덱스 ix에 있는 속성값의 리스트에 attrVal를 추가합니다. ix 이상의 인덱스에 있는 값은 리스트의 말미 방향으로 아래에 쉬프트 되어 그 인덱스는 1개 씩 늘려집니다. 속성값이 순서 붙일 수 있지 않고 attrVal가 이미 존재하는 경우는 IllegalStateException 이 발생 됩니다.

정의:

인터페이스 Attribute 내의 add

파라미터:

ix - 새로운 값을 추가하는 속성값의 순서를 갖는 리스트의 인덱스. 0 <= ix <= size()

attrVal - null 가능성이 있는 추가하는 새로운 값. null인 경우, null이 값으로 해서 추가된다

set

public Object  set(int ix,
                  Object  attrVal)

인터페이스 Attribute 기술:

속성값의 순서를 갖는 리스트의 속성값을 설정합니다. 이 메서드는 속성값의 리스트의 ix 인덱스에 있는 값이 attrVal가 되도록 설정합니다. 낡은 값은 삭제됩니다. 이 속성값이 순서 붙일 수 있지 않은 경우는 attrVal가 값의 1개가 아닌 경우에 한정해, 이 메서드는 그 인덱스에 있던 값을 attrVal로 설정합니다. attrVal가 이미 존재하는 경우는 IllegalStateException이 발생 됩니다.

정의:

인터페이스 Attribute 내의 set

파라미터:

ix - 속성값의 순서를 갖는 리스트의 값의 인덱스. 0 <= ix < size()

attrVal - null 가능성이 있는 사용하는 속성값. null인 경우, 낡은 값이 null에 변환된다

반환값:

null 가능성이 있는 치환된 인덱스 ix에 있는 속성값. 속성값이 null인 경우는 null

getAttributeSyntaxDefinition

public DirContext  getAttributeSyntaxDefinition()
                                        throws NamingException 

이 속성에 관련된 구문의 정의를 검색합니다.

이 메서드는 디폴트에서는 OperationNotSupportedException을 Throw 합니다. 서브 클래스가 schema를 지원하는인 경우, 서브 클래스가 이 메서드를 오버라이드(override) 합니다.

정의:

인터페이스 Attribute 내의 getAttributeSyntaxDefinition

반환값:

속성의 구문 정의. 구현이 schema를 지원 해도, 이 특정의 속성에 schema 정보가 포함되지 않은 경우는 null

예외:

OperationNotSupportedException - schema의 취득이 지원 되어 있지 않은 경우

NamingException - schema의 취득중에 네이밍 예외가 발생했을 경우

getAttributeDefinition

public DirContext  getAttributeDefinition()
                                  throws NamingException 

이 속성의 schema 정의를 검출합니다.

이 메서드는 디폴트에서는 OperationNotSupportedException을 Throw 합니다. 서브 클래스가 schema를 지원하는인 경우, 서브 클래스가 이 메서드를 오버라이드(override) 합니다.

정의:

인터페이스 Attribute 내의 getAttributeDefinition

반환값:

이 속성의 schema 정의. 구현이 schema를 지원 해도, 이 특정의 속성에 schema 정보가 포함되지 않은 경우는 null

예외:

OperationNotSupportedException - schema의 취득이 지원 되어 있지 않은 경우

NamingException - schema의 취득중에 네이밍 예외가 발생했을 경우