org.xml.sax.helpers
클래스 AttributesImpl

java.lang.Object 
  |
  +--org.xml.sax.helpers.AttributesImpl

모든 구현 인터페이스:

Attributes

public class AttributesImpl

extends Object

implements Attributes

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

이 모듈은 원시 코드, 문서 모두 공개 도메인에 놓여져 있습니다. 따라서, 내용에 관한프로텍션은 일절 제공되지 않습니다.

이 클래스는 리스트의 변경이나 재이용을 가능하게 하기 위한(해), 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 오브젝트를 카피합니다.

이 constructor 은 특히 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 - 지정된 인덱스가 리스트내의 속성을 포인트 하지 않는 경우