org.xml.sax.helpers
클래스 AttributesImpl

java.lang.Object 
  org.xml.sax.helpers.AttributesImpl

모든 구현된 인터페이스:

Attributes

알려진 직계 서브 클래스:

Attributes2Impl

public class AttributesImpl
extends Object 
implements Attributes 

Attributes 인터페이스의 디폴트 구현입니다.

이 모듈은 원시 코드, 문서 모두 공개 도메인에 놓여져 있습니다. 따라서, 내용에 관한보증은 일절 제공되지 않습니다. 상세한 것에 대하여는 http://www.saxproject.org 를 참조하십시오.

이 클래스는 리스트의 변경이나 재이용을 가능하게 하기 위한, SAX2 Attributes 인터페이스의 디폴트 구현에 매니플레이터를 추가합니다.

이 클래스의 전형적인 용도는 아래의 2 종류입니다.

1. startElement 이벤트내의 Attributes 객체의 지속적인 snapshot를 작성한다
2. SAX2 드라이버 또는 필터내에서 Attributes 객체를 구축 또는 변경한다

이 클래스는 현재는비추천으로 가리키는 SAX1 AttributeListImpl 클래스에 대신하는 클래스입니다. 비추천 AttributeList 인터페이스가 아니고 갱신된 Attributes 인터페이스를 지원 합니다. 또, Vectors 세트 대신에 단일의 배열을 사용해보다 효율적인 구현을 제공합니다.

도입된 버전 :

SAX 2.0

생성자 개요

AttributesImpl ()
새로운 비어있는 AttributesImpl 객체를 작성합니다.

AttributesImpl (Attributes atts)
기존의 Attributes 객체를 카피합니다.

메서드 개요

void	addAttribute (String uri, String localName, String qName, String type, String value) 리스트의 말미에 속성을 추가합니다.
void	clear () 재이용하기 위해, 속성 리스트를 소거합니다.
int	getIndex (String qName) 수식명 (전크기식자 첨부)을 지정해 속성의 인덱스를 검색합니다.
int	getIndex (String uri, String localName) 이름 공간명을 지정해 속성의 인덱스를 검색합니다.
int	getLength () 리스트내에 있는 속성의 수를 리턴합니다.
String	getLocalName (int index) 속성의 로컬명을 리턴합니다.
String	getQName (int index) 속성의 수식명 (전크기식자 첨부)을 리턴합니다.
String	getType (int index) 인덱스를 지정해 속성의 형태를 리턴합니다.
String	getType (String qName) 수식명 (전크기식자 첨부)을 지정해 속성의 형태를 검색합니다.
String	getType (String uri, String localName) 이름 공간 수식명을 지정해 속성의 형태를 검색합니다.
String	getURI (int index) 속성의 이름 공간 URI를 리턴합니다.
String	getValue (int index) 인덱스를 지정해 속성의 값을 리턴합니다.
String	getValue (String qName) 수식명 (전크기식자 첨부)을 지정해 속성의 값을 검색합니다.
String	getValue (String uri, String localName) 이름 공간 수식명을 지정해 속성의 값을 검색합니다.
void	removeAttribute (int index) 리스트로부터 속성을 삭제합니다.
void	setAttribute (int index, String uri, String localName, String qName, String type, String value) 리스트내의 속성을 설정합니다.
void	setAttributes (Attributes atts) Attributes 객체 전체를 카피합니다.
void	setLocalName (int index, String localName) 특정의 속성의 로컬명을 설정합니다.
void	setQName (int index, String qName) 특정의 속성의 수식명을 설정합니다.
void	setType (int index, String type) 특정의 속성의 형태를 설정합니다.
void	setURI (int index, String uri) 특정의 속성의 이름 공간 URI를 설정합니다.
void	setValue (int index, String value) 특정의 속성의 값을 설정합니다.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

생성자 상세

AttributesImpl

public AttributesImpl()

새로운 비어있는 AttributesImpl 객체를 작성합니다.

AttributesImpl

public AttributesImpl(Attributes  atts)

기존의 Attributes 객체를 카피합니다.

이 생성자는 특히 startElement 이벤트내에서 도움이 됩니다.

파라미터:

atts - 기존의 Attributes 객체

메서드의 상세

getLength

public int getLength()

리스트내에 있는 속성의 수를 리턴합니다.

정의:

인터페이스 Attributes 내의 getLength

반환값:

리스트내의 속성의 수

관련 항목:

Attributes.getLength()

getURI

public String  getURI(int index)

속성의 이름 공간 URI를 리턴합니다.

정의:

인터페이스 Attributes 내의 getURI

파라미터:

index - 속성 인덱스 (제로로부터 시작된다)

반환값:

