javax.naming.directory
클래스 BasicAttribute

java.lang.Object 
  |
  +--javax.naming.directory.BasicAttribute

모든 구현 인터페이스:

Attribute , Cloneable , Serializable

public class BasicAttribute

extends Object

implements Attribute

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

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

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

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

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

도입된 버젼:

1.3

관련 항목:

직렬화 된 형식

필드의 개요

protected String	attrID 속성의 ID 를 보관 유지합니다.
protected boolean	ordered 이 속성의 값이 순서 붙이고 될지 어떨지를 기록하는 플래그입니다.
protected Vector	values 속성의 값을 보관 유지합니다.

인터페이스 javax.naming.directory. Attribute 에서 상속받은 필드

serialVersionUID

생성자의 개요

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 constructor 에 의해 초기화되어 attrID 를 사용하고 있는 BasicAttribute 의 메소드가 오버라이드(override)되어 있지 않은 한, null 로 할 수 없습니다.

values

protected transient Vector  values

속성의 값을 보관 유지합니다. public constructor 에 의해 초기화됩니다. 값을 사용하는 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()

인터페이스 Attribute 의 기술:

속성의 카피를 작성합니다. 카피에는 원의 속성과 같은 속성치가 포함됩니다. 속성치 그 자체는 복제되지 않습니다. 카피로 변경을 더해도 원의 속성에는 영향 없습니다. 또 역의 경우도 같습니다.

정의:

인터페이스 Attribute 내의 clone

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 속성의 null 이외의 카피

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 

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

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

정의:

인터페이스 Attribute 내의 getAll

반환값:

속성치의 null 이외의 열거. 열거의 각 요소는 null 오브젝트의 가능성이 있다. 오브젝트의 클래스는 속성치의 클래스이다. 속성치가 null 의 경우는 요소는 null 가 된다. 속성에 제로치가 포함되는 경우는 하늘의 열거가 돌려주어진다

예외:

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

관련 항목:

Attribute.isOrdered()

get

public Object  get()
           throws NamingException 

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

디폴트에서는 반환값은 constructor로 건네진 값, 또는 추가 치환 삭제 메소드를 사용해 처리된 값, 혹은 그 양쪽 모두 가운데 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 를 슬로우 합니다. 서브 클래스가 schema를 서포트하는 경우, 서브 클래스가 이 메소드를 오버라이드(override) 합니다.

정의:

인터페이스 Attribute 내의 getAttributeSyntaxDefinition

반환값:

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

예외:

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

getAttributeDefinition

public DirContext  getAttributeDefinition()
                                  throws NamingException 

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

이 메소드는 디폴트에서는 OperationNotSupportedException 를 슬로우 합니다. 서브 클래스가 schema를 서포트하는 경우, 서브 클래스가 이 메소드를 오버라이드(override) 합니다.

정의:

인터페이스 Attribute 내의 getAttributeDefinition

반환값:

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

예외:

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