ILSParser 인터페이스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
다양한 입력 소스에서 DOM 트리를 빌드하거나 보강할 수 있는 개체에 대한 인터페이스입니다.
[Android.Runtime.Register("org/w3c/dom/ls/LSParser", "", "Org.W3c.Dom.LS.ILSParserInvoker")]
public interface ILSParser : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("org/w3c/dom/ls/LSParser", "", "Org.W3c.Dom.LS.ILSParserInvoker")>]
type ILSParser = interface
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 특성
- 구현
설명
다양한 입력 소스에서 DOM 트리를 빌드하거나 보강할 수 있는 개체에 대한 인터페이스입니다.
LSParser
에서는 XML을 구문 분석하고 해당 DOM 문서 구조를 빌드하기 위한 API를 제공합니다. 메서드를 LSParser
호출하여 인스턴스를 DOMImplementationLS.createLSParser()
가져올 수 있습니다.
[DOM 수준 3 Core]에 지정된 대로 LSParser <를 통해 문서를 처음 사용할 수 있게 되면 ul><li> 에는 NODE_TEXT 형식의 인접 노드가 두 개도 없으며 빈 텍스트 노드는 없습니다. </li li>>< 노드의 Attr
value
특성 nodeValue
은 처음에 XML 1.0 정규화된 값을 반환해야 합니다. 그러나 사용된 특성 정규화에 따라 " validate-if-schema" 및 " datatype-normalization" 매개 변수가 설정된 true
경우 특성 값은 XML 1.0 특성 정규화에서 얻은 값과 다를 수 있습니다. 매개 변수 "datatype-normalization"을 false
설정하면 XML 1.0 특성 정규화가 보장되고 특성 목록에 네임스페이스 선언이 없는 경우 노드의 attributes
특성은 [XML 정보 집합]에 Element
정의된 속성 <b>[attributes]</b>를 나타냅니다. </li></ul>
또한 비동 LSParser
기 개체는 비동 LSParser
기 개체에 이벤트 수신기를 등록할 수 있도록 인터페이스를 구현 events::EventTarget
해야 합니다.
비동 LSParser
기 개체에서 지원하는 이벤트는 다음과 같습니다 <. dl><dt>load</dt><dd>LSParser
문서를 로드하기 위해 완료됩니다. 인터페이스의 정의도 참조하세요 LSLoadEvent
. </dd><dt>progress</dt><dd>LSParser
데이터가 구문 분석될 때 신호가 진행됩니다. 이 사양은 진행률 이벤트를 디스패치해야 하는 정확한 시기를 정의하려고 시도하지 않습니다. 이는 의도적으로 구현에 종속된 것으로 남아 있습니다. 다음은 애플리케이션이 진행률 이벤트를 디스패치하는 방법의 한 예입니다. 파서가 데이터 수신을 시작하면 구문 분석이 시작됨을 나타내기 위해 진행률 이벤트가 디스패치됩니다. 여기에서 수신 및 처리되는 데이터의 4096바이트마다 진행률 이벤트가 디스패치됩니다. 그러나 이것은 하나의 예일 뿐이며 구현은 구문 분석하는 동안 언제든지 진행률 이벤트를 디스패치하거나 전혀 디스패치하지 않도록 선택할 수 있습니다. 인터페이스의 정의도 참조하세요 LSProgressEvent
. </dd></dl><p ><b>참고:</b> 이 사양에 정의된 모든 이벤트는 네임스페이스 URI "http://www.w3.org/2002/DOMLS"
를 사용합니다.
입력 소스를 구문 분석하는 동안 오류 처리기(LSParser.domConfig
'오류 처리기' 매개 변수)를 통해 오류가 애플리케이션에 보고됩니다. 이 사양은 XML 또는 다른 태그를 구문 분석하는 동안 발생할 수 있는 모든 가능한 오류를 정의하려고 시도하지 않지만 몇 가지 일반적인 오류 사례가 정의됩니다. 이 사양에서 정의한 오류 및 경고의 형식(DOMError.type
)은 다음과 같습니다<. "check-character-normalization" 매개 변수가 true로 설정되어 있고 정규화 검사에 실패한 문자열이 발견되면 dl<>dt><"check-character-normalization-failure" [error]
/dt><dd> Raised입니다. <구성 매개 변수 "disallow-doctype"이 설정되고 doctype이 발견되면 /dd><dt"doctype-not-allowed" [fatal]
></dt<>dd> Raised입니다.true
</dd><dt><"no-input-specified" [fatal]
/dt><dd> 문서를 로드할 때 발생하며 개체에 LSInput
입력이 지정되지 않습니다. <처리 명령의 기본 URI를 유지할 수 없는 위치에서 처리 명령이 발견되면 /dd><dt>"pi-base-uri-not-preserved" [warning]
</dt><dd> Raised입니다. 이 경고가 발생하는 경우의 한 가지 예는 구성 매개 변수 " 엔터티"를 설정하고 false
다음 XML 파일을 구문 분석하는 경우입니다.
<!DOCTYPE root [ <!ENTITY e SYSTEM 'subdir/myentity.ent' ]>
<root> &e; </root>
다음 subdir/myentity.ent
을 포함합니다.
<one> <two/> </one> <?pi 3.14159?>
<more/>
</dd><dt/dt><>"unbound-prefix-in-entity" [warning]
< dd> 구성 매개 변수 "네임스페이스"를 설정하고 true
엔터티의 대체 텍스트에서 바인딩되지 않은 네임스페이스 접두사를 발견하면 발생할 수 있는 구현 종속 경고입니다. 일부 기존 파서가 엔터티의 대체 텍스트에서 바인딩되지 않은 네임스페이스 접두사를 인식하지 못할 수 있으므로 이 경고를 발생시키지 않습니다. <구성 매개 변수 "ignore-unknown-character-denormalizations"가 설정되고 프로세서에서 정규화 속성을 확인할 수 없는 문자가 발견되면 /dd><dt"unknown-character-denormalization" [fatal]
></dt<>dd> Raised입니다.false
<지원되지 않는 인코딩이 발생하면 /dd><dt>"unsupported-encoding" [fatal]
</dt><dt dd> Raised입니다. <구성 매개 변수 "supported-media-types-only"가 설정되어 있고 지원되지 않는 미디어 형식이 발견되면 /dd><dt"unsupported-media-type" [fatal]
></dt<>dd> Raised입니다.true
</dd></dl>
정의된 오류 및 경고를 발생시키는 것 외에도 구현은 IO 오류(파일을 찾을 수 없음, 사용 권한 거부,...), XML 올바른 형식 오류 등과 같은 다른 오류 및 경고 사례에 대한 구현별 오류 및 경고를 발생시키는 것으로 예상됩니다.
DOM(문서 개체 모델) 수준 3 로드 및 저장 사양도 참조하세요.
에 대한 org.w3c.dom.ls.LSParser
Java 설명서
이 페이지의 일부는 Android 오픈 소스 프로젝트에서 만들고 공유하고 Creative Commons 2.5 특성 라이선스에 설명된 용어에 따라 사용되는 작업을 기반으로 하는 수정 사항입니다.
필드
ActionAppendAsChildren |
구문 분석 작업의 결과를 컨텍스트 노드의 자식으로 추가합니다. |
ActionInsertAfter |
구문 분석 작업의 결과를 컨텍스트 노드의 바로 다음 형제로 삽입합니다. |
ActionInsertBefore |
구문 분석 작업의 결과를 컨텍스트 노드의 바로 앞 형제로 삽입합니다. |
ActionReplace |
컨텍스트 노드를 구문 분석 작업의 결과로 바꿉니다. |
ActionReplaceChildren |
컨텍스트 노드의 모든 자식을 구문 분석 작업의 결과로 바꿉니다. |
속성
Async |
|
Busy |
|
DomConfig |
|
Filter |
필터가 제공되면 구현은 DOM 트리 구조를 생성할 때 필터를 호출합니다. |
Handle |
기본 Android 개체의 JNI 값을 가져옵니다. (다음에서 상속됨 IJavaObject) |
JniIdentityHashCode |
래핑된 인스턴스의 |
JniManagedPeerState |
관리되는 피어의 상태입니다. (다음에서 상속됨 IJavaPeerable) |
JniPeerMembers |
멤버 액세스 및 호출 지원. (다음에서 상속됨 IJavaPeerable) |
PeerReference |
JniObjectReference 래핑된 Java 개체 인스턴스의 값을 반환합니다. (다음에서 상속됨 IJavaPeerable) |
메서드
Abort() |
에 의해 현재 로드되고 있는 문서의 로드를 중단합니다 |
Disposed() |
인스턴스가 삭제되었을 때 호출됩니다. (다음에서 상속됨 IJavaPeerable) |
DisposeUnlessReferenced() |
이 인스턴스에 대한 미해결 참조가 없으면 호출 |
Finalized() |
인스턴스가 종료될 때 호출됩니다. (다음에서 상속됨 IJavaPeerable) |
Parse(ILSInput) |
로 식별되는 리소스에서 XML 문서를 구문 분석합니다 |
ParseURI(String) |
URI 참조 [IETF RFC 2396]로 식별된 위치에서 XML 문서를 구문 분석합니다. |
ParseWithContext(ILSInput, INode, Int16) |
A로 식별된 |
SetJniIdentityHashCode(Int32) |
에서 반환 |
SetJniManagedPeerState(JniManagedPeerStates) |
다양한 입력 소스에서 DOM 트리를 빌드하거나 보강할 수 있는 개체에 대한 인터페이스입니다. (다음에서 상속됨 IJavaPeerable) |
SetPeerReference(JniObjectReference) |
에서 반환 |
UnregisterFromRuntime() |
런타임이 이후 Java.Interop.JniRuntime+JniValueManager.PeekValue 호출에서 반환되지 않도록 이 인스턴스의 등록을 취소합니다. (다음에서 상속됨 IJavaPeerable) |
확장 메서드
JavaCast<TResult>(IJavaObject) |
Android 런타임 확인 형식 변환을 수행합니다. |
JavaCast<TResult>(IJavaObject) |
다양한 입력 소스에서 DOM 트리를 빌드하거나 보강할 수 있는 개체에 대한 인터페이스입니다. |
GetJniTypeName(IJavaPeerable) |
다양한 입력 소스에서 DOM 트리를 빌드하거나 보강할 수 있는 개체에 대한 인터페이스입니다. |
ParseAsync(ILSParser, ILSInput) |
다양한 입력 소스에서 DOM 트리를 빌드하거나 보강할 수 있는 개체에 대한 인터페이스입니다. |
ParseURIAsync(ILSParser, String) |
다양한 입력 소스에서 DOM 트리를 빌드하거나 보강할 수 있는 개체에 대한 인터페이스입니다. |
ParseWithContextAsync(ILSParser, ILSInput, INode, Int16) |
다양한 입력 소스에서 DOM 트리를 빌드하거나 보강할 수 있는 개체에 대한 인터페이스입니다. |