javax.naming.directory
인터페이스 Attributes

모든 슈퍼 인터페이스:

Cloneable , Serializable

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

BasicAttributes

public interface Attributes

extends Cloneable , Serializable

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

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

Attributes 인터페이스를 구현하는 1 개의 오브젝트에 포함되는 속성은 순서 붙일 수 있고 있지 않습니다. 오브젝트에는 제로 이상의 속성을 포함할 수가 있습니다. 속성은 대문자와 소문자를 구별하는 경우와 구별하지 않는 경우가 있습니다. 이 프로퍼티는 Attributes 오브젝트가 작성되는 시점에서 결정됩니다 (예에 대해서는 「BasicAttributes constructor 」을 참조). 대문자와 소문자를 구별하지 않는 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	getAll () 속성 세트의 속성의 열거를 꺼냅니다.
NamingEnumeration	getIDs () 속성 세트의 속성 ID 의 열거를 꺼냅니다.
boolean	isCaseIgnored () 속성의 수중에 넣어 또는 추가를 하고 있을 때, 속성 세트가 속성 식별자의 대문자와 소문자를 무시할지 어떨지를 판별합니다.
Attribute	put (Attribute attr) 속성 세트에 새로운 속성을 추가합니다.
Attribute	put (String attrID, Object val) 속성 세트에 새로운 속성을 추가합니다.
Attribute	remove (String attrID) 속성 세트로부터 속성 ID 「attrID」를 가지는 속성을 삭제합니다.
int	size () 속성 세트의 속성수를 수중에 넣습니다.

메소드의 상세

isCaseIgnored

public boolean isCaseIgnored()

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

반환값:

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

size

public int size()

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

반환값:

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

get

public Attribute  get(String  attrID)

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

파라미터:

attrID - 취득하는 속성의 null 이외의 ID. 이 속성 세트가 속성 ID 의 대문자와 소문자를 무시하는 경우, attrID 의 대문자와 소문자는 무시된다

반환값:

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

관련 항목:

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

getAll

public NamingEnumeration  getAll()

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

반환값:

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

getIDs

public NamingEnumeration  getIDs()

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

반환값:

이 속성 세트의 속성 ID 의 null 이외의 열거. 열거의 각 요소는 클래스 String 가 된다. 속성 세트에 제로 속성이 있는 경우, 하늘의 열거가 돌려주어진다

put

public Attribute  put(String  attrID,
                     Object  val)

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

파라미터:

attrID - 추가하는 속성의 null 이외의 ID. 속성 세트가 속성 ID 의 대문자와 소문자를 무시하는 경우, attrID 의 대문자와 소문자는 무시되는

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

반환값:

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

관련 항목:

remove(java.lang.String)

put

public Attribute  put(Attribute  attr)

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

파라미터:

attr - 추가하는 null 이외의 속성. 속성 세트가 속성 ID 의 대문자와 소문자를 무시하는 경우, attrID 의 대문자와 소문자는 무시된다

반환값:

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

관련 항목:

remove(java.lang.String)

remove

public Attribute  remove(String  attrID)

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

파라미터:

attrID - 삭제하는 속성의 null 이외의 ID. 이 속성 세트가 속성 ID 의 대문자와 소문자를 무시하는 경우, attrID 의 대문자와 소문자는 무시된다

반환값:

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

clone

public Object  clone()

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

반환값:

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