JavaTM Platform
Standard Ed. 6

org.xml.sax.helpers
클래스 AttributesImpl

java.lang.Object 
  상위를 확장 org.xml.sax.helpers.AttributesImpl
모든 구현된 인터페이스:
Attributes
직계의 기존의 서브 클래스:
Attributes2Impl


public class AttributesImpl
extends Object
implements Attributes

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

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

이 클래스는, 리스트의 변경이나 재사용을 가능하게 하기 위한(해), SAX2 Attributes 인터페이스의 디폴트 구현에 매니플레이터를 추가합니다.

이 클래스의 전형적인 용도는 이하의 2 종류입니다.

  1. startElement 이벤트내의 Attributes 객체의 지속적인 snapshot를 작성한다
  2. SAX2 드라이버 또는 필터내에서 Attributes 객체를 구축 또는 변경한다

이 클래스는, 현재는비추천으로 지정되고 있는 SAX1 AttributeListImpl 클래스에 대신하는 클래스입니다. 비추천 AttributeList 인터페이스는 아니고 갱신된 Attributes 인터페이스를 지원합니다. 또, Vectors 세트 대신에 단일의 배열을 사용해보다 효율적인 구현을 제공합니다.

도입된 버젼:
SAX 2.0

생성자 의 개요
AttributesImpl ()
          새로운 빈 상태(empty)의 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()
새로운 빈 상태(empty)의 AttributesImpl 객체를 작성합니다.


AttributesImpl

public AttributesImpl(Attributes  atts)
기존의 Attributes 객체를 카피합니다.

이 생성자 은, 특히 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. 사용 가능한 이름 공간 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 - 지정되었다 인덱스가 리스트내의 속성을 포인트 하지 않는다 경우

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.