org.xml.sax
인터페이스 Attributes

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

AttributesImpl

public interface Attributes

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

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

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

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

#IMPLIED 라고 선언되고 있지만 개시 태그내로 지정되어 있지 않은 속성은 리스트에는 포함되지 않습니다. 또, 이름 공간 선언 (xmlns*)으로서 사용되는 속성도,http://xml.org/sax/features/namespace-prefixes 기능의 값을 true 로 설정하지 않는 한 리스트에는 포함되지 않습니다 (디폴트 값은 false).

이름 공간 수식 기능 (상기를 참조)이 false 로 설정되어 있는 경우, 수식명을 지정해 액세스 할 수 없습니다. http://xml.org/sax/features/namespaces 기능의 값이 false 로 설정되어 있는 경우, 이름 공간 수식명을 지정해 액세스 할 수 없습니다.

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

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

도입된 버젼:

SAX 2.0

관련 항목:

AttributeListImpl

메소드의 개요

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

메소드의 상세

getLength

public int getLength()

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

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

반환값:

리스트내의 속성의 수

관련 항목:

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

getURI

public String  getURI(int index)

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

파라미터:

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

반환값:

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

관련 항목:

getLength()

getLocalName

public String  getLocalName(int index)

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

파라미터:

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

반환값:

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

관련 항목:

getLength()

getQName

public String  getQName(int index)

인덱스를 지정해 속성의 XML 1.0 수식명을 검색합니다.

파라미터:

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

반환값:

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

관련 항목:

getLength()

getType

public String  getType(int index)

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

속성형은 캐릭터 라인 "CDATA","ID","IDREF","IDREFS","NMTOKEN","NMTOKENS","ENTITY","ENTITIES","NOTATION" 의 몇개의 형태가 됩니다 (항상 대문자를 사용).

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

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

파라미터:

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

반환값:

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

관련 항목:

getLength()

getValue

public String  getValue(int index)

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

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

파라미터:

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

반환값:

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

관련 항목:

getLength()

getIndex

public int getIndex(String  uri,
                    String  localPart)

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

파라미터:

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

반환값:

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

getIndex

public int getIndex(String  qName)

XML 1.0 수식명을 지정해 속성의 인덱스를 검색합니다.

파라미터:

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

반환값:

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

getType

public String  getType(String  uri,
                      String  localName)

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

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

파라미터:

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

localName - 속성의 로컬명

반환값:

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

getType

public String  getType(String  qName)

XML 1.0 수식명을 지정해 속성의 형태를 검색합니다.

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

파라미터:

qName - XML 1.0 수식명

반환값:

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

getValue

public String  getValue(String  uri,
                       String  localName)

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

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

파라미터:

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

localName - 속성의 로컬명

반환값:

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

getValue

public String  getValue(String  qName)

XML 1.0 수식명을 지정해 속성의 값을 검색합니다.

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

파라미터:

qName - XML 1.0 수식명

반환값:

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