第三章 使用$ZF(-100)运行程序或系统命令

$ZF(-100)函数允许 IRIS 进程调用可执行程序或主机操作系统的命令。这是唯一可以在没有特殊的Callout共享库的情况下使用的函数。

• $ZF(-100)的语法和功能概述。
• 程序执行-程序可以选择异步运行或在操作系统外壳中运行。
• 记录命令和重定向输出——可选设置可以记录命令或重定向I/O。
• 添加%System_Callout:USE特权—使用$ZF(-100)需要此特权。

注意:$ZF(-100)取代了已弃用的函数和，在所有情况下都应优先使用。

介绍

提供类似于命令行接口的功能，允许调用可执行程序或主机操作系统的命令。这个函数的语法是:

第一个参数必须是字面量。其他三个参数指定以下信息:

• - 包含指定各种选项的关键字的字符串。例如，字符串指定程序应该异步运行，并将命令行写入日志文件。
• Command - 指定要调用的程序或系统命令的字符串。如果未指定可执行文件的完整路径，则操作系统将应用标准搜索路径规则。
• 参数 - 命令参数被指定为一系列以逗号分隔的表达式(如下面的示例所示)。

函数返回由操作系统和被调用的程序确定的退出状态码。

下面的示例将三个字符串传递给命令，然后显示状态码。这个例子没有使用关键字，所以关键字参数是一个空字符串。最后一个命令参数指定一个带引号的字符串(遵循标准的

第二章 $ZF Callout函数概述

IRIS $ZF系统功能是一套相关功能的容器。$ZF套件中的大多数函数都由函数调用的第一个参数标识，该参数将是一个负数，-100或到。例如，调用操作系统命令的函数具有)的形式，其中是包含要执行的命令的字符串。当讨论这个函数时，它将被称为。以同样的方式，其他函数将被称为$ZF(-3)到，只使用实际函数调用的第一个参数。也可以在不带负数参数的情况下调用函数，在这种情况下，它调用名为的特殊库中的函数。

注:是动态链接的文件(为DLL文件，及相关操作系统为文件)。库是一个共享库，它包含到接口的钩子，允许各种函数在运行时加载它并调用库函数。

函数集包括以下接口:

函数(不带负数参数)