이름 공간 URI. 사용 가능한 이름 공간 URI가 존재하지 않는 경우는 공문자열. 인덱스가 범위외의 경우는 null

관련 항목:

Attributes.getURI(int)

getLocalName

public String  getLocalName(int index)

속성의 로컬명을 리턴합니다.

정의:

인터페이스 Attributes 내의 getLocalName

파라미터:

index - 속성 인덱스 (제로로부터 시작된다)

반환값:

속성의 로컬명. 사용 가능한 로컬명이 존재하지 않는 경우는 공문자열. 인덱스가 범위외의 경우는 null

관련 항목:

Attributes.getLocalName(int)

getQName

public String  getQName(int index)

속성의 수식명 (전크기식자 첨부)을 리턴합니다.

정의:

인터페이스 Attributes 내의 getQName

파라미터:

index - 속성 인덱스 (제로로부터 시작된다)

반환값:

속성의 수식명. 사용 가능한 수식명이 존재하지 않는 경우는 공문자열. 인덱스가 범위외의 경우는 null

관련 항목:

Attributes.getQName(int)

getType

public String  getType(int index)

인덱스를 지정해 속성의 형태를 리턴합니다.

정의:

인터페이스 Attributes 내의 getType

파라미터:

index - 속성 인덱스 (제로로부터 시작된다)

반환값:

속성의 형태. 불명한 경우는 「CDATA」, 인덱스가 범위외의 경우는 null

관련 항목:

Attributes.getType(int)

getValue

public String  getValue(int index)

인덱스를 지정해 속성의 값을 리턴합니다.

정의:

인터페이스 Attributes 내의 getValue

파라미터:

index - 속성 인덱스 (제로로부터 시작된다)

반환값:

속성값. 인덱스가 범위외의 경우는 null

관련 항목:

Attributes.getValue(int)

getIndex

public int getIndex(String  uri,
                    String  localName)

이름 공간명을 지정해 속성의 인덱스를 검색합니다.

일반적으로 이름의 조회 메서드를 반복해 사용하는 것보다도, 이름을 1회 만 검색해, 나머지는 인덱스 조회 메서드를 사용하는 편이 효율적입니다.

정의:

인터페이스 Attributes 내의 getIndex

파라미터:

uri - 속성의 이름 공간 URI. 사용 가능한 이름 공간이 존재하지 않는 경우는 공문자열

localName - 속성의 로컬명

반환값:

속성의 인덱스. 일치하는 것이 없는 경우는 -1

관련 항목:

Attributes.getIndex(java.lang.String, java.lang.String)

getIndex

public int getIndex(String  qName)

수식명 (전크기식자 첨부)을 지정해 속성의 인덱스를 검색합니다.

정의:

인터페이스 Attributes 내의 getIndex

파라미터:

qName - 수식명

반환값:

속성의 인덱스. 일치하는 것이 없는 경우는 -1

관련 항목:

Attributes.getIndex(java.lang.String)

getType

public String  getType(String  uri,
                      String  localName)

이름 공간 수식명을 지정해 속성의 형태를 검색합니다.

정의:

인터페이스 Attributes 내의 getType

파라미터:

uri - 이름 공간 URI. 이름이 명시적인 이름 공간 URI를 가지지 않는 경우는 공문자열

localName - 로컬명

반환값:

속성의 형태. 일치하는 속성이 존재하지 않는 경우는 null

관련 항목:

Attributes.getType(java.lang.String, java.lang.String)

getType

public String  getType(String  qName)

수식명 (전크기식자 첨부)을 지정해 속성의 형태를 검색합니다.

정의:

인터페이스 Attributes 내의 getType

파라미터:

qName - 수식명

반환값:

속성의 형태. 일치하는 속성이 존재하지 않는 경우는 null

관련 항목:

Attributes.getType(java.lang.String)

getValue

public String  getValue(String  uri,
                       String  localName)

이름 공간 수식명을 지정해 속성의 값을 검색합니다.

정의:

인터페이스 Attributes 내의 getValue

파라미터:

uri - 이름 공간 URI. 이름이 명시적인 이름 공간 URI를 가지지 않는 경우는 공문자열

localName - 로컬명

반환값:

속성값. 일치하는 속성이 존재하지 않는 경우는 null

관련 항목:

Attributes.getValue(java.lang.String, java.lang.String)

getValue

public String  getValue(String  qName)

수식명 (전크기식자 첨부)을 지정해 속성의 값을 검색합니다.

정의:

인터페이스 Attributes 내의 getValue

파라미터:

qName - 수식명

반환값:

속성값. 일치하는 속성이 존재하지 않는 경우는 null

관련 항목:

Attributes.getValue(java.lang.String)

clear

public void clear()

