org.w3c.dom
인터페이스 DOMConfiguration

public interface DOMConfiguration

DOMConfiguration인터페이스는 문서의 구성을 나타내, 인정되고 있는 파라미터의 테이블을 보관 유지합니다. 이 구성을 사용하면, CDATASection 노드를 Text 노드에 치환 충분해Document 검증이 요구되었을 때에 사용하는 schema 의 형태를 지정하거나 하는 등, Document.normalizeDocument() 동작을 변경할 수 있습니다. DOMConfiguration객체는 DOMParser인터페이스나 DOMSerializer 인터페이스의 「DOM Level 3 Load and Save」에서도 사용할 수 있습니다.

DOMConfiguration 객체로 사용하는 파라미터이름은 DOM 레벨 3 사양 전체로 정의되고 있습니다. 이름은 대문자와 코후미 글자가 구별됩니다. 충돌을 피하기 때문에 규칙으로서 DOM 사양의 범위외에서 정의된 파라미터를 참조하는 이름은 일의로 할 필요가. 파라미터는 프로퍼티로서 공개되므로 이름은 추가의 문자 「-」(HYPHEN-MINUS)을 포함한 「Unicode」의 섹션 5.16 「식별자」에 따르는 것을 추천합니다만, DOM 구현에 의해 강제는 되지 않습니다. DOM 레베 르 3 코어 구현에서는 이 사양으로 정의 떠날 수 있어 모든 파라미터를 인식 할 필요가 있습니다. 일부의 파라미터값도, 이 구현으로 지원 되는 필 요점이 있습니다. 값이 지원 되고 있는지 어떤지에 대해서는 파라미터의 정의를 참조하십시오.

주: 파라미터는, SAX2「SAX」로 사 용 되는 기능 및 프로퍼티와 같습니다.

다음의 파라미터 리스트는 DOM 로 정의되고 있습니다.

"canonical-form"

true

「옵션」의 정규 XML 로 가리키는 규칙에 따라 DocumentType 노드 (존재하는 경우)를 트리로부터 삭제하거나 개개의 요소로부터 불필요한 이름 공간 선언을 삭제해 문서를 표준화 합니다. 이것은 DOM 로 표현할 수 있는 컨텐츠에 제한됩니다. 특히, DOM 로 속성의 순서를 지정하는 방법은 없습니다. 또, 이 파라미터를 true로 설정하면, 아래와 같은 파라미터 상태도 설정됩니다. 나중에 그 중의 1개 로 변경하면, 「canonical-form」는 false에 돌아옵니다. false로 설정되는 파라미터는 「entities」, 「normalize-characters」, 「cdata-sections」로true로 설정되는 파라미터는 「namespaces」, 「namespace-declarations」, 「well-formed」, 「element-content-whitespace」입니다. 그 이외의 파라미터는 파라미터의 설명에 명시적으로 지정되어 있지 않은 한, 변경되지 않습니다.

false

「필수」(디폴트) 문서를 표준화 하지 않습니다.

"cdata-sections"

true

「필수」(디폴트) 문서의 CDATASection 노드를 유지합니다.

false

「필수」문서의 CDATASection 노드를 Text 노드로 변환합니다. 이것에 의해 새로운 Text 노드는 인접하는 Text 노드와 결합됩니다.

"check-character-normalization"

true

「옵션」문서내의 캐릭터 라인이, 「XML 1.1」의 부록 B 로 정의되고 있도록완전하게 정규화되고 있는지를 확인합니다. 캐릭터 라인의 정규화 체크에 실패했을 경우, DOMError.type에 러는 「check-character-normalization-failure」가 발행되는 것과 같습니다.

false

「필수」(디폴트) 문자가 정규화되고 있는지를 체크하지 않습니다.

"comments"

true

「필수」(디폴트) 문서의 Comment 노드를 유지합니다.

false

「필수」문서의 Comment 노드를 파기합니다.

"datatype-normalization"

true

「옵션」XML schema의 XML schema 정규화치 등, 트리의 schema 정규화치를 공개합니다. 이 파라미터에는 schema 정보가 필요하기 때문에 「validate」파라미터도 true로 설정됩니다. 「validate」가 false 때에 이 파라미터를 활성화 해도 효과는 없고, schema의 정규화는 행해지지 않습니다.

주: 문서는 XML 1.0 처리의 결과를 포함하고 있으므로 이 파라미터는 「XML 1.0」의 섹션 3.3. 3 으로 정의되고 있는 속성값 정규화에는 적용되지 않고, 문서형 정의 (DTD) 이외의 schema 언어만을 대상으로 하고 있습니다.

