IXmlPullParser 인터페이스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
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 ( "<foo>Hello World!</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 값을 반환 |
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 대한 미해결 참조가 없으면 를 호출 |
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) |
에서 반환 |
SetJniManagedPeerState(JniManagedPeerStates) |
XML 끌어오기 파서는 XMLPULL V1 API 에 제공된 구문 분석 기능을 정의하는 인터페이스입니다(이 웹 사이트를 방문하여 API 및 해당 구현에 대해 자세히 알아보세요). (다음에서 상속됨 IJavaPeerable) |
SetPeerReference(JniObjectReference) |
에서 반환 |
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 및 해당 구현에 대해 자세히 알아보세요). |