Share via


IXmlPullParser 인터페이스

정의

XML 끌어오기 파서는 XMLPULL V1 API 에 제공된 구문 분석 기능을 정의하는 인터페이스입니다(이 웹 사이트를 방문하여 API 및 해당 구현에 대해 자세히 알아보세요).

[Android.Runtime.Register("org/xmlpull/v1/XmlPullParser", "", "Org.XmlPull.V1.IXmlPullParserInvoker")]
public interface IXmlPullParser : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("org/xmlpull/v1/XmlPullParser", "", "Org.XmlPull.V1.IXmlPullParserInvoker")>]
type IXmlPullParser = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
파생
특성
구현

설명

XML 끌어오기 파서는 XMLPULL V1 API 에 제공된 구문 분석 기능을 정의하는 인터페이스입니다(이 웹 사이트를 방문하여 API 및 해당 구현에 대해 자세히 알아보세요).

FEATURE_VALIDATION true일 때 XML 1.0 사양에 정의된 대로 FEATURE_PROCESS_DOCDECL true <li b 유효성 검사 파서/b로 설정된 경우 XML 1.0 사양에 정의된 대로 ul><li><><b>>non-validating</b>> 파서가 설정된< 기능에 따라 다음과 같은 다양한 종류의 파서<가 있습니다(FEATURE_PROCESS_DOCDECL true임을 의미함).><FEATURE_PROCESS_DOCDECL false이면(기본값이며 구문 분석이 시작되기 전에 다른 값을 변경해야 하는 경우) 파서는 XML 문서에 DOCDECL><이 없음을 조건으로 <>XML 1.0 규격의 유효성 검사되지 않는 파서처럼 동작합니다(내부 엔터티는 defineEntityReplacementText()로 정의될 수 있음). 이 작업 모드는 J2ME와 같은 제한된 환경</b에서 작동하기 위한 b>>입니다<. </ul>

next() 및 nextToken()의 두 가지 주요 메서드가 있습니다. next()는 상위 수준 구문 분석 이벤트에 대한 액세스를 제공하지만 nextToken()은 하위 수준 토큰에 대한 액세스를 허용합니다.

파서의 현재 이벤트 상태는 getEventType() 메서드를 호출하여 확인할 수 있습니다. 처음에는 파서가 START_DOCUMENT 상태입니다.

next() 메서드는 파서가 다음 이벤트로 이동합니다. 다음에서 반환된 int 값은 현재 파서 상태를 결정하며 getEventType()에 대한 다음 호출에서 반환된 값과 동일합니다.