false

「필수」(디폴트) 트리로 schema 정규화를 실행하지 않습니다.

"element-content-whitespace"

true

「필수」(디폴트) 문서로 모든 공백 문자를 유지합니다.

false

「옵션」의 요소 컨텐츠의 공백 문자로 설명되고 있는 것 같은 요소 컨텐츠에 출현한 공백 문자를 포함한 모든 Text 노드를 파기합니다. 구현에서는 Text.isElementContentWhitespace 속성을 사용해, Text 노드를 파기할 필요가 있을지 어떨지를 판정하는 것이 요구됩니다.

"entities"

true

「필수」(디폴트) 문서의 EntityReference 노드를 유지합니다.

false

「필수」문서로부터 모든 EntityReference 노드를 삭제해, 그 위치에서 실체 확장을 실시합니다. Text 노드는 Node.normalize로 정의되고 있는 대로 정규화됩니다. 확장되어 있지 않은 실체 참조만이 문서에 유지됩니다.

주: 이 파라미터는 Entity 노드에는 영향을 주지 않습니다.

"error-handler"

「필수」DOMErrorHandler 객체를 포함합니다. 문서로 에러가 발생했을 경우, 구현에서는 이 파라미터를 사용해 등록된 DOMErrorHandler를 호출합니다. 구현에서는 디폴트의 DOMErrorHandler 객체가 제공되는 경우가 있습니다. 불려 갔을 경우, DOMError.relatedData에는 에러가 발생한 장소에 가장 가까운 노드가 포함됩니다. 에러가 발생한 장소를 구현으로 특정할 수 없는 경우는 DOMError.relatedData에 Document 노드가 포함됩니다. 에러 핸들러내로부터 문서에 대해서 변경을 더하면, 구현에 존한 동작이 됩니다.

"infoset"

true

「필수」XML 정보 세트 XML 정보 세트로 정의된 정보를 문서에 유지합니다. 이것에 의해 validate-if-schema, entities, datatype-normalization, cdata-sections 파라미터는 false로 설정됩니다. 또, namespace-declarations, well-formed, element-content-whitespace, comments, namespaces 파라미터는 true로 설정됩니다. 다른 파라미터는 파라미터의 기술로 명시적으로 지정하지 않는 한, 변경되지 않습니다. getParameter로 이 파라미터를 조회하면, 상기의 파라미터가 적절히 설정되어 있는 경우만, true가 리턴됩니다 .

false

infoset를 false로 설정해도 영향은 없습니다.

"namespaces"

true

「필수」(디폴트) 정의에 따라, 이름 공간 처리를 실행합니다.

false

「옵션」이름 공간 처리를 실행하지 않습니다.

"namespace-declarations"

「namespaces」파라미터를 false로 설정해도 영향은 없습니다.

true

「필수」(디폴트) schema로 지정 또는 디폴트 설정되어 있는 이름 공간 선언 속성을 문서에 포함합니다. XML 이름 공간과「XML Namespaces 1.1」의 이름 공간의 선언의 섹션도 참조하십시오.

false

「필수」모든 이름 공간 선언 속성을 파기합니다. 이 파라미터가 false로 설정되어 있어도, 이름 공간 접두사 ( Node.prefix)는 보관 유지됩니다.

"normalize-characters"

true

「옵션」의 「XML 1.1」의 부록 B 로 정의되고 있도록, 문서의 캐릭터 라인을완전하게 정규화합니다.

false

「필수」(디폴트) 문자의 정규화를 실행하지 않습니다.

"schema-location"

「옵션」공백 문자 (「XML 1.0」의 섹션 2.3 으로 정의되고 있는비종단 생성 S에 일치하는 문자)로 단락지어진 URI 리스트를 포함한 DOMString 객체를 나타냅니다. 이 객체는 검증을 하는 schema (현재의 schema)를 나타냅니다. 이 리스트로 참조되는 schema의 형태는 schema-type로 지정된 형태에 일치하지 않으면 안됩니다. 일치하지 않는 경우, 구현의 동작은 보증되지 않습니다. 이 프로퍼티를 사용해 지정된 schema는 문서로 독자적으로 지정된 schema 정보보다 우선됩니다. 이름 공간 인식 schema의 경우, 이 프로퍼티로 지정된 schema와 schema 문서 (schema import 메카니즘을 사용)의 문서 인스턴스 (schemaLocation 속성을 사용)로 지정된 schema가 같은 targetNamespace를 공유할 때, 사용자가 이 프로퍼티를 사용해 지정한 schema가 사용됩니다. 이 프로퍼티를 사용해 지정된 2개의 schema가 같은 targetNamespace를 공유하는지, 이름 공간을 가지지 않는 경우, 동작은 구현에 존해 정해집니다. 장소를 지정하지 않았던 경우, 이 파라미터는 null이 됩니다.

