javax.naming.directory
인터페이스 Attributes

모든 슈퍼 인터페이스:

Cloneable , Serializable

기존의 구현 클래스의 일람:

BasicAttributes

public interface Attributes
extends Cloneable , Serializable 

이 인터페이스는 속성의 컬렉션을 나타냅니다.

디렉토리에서는, 지정된 객체는 그러한 속성과 관련지을 수가 있습니다. Attributes 인터페이스는 속성의 컬렉션을 나타냅니다. 예를 들어, 1 개의 객체에 관련지을 수 있었던 복수의 속성을 디렉토리에 요구할 수 있습니다. 그러한 속성은, Attributes 인터페이스를 구현하는 1 개의 객체로 돌려주어집니다.

Attributes 인터페이스를 구현하는 1 개의 객체에 포함되는 속성은 순서 붙일 수 있고 있지 않습니다. 객체에는 제로 이상의 속성을 포함할 수가 있습니다. 속성은 대문자와 소문자를 구별하는 경우와 구별하지 않는 경우가 있습니다. 이 프로퍼티은, Attributes 객체가 작성된 시점에서 결정됩니다 (예를 들어, BasicAttributes 생성자 을 참조해 주세요). 대문자와 소문자를 구별하지 않는 Attributes 에서는, 속성을 검색하는 경우나 속성을 추가하는 경우에 속성 식별자의 대문자와 소문자는 무시됩니다. 대문자와 소문자를 구별하는 Attributes 에서는, 대문자와 소문자의 구별은 중요합니다.

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

도입된 버젼:

1.3

관련 항목:

DirContext.getAttributes(javax.naming.Name) , DirContext.modifyAttributes(javax.naming.Name, int, javax.naming.directory.Attributes) , DirContext.bind(javax.naming.Name, java.lang.Object, javax.naming.directory.Attributes) , DirContext.rebind(javax.naming.Name, java.lang.Object, javax.naming.directory.Attributes) , DirContext.createSubcontext(javax.naming.Name, javax.naming.directory.Attributes) , DirContext.search(javax.naming.Name, javax.naming.directory.Attributes, java.lang.String[]) , BasicAttributes

메소드의 개요

Object	clone () 속성 세트의 카피를 작성합니다.
Attribute	get (String attrID) 속성 세트로부터, 지정된 속성 ID 를 가지는 속성을 수중에 넣습니다.
NamingEnumeration <? extends Attribute >	getAll () 속성 세트의 속성의 열거를 꺼냅니다.
NamingEnumeration <String >	getIDs () 속성 세트의 속성 ID 의 열거를 꺼냅니다.
boolean	isCaseIgnored () 속성의 수중에 넣어 또는 추가를 하고 있을 때, 속성 세트가 속성 식별자의 대문자와 소문자를 무시할지 어떨지를 판별합니다.
Attribute	put (Attribute attr) 속성 세트에 새로운 속성을 추가합니다.
Attribute	put (String attrID, Object val) 속성 세트에 새로운 속성을 추가합니다.
Attribute	remove (String attrID) 속성 세트로부터 속성 ID 「attrID」를 가지는 속성을 삭제합니다.
int	size () 속성 세트의 속성수를 수중에 넣습니다.

메소드의 상세

isCaseIgnored

boolean isCaseIgnored()

속성의 수중에 넣어 또는 추가를 하고 있을 때, 속성 세트가 속성 식별자의 대문자와 소문자를 무시할지 어떨지를 판별합니다.

반환값:

대문자와 소문자가 무시되는 경우는 true, 그렇지 않은 경우는 false

size

int size()

속성 세트의 속성수를 수중에 넣습니다.

반환값:

이 속성 세트의 부가 아닌 속성수

get

Attribute  get(String  attrID)

속성 세트로부터, 지정된 속성 ID 를 가지는 속성을 수중에 넣습니다.

파라미터:

attrID - 취득하는 속성의 null 이외의 ID. 이 속성 세트가 속성 ID 의 대문자와 소문자를 구별하지 않는다 경우, attrID 의 대문자와 소문자는 구별되지 않는다

반환값:

attrID 로 식별되는 속성. 검출되지 않는 경우는 null

관련 항목:

put(java.lang.String, java.lang.Object) , remove(java.lang.String)

getAll

NamingEnumeration <?  extends Attribute > getAll()

속성 세트의 속성의 열거를 꺼냅니다. 이 열거로 이 속성 세트를 변경했을 경우의 효과는 정의되고 있지 않습니다.

반환값:

이 속성 세트내의 null 이외의 속성의 열거. 이 열거의 각 요소는, 클래스 Attribute 가 된다. 속성 세트에 제로 속성이 있는 경우, 빈 상태(empty)의 열거가 반환된다

getIDs

NamingEnumeration <String > getIDs()

속성 세트의 속성 ID 의 열거를 꺼냅니다. 이 열거로 이 속성 세트를 변경했을 경우의 효과는 정의되고 있지 않습니다.

반환값:

이 속성 세트의 속성 ID 의 null 이외의 열거. 열거된 각 요소의 클래스는 String 속성 세트에 제로 속성이 있는 경우, 빈 상태(empty)의 열거가 반환된다

put

Attribute  put(String  attrID,
              Object  val)

속성 세트에 새로운 속성을 추가합니다.

파라미터:

attrID - 추가하는 속성의 null 이외의 ID 속성 세트가 속성 ID 의 대문자와 소문자를 구별하지 않는다 경우, attrID 의 대문자와 소문자는 구별되지 않는

val - null 의 가능성이 있는, 추가하는 속성의 값. null 의 경우는, 속성에 값은 포함되지 않는다

반환값:

이 속성 세트에 이전 존재하고 있던 attrID 를 가지는 Attribute. 그러한 속성이 존재하지 않았던 경우는 null

관련 항목:

remove(java.lang.String)

put

Attribute  put(Attribute  attr)

속성 세트에 새로운 속성을 추가합니다.

파라미터:

attr - 추가하는 null 이외의 속성 속성 세트가 속성 ID 의 대문자와 소문자를 구별하지 않는다 경우, attr 의 ID 의 대문자와 소문자는 구별되지 않는다

반환값:

이 속성 세트에 이전 존재하고 있던 같은 attrID 를 가지는 Attribute 그러한 속성이 존재하지 않았던 경우는 null

관련 항목:

remove(java.lang.String)

remove

Attribute  remove(String  attrID)

속성 세트로부터 속성 ID 「attrID」를 가지는 속성을 삭제합니다. 이 속성이 존재하지 않는 경우는, 무시됩니다.

파라미터:

attrID - 삭제하는 속성의 null 이외의 ID. 속성 세트가 속성 ID 의 대문자와 소문자를 구별하지 않는다 경우, attrID 의 대문자와 소문자는 구별되지 않는다

반환값:

이 속성 세트에 이전 존재하고 있던 attrID 와 같은 ID 를 가지는 Attribute 그러한 속성이 존재하지 않았던 경우는 null

clone

Object  clone()

속성 세트의 카피를 작성합니다. 새로운 세트에는, 원세트와 같은 속성이 포함됩니다. 이 속성 자체는 복제되지 않습니다. 카피로 변경을 더해도 원의 속성에는 영향 없습니다. 또 역의 경우도 같습니다.

반환값:

이 속성 세트의 null 이외의 카피