主要的$ZF()函数提供了对来自名为iriszf的特殊库的函数的直接访问。当定义并编译了这个自定义库后，只需指定函数名和参数(例如，，就可以调用它的函数。与、或不同，不需要加载库或指定库标识符。

函数

函数用于运行shell命令和操作系统服务调用。它不用于访问库，可以在没有任何先前设置的情况下调用。

函数

函数是一种加载库并使用一条语句调用库函数的简单方法。库及其函数都是通过名称指定的，并且库保留在内存中，直到被对另一个库的调用所替换。

函数

函数为和提供了一组服务。它是由前两个参数(到)标识的八个效用函数的容器。

第四十一章 XML 映射参数摘要

第四十章 其他特殊主题 - 处理导入时意外的元素和属性

处理导入时意外的元素和属性

由于源 XML 文档可能包含意外的元素和属性，因此支持 XML 的类提供两个参数来指定导入此类文档时如何反应。例如，考虑以下类定义：

Class GXML.TestImportParms.Person Extends (%Persistent,%XML.Adaptor) 
{

Property Name As %Name [ Required ];
Property DOB As %Date(FORMAT = 5, MAXVAL = "+$h") [ Required ];
}

另请考虑以下 文档：

<?xml version="1.0" encoding="UTF-8"?>
<Root>
   <Person employeeID="450">
      <Name>Dillard, Daniel</Name>
      <DOB>1962-09-18</DOB>
      <UserID>fr0078</UserID>
      <Address>
         <Street>810 Main Street</Street>
         <City>Reston</City>
         <State>NJ</State>
         <Zip>02641</Zip>
      </Address>
   </Person>
</Root>

第三十九章 其他特殊主题 - 映射 IRIS ID 以供导出

当在顶层映射 IRIS 对象（而不是作为另一个对象的属性）时，其内部 ID、OID 和全局唯一 不能用作对象属性，因此不会映射这些 。但是，在某些情况下，可能希望使用对象 作为唯一标识符。然后，例如，可以在更新存储的对象之前将传入（已更改）的对象与相应的存储对象进行匹配。

支持提供了多个帮助程序类，可用于将 对象标识符投影到 XML 文档： 中（对于内部 ID）、（对于 ``）和 （用于全局唯一 ）。

要使用这些类，请向支持 的类添加一个特殊属性，该属性的用途是包含要导出的 。该属性的类型必须为 %XML.Id、或 。确保该属性已映射，并将其标记为瞬态，以便它不包含在该类的 映射中。

当导出到 时，将支持 的类的对象带入内存。当对象位于内存中时，添加的特殊属性将从 IRIS 内部存储中检索请求的 并包含该值（以便您可以导出它）。

例如，考虑以下类：

Class MyApp4.Obj.Person4 Extends (%Persistent,%Populate,%XML.Adaptor) 
{

Property IdForExport As %XML.Id 
(XMLNAME="IRISID", XMLPROJECTION="ELEMENT") [Private, Transient];

Property Name As %Name;

Property DOB As %Date(FORMAT = 5, MAXVAL = "+$h");

}

第三十八章 其他特殊主题

类和属性参数

• XMLNAME
• XMLSEQUENCE
• XMLUNSWIZZLE

控制元素的关闭

在 XML 中，仅包含属性的元素可以用以下任一方式表示：

IRIS 认为这些形式是等效的。当使用 %XML.Writer 导出对象时，可以控制关闭形式，但不能通过修改 投影本身来控制。

处理具有多个同名标签的文档

中的给定元素可以包含多个具有相同名称的元素；这些元素通过它们的顺序彼此区分。例如，以下是一个合法的 文档：

<?xml version="1.0" encoding="UTF-8"?>
<Root>
   <Person>
      <Name>Able, Andrew</Name>
      <DOB>1977-10-06</DOB>
      <Address>
         <Street>6218 Clinton Drive</Street>
         <City>Reston</City>
         <State>TN</State>
         <Zip>87639</Zip>
      </Address>
      <Address>
         <Street>110 High Street</Street>
         <City>Zanesville</City>
         <State>OR</State>
         <Zip>80719</Zip>
      </Address>
   </Person>
</Root>

第三十七章 XML 模式的高级选项 - 超类如何表示为类型

超类如何表示为类型

如果需要 XML 架构来显示特定的类型层次结构，则需要了解映射如何解释 IRIS 类层次结构。

类层次结构代表了有意义的数据组织等。该层次结构尽可能地反映在相应的 XML 类型定义中。

例如，假设有以下类：

• 名为 Base 的类，定义了三个公共属性（Property1、 和 ）。
• 名为 的类，它扩展 并定义一个附加公共属性 (Addition1)。
• 名为 的类，它扩展 并定义一个附加公共属性 (Addition2)。

的架构应包含什么？它必须代表所有五个属性。另外，因为这些类都是用户定义的，所以 的架构应该显示类层次结构的详细信息；相反，如果 Base 从 类库扩展一个类，而 类库又从该库扩展其他类，那么这些细节就不那么有趣了。

相应地， 的 模式默认如下所示：

<s:complexType name="Addition2">
    <s:complexContent>
        <s:extension base="Addition1">
            <s:sequence>
                <s:element name="Addition2" type="s:decimal" minOccurs="0" />
            </s:sequence>
        </s:extension>
    </s:complexContent>
</s:complexType>
<s:complexType name="Addition1">
    <s:complexContent>
        <s:extension base="Base">
            <s:sequence>
                <s:element name="Addition1" type="s:string" minOccurs="0" />
            </s:sequence>
        </s:extension>
    </s:complexContent>
</s:complexType>
<s:complexType name="Base">
    <s:sequence>
        <s:element name="Property1" type="s:string" minOccurs="0" />
        <s:element name="Property2" type="s:decimal" minOccurs="0" />
        <s:element name="Property3" type="s:date" minOccurs="0" />
    </s:sequence>
</s:complexType>

第三十六章 XML 模式的高级选项 - 创建子类型的替换组

创建子类型的替换组

XML 模式规范还允许定义替换组，这可以是创建选择的替代方法。语法有些不同。

第三十五章 XML 模式的高级选项 - 创建子类型的选择列表

创建子类型的选择列表

根据 XML Schema 规范，复杂类型可以由类型（特别是相关类型）的选择列表组成。假设我们希望架构允许使用 , , or 元素，而不是 元素。要定义这样的架构，我们会将 Person 属性的 属性参数设置为等于“CHOICE”，如下所示：

Class UsingSubclasses.Example2 Extends (%Persistent, %XML.Adaptor)
{
Property Person As UsingSubclasses.Person(XMLTYPECONSTRAINT = "CHOICE");
}

默认情况下，选择列表由 类的所有子类组成。示例 的架构如下：

<s:complexType name="Example2">
    <s:sequence>
        <s:choice minOccurs="0">
            <s:element name="Employee" type="Employee" />
            <s:element name="Patient" type="Patient" />
            <s:element name="Person" type="Person" />
        </s:choice>
    </s:sequence>
</s:complexType>
<s:complexType name="Employee">
    <s:complexContent>
        <s:extension base="Person">
            <s:sequence>
                <s:element name="EmployeeID" type="s:string" />
            </s:sequence>
        </s:extension>
    </s:complexContent>
</s:complexType>
<s:complexType name="Person">
    <s:sequence>
        <s:element name="Name" type="s:string" />
        <s:element name="DOB" type="s:date" />
    </s:sequence>
</s:complexType>
<s:complexType name="Patient">
    <s:complexContent>
        <s:extension base="Person">
            <s:sequence>
                <s:element name="PatientID" type="s:string" />
            </s:sequence>
        </s:extension>
    </s:complexContent>
</s:complexType>

第三十四章 XML 模式的高级选项

类和属性参数

• XMLTYPECONSTRAINT

• XMLINCLUDEINLIST

• XMLINHERITANCE

自动创建子类的类型

当为一个类定义 XML 投影时，它的所有子类都会自动映射到单独的类型，所有这些类型都使用超类作为基类型。这意味着无论何时使用超类型，都可以使用其中一种子类型。还可以使用子类型在 XML 模式中定义选择列表或替换组。

请注意，可以为抽象类定义 XML 映射；该类在任何派生类模式中都显示为基类型，尽管它是抽象的，无法实例化。

考虑一个例子。我们从一个简单的 类开始：

Class UsingSubclasses.Person Extends (%Persistent, %XML.Adaptor)
{
Property Name As %String [Required];
Property DOB As %Date(FORMAT = 5, MAXVAL = "+$h") [Required];
}

假设我们有两个直接基于 Person 类的类。首先是 Patient 类：

Class UsingSubclasses.Patient Extends UsingSubclasses.Person
{
Property PatientID As %String [Required];
}

第三十三章 控制到 XML 模式的映射 - 其他支持 XML 的类到 XML 类型的映射

其他支持 XML 的类到 XML 类型的映射

对于支持 XML 的类或基于支持 的类的属性，XML 类型按如下方式确定： 如果该类具有 参数的值，则该值将用作类型名称。否则，短类名将被视为 类型名。

例如，考虑以下类定义：

Class GXML.PersonWithAddress Extends (%Persistent, %XML.Adaptor) 
{
Parameter XMLTYPE = "PersonType";

Property Name As %Name;

Property DOB As %Date(FORMAT = 5, MAXVAL = "+$h");

Property HomeAddress As GXML.Address;

}

对于此类的实例， 类型是 ，它取自 参数。

假设 类不包含 参数。在本例中，对于 元素， 类型是 ，它是短类名。

指定类型的命名空间

类型分配给命名空间，如下所示：

1. 如果相应的类定义定义了 XSDTYPE 类参数，则该类型位于以下 W3 命名空间中：

http://www.w3.org/2001/XMLSchema

只能在数据类型类中指定 。

注意：数据类型类不继承 类参数。

第三十二章 控制到 XML 模式的映射 - %ListOfObjects

本部分显示了从支持 XML 的类生成的 XML架构的一部分，该类包含定义为 %ListOfObjects 的属性。例如，考虑以下属性定义：

Property PropName As list Of %Integer(XMLITEMNAME = "MyXmlItemName");

如果此属性位于名为 的启用 的类中，则该类的 XML 架构包含以下内容：

<schema xmlns="http://www.w3.org/2001/XMLSchema" xmlns:s="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" 
targetNamespace="mytypes">
  <complexType name="DemoObjList1">
    <sequence>
      <element minOccurs="0" name="PropName" type="s01:ArrayOfMyXmlItemNameRegisteredObject" xmlns:s01="mytypes"/>
    </sequence>
  </complexType>
  <complexType name="ArrayOfMyXmlItemNameRegisteredObject">
    <sequence>
      <element maxOccurs="unbounded" minOccurs="0" name="MyXmlItemName" nillable="true" type="s01:RegisteredObject" xmlns:s01="mytypes"/>
    </sequence>
  </complexType>
...
</schema>

第三十一章 控制到 XML 模式的映射 - %ListOfDataTypes

%ListOfDataTypes

本部分显示从支持 XML 的类生成的 XML 架构的一部分，该类包含中定义为%ListOfDataTypes 的属性。例如，考虑以下属性定义：

Property PropName As %ListOfDataTypes(XMLITEMNAME = "MyXmlItemName");

如果此属性位于名为 的启用 的类中，则该类的 XML 架构包含以下内容：

<schema xmlns="http://www.w3.org/2001/XMLSchema" xmlns:s="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" targetNamespace="mytypes">
  <complexType name="DemoList">
    <sequence>
      <element minOccurs="0" name="PropName" type="s01:ArrayOfMyXmlItemNameString" xmlns:s01="mytypes"/>
    </sequence>
  </complexType>
  <complexType name="ArrayOfMyXmlItemNameString">
    <sequence>
      <element maxOccurs="unbounded" minOccurs="0" name="MyXmlItemName" nillable="true" type="s:string"/>
    </sequence>
  </complexType>
</schema>

第三十章 控制到 XML 模式的映射 - Array of Classname

Array of Classname

本部分显示了从启用 XML 的类生成的XML 架构的一部分，此时该类包含定义为类名数组的属性。例如，考虑以下属性定义：

Property PropName As array Of %Integer(XMLITEMNAME = "MyXmlItemName", XMLKEYNAME = "MyXmlKeyName");

如果此属性位于名为 的启用 XML 的类中，则该类的 XML 架构包含以下内容：

<schema xmlns="http://www.w3.org/2001/XMLSchema" xmlns:s="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" targetNamespace="mytypes">
  <complexType name="DemoArray1">
    <sequence>
      <element minOccurs="0" name="PropName" type="s01:ArrayOfMyXmlItemNamePairOfMyXmlKeyNameLong" xmlns:s01="mytypes"/>
    </sequence>
  </complexType>
  <complexType name="ArrayOfMyXmlItemNamePairOfMyXmlKeyNameLong">
    <sequence>
      <element maxOccurs="unbounded" minOccurs="0" name="MyXmlItemName" nillable="true" type="s01:PairOfMyXmlKeyNameLong" xmlns:s01="mytypes"/>
    </sequence>
  </complexType>
  <complexType name="PairOfMyXmlKeyNameLong">
    <simpleContent>
      <extension base="s:long">
        <attribute name="MyXmlKeyName" type="s:string" use="required"/>
      </extension>
    </simpleContent>
  </complexType>
...
</schema>

浅谈一下个人基于IRIS后端业务开发框架的理解

现状

由于国内使用基于M语言IRIS平台几乎都在医疗行业。医疗系统又非常的庞大和复杂。前期由于快速占领市场，系统数量越来越多，到了临界点后就产生了质变，所以前期基于功能的线性开发注重效率，所以导致大量的产品业务代码有如下集中情况：

• 系统交互乱如麻，各系统的交互关系变成了网状。
• 系统规模庞大，内部耦合严重，牵一发而动全身，后续修改和扩展困难，开发效率低。
• 关键功能逻辑复杂，容易出现问题，出现问题后很难排查和修复，开发成本高。
• 功能越来越多，导致系统复杂度指数级上升。
• 重复造轮子，相似的功能不断重复开发。

如上图所示，这仅仅是展示了五个模块之前的交互，在此基础上继续增加模块则复杂度成指数级上升，并且如果每个模块之间如果没有做好接口管理，维护起来也是地狱级别。

如何解决这个问题，一般会分为两派：优化派与架构派。

优化派的思想是将现有的系统优化。例如重构某个方法，优化某个SQL。优化派的优势是针对系统改动较小，可以保持系统的稳定性，可以快速实施，缺点是治标不治本，随着需求越来越多，增加的代码量越多，后期还是会撑不住。

架构派的核心思想是调整系统架构，将原来的大系统拆分为多个互相配合的小系统，例如药库系统拆分为，采购模块，订单模块，查询模块，分析模块等。架构派的优势是一次调整可以支撑比较长期的业务发展，缺点是动作较大，耗时较长，稳定性需要项目考验。

[toc]

第三十三章 Objects - OREFs

OREFs

对象类的 %New() 方法创建一个内部内存结构来包含对象的数据，并返回指向该结构的 OREF（对象引用）。 OREF 是 中的一种特殊值。应该记住以下几点：

• 在终端中，OREF 的内容取决于所使用的语言：
  • 在 ObjectScript 中，会看到一个由数字、@ 符号和类名称组成的字符串。
  • 在 Python 中，会看到一个包含类名和内存中 个字符的唯一位置的字符串。

例如：

TESTNAMESPACE>set myobj=##class(Sample.Person).%New()
 
TESTNAMESPACE>w myobj
3@Sample.Person 

>>> myobj=iris.cls("Sample.Person")._New()
>>> print(myobj)
<iris.Sample.Person object at 0x000001A1E52FFD20>

• 如果没有使用预期的 或者使用了错误类型的 ， 将返回错误。此错误与 终端和 终端不同：

TESTNAMESPACE>set x=2

TESTNAMESPACE>set x.Name="Fred Parker"

SET x.Name="Fred Parker"
^
<INVALID OREF>

第三十一章 Classes - 继承规则

继承规则

与其他基于类的语言一样，可以通过继承组合多个类定义。 类定义可以扩展（或继承）多个其他类。这些类又可以扩展其他类。

请注意，类不能继承 Python 中定义的类（即 .py 文件中包含的类定义），反之亦然。

以下小节提供了中类继承的基本规则。

继承顺序

使用以下继承顺序规则：

1. 默认情况下，如果在多个超类中定义了给定名称的类成员，则子类将从超类列表中最左边的类中获取定义。
2. 如果类定义包含 Inheritance = right，则子类从超类列表中最右侧的类中获取定义。

由于历史原因，大多数类都包含 。

主要的超类

任何扩展其他类的类都有一个主要超类。

无论类使用哪种继承顺序，主超类都是第一个，从左到右阅读。

对于任何类级编译器关键字，给定类使用其主超类中指定的值。

对于持久化类来说，主超类尤其重要。

最具体的类型类Most-Specific Type Class

尽管一个对象可以是属于多个类extent的实例（例如各种超类的extent），但它始终具有最特定的类型类 ()。当该对象是该类的实例但不是该类的任何子类的实例时，类是该对象的最具体类型。

重写方法

类从其一个或多个超类继承方法（类方法和实例方法），可以覆盖这些方法。如果这样做，必须确保方法定义中的签名与要重写的方法的签名匹配。

第三十章 Classes - 方法生成器

方法生成器

方法生成器是类编译器在类编译期间调用的程序。它的输出是该方法的实际运行时实现。方法生成器提供了一种继承方法的方法，可以生成根据继承类或属性的需要定制的高性能、专用代码。在 IRIS 库中，方法生成器广泛用于数据类型和存储类。

Class Queries

类可以包含类查询。类查询定义可由该类使用的 SQL 查询，并指定用作查询容器的类。下面显示了一个示例：

Query QueryName(Parameter As %String) As %SQLQuery
{
SELECT MyProperty, MyOtherProperty FROM MyClass
 WHERE (MyProperty = "Hello" AND MyOtherProperty = :Parameter)
 ORDER BY MyProperty
}

定义类查询以提供预定义的查找以供在应用程序中使用。例如，可以按某些属性（例如按名称）查找实例，或提供满足一组特定条件的实例列表，例如从巴黎到马德里的所有航班。此处显示的示例使用参数，这是提供灵活查询的常用方法。请注意，可以在任何类中定义类查询；不需要在持久类中包含类查询。

第二十八章 Classes - 引用其他类的方法

引用其他类的方法

在方法(或例程)中，使用下面的语法来引用其他类中的方法:

要调用类方法并访问其返回值，请使用如下表达式:

 ##class(Package.Class).MethodName(arguments)

iris.cls("Package.Class").MethodName(arguments)

例如：

 Set x=##class(Util.Utils).GetToday()

也可以调用一个类方法而不访问它的返回值，如下所示:

注意:##class不区分大小写。

• 要调用实例方法，创建一个实例，然后在ObjectScript或Python中使用如下表达式来调用该方法并访问其返回值:

例如：

你也可以在不访问返回值的情况下调用实例方法，方法如下:

并非所有方法都有返回值，因此请选择适合情况的语法。

对当前实例的引用

在实例方法中，有时需要引用当前实例本身，而不是实例的属性或方法。例如，在调用其他代码时，可能需要将当前实例作为参数传递。

在ObjectScript中，使用特殊变量$THIS来引用当前实例。在Python中，使用变量来引用当前实例。

第二十七章 Classes - 引用其他类成员

引用其他类成员

在方法中，使用下面的语法来引用其他类成员:

• 要引用ObjectScript中的参数，使用如下表达式:

 ..#PARAMETERNAME

只能使用ObjectScript直接访问参数。要从Python访问参数，请使用ObjectScript包装器方法返回参数，并在需要时调用此方法。例如:

Class User.Employee Extends %RegisteredObject
{

Parameter ADDRESS = "123 Main St.";

ClassMethod AddressWrapper() As %String [ Language = objectscript ]
{
    return ..#ADDRESS
}

ClassMethod OfficeLocation() [ Language = python ]
{
    import iris
    location=iris.cls("User.Employee").AddressWrapper()
    print("This office is located at", location)
}

Method EmployeeLocation() [ Language = python ]
{
    location=self.AddressWrapper()
    print("This employee works at", location)
}

}

第二十六章 Classes - Methods

Methods

方法有两种：实例方法和类方法（在其他语言中称为静态方法）。

指定方法关键字

在方法定义中，可以包含影响方法行为的可选编译器关键字。以下列表显示了一些最常见的方法关键字：

Language

在 IRIS 中，可以用 ObjectScript 或 Python 编写方法。要指定编写方法所用的语言，请使用以下语法：

Method MyMethod() [ Language = objectscript ]
{
    // implementation details written in ObjectScript
}

Method MyMethod() [ Language = python ]
{
    # implementation details written in Python
}

如果方法不使用 关键字，编译器将默认该方法是用 编写的。

必须以全部小写字母编写方法的语言，如示例中所示。

Private

该关键字指定该方法是私有的，并且只能与 方法一起使用。子类继承 关键字的值并且不能覆盖它。

默认情况下，方法是公共的并且可以在任何地方访问。可以将方法标记为私有（通过 Private 关键字）。如果你这样做：

• 只能通过它所属类的方法来访问。
• 没有出现在类参考中。

然而，它是继承的并且在定义该方法的类的子类中可用。

第二十五章 Classes - 基于数据类型的属性

基于数据类型的属性

当定义属性并将其类型指定为数据类型类时，可以使用特殊选项来定义和使用该属性，如本节中所述。

数据类型类

数据类型类使能够强制执行有关属性值的规则集。

IRIS 提供的数据类型类包括 %Library.String、 %Library.Integer、 、等等。因为 包的类名可以缩写，所以可以缩写其中的许多类；例如， 是 的缩写。

每个数据类型类都具有以下特征：

• 它指定编译器关键字的值。对于属性，编译器关键字可以执行以下操作：

  • 使属性成为必需的
  • 指定属性的初始值
  • 控制如何将属性映射到 SQL、ODBC 和 Java 客户端

• 它指定影响细节的参数值，如下所示：

  • 数据类型允许的最大和最小逻辑值
  • 字符串可以包含的最大和最小字符数
  • 小数点后的位数
  • 如果字符串超过最大字符数是否截断
  • 显示格式
  • 如何转义任何特殊的 或 字符
  • 可在任何用户界面中使用的逻辑值和显示值的枚举列表
  • 字符串必须匹配的模式（自动使用模式匹配运算符）
  • 导入或导出到 XML 时是否尊重或忽略 时区

• 它提供了一组方法来在存储（磁盘上）、逻辑（内存中）和显示格式之间转换文字数据。

可以添加自己的数据类型类。例如，以下显示了 的自定义子类：

Class MyApp.MyType Extends %Library.String
{

/// The maximum number of characters the string can contain.
Parameter MAXLEN As INTEGER = 2000;

}

第二十四章 Classes - 指定属性关键字

指定属性关键字

在属性定义中，可以包含影响属性使用方式的可选属性关键字。以下列表显示了一些最常见的关键字：

Required

指定可以将此类实例之前设置的属性值存储到磁盘。默认情况下，属性不是必需的。在子类中，可以将可选属性标记为必需，但不能执行相反的操作。

InitialExpression

指定属性的初始值。默认情况下，属性没有初始值。子类继承InitialExpression关键字的值并且可以覆盖它。指定的值必须是有效的 表达式。

Transient

指定该属性不存储在数据库中。默认情况下，属性不是瞬态的。子类继承 关键字的值并且不能覆盖它。

指定该属性是私有的。子类继承 Private 关键字的值并且不能覆盖它。

默认情况下，属性是公共的并且可以在任何地方访问。可以将属性标记为私有（通过 关键字）。如果是这样，则只能通过其所属对象的方法来访问它

在 中，私有属性始终是继承的，并且对定义该属性的类的子类可见。

在其他编程语言中，这些通常称为受保护的属性。

Calculated

指定在实例化包含该属性的对象时，没有为其分配内存存储。默认情况下，不计算属性。子类继承了关键字并且不能重写它。

指定属性是多维的。该属性与其他属性的不同之处如下：

• 没有关联的方法。
• 当验证或保存对象时，会被忽略。

第二十三章 Classes - 属性

形式上 IRIS 有两种属性：

• 属性，保存值。该值可以是以下任意值：

  • 单个文字值，通常基于数据类型。
  • 对象值（包括集合对象和流对象）。
  • 多维数组。这种情况不太常见。

  属性一词通常仅指作为properties的attributes，而不是指具有关联的属性。

• 关系，保持对象之间的关联。

可以在包含 ObjectScript 方法、 方法或两者组合的类中定义属性。但是，无法从 Python 方法访问关系。本节展示了一个示例类，其中包含显示以下一些变体的属性定义：

Class MyApp.Main.Patient Extends %Persistent
{

Property PatientID As %String [Required];

Property Gender As %String(DISPLAYLIST = ",Female,Male", VALUELIST = ",F,M");

Property BirthDate As %Date;

Property Age As %Numeric [Transient];

Property MyTempArray [MultiDimensional];

Property PrimaryCarePhysician As Doctor;

Property Allergies As list Of PatientAllergy;

Relationship Diagnoses As PatientDiagnosis [ Cardinality = children, Inverse = Patient ]; 
}

第二十二章 Classes - 调用类方法的快捷方式

调用类方法的快捷方式

使用 ObjectScript 调用类方法时，在以下情况下可以省略包（或更高级别的包）：

• 引用是在一个类内，并且被引用的类在同一个包或子包中。
• 引用位于类内，并且该类使用 IMPORT 指令导入包含引用的类的包或子包。
• 该引用位于方法内，并且该方法使用 IMPORT 指令导入包含引用的类的包或子包。

从 ObjectScript 或 调用类方法时，在以下情况下可以省略包（或更高级别的包）：

• 指的是 %Library 包中的一个类，该类是经过特殊处理的。可以将类 %Library.ClassName 引用为 %ClassName。例如，可以将 引用为 。
• 指的是 包中的一个类，该类是经过特殊处理的。例如，可以将 引用为 。

在 User 包中不提供任何类，这些类是保留给使用的。

在所有其他情况下，必须始终使用完整的包和类名称来调用类方法。

类参数

类参数定义一个对于给定类的所有对象都相同的值。除了极少数例外，该值是在编译类时确定的，并且不能在运行时更改。将类参数用于以下目的：

• 定义一个在运行时无法更改的值。
• 定义有关类定义的用户特定信息。类参数只是一个任意的名称-值对；可以使用它来存储您喜欢的有关课程的任何信息。
• 自定义各种数据类型类用作属性时的行为（例如提供验证信息）；这将在下一节中讨论。

第十九章 ObjectScript - 执行例程

执行例程

执行例程时，使用DO命令，如下所示:

 do ^routinename

要执行一个过程、函数或子程序(不访问其返回值)，可以使用以下命令:

 do label^routinename

或

 do label^routinename(arguments)

要执行过程、函数或子例程并引用其返回值，可以使用$$label^routinename或(参数)形式的表达式。例如:

 set myvariable=$$label^routinename(arguments)

在所有情况下，如果标签位于同一个例程中，则可以省略插入符号和例程名称。例如:

在所有情况下，传递的参数可以是文字值、表达式或变量名。

New 命令

IRIS提供了另一种机制，使能够控制例程中变量的作用域:命令。此命令的参数是一个或多个变量名，以逗号分隔的列表表示。变量必须是公共变量，不能是Global。

该命令为变量建立一个新的有限上下文(可能已经存在，也可能不存在)。例如，考虑下面的例程:

运行完这个例程后，变量可用，变量不可用，如下例所示:

如果该变量在使用之前已经存在，那么在NEW作用域结束后，该变量仍然存在，并保留其先前的值。

第十八章 ObjectScript - 使用例程

例程

可以将例程视为 ObjectScript 程序。例程可以从头开始编写，也可以在编译类时自动生成。

Procedures, Functions, and Subroutines 过程、函数和子程序

在 例程中，标签定义以下代码单元之一的起点：

• Procedures过程（可选地返回一个值）。过程中定义的变量是该过程私有的，这意味着它们不可用于其他代码。对于函数和子例程来说，情况并非如此。

过程也称为过程块。

• 函数（返回值）。
• 子例程（不返回值）。

建议使用过程，因为这可以简化控制变量范围的任务。然而，在现有代码中，可能还会看到函数和子例程，并且能够识别它们非常有用。以下列表显示了所有这些形式的代码的外观。

procedure

或者

label(args) scopekeyword {
    zero or more lines of code 
    }

是过程的标识符。

args 是可选的以逗号分隔的参数列表。即使没有参数，也必须包含括号。

可选的是以下之一（不区分大小写）：

• Public - 如果指定 Public，则该过程是公共的，并且可以在例程本身之外调用。
• （过程的默认值）。如果指定 ，则该过程是私有的，只能由同一例程中的其他代码调用。

第十七章 ObjectScript - 使用宏和包含文件

使用宏和包含文件

如前所述，可以定义宏并稍后在同一类或例程中使用它们。更常见的是，在包含文件中定义它们。

Macros

ObjectScript 支持定义替换的宏。定义可以是一个值、整行代码或（使用 ##continue 指令）多行。

要定义宏，请使用 指令或其他预处理器指令。例如：

#define macroname <definition> 

要引用宏，请使用以下语法：

$$$macroname

或者：

$$$macroname(arguments)

使用宏来确保一致性。例如：

为了让了解宏可以做什么，以下示例显示了内部使用的宏的定义：

这个宏接受参数，就像许多宏一样。它还引用了另一个宏。

一些系统类广泛使用宏。

预处理器指令记录在 宏和使用 中的宏预处理器中。

注意：管理门户列出了包含例程的Include files 。然而，Include files 实际上并不是例程，因为它们不可执行。

可以在类或例程中定义宏，并稍后在同一类或例程中使用它们。更常见的是，在中心位置定义它们。为此，需要创建并使用包含文件。包含文件定义宏，并且可以包含其他包含文件，并且是扩展名为 .inc 的文档。

创建包含文件后，可以执行以下操作：

• 在任何例程的开始处包含

第十六章 ObjectScript - 日期和时间值

日期和时间值

当地时间

要访问当前进程的日期和时间，可以使用 $HOROLOG 特殊变量。因此，在许多 IRIS 应用程序中，日期和时间都以此变量使用的格式存储和传输。这种格式通常称为$H 格式或 格式。

从操作系统检索日期和时间，因此始终位于本地时区。

IRIS 类库包含以更常见的格式（例如 ODBC）表示日期的数据类型类，许多应用程序使用这些数据类型而不是 $H 格式。请注意，通过数据类型类中的 支持 时间，新应用程序应使用该类来表示日期/时间值。

UTC Time

IRIS 还提供 $ZTIMESTAMP 特殊变量，其中包含 格式的协调世界时值形式的当前日期和时间。这是全球时间和日期标准；该值很可能与本地时间（和日期）值不同。

日期和时间转换

包含用于转换日期和时间值的函数。

给定 格式的日期，函数 返回一个表示指定格式的日期的字符串。

例如：

给定 格式的日期和时间，函数 $ZDATETIME 返回一个表示指定格式的日期和时间的字符串。

TESTNAMESPACE>WRITE $ZDATETIME($HOROLOG,3)
2010-12-03 14:55:48

• 给定其他格式的字符串日期和时间，函数 和 将它们转换为 格式。
• 函数 和 将时间与

第十四章 ObjectScript - 系统函数

系统函数

本节重点介绍 ObjectScript 中一些最常用的系统函数。

这些函数的名称不区分大小写。

类库还提供了大量实用方法，可以像使用函数一样使用它们。

Value Choice

在给定一些输入的情况下，可以使用以下函数来选择一个值：

• $CASE 将给定的测试表达式与一组比较值进行比较，然后返回与匹配的比较值关联的返回值。例如：

TESTNAMESPACE>set myvar=1
 
TESTNAMESPACE>write $CASE(myvar,0:"zero",1:"one",:"other")
one

• $SELECT 检查一组表达式并返回与第一个 true 表达式关联的返回值。例如：

TESTNAMESPACE>set myvar=1
 
TESTNAMESPACE>write $SELECT(myvar=0:"branch A",1=1:"branch B")
branch B

存在函数

可以使用以下函数来测试变量或变量节点是否存在。

• 要测试特定变量是否存在，请使用 $DATA 函数。

对于包含多个节点的变量，该函数可以指示给定节点是否存在，以及给定节点是否有值和子节点。

• 要获取变量的值（如果存在）或获取默认值（如果不存在），请使用 函数。

列表函数

提供本机列表格式。