주: schema-type 파라미터값를 설정하지 않는 한, 「schema-location」파라미터는 무시됩니다. Document.documentURI를 설정해, 참조된 외부 실체를 구현으로 문제 없게 해결할 수 있도록 하는 것을 강하게 추천합니다.

"schema-type"

「옵션」절대 URI를 포함해, 문서의 검증에 사용되는 schema 언어의 형태를 나타내는 DOMString 객체를 표현합니다. 절대 URI 에서는 자구 체크는 행해지지 않습니다. 이 파라미터가 설정되지 않는 경우, 구현에서는 지원 되고 있는 schema 언어나 로드시에 사용된 schema 언어에 응해, 디폴트의 값을 지정할 수 있습니다. 값을 지정하지 않는 경우, 이 파라미터는 null이 됩니다.

주: XML schema「XML Schema Part 1」 인 경우는 어플리케이션으로 값「http://www.w3.org/2001/XMLSchema」 를 사용할 필요가 있습니다. XML DTD「XML 1.0」 인 경우는 어플리케이션으로 값「http://www.w3.org/TR/REC-xml」를 사용할 필요가 있습니다. 다른 schema 언어는 W3C 범위외이기 때문에 이 메서드를 사용하려면, 절대 URI를 사용하는 것을 추천합니다.

"split-cdata-sections"

true

「필수」(디폴트) CDATA 섹션 종료 마커 「]]>」를 포함하고 있는 CDATA 섹션을 분할합니다. CDATA 섹션이 분할되면, 분할의 결과의 문서순서에 DOMError.type 하지만 「cdata-sections-splitted」이며, DOMError.relatedData가 문서의 최초의 CDATASection 노드인 경고가 통지됩니다.

false

「필수」(디폴트) CDATASection을 표현할 수 없는 문자를 포함한 경우에 에러를 통지합니다.

"validate"

true

「옵션」의 「XML 1.0」 그리고 정의되고 있도록 정규화되고 있는 문서의 schema (XML schema, DTD, schema의 다른 형태 또는 표현)에 대한 검증을 필요와 섬. 검증 에러가 발견되거나 schema가 발견되지 않거나 했을 경우는 에러 핸들러에 통지됩니다. 「datatype-normalization」파라미터가 true로 설정되어 있지 않은 한, 사용되고 있는 schema에 따라서 schema 정규화치는 공개되지 않습니다. 이 파라미터는 다음의 항목에 붙어 재평가합니다.

• Attr인터페이스의 설명 그리고 지정되고 있도록, At tr.specified가 false인 속성 노드
• 모든 Text 노드의 Text.isElementContentWhitespace 속성의 값
• 모든 Attr 노드의 Attr.isId 속성의 값
• Element.schemaTypeInfo 속성과 Attr.schemaTypeInfo 속성

주: 「validate-if-schema」와「validate」는 서로 배타적입니다. 한편을 true로 설정하면, 한편은 false에 설정됩니다. 어플리케이션에서는 문서의 검증시, 이 옵션의 디폴트인 w ell-formed 파라미터를 true로 설정 하는 일도 고려할 필요가 있습니다.

false

「필수」(디폴트) 내부 부분집합 처리를 포함해, schema 처리 를 실행하지 않습니다. 디폴트의 속성값 정보는 유지됩니다. 그런데도 「validate-if-schema」가 true인 경우는 검증을 할 가능성이 있습니다.

"validate-if-schema"

true

「옵션」schema로 문서 요소의 선언 (XML schema, DTD, 혹은 schema의 다른 형태 또는 표현. 보고 개나 장소에 무관계)가 발견되었을 경우만 검증을 유효하게 합니다. 검증이 유 효과인 경우, 이 파라미터는 「validate」파라미터가 true로 설정되어 있을 때와 같은 동작을 합니다.

주: 「validate-if-schema」와「validate」는 서로 배타적입니다. 한편을 true (으)로 설정하면, 한편은 false로 설정됩니다.

false

「필수」(디폴트) 문서에 schema (이)가 있는 경우, 내부 부분집합 처리등의 schema 처리를 실행하지 않습니다. 데 fault의 속성값 정보는 유지됩니다. 그런데도 「validate」가 true인 경우는 검증을 합니다.

"well-formed"

true

