第十二章 XML其他示例

其他示例

Flexible Reader类

/// desc：灵活读取类
ClassMethod Read(mydir, myfile, class, element)
{
    set reader=##class(%XML.Reader).%New()
    if $extract(mydir,$length(mydir))'="/" {set mydir=mydir_"/"}
    set file=mydir_myfile
    set status=reader.OpenFile(file)
    if $$$ISERR(status) {do $System.Status.DisplayError(status)}

    do reader.Correlate(element,class)

    while reader.Next(.object,.status)
    {
        if $$$ISERR(status) {do $System.Status.DisplayError(status)}
        set status=object.%Save()

第十章 XML元素和属性

检查必需的元素和属性

默认情况下，next()方法不检查是否存在与标记为必需的属性相对应的元素和属性。要使读取器检查此类元素和属性是否存在，请在调用Next()之前将读取器的CheckRequired属性设置为1。出于兼容性原因，此属性的默认值为0。

如果将CheckRequired设置为1，并且调用next()，而导入的XML缺少必需的元素或属性，则next()方法会将sc参数设置为错误代码。例如：

为Caché 进行 Prometheus 监控时，配置好应用程序/metrics， Prometheus配置文件配置完成后，抓取不到cache监控数据，提示“server returned HTTP status 404 Not Found”。请问是什么原因？

第九章 将XML导入到对象中

本章介绍如何使用%XML.Reader将XML文档导入到 IRIS对象中。

注意：使用的任何XML文档的XML声明都应该指明该文档的字符编码，并且文档应该按照声明的方式进行编码。如果未声明字符编码， IRIS将使用前面的“输入和输出的字符编码”中描述的默认值。如果这些默认值不正确，请修改XML声明，使其指定实际使用的字符集。

还可以使用%XML.Reader读取任意XML文档并返回DOM(文档对象模型)。

创建XML读取器概述

IRIS提供了一些工具，用于读取XML文档并创建与该文档的元素相对应的启用XML的 IRIS对象的一个或多个实例。基本要求如下：

• 该对象的类定义必须扩展%XML.Adaptor。除了少数例外，该对象引用的类还必须扩展%XML.Adaptor。

提示：如果相应的XML模式可用，可以使用它来生成类(以及任何支持的类)。

为了解国内外最新的互联互通标准，共同助推我国卫生信息互联互通标准化成熟度测评工作，指导各地医院信息平台的建设，《中国卫生信息管理杂志》社决定召开国内外互联互通标准解读与实践线上交流会。会议由《中国卫生信息管理杂志》社主办，InterSystems中国协办，欢迎报名参会！

第八章 Other Options of the Writer

Other Options of the Writer

Canonicalize()

方法的作用是：以规范化的形式编写XML节点。此方法具有以下签名：

本帖概述了通过为 InterSystems 数据平台（InterSystems IRIS、Caché 和 Ensemble）上的数据库磁盘创建 LVM 物理盘区 (PE) 条带来实现低延迟存储 IO 的最佳实践配置，并提供了有用链接。

一致的低延迟存储是获得最佳数据库应用程序性能的关键。 例如，对于在 Linux 上运行的应用程序，经常在数据库磁盘中使用逻辑卷管理器 (LVM) ，因为它能够扩展卷和文件系统，或者为在线备份创建快照。 对于数据库应用程序，在使用 LVM PE 条带化逻辑卷的情况下，并行写入还可提高数据 I/O 的效率，从而有助于提高大规模连续读取和写入的性能。

第六章 控制名称空间的使用

控制名称空间的使用

如将对象投射到XML中所述，可以将类分配给名称空间，以便相应的XML元素属于该名称空间，还可以控制类的属性是否也属于该名称空间。

将类中的对象导出为XML时，%XML.Write提供其他选项，例如指定元素是否为其父级的本地元素。本节包括以下主题：

• 默认情况下，%XML.Writer如何处理命名空间
• 如何指定本地元素是否合格
• 如何指定元素是否为其父元素的本地元素
• 如何指定属性是否合格
• 命名空间分配方式的摘要

注意：在InterSystems IRIS XML支持中，可以按类指定名称空间。通常，每个类都有自己的命名空间声明；但是，通常只需要一个或少量的命名空间。还可以在逐个类的基础上指定相关信息(而不是以某种全局方式)。这包括控制元素是否为其父元素的本地元素以及子元素是否合格的设置。为简单起见，建议使用一致的方法。

第四章 添加命名空间声明

添加命名空间声明

默认行为

在%XML.Writer会自动插入命名空间声明，生成命名空间前缀，并在适当的地方应用前缀。例如，以下类定义：

Class Sample.Person Extends (%Persistent, %Populate, %XML.Adaptor)
{

Parameter NAMESPACE = "http://www.yaoxin.com";
}

如果导出此类的多个对象，则会看到类似以下内容：

请问cahce中所有的数据库访问都是通过cache server完成的吗，比如使用终端访问数据库、studio开发的应用、使用第三方库使用代码都是先访问cache server，然后通过cache server对数据进行存取的吗?使用studio开发的应用程序也是跑在cache server中吗? 如果是的话studio开发的应用程序(比如web程序)如何跟cache server分开部署呢?

第二章 从对象写入XML输出

本章介绍如何从InterSystems IRIS对象生成XML输出。

创建XML编写器概述

InterSystems IRIS提供了用于为InterSystems IRIS对象生成XML输出的工具。可以指定XML投影的详细信息，如将对象投影到XML中所述。然后创建一个Writer方法，该方法指定XML输出的整体结构：字符编码、对象的显示顺序、是否包括处理指令等。

基本要求如下：

• 如果需要特定对象的输出，则该对象的类定义必须扩展%XML.Adaptor。除了少数例外，该对象引用的类还必须扩展%XML.Adaptor。

• 输出方法必须创建%XML.Writer的实例，然后使用该实例的方法。

下面的终端会话显示了一个简单的示例，在该示例中，我们访问启用了XML的对象并为其生成输出：

如果您在升级了系统之后，打开SMP时看到如下报错，
ERROR #5001: 对象的服务器版本与客户端发送的版本不一致: %ZEN.Component.vgroup

一般情况下，这个报错是由浏览器缓存中残留的过期信息造成的，可以通过清除浏览器缓存来解决。

如果清除浏览器缓存之后仍然未能解决此问题，请您前往系统安装目录, 如：d:\InterSystems\IRIS\CSP\broker，查看css/js文件的时间戳在本次更新安装之后是否并没有相应地更新，如果没有，请您做以下尝试，
1）在IRIS中更改数据库IRISLIB, 之前的版本是CACHELIB, 取消只读装载，方法如下，打开管理门户SMP, 系统管理->配置->本地数据库，选择要更改的数据库，取消"只读方式挂载",点击【保存】。
2）重新编译%Zen组件，
w ##class(%SYSTEM.OBJ).Compile("%ZEN.Component.vgroup")
此时，再次前往，d:\InterSystems\IRIS\CSP\broker，会看到相关的css/js文件时间戳已经更新。
3）恢复上述数据库的只读装载。

为什么我用webservice上传文件比csp上传文件快？

webservice用的soap协议也得走http呀。csp直接处理http，少了xml的封装，按理来说应该更快。

经测试，1M的文件，csp慢了0.1s左右。在网关连接到1972后，有0.1s左右的停滞，不知道原因。

有什么办法能够使csp的文件上传速度比webservice快吗？

这是一个系列的第一篇文章。我将使用bpmn符号提供细节，如何开发、部署、保护、运营和消费IRIS数字服务，并与IRIS文档相联系。每一个子流程都将用一个单独的bpmn图来描述。这就是宏观过程。

Documentation links: