javax.naming.directory
클래스 BasicAttributes

java.lang.Object 
  javax.naming.directory.BasicAttributes

모든 구현된 인터페이스:

Serializable, Cloneable, Attributes

public class BasicAttributes
extends Object 
implements Attributes 

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

BasicAttributes는 대문자와 소문자의 구별있음으로 대문자와 소문자의 구별 없음의 어딘가에 됩니다. 이 프로퍼티는 BasicAttributes 생성자가 불려 간 시점에서 결정됩니다. 대문자와 소문자의 구별을 하지 않는 BasicAttributes인 경우는 속성의 검색 또는 속성의 추가 시에 속성 식별자의 대문자와 소문자는 구별되지 않습니다. 대문자와 소문자의 구별을 하는 BasicAttributes인 경우는 대문자와 소문자는 구별됩니다.

BasicAttributes 클래스가 Attribute를 작성할 필요가 있는 경우, BasicAttribute를 사용합니다. BasicAttribute 에 존하고 있는 것은 그 밖에 없습니다.

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

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

도입된 버전 :

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 ()
Attributes 인스턴스를 새롭게 구축합니다.

BasicAttributes (boolean ignoreCase)
Attributes 인스턴스를 새롭게 구축합니다.

BasicAttributes (String attrID, Object val)
Attributes 인스턴스를 1개의 속성으로 새롭게 구축합니다.

BasicAttributes (String attrID, Object val, boolean ignoreCase)
Attributes 인스턴스를 1개의 속성으로 새롭게 구축합니다.

메서드 개요

Object	clone () 이 객체의 복사본을 작성해 리턴합니다.
boolean	equals (Object obj) 이 BasicAttributes가 다른 Attributes와 동일한지 어떤지를 판별합니다.
Attribute	get (String attrID) 속성 세트로부터, 지정된 속성 ID를 가지는 속성을 수중에 넣습니다.
NamingEnumeration <Attribute >	getAll () 속성 세트의 속성의 열거를 꺼냅니다.
NamingEnumeration <String >	getIDs () 속성 세트의 속성 ID 열거를 꺼냅니다.
int	hashCode () 이 BasicAttributes 해시 코드를 계산합니다.
boolean	isCaseIgnored () 속성의 수중에 넣어 또는 추가를 하고 있을 때, 속성 세트가 속성 식별자의 대문자와 소문자를 무시할지 어떨지를 판별합니다.
Attribute	put (Attribute attr) 속성 세트에 새로운 속성을 추가합니다.
Attribute	put (String attrID, Object val) 속성 세트에 새로운 속성을 추가합니다.
Attribute	remove (String attrID) 속성 세트로부터 속성 ID 「attrID」를 가지는 속성을 삭제합니다.
int	size () 속성 세트의 속성수를 수중에 넣습니다.
String	toString () 이 속성 세트의 캐릭터 라인 표기를 생성합니다.

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

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

생성자 상세

BasicAttributes

public BasicAttributes()

Attributes 인스턴스를 새롭게 구축합니다. 이후 속성을 검색 또는 추가할 때에 속성 식별자를 대문자로 할까 소문자로 할까는 중요합니다.

BasicAttributes

public BasicAttributes(boolean ignoreCase)

Attributes 인스턴스를 새롭게 구축합니다. ignoreCase가 true인 경우, 속성 식별자의 대문자와 소문자는 구별되지 않습니다. 그렇지 않은 경우는 대문자로 할까 소문자로 할까는 중요합니다.

파라미터:

ignoreCase - 속성을 검색 또는 추가할 때에 이 속성 세트가 속성 식별자의 대문자와 소문자를 구별하지 않는 경우는 true, 그렇지 않은 경우는 false

BasicAttributes

public BasicAttributes(String  attrID,
                       Object  val)

Attributes 인스턴스를 1개의 속성으로 새롭게 구축합니다. 속성 ID 및 값에 의해 지정된 속성이, 새롭게 작성된 속성에 추가됩니다. 이후 속성을 검색 또는 추가할 때에 속성 식별자의 대문자와 소문자는 구별됩니다.

파라미터:

attrID - 추가하는 속성의 null 이외의 ID

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

BasicAttributes

public BasicAttributes(String  attrID,
                       Object  val,
                       boolean ignoreCase)

Attributes 인스턴스를 1개의 속성으로 새롭게 구축합니다. 속성 ID 및 val에 의해 지정된 속성이, 새롭게 작성된 속성에 추가됩니다. ignoreCase가 true인 경우, 속성 식별자의 대문자와 소문자는 구별되지 않습니다. 그 외의 경우, 대문자와 소문자는 구별됩니다.