「필수」(디폴트) Document.xmlVersion로 사용되고 (이)라고 있는 XML 버전에 따라, 모든 노드가 정형식의 XML 일까 제발을 체크합니다.

• Node.nodeName 속성이 노드형에 대해서 무효인 문자를 포함하고 있는지를 체크해, 필요하게 응해DOMError.SEVERITY_ERROR 중요도를 포함한다 「wf-invalid-character-in-node-name」 형의 DOMError 를 생성한다
• Attr, Element, Comment, Text, CDATASection인 어느 노드내의 텍스트 컨텐츠가 무효인 문자를 포함하고 있는지를 최 크 해, 필요에 따라서 DOMError.SEVERITY_ERROR 중요도를 포함한다 「wf-invalid-character」형의 DOMError를 생성 한다
• ProcessingInstruction 노드내의 데이터가 무효인 문자를 포함하고 있는지를 체크해, 필요에 따라서 DOMErr or.SEVERITY_ERROR 중요도를 포함한「wf-invalid-character」 형태의 DOMError를 생성한다

false

「옵션」XML 정형식을 체크해 선.

실체에 관련된 시스템 식별자의 해결은, Document.documentURI를 사용해 행해집니다. 다만, 「DOM Level 3 Load and Save」로 정의되고 있는 「LS」기능을 DOM 구현이 지원 하고 있을 때는 Document 노드에 추가되고 있는 DOMConfiguration 객체로 「resource-resolver」파라미터를 사용할 수도 있습니다. 이 파라미터가 설정되어 있으면, Document.normalizeDocument()는 Document.documentURI를 이용하는 대신에 자원 리절버를 호출합니다.

「Document Object Model (DOM) Level 3 Core Specification」도 참조하십시오.

도입된 버전 :

DOM Level 3

메서드 개요

boolean	canSetParameter (String name, Object value) 특정의 값에 대해서 파라미터를 설정하는 것이 지원 되고 있는지를 체크합니다.
Object	getParameter (String name) 기존의 경우는 파라미터의 값을 리턴합니다.
DOMStringList	getParameterNames () DOMConfiguration 객체가 지원 하고 있는 파라미터의 리스트.
void	setParameter (String name, Object value) 파라미터의 값을 설정합니다.

메서드의 상세

setParameter

void setParameter(String  name,
                  Object  value)
                  throws DOMException 

파라미터의 값을 설정합니다.

파라미터:

name - 설정하는 파라미터의 이름

value - 새로운 값 또는 사용자가 파라미터를 설정하지 않는 경우는 null. 파라미터의 치 형은 DOMUserData에 의해 정의되지만, 객체형은 파라미터의 정의에 의해 정의된 형태에 일치해야 한다. 예를 들어 파라미터가 error-handler 인 경우, 값은 DOMErrorHandler 형이 아니면 안된다

예외:

DOMException - NOT_FOUND_ERR: 파라미터명이 인식되지 않는 경우
NOT_SUPPORTED_ERR: 파라미터명은 인식되고 있어도, 요구된 값을 설정할 수 없는 경우
TYPE_MISMATCH_ERR: 이 파라미터명의 치 형이 예상한 치 형과 호환성이 없는 경우

getParameter

Object  getParameter(String  name)
                    throws DOMException 

기존의 경우는 파라미터의 값을 리턴합니다.

파라미터:

name - 파라미터의 이름

반환값:

지정된 파라미터에 관련된 현재의 객체. 객체가 관련하고 있지 않는 경우나 파라미터가 지원 되어 있지 않은 경우는 null

예외:

DOMException - NOT_SUPPORTED_ERR: 파라미터명이 인식되지 않는 경우

canSetParameter

boolean canSetParameter(String  name,
                        Object  value)

특정의 값에 대해서 파라미터를 설정하는 것이 지원 되고 있는지를 체크합니다.

파라미터:

name - 체크하는 파라미터의 이름

value - 객체. null인 경우, 리턴된 값은 true

반환값:

파라미터가 지정된 값에 문제 없게 설정할 수 있었을 경우는 true. 파라미터가 인식되지 않는 경우나 요구된 값이 지원 되어 있지 않은 경우는 false. 이것에 의해 파라미터 자체의 현재의 값은 변경되지 않는다

getParameterNames

DOMStringList  getParameterNames()

DOMConfiguration 객체가 지원 하고 있는 파라미터의 리스트. 어플리케이션에서는 적어도 1개의 값을 이러한 파라미터에 대해서 설정할 수 있습니다. 이 리스트에는 이 사양의 외부에서 정의된 파라미터명도 포함될 가능성이 있는 것에 주의해 주세요.