org.xml.sax
인터페이스 AttributeList

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

AttributeListImpl

추천 되고 있지 않습니다. 이 인터페이스는 이름 공간을 서포트하는 SAX2 의 Attributes 인터페이스로 옮겨놓을 수 있고 있습니다.

public interface AttributeList

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

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

이것은 요소의 속성을 보고하는 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

public int getLength()

추천 되고 있지 않습니다.

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

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

반환값:

리스트내의 속성의 수

getName

public String  getName(int i)

추천 되고 있지 않습니다.

이 리스트내의 속성의 이름 (위치에 의해)을 돌려줍니다.

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

속성명에 이름 공간앞치수식자가 붙어 있어도, 일전에치수식자가 삭제될 것은 없습니다.

파라미터:

i - 리스트내의 속성의 인덱스. 0 으로 시작된다

반환값:

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

관련 항목:

getLength()

getType

public String  getType(int i)

추천 되고 있지 않습니다.

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

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

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

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

파라미터:

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

반환값:

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

관련 항목:

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

getValue

public String  getValue(int i)

추천 되고 있지 않습니다.

리스트내의 속성의 값 (위치에 의해)을 돌려줍니다.

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

파라미터:

i - 리스트내의 속성의 인덱스. 0 으로 시작된다

반환값:

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

관련 항목:

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

getType

public String  getType(String  name)

추천 되고 있지 않습니다.

리스트내의 속성의 형태 (이름)를 돌려줍니다.

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

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

파라미터:

name - 속성의 이름

반환값:

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

관련 항목:

getType(int)

getValue

public String  getValue(String  name)

추천 되고 있지 않습니다.

리스트내의 속성의 값 (이름)을 돌려줍니다.

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

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

반환값:

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

관련 항목:

getValue(int)