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가 된다. 속성 세트에 제로 속성이 포함되어 있는 경우는 비어있는 열거가 리턴된다

getIDs

NamingEnumeration <String > getIDs()

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

반환값:

이 속성 세트의 속성 ID null 이외의 열거. 열거의 각 요소는 클래스 String가 된다. 속성 세트에 제로 속성이 있는 경우, 비어있는 열거가 리턴된다

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 대문자와 소문자를 무시하는 경우, attrID 대문자와 소문자는 무시된다

반환값:

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

관련 항목:

remove(java.lang.String)

remove

Attribute  remove(String  attrID)

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

파라미터:

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

반환값:

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

clone

Object  clone()

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

반환값:

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