org.xml.sax
인터페이스 Attributes

기존의 서브 인터페이스의 일람:

Attributes2

기존의 구현 클래스의 일람:

Attributes2Impl , AttributesImpl

public interface Attributes

XML 속성의 리스트를 위한 인터페이스입니다.

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

이 인터페이스는, 3 통과해 방법으로 속성 리스트에의 액세스를 제공합니다.

1. 속성 인덱스를 사용하는 방법
2. 이름 공간 수식명을 사용하는 방법
3. 전치수식자 첨부의 수식명을 사용하는 방법

#IMPLIED 라고 선언되고 있어도 개시 태그내로 지정되어 있지 않은 속성은, 리스트에는 포함되지 않습니다. 또, 이름 공간 선언 (xmlns*)으로서 사용되는 속성도,http://xml.org/sax/features/namespace-prefixes 기능의 값을 true 로 설정하지 않는 한 리스트에는 포함되지 않습니다 (디폴트 값는 false). SAX2 는 최초의 「Namespaces in XML」권고에 따르기 (위해)때문에, 일반적으로은 이름 공간 선언 속성에 이름 공간 URI 는 주어지지 않습니다.

SAX2 퍼서에 따라서는, 옵션으로 기능 플래그 (http://xml.org/sax/features/xmlns-uris)를 사용하도록(듯이) 지원해, SAX2 퍼서의 속성을 URI 에게 주도록(듯이) 요구해 하위 호환 할 수 없는 최초의 권고의 향후의 개정판에 맞추는 것도 있습니다. (디폴트에 의한 요소 이름 공간을 정의하는 경우의 속성의 「로컬명」은 접두사 또는 「xmls」). 호환성에 관해서는, 핸들러 코드가 기능 플래그의 설정을 변경할 수 있는 퍼서를 요구하는 것이 아니라, 항상 그 충돌을 해결하도록(듯이) 할 필요가 있습니다.

이름 공간 접두사의 기능 (전술을 참조)이 false 의 경우, 지정된 이름에 의해 액세스 할 수 없는 경우가 있습니다. http://xml.org/sax/features/namespaces 기능이 false 의 경우, 이름 공간 수식명에 의해 액세스 할 수 없는 경우가 있습니다.

이 인터페이스는 현재는 비추천으로 지정되고 있는 SAX1 AttributeList 인터페이스에 대신하는 인터페이스입니다. 이 인터페이스에는, SAX1 AttributeList 인터페이스에서는 지원되어 있지 않았던 이름 공간 기능외, 이하의 getIndex 메소드가 추가되고 있습니다.

리스트내의 속성의 순서는 미지정이며, 구현 마다 다릅니다.

도입된 버젼:

SAX 2.0

관련 항목:

AttributesImpl , DeclHandler.attributeDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String)

메소드의 개요

int	getIndex (String qName) XML 수식명 (접두사 첨부)을 지정해 속성의 인덱스를 검색합니다.
int	getIndex (String uri, String localName) 이름 공간명을 지정해 속성의 인덱스를 검색합니다.
int	getLength () 리스트내에 있는 속성의 수를 돌려줍니다.
String	getLocalName (int index) 인덱스를 지정해 속성의 로컬명을 검색합니다.
String	getQName (int index) 인덱스를 지정해 속성의 XML 수식명 (접두사 첨부)을 검색합니다.
String	getType (int index) 인덱스를 지정해 속성의 형태를 검색합니다.
String	getType (String qName) XML 수식명 (접두사 첨부)을 지정해 속성의 형태를 검색합니다.
String	getType (String uri, String localName) 이름 공간명을 지정해 속성의 형태를 검색합니다.
String	getURI (int index) 인덱스를 지정해 속성의 이름 공간 URI 를 검색합니다.
String	getValue (int index) 인덱스를 지정해 속성의 값을 검색합니다.
String	getValue (String qName) XML 수식명 (접두사 첨부)을 지정해 속성의 값을 검색합니다.
String	getValue (String uri, String localName) 이름 공간명을 지정해 속성의 값을 검색합니다.

메소드의 상세

getLength

int getLength()

리스트내에 있는 속성의 수를 돌려줍니다.