다음 이벤트 유형은 next()<dl<>dt>START_TAG<dd> XML 시작 태그를 읽은 것으로 표시됩니다. <dt>TEXT<dd> 텍스트 콘텐츠를 읽었습니다. getText() 메서드를 사용하여 텍스트 콘텐츠를 검색할 수 있습니다. (유효성 검사 모드 next()에서 무시할 수 있는 공백을 보고하지 않는 경우 nextToken()을 대신 < 사용합니다.dt>END_TAG<dd> 엔드 태그가 dt>END_DOCUMENT<dd> 더 이상 사용할 수 없는 <이벤트 /dl을 읽었<습니다.>

첫 번째 next() 또는 nextToken() (또는 다른 next*() 메서드)가 호출된 후 사용자 애플리케이션은 다음과 같은 방법으로< XML 선언에서 XML 버전, 독립 실행형 및 인코딩을 가져올 수 있습니다.ul<>li><b>version</b>: getProperty("http://xmlpull.org/v1/doc/properties.html#xmldecl-version")는 STRING("1.0")을 반환하거나 XMLDecl을 읽지 않았거나 속성이 지원<><되지 않는 경우 null을 반환합니다.><> getProperty("http://xmlpull.org/v1/doc/properties.html#xmldecl-standalone")는 독립 실행형 선언이 없거나 속성이 지원되지 않는 경우 부울을 반환합니다. 그렇지 않으면 standalone="yes"이면 Boolean(false)을 반환하고 독립 실행형="아니요"<인 경우 Boolean(false)을 반환합니다. li><b>encoding</b>: 스트림에 알 수 없는 인코딩(setInputStream에서 설정되지 않음)이 있고 XMLDecl </ul에서 선언되지 않은 경우 getInputEncoding() null에서 가져옵니다.>

이 API를 사용하는 최소 예제는 다음과 같습니다.

import java.io.IOException;
            import java.io.StringReader;

            import org.xmlpull.v1.XmlPullParser;
            import org.xmlpull.v1.<a href="XmlPullParserException.html">XmlPullParserException</a>;
            import org.xmlpull.v1.<a href="XmlPullParserFactory.html">XmlPullParserFactory</a>;

            public class SimpleXmlPullApp
            {

                public static void main (String args[])
                    throws XmlPullParserException, IOException
                {
                    XmlPullParserFactory factory = XmlPullParserFactory.newInstance();
                    factory.setNamespaceAware(true);
                    XmlPullParser xpp = factory.newPullParser();

                    xpp.<a href="#setInput">setInput</a>( new StringReader ( "&lt;foo>Hello World!&lt;/foo>" ) );
                    int eventType = xpp.getEventType();
                    while (eventType != XmlPullParser.END_DOCUMENT) {
                     if(eventType == XmlPullParser.START_DOCUMENT) {
                         System.out.println("Start document");
                     } else if(eventType == XmlPullParser.START_TAG) {
                         System.out.println("Start tag "+xpp.<a href="#getName()">getName()</a>);
                     } else if(eventType == XmlPullParser.END_TAG) {
                         System.out.println("End tag "+xpp.getName());
                     } else if(eventType == XmlPullParser.TEXT) {
                         System.out.println("Text "+xpp.<a href="#getText()">getText()</a>);
                     }
                     eventType = xpp.next();
                    }
                    System.out.println("End document");
                }
            }

위의 예제에서는 다음 출력을 생성합니다.

Start document
            Start tag foo
            Text Hello World!
            End tag foo
            End document

API 사용에 대한 자세한 내용은 에서 사용 가능한 빠른 소개를 참조하세요. http://www.xmlpull.org

에 대한 Java 설명서입니다 org.xmlpull.v1.XmlPullParser.

이 페이지의 일부는 만들고 공유하며 에 설명된 조건에 따라 사용되는 작업을 기반으로 수정됩니다.

필드

FeatureProcessDocdecl

이 기능은 문서 선언이 처리되는지 여부를 결정합니다.

FeatureProcessNamespaces

이 기능은 파서가 네임스페이스를 처리하는지 여부를 결정합니다.

FeatureReportNamespaceAttributes

이 기능은 특성 액세스 메서드를 통해 네임스페이스 특성이 노출되는지 여부를 결정합니다.

FeatureValidation

이 기능이 활성화되면 XML 1에 정의된 모든 유효성 검사 오류가 발생합니다.

NoNamespace

이 상수는 기본 네임스페이스(빈 문자열 "")를 나타냅니다.

속성

AttributeCount

현재 시작 태그의 특성 수를 반환하거나 현재 이벤트 형식이 START_TAG

ColumnNumber

0부터 시작하여 현재 열 번호를 반환합니다.

Depth

요소의 현재 깊이를 반환합니다.

EventType

현재 이벤트(START_TAG, END_TAG, TEXT 등)의 형식을 반환합니다.

Handle

기본 Android 개체의 JNI 값을 가져옵니다.

(다음에서 상속됨 IJavaObject)
InputEncoding

알려진 경우 입력 인코딩을 반환하고, 그렇지 않으면 null을 반환합니다.

IsEmptyElementTag

현재 이벤트가 START_TAG 태그가 퇴화되면 true를 반환합니다(예: <foobar/>).

IsWhitespace

현재 TEXT 이벤트에 공백 문자만 포함되어 있는지 여부를 확인합니다.

JniIdentityHashCode

래핑된 instance 값을 반환 java.lang.System.identityHashCode() 합니다.

(다음에서 상속됨 IJavaPeerable)
JniManagedPeerState

관리되는 피어의 상태입니다.

(다음에서 상속됨 IJavaPeerable)
JniPeerMembers

멤버 액세스 및 호출 지원.

(다음에서 상속됨 IJavaPeerable)
LineNumber

1부터 현재 줄 번호를 반환합니다.

Name

START_TAG 또는 END_TAG 이벤트의 경우 네임스페이스를 사용하도록 설정하면 현재 요소의 (로컬) 이름이 반환됩니다.

Namespace

현재 요소의 네임스페이스 URI를 반환합니다.

PeerReference

JniObjectReference 래핑된 Java 개체 instance 의 를 반환합니다.

(다음에서 상속됨 IJavaPeerable)
PositionDescription

위치, 현재 이벤트에 대한 설명 및 알려진 경우 데이터 원본을 포함하여 현재 파서 상태를 설명하는 짧은 텍스트를 반환합니다.

Prefix

현재 요소의 접두사를 반환합니다.

Text

현재 이벤트의 텍스트 콘텐츠를 String으로 반환합니다.

Types

이 배열은 START_TAG 또는 TEXT와 같은 이벤트 형식 정수 상수를 문자열로 변환하는 데 사용할 수 있습니다.

메서드

DefineEntityReplacementText(String, String)

XML 1.0 섹션 4.5 내부 엔터티 대체 텍스트 생성에 정의된 대로 엔터티 대체 텍스트에 대한 새 값을 설정합니다.

Disposed()

instance 삭제될 때 호출됩니다.

(다음에서 상속됨 IJavaPeerable)
DisposeUnlessReferenced()

이 instance 대한 미해결 참조가 없으면 를 호출Dispose()합니다. 그렇지 않으면 아무 작업도 수행하지 않습니다.

(다음에서 상속됨 IJavaPeerable)
Finalized()

instance 완료될 때 호출됩니다.

(다음에서 상속됨 IJavaPeerable)
GetAttributeName(Int32)

네임스페이스를 사용하는 경우 지정된 특성의 로컬 이름을 반환하거나 네임스페이스를 사용하지 않도록 설정한 경우 특성 이름만 반환합니다.

GetAttributeNamespace(Int32)

지정된 인덱스를 사용하여 특성의 네임스페이스 URI를 반환합니다(0부터 시작).

GetAttributePrefix(Int32)

요소에 접두사를 없으면 지정된 특성의 접두사를 반환 Null을 반환합니다.

GetAttributeType(Int32)

지정된 특성의 형식을 반환합니다. 파서가 유효성을 검사하지 않으면 CDATA를 반환해야 합니다.

GetAttributeValue(Int32)

지정된 특성 값을 반환합니다.

GetAttributeValue(String, String)

네임스페이스 URI 및 네임스페이스 localName으로 식별된 특성 값을 반환합니다.

GetFeature(String)

지정된 기능의 현재 값을 반환합니다.

GetNamespace(String)

파서의 현재 상태에 따라 지정된 접두사에 해당하는 URI를 반환합니다.

GetNamespaceCount(Int32)

지정된 깊이에 대한 네임스페이스 스택의 요소 수를 반환합니다.

GetNamespacePrefix(Int32)

네임스페이스 스택에서 지정된 위치에 대한 네임스페이스 접두사를 반환합니다.

GetNamespaceUri(Int32)

네임스페이스 스택에서 지정된 위치에 대한 네임스페이스 URI를 반환합니다. 위치가 범위를 벗어나면 예외가 throw됩니다.

GetProperty(String)

속성 값을 조회합니다.

GetTextCharacters(Int32[])

현재 이벤트의 텍스트와 현재 이벤트와 관련된 시작 오프셋 및 길이가 포함된 버퍼를 반환합니다.

IsAttributeDefault(Int32)

지정된 특성이 입력에 없는 경우 XML에서 선언된 경우 를 반환합니다.

Next()

다음 구문 분석 이벤트 가져오기 - 요소 콘텐츠가 병합되고 전체 요소 콘텐츠에 대해 하나의 TEXT 이벤트만 반환되어야 합니다(주석 및 처리 지침은 무시되고 엔터티 참조를 확장해야 하거나 엔터티 참조를 확장할 수 없는 경우 예외가 throw되어야 합니다).

NextTag()

next()를 호출하고 START_TAG 또는 END_TAG 그렇지 않으면 예외를 throw하는 이벤트를 반환합니다.

NextText()

현재 이벤트가 START_TAG 경우 next 요소가 TEXT이면 요소 콘텐츠가 반환되거나 다음 이벤트가 END_TAG 빈 문자열이 반환되면 예외가 throw됩니다.

NextToken()

이 메서드는 next()와 유사하게 작동하지만 입력에서 사용할 수 있는 경우 추가 이벤트 형식(COMMENT, CDSECT, DOCDECL, ENTITY_REF, PROCESSING_INSTRUCTION 또는 IGNORABLE_WHITESPACE)을 노출합니다.

Require(XmlPullParserNode, String, String)

현재 이벤트가 지정된 형식인지, 네임스페이스와 이름이 일치하는지 테스트합니다.

SetFeature(String, Boolean)

이 호출을 사용하여 네임스페이스 처리 또는 doctype 선언 처리와 같은 파서의 일반적인 동작을 변경합니다.

SetInput(Reader)

파서의 입력 소스를 지정된 판독기로 설정하고 파서가 다시 설정됩니다.

SetInput(Stream, String)

파서가 처리할 입력 스트림을 설정합니다.

SetJniIdentityHashCode(Int32)

에서 반환 JniIdentityHashCode된 값을 설정합니다.

(다음에서 상속됨 IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)

XML 끌어오기 파서는 XMLPULL V1 API 에 제공된 구문 분석 기능을 정의하는 인터페이스입니다(이 웹 사이트를 방문하여 API 및 해당 구현에 대해 자세히 알아보세요).

(다음에서 상속됨 IJavaPeerable)
SetPeerReference(JniObjectReference)

에서 반환 PeerReference된 값을 설정합니다.

(다음에서 상속됨 IJavaPeerable)
SetProperty(String, Object)

속성 값을 설정합니다.

UnregisterFromRuntime()

런타임이 이후 Java.Interop.JniRuntime+JniValueManager.PeekValue 호출에서 반환되지 않도록 이 instance 등록을 취소합니다.

(다음에서 상속됨 IJavaPeerable)

확장 메서드

JavaCast<TResult>(IJavaObject)

Android 런타임 확인 형식 변환을 수행합니다.

JavaCast<TResult>(IJavaObject)

XML 끌어오기 파서는 XMLPULL V1 API 에 제공된 구문 분석 기능을 정의하는 인터페이스입니다(이 웹 사이트를 방문하여 API 및 해당 구현에 대해 자세히 알아보세요).

GetJniTypeName(IJavaPeerable)

XML 끌어오기 파서는 XMLPULL V1 API 에 제공된 구문 분석 기능을 정의하는 인터페이스입니다(이 웹 사이트를 방문하여 API 및 해당 구현에 대해 자세히 알아보세요).

NextAsync(IXmlPullParser)

XML 끌어오기 파서는 XMLPULL V1 API 에 제공된 구문 분석 기능을 정의하는 인터페이스입니다(이 웹 사이트를 방문하여 API 및 해당 구현에 대해 자세히 알아보세요).

NextTagAsync(IXmlPullParser)

XML 끌어오기 파서는 XMLPULL V1 API 에 제공된 구문 분석 기능을 정의하는 인터페이스입니다(이 웹 사이트를 방문하여 API 및 해당 구현에 대해 자세히 알아보세요).

NextTextAsync(IXmlPullParser)

XML 끌어오기 파서는 XMLPULL V1 API 에 제공된 구문 분석 기능을 정의하는 인터페이스입니다(이 웹 사이트를 방문하여 API 및 해당 구현에 대해 자세히 알아보세요).

NextTokenAsync(IXmlPullParser)

XML 끌어오기 파서는 XMLPULL V1 API 에 제공된 구문 분석 기능을 정의하는 인터페이스입니다(이 웹 사이트를 방문하여 API 및 해당 구현에 대해 자세히 알아보세요).

적용 대상