재이용하기 위해, 속성 리스트를 소거합니다.

이 호출에 의해 해방되는 메모리는 매우 불과입니다. 현재의 배열이 그대로 재이용됩니다.

setAttributes

public void setAttributes(Attributes  atts)

Attributes 객체 전체를 카피합니다.

항상 새로운 객체를 할당하는 것보다도, 기존의 객체를 재이용하는 편이 효율이 좋아질 가능성이 있습니다.

파라미터:

atts - 카피하는 속성

addAttribute

public void addAttribute(String  uri,
                         String  localName,
                         String  qName,
                         String  type,
                         String  value)

리스트의 말미에 속성을 추가합니다.

처리의 고속화를 위해, 이 메서드는 그 속성이 리스트내에 이미 존재할지 어떨지를 확인하지 않습니다. 이 확인 처리는 어플리케이션으로 실시할 필요가 있습니다.

파라미터:

uri - 이름 공간 URI. 사용 가능한 이름 공간 URI가 존재하지 않는 경우나, 이름 공간 처리가 실행되어 있지 않은 경우는 공문자열

localName - 로컬명. 이름 공간 처리를 하지 않은 경우는 공문자열

qName - 전크기식자를 가지는 수식명. 수식명을 사용할 수 없는 경우는 공문자열

type - 속성형을 나타내는 캐릭터 라인

value - 속성값

setAttribute

public void setAttribute(int index,
                         String  uri,
                         String  localName,
                         String  qName,
                         String  type,
                         String  value)

리스트내의 속성을 설정합니다.

처리의 고속화를 위해, 이 메서드는 이름이 경합 하지 않는지 어떤지, 올바른 형식일지 어떨지를 확인하지 않습니다. 이 확인 처리는 어플리케이션에 의해 실시할 필요가 있습니다.

파라미터:

index - 속성 인덱스 (제로로부터 시작된다)

uri - 이름 공간 URI. 사용 가능한 이름 공간 URI가 존재하지 않는 경우나, 이름 공간 처리가 실행되어 있지 않은 경우는 공문자열

localName - 로컬명. 이름 공간 처리를 하지 않은 경우는 공문자열

qName - 수식명. 수식명을 사용할 수 없는 경우는 공문자열

type - 속성형을 나타내는 캐릭터 라인

value - 속성값

예외:

ArrayIndexOutOfBoundsException - 지정된 인덱스가 리스트내의 속성을 포인트 하지 않는 경우

removeAttribute

public void removeAttribute(int index)

리스트로부터 속성을 삭제합니다.

파라미터:

index - 속성 인덱스 (제로로부터 시작된다)

예외:

ArrayIndexOutOfBoundsException - 지정된 인덱스가 리스트내의 속성을 포인트 하지 않는 경우

setURI

public void setURI(int index,
                   String  uri)

특정의 속성의 이름 공간 URI를 설정합니다.

파라미터:

index - 속성 인덱스 (제로로부터 시작된다)

uri - 속성의 이름 공간 URI. 사용 가능한 이름 공간이 존재하지 않는 경우는 공문자열

예외:

ArrayIndexOutOfBoundsException - 지정된 인덱스가 리스트내의 속성을 포인트 하지 않는 경우

setLocalName

public void setLocalName(int index,
                         String  localName)

특정의 속성의 로컬명을 설정합니다.

파라미터:

index - 속성 인덱스 (제로로부터 시작된다)

localName - 속성의 로컬명. 사용 가능한 로컬명이 존재하지 않는 경우는 공문자열

예외:

ArrayIndexOutOfBoundsException - 지정된 인덱스가 리스트내의 속성을 포인트 하지 않는 경우

setQName

public void setQName(int index,
                     String  qName)

특정의 속성의 수식명을 설정합니다.

파라미터:

index - 속성 인덱스 (제로로부터 시작된다)

qName - 속성의 수식명. 사용 가능한 수식명이 존재하지 않는 경우는 공문자열

예외:

ArrayIndexOutOfBoundsException - 지정된 인덱스가 리스트내의 속성을 포인트 하지 않는 경우

setType

public void setType(int index,
                    String  type)

특정의 속성의 형태를 설정합니다.

파라미터:

index - 속성 인덱스 (제로로부터 시작된다)

type - 속성의 형태

예외:

ArrayIndexOutOfBoundsException - 지정된 인덱스가 리스트내의 속성을 포인트 하지 않는 경우

setValue

public void setValue(int index,
                     String  value)

특정의 속성의 값을 설정합니다.

파라미터:

index - 속성 인덱스 (제로로부터 시작된다)

value - 속성의 값

예외:

ArrayIndexOutOfBoundsException - 지정된 인덱스가 리스트내의 속성을 포인트 하지 않는 경우