파라미터:

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

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

ignoreCase - 속성을 검색 또는 추가할 때에 이 속성 세트가 속성 식별자의 대문자와 소문자를 구별하지 않는 경우는 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 메서드를 호출하면, 실행시에 예외가 발생 됩니다.

정의:

인터페이스 Attributes 내의 clone

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 인스턴스의 복제

관련 항목:

Cloneable

isCaseIgnored

public boolean isCaseIgnored()

인터페이스 Attributes 기술:

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

정의:

인터페이스 Attributes 내의 isCaseIgnored

반환값:

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

size

public int size()

인터페이스 Attributes 기술:

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

정의:

인터페이스 Attributes 내의 size

반환값:

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

get

public Attribute  get(String  attrID)

인터페이스 Attributes 기술:

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

정의:

인터페이스 Attributes 내의 get

파라미터:

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

반환값:

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

관련 항목:

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

getAll

public NamingEnumeration <Attribute > getAll()

인터페이스 Attributes 기술:

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

정의:

인터페이스 Attributes 내의 getAll

반환값:

이 속성 세트내의 null 이외의 속성의 열거. 이 열거의 각 요소는 클래스 Attribute가 된다. 속성 세트에 제로 속성이 포함되어 있는 경우는 비어있는 열거가 리턴된다

getIDs

public NamingEnumeration <String > getIDs()

인터페이스 Attributes 기술:

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

정의:

인터페이스 Attributes 내의 getIDs

반환값:

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

put

public Attribute  put(String  attrID,
                     Object  val)

인터페이스 Attributes 기술:

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

정의:

인터페이스 Attributes 내의 put

파라미터:

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

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

반환값:

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

관련 항목:

Attributes.remove(java.lang.String)

put

public Attribute  put(Attribute  attr)

인터페이스 Attributes 기술:

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

정의:

인터페이스 Attributes 내의 put

파라미터:

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

반환값:

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

관련 항목:

Attributes.remove(java.lang.String)

remove

public Attribute  remove(String  attrID)

인터페이스 Attributes 기술:

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

정의:

인터페이스 Attributes 내의 remove

파라미터:

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

반환값:

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

toString

public String  toString()

이 속성 세트의 캐릭터 라인 표기를 생성합니다. 캐릭터 라인은 각 속성 식별자 및 각 속성의 내용에 의해 구성됩니다. 이 캐릭터 라인의 내용은 디버그에 유효합니다만, 프로그램에 의해 해석될 것은 없습니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 속성 세트의 내용을 나타내는 null 이외의 캐릭터 라인 표기

equals

public boolean equals(Object  obj)

이 BasicAttributes가 다른 Attributes와 동일한지 어떤지를 판별합니다. 2개의 Attributes가 함께 Attributes 인스턴스이며, 속성 ID 대문자와 소문자를 같은 방법으로 취급해, 같은 속성을 포함한 경우, 이 2개의 Attributes는 동일합니다. 이 BasicAttributes 각 < tt>Attribute가 동일한가 어떤가는 Object.equals()를 사용해 판정됩니다. Object.equals()는 Attribute 구현에 의해 오버라이드(override) 되고 있는 일이 있습니다. 서브 클래스가 equals()를 오버라이드(override) 했을 경우, 서브 클래스는 hashCode()도 똑같이 오버라이드(override) 해, 동일한 Attributes 인스턴스가 같은 해시 코드를 가지도록 합니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - null 가능성이 있는 비교 대조 객체

반환값:

obj가 이 BasicAttributes와 동일한 경우는 true

관련 항목:

hashCode()

hashCode

public int hashCode()

이 BasicAttributes 해시 코드를 계산합니다.

해시 코드는 이 객체의 속성의 해시 코드를 가산하는 것에 의해 계산됩니다. 이 BasicAttributes가 속성 ID 대문자와 소문자를 구별하지 않는 경우는 해시 코드에 1 이 가산됩니다. 서브 클래스가 hashCode() 를 오버라이드(override) 했을 경우, 서브 클래스는 equals()도 똑같이 오버라이드(override) 해, 동일한 2개의 Attributes 인스턴스가 같은 해시 코드를 가지도록 합니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 BasicAttributes 인스턴스의 해시 코드를 나타내는 int

관련 항목:

equals(java.lang.Object)