속성의 수가 특정되면(자), 이 리스트로 반복 처리를 실시할 수가 있습니다.

반환값:

리스트내의 속성의 수

관련 항목:

getURI(int) , getLocalName(int) , getQName(int) , getType(int) , getValue(int)

getURI

String  getURI(int index)

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

파라미터:

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

반환값:

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

관련 항목:

getLength()

getLocalName

String  getLocalName(int index)

인덱스를 지정해 속성의 로컬명을 검색합니다.

파라미터:

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

반환값:

로컬명. 이름 공간 처리가 실행되지 않는 경우는 공문자열. 인덱스가 범위외의 경우는 null

관련 항목:

getLength()

getQName

String  getQName(int index)

인덱스를 지정해 속성의 XML 수식명 (접두사 첨부)을 검색합니다.

파라미터:

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

반환값:

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

관련 항목:

getLength()

getType

String  getType(int index)

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

속성형은, 「CDATA」, 「ID」, 「IDREF」, 「IDREFS」, 「NMTOKEN」, 「NMTOKENS」, 「ENTITY」, 「ENTITIES」, 「NOTATION」의 어느쪽이든 1 개(살)이 됩니다 (항상 대문자를 사용).

퍼서가 속성의 선언을 읽어내지 않고, 속성형을 보고하지 않는 경우, XML 1.0 권고 (3.3. 3 「속성치의 정규화」)에 따라, 값 「CDATA」가 돌려주어집니다.

표기법 이외의 열거형 속성의 형태는 「NMTOKEN」라고 보고됩니다.

파라미터:

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

반환값:

속성형을 나타내는 캐릭터 라인. 인덱스가 범위외의 경우는 null

관련 항목:

getLength()

getValue

String  getValue(int index)

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

속성치가 IDREFS, ENTITIES, NMTOKENS 의 몇개의 토큰의 리스트인 경우, 토큰은 공백 문자로 단락지어진 단일의 캐릭터 라인에 연결됩니다.

파라미터:

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

반환값:

속성치를 나타내는 캐릭터 라인. 인덱스가 범위외의 경우는 null

관련 항목:

getLength()

getIndex

int getIndex(String  uri,
             String  localName)

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

파라미터:

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

localName - 속성의 로컬명

반환값:

속성 인덱스. 리스트내에 존재하지 않는 경우는 ? 1

getIndex

int getIndex(String  qName)

XML 수식명 (접두사 첨부)을 지정해 속성의 인덱스를 검색합니다.

파라미터:

qName - 전치수식자 첨부의 수식명

반환값:

속성 인덱스. 리스트내에 존재하지 않는 경우는 ? 1

getType

String  getType(String  uri,
               String  localName)

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

사용 가능한 형태에 대해서는,getType(int) 의 설명을 참조해 주세요.

파라미터:

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

localName - 속성의 로컬명

반환값:

속성형을 나타내는 캐릭터 라인. 속성이 리스트내에 존재하지 않는 경우, 또는 이름 공간 처리가 실행되지 않는 경우는 null

getType

String  getType(String  qName)

XML 수식명 (접두사 첨부)을 지정해 속성의 형태를 검색합니다.

사용 가능한 형태에 대해서는,getType(int) 의 설명을 참조해 주세요.

파라미터:

qName - XML 수식명

반환값:

속성형을 나타내는 캐릭터 라인. 속성이 리스트내에 존재하지 않는 경우, 또는 수식명을 사용할 수 없는 경우는 null

getValue

String  getValue(String  uri,
                String  localName)

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

사용 가능한 값에 대해서는,getValue(int) 의 설명을 참조해 주세요.

파라미터:

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

localName - 속성의 로컬명

반환값:

속성치를 나타내는 캐릭터 라인. 속성이 리스트내에 존재하지 않는 경우는 null

getValue

String  getValue(String  qName)

XML 수식명 (접두사 첨부)을 지정해 속성의 값을 검색합니다.

사용 가능한 값에 대해서는,getValue(int) 의 설명을 참조해 주세요.

파라미터:

qName - XML 수식명

반환값:

속성치를 나타내는 캐릭터 라인. 속성이 리스트내에 존재하지 않는 경우, 또는 수식명을 사용할 수 없는 경우는 null