鸿蒙语言基础类库：ohos.xml xml解析与生成

jf_46214456 2024-07-12 284

电子说

1.3w人已加入

描述

xml解析与生成

说明： 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

导入模块

import xml from '@ohos.xml';

XmlSerializer

constructor

constructor(buffer: ArrayBuffer | DataView, encoding?: string)

XmlSerializer的构造函数。

系统能力： SystemCapability.Utils.Lang

参数：

参数名类型必填说明
bufferArrayBufferDataView是
encodingstring否编码格式。

示例：

var arrayBuffer = new ArrayBuffer(1024);
var bufView = new DataView(arrayBuffer);
var thatSer = new xml.XmlSerializer(bufView);

setAttributes

setAttributes(name: string, value: string): void

设置Attributes方法。

系统能力： SystemCapability.Utils.Lang

参数：

参数名类型必填说明
namestring是属性的key值。
valuestring是属性的value值。

示例：

var arrayBuffer = new ArrayBuffer(1024);
var bufView = new DataView(arrayBuffer);
var thatSer = new xml.XmlSerializer(bufView);
thatSer.setAttributes("importance", "high");

addEmptyElement

addEmptyElement(name: string): void

写入一个空元素。

系统能力： SystemCapability.Utils.Lang

参数：

参数名类型必填说明
namestring是该空元素的元素名。

示例：

var arrayBuffer = new ArrayBuffer(1024);
var bufView = new DataView(arrayBuffer);
var thatSer = new xml.XmlSerializer(bufView);
thatSer.addEmptyElement("b"); // = >

setDeclaration

setDeclaration(): void

设置Declaration方法。

系统能力： SystemCapability.Utils.Lang

示例：

var arrayBuffer = new ArrayBuffer(1024);
var bufView = new DataView(arrayBuffer);
var thatSer = new xml.XmlSerializer(bufView);
thatSer.setDeclaration() // = > < ?xml version="1.0" encoding="utf-8"? >;

startElement

startElement(name: string): void

根据给定名称写入元素开始标记。

系统能力： SystemCapability.Utils.Lang

参数：

参数名类型必填说明
namestring是当前元素的元素名。

示例：

var arrayBuffer = new ArrayBuffer(1024);
var thatSer = new xml.XmlSerializer(arrayBuffer);
thatSer.startElement("notel");
thatSer.endElement();// = > '< notel/ >';

endElement

endElement(): void

写入元素结束标记。

系统能力： SystemCapability.Utils.Lang

示例：

var arrayBuffer = new ArrayBuffer(1024);
var bufView = new DataView(arrayBuffer);
var thatSer = new xml.XmlSerializer(bufView);
thatSer.setNamespace("h", "http://www.w3.org/TR/html4/");
thatSer.startElement("table");
thatSer.setAttributes("importance", "high");
thatSer.setText("Happy");
endElement(); // = > < h:table importance="high" xmlns:h="http://www.w3.org/TR/html4/" >Happy< /h:table >

setNamespace

setNamespace(prefix: string, namespace: string): void

写入当前元素标记的命名空间。

系统能力： SystemCapability.Utils.Lang

参数：

参数名类型必填说明
prefixstring是当前元素及其子元素的前缀。
namespacestring是当前元素及其子元素的命名空间。

示例：

var arrayBuffer = new ArrayBuffer(1024);
var thatSer = new xml.XmlSerializer(arrayBuffer);
thatSer.setDeclaration();
thatSer.setNamespace("h", "http://www.w3.org/TR/html4/");
thatSer.startElement("note");
thatSer.endElement();// = >'< ?xml version="1.0" encoding="utf-8"? >rn< h:note xmlns:h="http://www.w3.org/TR/html4/"/ >';

setComment

setComment(text: string): void

写入comment属性。

系统能力： SystemCapability.Utils.Lang

参数：

参数名类型必填说明
textstring是当前元素的注释内容。

示例：

var arrayBuffer = new ArrayBuffer(1024);
var thatSer = new xml.XmlSerializer(arrayBuffer);
thatSer.startElement("note");
thatSer.setComment("Hi!");
thatSer.endElement(); // = > '< note >rn  < !--Hi!-- >rn< /note >';

setCDATA

setCDATA(text: string): void

写入CDATA属性。

系统能力： SystemCapability.Utils.Lang

参数：

参数名类型必填说明
textstring是CDATA属性的内容。

示例：

var arrayBuffer = new ArrayBuffer(1028);
var thatSer = new xml.XmlSerializer(arrayBuffer);
thatSer.setCDATA('root SYSTEM') // = > '< ![CDATA[root SYSTEM]] >';

setText

setText(text: string): void

设置Text方法。

系统能力： SystemCapability.Utils.Lang

参数：

参数名类型必填说明
textstring是text属性的内容。

示例：

var arrayBuffer = new ArrayBuffer(1024);
var thatSer = new xml.XmlSerializer(arrayBuffer);
thatSer.startElement("note");
thatSer.setAttributes("importance", "high");
thatSer.setText("Happy1");
thatSer.endElement(); // = > '< note importance="high" >Happy1< /note >';

setDocType

setDocType(text: string): void

写入DocType属性。

系统能力： SystemCapability.Utils.Lang

参数：

参数名类型必填说明
textstring是DocType属性的内容。

示例：

var arrayBuffer = new ArrayBuffer(1024);
var thatSer = new xml.XmlSerializer(arrayBuffer);
thatSer.setDocType('root SYSTEM'); // = > '< !DOCTYPE root SYSTEM >';

XmlPullParser

XmlPullParser

