TypeInfoProvider (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세: 필드 | 생성자 | 메소드

javax.xml.validation
클래스 TypeInfoProvider

java.lang.Object 
  javax.xml.validation.TypeInfoProvider

public abstract class TypeInfoProvider
extends Object
extends Object

이 클래스는 ValidatorHandler 에 의해 판정된 형태 정보에 액세스 합니다.

W3C XML Schema 등의 일부의 schema 언어에서는, 발리 데이터로 각 속성 및 요소에 할당하는 「형태」를 보고할 것이 추천 되고 있습니다. 이 형태 정보에 액세스 하려고 하는 어플리케이션에서는, 이 「인터페이스」에 정의된 메소드를 호출해 그러한 형태 정보에 액세스 할 수 있습니다.

이 「인터페이스」의 구현은 ValidatorHandler.getTypeInfoProvider() 메소드에 의해 취득할 수 있습니다.

도입된 버젼:: 1.5
관련 항목:: TypeInfo

생성자 의 개요
`protected`	`TypeInfoProvider ()` 상속 클래스의 생성자 입니다.

메소드의 개요
`abstract TypeInfo`	`getAttributeTypeInfo (int index)` 현재의 요소의 지정된 속성의 불변 `TypeInfo` 객체를 돌려줍니다.
`abstract TypeInfo`	`getElementTypeInfo ()` 현재의 요소의 불변 `TypeInfo` 객체를 돌려줍니다.
`abstract boolean`	`isIdAttribute (int index)` 지정된 속성이 식별자이라고 판정되었을 경우에 `true` 를 돌려줍니다.
`abstract boolean`	`isSpecified (int index)` 속성이 발리 데이터에 의해 추가되었을 경우 `false` 를 돌려줍니다.

클래스 java.lang. Object 로부터 상속된 메소드
`clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait`

생성자 의 상세

TypeInfoProvider

protected TypeInfoProvider()

상속 클래스의 생성자 입니다.

이 생성자 은 아무것도 실시하지 않습니다.

메소드의 상세

getElementTypeInfo

public abstract TypeInfo  getElementTypeInfo()

현재의 요소의 불변 TypeInfo 객체를 돌려줍니다.

메소드는 어플리케이션으로 ValidatorHandler 로 설정한 ContentHandler 의 startElement 이벤트 또는 endElement 이벤트에 의해서만 호출할 수가 있습니다.

W3C XML Schema 검증의 실행중, 요소가 union 형을 가지는 경우, startElement 로부터의 getElementTypeInfo() 의 호출에 의해 반환되는 TypeInfo 는 union 형이 됩니다. endElement 이벤트로부터의 호출에 의해 반환되는 TypeInfo 는, 요소의 검증에 사용하는 실제의 멤버의 형태가 됩니다.

반환값:: 현재의 요소의 형태를 나타내는 불변의 TypeInfo 객체. 호출측은 취득한 TypeInfo 에의 참조를 콜백 스코프보다 길게 보관 유지할 수 있다 일로 주의. 또는, 발리 데이터가 어떠한 이유 (예를 들어 발리 데이터가 이전의 에러로부터 회복중인 경우 등) 에 의해, 현재의 요소의 형태를 판정할 수 없는 경우, 이 메소드는 null (을)를 돌려준다
예외:: IllegalStateException - 이 메소드가 다른 ContentHandler 메소드로부터 불려 갔다 경우

getAttributeTypeInfo

public abstract TypeInfo  getAttributeTypeInfo(int index)

현재의 요소의 지정된 속성의 불변 TypeInfo 객체를 돌려줍니다.

메소드는 어플리케이션으로 ValidatorHandler 로 설정한 ContentHandler 의 startElement 이벤트에 의해서만 호출할 수가 있습니다.

파라미터:: index - 속성의 인덱스. startElement 콜백에게 건네졌다 Attributes 객체의 같다 인덱스
반환값:: 현재의 요소의 형태를 나타내는 불변의 TypeInfo 객체. 호출측은 취득한 TypeInfo 에의 참조를 콜백 스코프보다 길게 보관 유지할 수 있다 일로 주의. 또는, 발리 데이터가 형태를 판정할 수 없는 경우, 이 메소드는 null (을)를 돌려준다
예외:: IndexOutOfBoundsException - 인덱스가 무효인 경우; IllegalStateException - 이 메소드가 다른 ContentHandler 메소드로부터 불려 갔다 경우

isIdAttribute

public abstract boolean isIdAttribute(int index)

지정된 속성이 식별자이라고 판정되었을 경우에 true 를 돌려줍니다.

속성이 어떻게 해 「식별자로 판정된다」인가는, schema 언어에 의해 다릅니다. W3C XML Schema 의 경우는, 속성의 실제의 형태가 짜넣어 식별자형 또는 그 파생형이면, 식별자로 판정됩니다.

DocumentBuilder 가 Attr.isId() 를 적절히 구현하기 위해서 이 정보를 사용합니다.

메소드는 어플리케이션으로 ValidatorHandler 로 설정한 ContentHandler 의 startElement 이벤트에 의해서만 호출할 수가 있습니다.

파라미터:: index - 속성의 인덱스. startElement 콜백에게 건네졌다 Attributes 객체의 같다 인덱스
반환값:: true 지정된 속성의 형태가 식별자인 경우
예외:: IndexOutOfBoundsException - 인덱스가 무효인 경우; IllegalStateException - 이 메소드가 다른 ContentHandler 메소드로부터 불려 갔다 경우

isSpecified

public abstract boolean isSpecified(int index)

속성이 발리 데이터에 의해 추가되었을 경우 false 를 돌려줍니다.

이 메소드는 DocumentBuilder 가 Attr.getSpecified() 메소드로부터 돌려줄 필요가 있는 DOM 트리를 특정하기 위해서 필요한 정보를 제공합니다.

메소드는 어플리케이션으로 ValidatorHandler 로 설정한 ContentHandler 의 startElement 이벤트에 의해서만 호출할 수가 있습니다.

발리 데이터의 일반적인 가이드 라인은, 속성이 최초부터 파이프라인에 존재하고 있었을 경우 true 를 돌려주어, 발리 데이터에 의해 추가되었을 경우 false 를 돌려주는 것입니다.

파라미터:: index - 속성의 인덱스. startElement 콜백에게 건네졌다 Attributes 객체의 같다 인덱스
반환값:: 발리 데이터가 입력을 처리하는 전부터 속성이 존재하고 있었을 경우는 true. 속성이 발리 데이터에 의해 추가되었을 경우는 false
예외:: IndexOutOfBoundsException - 인덱스가 무효인 경우; IllegalStateException - 이 메소드가 다른 ContentHandler 메소드로부터 불려 갔다 경우