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 및 val 에 의해 지정된 속성이, 새롭게 작성된 속성에 추가됩니다. 이후 속성을 검색 또는 추가할 때에, 속성 식별자의 대문자와 소문자는 구별됩니다.

파라미터:

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 의 대문자와 소문자를 구별하지 않는다 경우, attrID 의 대문자와 소문자는 구별되지 않는

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 개 이상 (객체가 돌려주기 전에) 변경하는 것이 필요하게 되는 경우가 있습니다. 이것은, 일반적으로, 복제하는 객체의 내부 「심층 구조」를 구성하는 가변 객체의 카피, 및 이러한 객체에의 참조를 카피에의 참조에 옮겨놓는 것을 의미합니다. 클래스에 프리미티브(primitive) 필드 또는 불변 객체에의 참조만이 포함되는 경우, 일반적으로,super.clone 에 의해 반환되는 객체내의 필드를 변경할 필요는 없습니다.

Object 클래스의 clone 메소드는, 특정의 복제 처리를 실행합니다. 우선, 이 객체의 클래스가 Cloneable 인터페이스를 구현하고 있지 않는 경우는,CloneNotSupportedException 가 throw 됩니다. 배열은 모두, 인터페이스 Cloneable 를 구현하고 있는 것이라고 보여지는 것에 주의해 주세요. 구현하고 있지 않는 경우, 이 메소드는 이 객체의 클래스의 새로운 인스턴스를 생성해, 그 필드를 모두, 이 객체의 대응하는 각 필드의 내용으로 초기화합니다. 이것은 대입과 같아, 필드의 내용 자신이 복제되는 것은 아닙니다. 즉 이 메소드는, 객체의 「shallow 복사」를 생성합니다만, 「딥 카피」는 생성하지 않습니다.

Object 클래스 자체는,Cloneable 인터페이스를 구현하지 않기 때문에, 클래스가 Object 인 clone 메소드를 호출하면(자), 실행시에 예외가 throw 됩니다.

정의:

인터페이스 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 가 된다. 속성 세트에 제로 속성이 있는 경우, 빈 상태(empty)의 열거가 반환된다

getIDs

public NamingEnumeration <String > getIDs()

인터페이스 Attributes 의 기술:

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

정의:

인터페이스 Attributes 내의 getIDs

반환값:

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

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 의 대문자와 소문자를 구별하지 않는다 경우, attr 의 ID 의 대문자와 소문자는 구별되지 않는다

반환값:

이 속성 세트에 이전 존재하고 있던 같은 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 와 같은 ID 를 가지는 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 의 각 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)