constructor(buffer: ArrayBuffer | DataView, encoding?: string)

创建并返回一个XmlPullParser对象，该XmlPullParser对象传参两个, 第一参数是ArrayBuffer或DataView类型的一段内存，第二个参数为文件格式（默认为UTF-8）

系统能力： SystemCapability.Utils.Lang

参数：

参数名类型必填说明
bufferArrayBufferDataView是
encodingstring否编码格式（仅支持utf-8）。

示例：

var strXml =
            '< ?xml version="1.0" encoding="utf-8"? >' +
            '< note importance="high" logged="true" >' +
            '    < title >Happy< /title >' +
            '    < todo >Work< /todo >' +
            '    < todo >Play< /todo >' +
            '< /note >';
var arrayBuffer = new ArrayBuffer(strXml.length*2);
var bufView = new Uint8Array(arrayBuffer);
var strLen = strXml.length;
for (var i = 0; i < strLen; ++i) {
    bufView[i] = strXml.charCodeAt(i);//设置arraybuffer方式
}
var that = new xml.XmlPullParser(arrayBuffer);

parse

parse(option: ParseOptions): void

该接口用于解析xml。

系统能力： SystemCapability.Utils.Lang

参数：

参数名类型必填说明
option[ParseOptions]是用户控制以及获取解析信息的选项。

示例：

var strXml =
            '< ?xml version="1.0" encoding="utf-8"? >' +
            '< note importance="high" logged="true" >' +
            '    < title >Happy< /title >' +
            '    < todo >Work< /todo >' +
            '    < todo >Play< /todo >' +
            '< /note >';
var arrayBuffer = new ArrayBuffer(strXml.length*2);
var bufView = new Uint8Array(arrayBuffer);
var strLen = strXml.length;
for (var i = 0; i < strLen; ++i) {
    bufView[i] = strXml.charCodeAt(i);
}
var that = new xml.XmlPullParser(arrayBuffer);
var arrTag = {};
arrTag[0] = '132';
var i = 1;
function func(key, value){
    arrTag[i] = 'key:'+key+' value:'+ value.getDepth();
    i++;
    return true;
}
var options = {supportDoctype:true, ignoreNameSpace:true, tokenValueCallbackFunction:func}
that.parse(options);

ParseOptions

xml解析选项。

系统能力： 以下各项对应的系统能力均为SystemCapability.Utils.Lang

名称类型必填说明
supportDoctypeboolean否是否忽略Doctype , 默认false。
ignoreNameSpaceboolean否是否忽略NameSpace，默认false。
tagValueCallbackFunction(name: string, value: string)=> boolean否获取tagValue回调函数。
attributeValueCallbackFunction(name: string, value: string)=> boolean否获取attributeValue回调函数。
tokenValueCallbackFunction(eventType: [EventType], value: [ParseInfo])=> boolean否获取tokenValue回调函数。

ParseInfo

当前xml解析信息。

getColumnNumber

getColumnNumber(): number

获取当前列号，从1开始。

系统能力： SystemCapability.Utils.Lang

返回值：

类型说明
number返回当前列号。

getDepth

getDepth(): number

获取元素的当前深度。

系统能力： SystemCapability.Utils.Lang

返回值：

类型说明
number返回元素的当前深度。

getLineNumber

getLineNumber(): number

获取当前行号，从1开始。

系统能力： SystemCapability.Utils.Lang

返回值：

类型说明
number返回当前行号。

getName

getName(): string

获取当前元素名称。

系统能力： SystemCapability.Utils.Lang

返回值：

类型说明
string返回当前元素名称。

getNamespace

getNamespace(): string

获取当前元素的命名空间。

系统能力： SystemCapability.Utils.Lang

返回值：

类型说明
string返回当前元素的命名空间。

getPrefix

getPrefix(): string

获取当前元素前缀。

系统能力： SystemCapability.Utils.Lang

返回值：

类型说明
string返回当前元素前缀。

getText

getText(): string

获取当前事件的文本内容。

系统能力： SystemCapability.Utils.Lang

返回值：

类型说明
string返回当前事件的文本内容。

isEmptyElementTag

isEmptyElementTag(): boolean

判断当前元素是否为空元素。

系统能力： SystemCapability.Utils.Lang

返回值：

类型说明
boolean返回true，当前元素为空元素。

isWhitespace

isWhitespace(): boolean

判断当前文本事件是否仅包含空格字符。

系统能力： SystemCapability.Utils.Lang

返回值：

类型说明
boolean返回true，当前文本事件仅包含空格字符。

getAttributeCount

getAttributeCount(): number

获取当前开始标记的属性数。

系统能力： SystemCapability.Utils.Lang

返回值：

类型说明HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿
number当前开始标记的属性数。

EventType

事件枚举。

系统能力： 以下各项对应的系统能力均为SystemCapability.Utils.Lang

名称枚举值说明
START_DOCUMENT0启动文件事件。
END_DOCUMENT1结束文件事件。
START_TAG2启动标签事件。
END_TAG3结束标签事件。
TEXT4文本事件。
CDSECT5CDATA事件。
COMMENT6XML注释事件。
DOCDECL7XML文档类型声明事件。
INSTRUCTION8XML处理指令声明事件。
ENTITY_REFERENCE9实体引用事件。
WHITESPACE10空白事件。

审核编辑 黄宇

打开APP阅读更多精彩内容
声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。 举报投诉

全部0条评论

快来发表一下你的评论吧 !

下载APP
|投诉反馈|电子发烧友网
© 2021 elecfans.com
湘ICP备2023018690号
×
20
完善资料，
赚取积分