org.xml.sax
인터페이스 AttributeList

알려진 구현 클래스 목록:

AttributeListImpl

추천하지 않습니다. 이 인터페이스는 이름 공간을 지원하는 SAX2 Attributes 인터페이스로 대체할 수 있습니다.

public interface AttributeList

요소의 속성 지정을 위한 인터페이스입니다.

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

이것은 요소의 속성을 보고하는 SAX1 인터페이스입니다. 새로운 Attributes 인터페이스와는 달라, 이름 공간 관련 정보의 지원은 실시하지 않습니다.

속성 리스트가 startElement 이벤트의 일부로서 제공되었을 경우, 리스트는 이벤트 범위내에서만 유효한 결과를 리턴합니다. 이벤트 핸들러로부터 파서에 제어가 옮기면, 속성 리스트는 무효가 됩니다. 속성 리스트의 지속적인 복사본을 보존하려면, SAX1 AttributeListImpl 헬퍼 클래스를 사용합니다.

속성 리스트에는 지정된 속성 또는 생략시 속성만이 포함됩니다. #IMPLIED 속성은 포함되지 않습니다.

SAX 어플리케이션이 AttributeList 로부터 정보를 얻는 방법은 2 종류 있습니다. 우선, 리스트 전체로 반복 처리를 실시한다고 하는 방법이 있습니다.

 public void startElement (String name, AttributeList atts) {
   for (int i = 0; i < atts.getLength(); i++) {
     String name = atts.getName(i);
     String type = atts.getType(i);
     String value = atts.getValue(i);
     [...]
   }
 }
 

속성이 존재하지 않는 경우, getLength()의 결과는 제로가 됩니다.

다음에 어플리케이션으로부터 특정의 속성의 값 또는 형태를 요구한다고 하는 방법이 있습니다.

 public void startElement (String name, AttributeList atts) {
   String identifier = atts.getValue("id");
   String label = atts.getValue("label");
   [...]
 }
 

도입된 버전 :

SAX 1.0

관련 항목:

startElement, AttributeListImpl

메서드 개요

int	getLength () 추천하지 않습니다. 이 리스트내에 있는 속성의 수를 리턴합니다.
String	getName (int i) 추천하지 않습니다. 이 리스트내의 속성의 이름 (위치에 해)을 리턴합니다.
String	getType (int i) 추천하지 않습니다. 이 리스트내의 속성의 형태 (위치에 해)를 리턴합니다.
String	getType (String name) 추천하지 않습니다. 리스트내의 속성의 형태 (이름)를 리턴합니다.
String	getValue (int i) 추천하지 않습니다. 리스트내의 속성의 값 (위치에 해)을 리턴합니다.
String	getValue (String name) 추천하지 않습니다. 리스트내의 속성의 값 (이름)을 리턴합니다.

메서드의 상세

getLength

int getLength()

추천하지 않습니다.

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

SAX 파서는 선언된 순서 또는 지정된 순서와는 관계없이, 임의의 순서로 속성을 제공합니다. 속성수가 제로의 경우도 있습니다.

반환값:

리스트내의 속성의 수

getName

String  getName(int i)

추천하지 않습니다.

이 리스트내의 속성의 이름 (위치에 해)을 리턴합니다.

속성의 이름은 일의가 아니면 안됩니다. SAX 파서에 같은 속성을 중복의해 포함할 수 없습니다. 값을 가지지 않는 속성 (개시 태그로 지정된 값을 사용하지 않고 #IMPLIED를 선언한 속성)은 리스트에 기재되지 않습니다.

속성명에 이름 공간 접두사가 붙어 있어도, 이 접두사가 삭제될 것은 없습니다.

파라미터:

i - 리스트내의 속성의 인덱스(0 으로부터 시작된다)

반환값:

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

관련 항목:

getLength()

getType

String  getType(int i)

추천하지 않습니다.

이 리스트내의 속성의 형태 (위치에 해)를 리턴합니다.

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

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

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

파라미터:

i - 리스트내의 속성의 인덱스(0 으로부터 시작된다)

반환값:

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

관련 항목:

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

getValue

String  getValue(int i)

추천하지 않습니다.

리스트내의 속성의 값 (위치에 해)을 리턴합니다.

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

파라미터:

i - 리스트내의 속성의 인덱스(0 으로부터 시작된다)

반환값:

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

관련 항목:

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

getType

String  getType(String  name)

추천하지 않습니다.

리스트내의 속성의 형태 (이름)를 리턴합니다.

반환값은 getType(int)의 반환값과 같습니다.

속성명에 문서내의 이름 공간 접두사가 포함되어 있는 경우, 어플리케이션은 여기에 접두사를 포함할 필요가 있습니다.

파라미터:

name - 속성의 이름

반환값:

속성형을 나타내는 캐릭터 라인. 해당하는 속성이 존재하지 않는 경우는 null

관련 항목:

getType(int)

getValue

String  getValue(String  name)

추천하지 않습니다.

리스트내의 속성의 값 (이름)을 리턴합니다.

반환값은 getValue(int)의 반환값과 같습니다.

속성명에 문서내의 이름 공간 접두사가 포함되어 있는 경우, 어플리케이션은 여기에 접두사를 포함할 필요가 있습니다.

파라미터:

name - 돌려주는 속성의 이름

반환값:

속성값을 나타내는 캐릭터 라인. 해당하는 속성이 존재하지 않는 경우는 null

관련 항목:

getValue(int)