第十三章 SQL命令 CREATE ROLE

创建角色

大纲

CREATE ROLE role-name

参数

• role-name - 要创建的角色的名称，它是一个标识符。角色名称不区分大小写。

描述

CREATE ROLE命令可创建角色。角色是可以分配给多个用户的一组命名权限。一个角色可以分配给多个用户，一个用户可以分配多个角色。角色在系统范围内可用，它不限于特定的命名空间。

角色名可以是最多64个字符的任何有效标识符。角色名称必须遵循标识符命名约定。角色名称可以包含Unicode字符。角色名称不区分大小写。如果选中了支持分隔标识符配置选项(默认设置)，则角色名可以是用引号括起来的分隔标识符。如果是分隔标识符，则角色名可以是SQL保留字。它可以包含句点(.)、插入符号(^)和两个字符的箭头序列(->)。它不能包含逗号(，)或冒号(：)字符。它可以以除星号(*)以外的任何有效字符开头。

最初创建角色时，角色只是一个名称；它没有权限。要向角色添加权限，请使用GRANT命令。还可以使用GRANT命令为角色分配一个或多个角色。这允许创建角色层次结构。

如果调用CREATE ROLE来创建已经存在的角色，SQL会发出SQLCODE-118错误。可以通过调用$SYSTEM.SQL.Security.RoleExists()方法确定角色是否已存在：

  WRITE $SYSTEM.SQL.Security.

第十二章 SQL命令 CREATE QUERY

创建Query

大纲

CREATE QUERY queryname(parameter_list) [characteristics] 
   [ LANGUAGE SQL ]
   BEGIN
code_body ;
   END

CREATE QUERY queryname(parameter_list) [characteristics] 
    LANGUAGE OBJECTSCRIPT
   { code_body }

参数

• queryname - 要在存储过程类中创建的查询的名称。queryname必须是有效的标识符。过程名可以是限定的(schema.procname)，也可以是非限定的(procname)。非限定过程名接受默认模式名。即使没有指定参数，queryname也必须后跟括号。
• parameter_list - 可选-传递给查询的参数列表。参数列表用圆括号括起来，列表中的参数用逗号分隔。即使没有指定参数，括号也是必须的。
• characteristics - 可选-指定查询特征的一个或多个关键字。允许的关键字有结果、容器ID、FOR、FINAL、PROCEDURE、SELECTMODE。多个特征由空白(空格或换行符)分隔。特性可以以任何顺序指定。

第十一章 SQL命令 CREATE PROCEDURE（二）

characteristics

用于创建方法的特征与用于创建查询的特征不同。

如果指定的特征无效，系统将生成SQLCODE -47错误。 指定重复的特征将导致SQLCODE -44错误。

可用的方法特征关键字如下:

第十章 SQL命令 CREATE PROCEDURE（一）

创建作为SQL存储过程公开的方法或查询。

利用Intersystems IRIS医疗版数据平台内置多模型整合

医院信息查询业务解决方案

概述：

随着医院信息化建设的逐步完善，医院子系统越来越多，系统间接口越来越多，同时接口费用不断增加，管理工作变得越来越复杂。其中，查询类业务接口根据业务类型分化，数量也是逐步递增，带来接口量大、开发工作繁重、代码冗余、维护困难等等问题。针对这一困境，我们利用Intersystems IRIS数据平台内置多模型整合医院信息查询业务解决方案。该应用程序可通过内置模型应用完成查询业务，大大缩小开发、维护、实施等项目关键运转周期。

应用链接：HealthInfoQueryLayer           

关键应用：IRIS for Health、REST API、ObjectScript、Globals 、SQL、DATA LOOKUP TABLES

应用程序采用模型及应用介绍：

1.采用模型

1.1. Globals (key-value)

Globals是可以在IRIS数据库中存储和管理的稀疏多维数组。您可以使用ObjectScript和本机API处理Globals。

工具:

https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=GGBL_MANAGING

应用：

应用程序根据Globals的键值对、访问速度快的特性。

第九章 SQL命令 CREATE METHOD（二）

characteristics

可用的关键字如下:

• FOR className - 指定要在其中创建方法的类的名称。 如果这个类不存在，它将被创建。 还可以通过限定方法名来指定类名。 FOR子句中指定的类名通过限定方法名重写指定的类名。
• FINAL - 指定子类不能重写该方法。 默认情况下，方法不是final。 FINAL关键字由子类继承。
• PRIVATE - 指定该方法只能由它自己的类或子类的其他方法调用。 默认情况下，方法是公共的，可以不受限制地调用。 这个限制由子类继承。
• PROCEDURE - 指定该方法是一个SQL存储过程。 存储过程由子类继承。 (这个关键字可以缩写为PROC。)
• RESULT SETS ,DYNAMIC RESULT SETS [n] - 指定创建的方法将包含ReturnResultsets关键字。 这一特征短语的所有形式都是同义词。
• RETURNS datatype - 指定调用该方法返回的值的数据类型。 如果省略RETURNS，则该方法不能返回值。 这个规范由子类继承，并且可以由子类修改。 该数据类型可以指定类型参数，如MINVAL、MAXVAL和SCALE。 例如RETURNS DECIMAL(19,4)。

第八章 SQL命令 CREATE METHOD（一）

在类中创建方法。

大纲

CREATE [STATIC] METHOD name (parameter_list) 
   [ characteristics ]
   [ LANGUAGE SQL ]
   BEGIN
code_body ;
   END

CREATE [STATIC] METHOD name (parameter_list) 
    [ characteristics ]
    LANGUAGE OBJECTSCRIPT
   { code_body }

参数

• name - 要在存储过程类中创建的方法的名称。 名称必须是有效的标识符。 过程名可以是限定的(schema.procname)，也可以是非限定的(procname)。 非限定过程名接受默认模式名。 名称后面必须跟括号，即使没有指定参数。
• parameter_list - 可选——传递给方法的参数列表。 参数列表用圆括号括起来，列表中的参数用逗号分隔。 即使没有指定参数，括号也是必须的。
• characteristics - 可选—指定方法特征的一个或多个关键字。 允许的关键字是RETURNS, FOR, FINAL, PRIVATE, PROCEDURE, SELECTMODE。

第七章 SQL命令 CREATE INDEX（二）

UNIQUE关键字

使用UNIQUE关键字，可以指定索引中的每条记录都有一个唯一的值。 更具体地说，这确保了索引(以及包含索引的表)中的两条记录不能具有相同的排序值。 默认情况下，大多数索引使用大写字符串排序(使搜索不区分大小写)。 在本例中，值“Smith”和“SMITH”被认为是相等的，而不是唯一的。 CREATE INDEX不能指定非默认索引字符串排序规则。 通过在类定义中定义索引，可以为各个索引指定不同的字符串排序规则。

可以更改名称空间的默认排序规则，使字段/属性在默认情况下区分大小写。 更改此选项需要重新编译命名空间中的所有类并重新构建所有索引。 转到Management Portal，选择Classes选项，为存储的查询选择名称空间，并使用Compile选项重新编译相应的类。 然后重建所有指数。 它们将区分大小写。

注意:当表的数据被其他用户访问时，不要重建索引。 这样做可能会导致不准确的查询结果。

BITMAP 关键字

使用BITMAP关键字，你可以指定这个索引将是位图索引。 位图索引由一个或多个位字符串组成，其中位位置表示行id，每个位值表示该行字段(或合并字段名字段的值)的特定值的存在(1)或不存在(0)。

第六章 SQL命令 CREATE INDEX（一）

为表创建索引。

大纲

CREATE [UNIQUE | BITMAP | BITMAPEXTENT | BITSLICE ] INDEX index-name
        ON [TABLE] table-name
       (field-name, ...)
       [AS index-class-name [ (parameter-name = parameter_value, ... ) ] ]
       [WITH DATA  (datafield-name, ...)]

参数

• UNIQUE - 可选的——一个约束，确保表中不会有两行索引中所有字段的值相同。不能为位图或位片索引指定此关键字。UNIQUE关键字后面可以跟(或被)CLUSTERED或NONCLUSTERED关键字替换。 这些关键字是no-ops; 它们是为了与其他供应商兼容而提供的。
• BITMAP - 可选—表示创建位图索引。 位图索引允许对具有少量不同值的字段进行快速查询。
• BITMAPEXTENT - 可选-表示应该创建位映射范围索引。 一个表最多只能创建一个位映射范围索引。 BITMAPEXTENT中没有指定字段名。
• BITSLICE - 可选—创建位片索引。

第五章 SQL命令 BUILD INDEX

用数据填充一个或多个索引。

大纲

BUILD INDEX [%NOLOCK] [%NOJOURN] FOR TABLE table-name [INDEX index-name [,index-name]]

BUILD INDEX [%NOLOCK] [%NOJOURN] FOR SCHEMA schema-name

BUILD INDEX [%NOLOCK] [%NOJOURN] FOR ALL

参数

• FOR TABLE table-name - 已存在表的名称。 表名可以是限定的(schema.table)，也可以是非限定的(table)。 非限定表名接受默认模式名。
• INDEX index-name - 可选—索引名称或以逗号分隔的索引名称列表。 如果指定，则只构建这些索引。 如果未指定，将构建为表定义的所有索引。
• FOR SCHEMA schema-name - 现有模式的名称。 此命令为指定模式中的所有表构建所有索引。

描述

BUILD INDEX提供了三种语法形式来构建/重新构建所有已定义的索引:

• Table: BUILD INDEX FOR TABLE table-name. 可选的INDEX子句允许仅构建/重新构建指定的索引。

第四章 SQL命令 ALTER VIEW

修改视图。

大纲

ALTER VIEW view-name [(column-commalist)] AS query [WITH READ ONLY]

ALTER VIEW view-name [(column-commalist)] AS query [WITH [level] CHECK OPTION]

参数

描述

ALTER VIEW命令用于修改视图。

第三章 SQL命令 ALTER USER

修改用户密码。

大纲

ALTER USER user-name IDENTIFY BY password

ALTER USER user-name IDENTIFIED BY password

参数

描述

ALTER USER命令允许更改用户的密码。可以随时更改自己的密码。要更改其他用户的密码，必须拥有%Admin_Secure:USE系统权限。

IDENTIFY BY和IDENTIFIED BY关键字是同义词。

user-name必须是已存在的用户。 指定一个不存在的用户将生成一个带有%msg的SQLCODE -400错误，如下所示:ERROR #838: User badname does not exist。可以通过调用$SYSTEM.SQL.Security.UserExists()方法来确定用户是否存在。

作为分隔标识符指定的用户名可以是SQL保留字，可以包含逗号(，)、句号(.)、插入符号(^)和两个字符的箭头序列(->)。 它可以以除星号(*)以外的任何有效字符开头。

密码可以是字符串字面值、数字或标识符。

第二章 SQL命令 ALTER TABLE（二）

删除列限制

DROP COLUMN可以删除指定为逗号分隔列表的多个列定义。每个列出的列名后面必须紧跟其RESTORY或CASCADE(如果未指定，则默认为RESTRICE)和%DELDATA或%NODELDATE(如果未指定，则默认为%NODELDATA)选项。

默认情况下，删除列定义不会从数据映射中删除存储在该列中的任何数据。 要同时删除列定义和数据，请指定%DELDATA选项。

删除列定义并不删除相应的列级特权。 例如，授予用户在该列上插入、更新或删除数据的权限。 这将产生以下后果:

• 如果删除了一个列，然后添加了另一个同名的列，那么用户和角色将在新列上拥有与旧列相同的特权。
• 删除列后，不可能撤销该列的对象特权。

由于这些原因，通常建议在删除列定义之前使用REVOKE命令从列中撤销列级特权。

RESTRICT关键字(或无关键字):如果列出现在索引中，或者定义在外键约束或其他唯一约束中，则不能删除该列。 为该列尝试DROP COLUMN失败，并出现SQLCODE -322错误。 默认为RESTRICT。

CASCADE关键字:如果该列出现在索引中，该索引将被删除。 可能有多个索引。 如果列出现在外键中，则将删除外键。 可能有多个外键。

如果列在COMPUTECODE或COMPUTEONCHANGE子句中使用，则不能删除该列。

第一章 SQL命令 ALTER TABLE（一）

修改表。

第十一章 发送和接收IBM WebSphere MQ消息

InterSystems IRIS为IBM WebSphere MQ提供了一个接口，可以使用该接口在InterSystems IRIS和IBM WebSphere MQ的消息队列之间交换消息。要使用此接口，必须能够访问IBM WebSphere MQ服务器，并且IBM WebSphere MQ客户端必须与InterSystems IRIS在同一台计算机上运行。

该接口由%Net.MQSend和%Net.MQRecv类组成，这两个类都是%Net.abstractMQ的子类。这些类使用由InterSystems IRIS在所有合适的平台上自动安装的动态链接库。(这是Windows上的MQInterface.dll；其他平台的文件扩展名不同。)。反过来，InterSystems IRIS动态链接库需要IBM WebSphere MQ动态链接库。

该界面仅支持发送和接收文本数据，不支持二进制数据。

使用IBM WebSphere MQ的RIS接口

通常，要使用IBM WebSphere MQ的InterSystems IRIS接口，请执行以下操作：

1. 确保有权访问IBM WebSphereMQv7.x或更高版本。具体而言：

• IBM WebSphere MQ客户端必须与InterSystems IRIS安装在同一台计算机上。

第九章 创建、编写和阅读MIME邮件

Iris提供了一个可以用于创建MultiPart Mime消息（％Net.MimePart）的类。创建要添加到SOAP消息的附件时，请使用此类;请参阅创建Web服务和Web客户端。因为MIME是一个常见的标准，所以有许多其他可能的应用程序，例如电子邮件处理和HTTP Multipart Post。

MIME消息概述

MIME格式的文档被称为MIME部分。每个MIME部件都有标题，包含邮件正文（文本或二进制）或包含额外的MIME部件。具有MIME版本标题的MIME部分可以用作顶级文档，称为MIME消息。下图显示了示例：

在该示例中，E和F具有未显示的附加子部分。

要表示MIME部件，请使用 %Net.MIMEPart类，该类提供用于设置零件的标题和内容的属性。

创建MIME部分

要创建一个MIME部件，执行以下步骤:

1. 创建%Net.MIMEPart的实例。
2. 做以下其中一项:

• 添加文本或二进制正文。为此，请创建流(文本或二进制)的实例，并将MIME部分的Body属性设置为等于该流。使用标准流接口将数据写入此流。不要为Parts属性指定值。
• 添加MIME部件列表。为此，请按此处所述创建MIME部件，并将Parts属性设置为等于这些部件的列表。不要为Body属性指定值。

3. 可以选择按照“设置和获取MIME部件标头”中的说明设置标头。

第八章 处理收到的电子邮件

处理收到的电子邮件

本节介绍如何处理通过%Net.POP3检索到的电子邮件(%Net.MailMessage)。

Message Basics

检索电子邮件(%Net.MailMessage)后，通常首先确定它是哪种类型的邮件以及如何阅读它；也就是说，它是否是多部分邮件以及各部分是否是二进制的。在此步骤中，您可以使用ContentType属性。或者，可以使用IsBinary、IsHTML和IsMultiPart属性，它们间接提供与contentType相同的信息。

如果消息是多部分消息，则每个部分都是%Net.MailMessagePart的一个实例。

Message Headers

消息本身和消息的每个部分都有一组标头。

%Net.MailMessage和%Net.MailMessagePart类提供的属性使可以轻松访问最常用的标头。例如，%Net.MailMessage提供收件人、发件人、主题和日期等属性。Headers数组属性允许访问任何自定义标题.

此外，如果已通过%Net.POP3检索到消息，则可以使用GetAttribute()方法。在给定标头名称和属性的情况下，此方法返回该属性的值。

Message Contents

了解常规消息结构后，请使用以下技术检索内容：

• 对于多部分消息，请使用Parts属性，该属性是部分的数组。Parts.

第七章 从POP3服务器提取电子邮件

将附件另存为文件

Content-Disposition标头可以指定附件，可以带文件名，也可以不带文件名。例如：

Content-Disposition: attachment; filename=genome.jpeg;

如果Content-Disposition标头确实指定了附件，则%Net.POP3实例可以将邮件中的所有附件保存到文件。要实现这一点，请执行以下操作：

1. 指定%Net.POP3实例的以下属性：

• 将StoreAttachToFile指定为%1。
• 将StoreInlineToFile指定为%1。
• 为AttachDir指定有效目录。根据操作系统的不同，确保使用斜杠(/)或反斜杠(\)结束目录名称。还要确保该目录已经存在，并且用户对其具有写访问权限。

2. 调用%Net.POP3实例的Fetch()或FetchMessage()。

每个文件名的确定方式如下：

1. 如果Content-Disposition标头指定了文件名，则使用该文件名。
2. 否则，如果Content-Type标头指定了文件名，则使用该文件名。
3. 否则，系统将创建格式为ATTxxxxx.dat的名称。

请注意以下几点：

• 如果该文件已存在，则不会下载附件。
• AttachDir没有默认值。
• 附件的大小不受IRIS的限制，但可能受文件系统的限制。
• 这里不使用Dir和FileName属性。

第六章 从POP3服务器提取电子邮件

从POP3服务器提取电子邮件

与POP3服务器通信

如果拥有所需的权限，并且邮件服务器正在运行，则可以使用POP3协议从该服务器下载和处理电子邮件。通常，要与POP3服务器通信，请登录，执行一系列影响邮箱的操作，然后提交或回滚任何更改。要在系统间IRIS中执行此操作，请执行以下操作：

1. 创建%Net.POP3的实例。此对象描述将使用的POP3服务器。
2. 可以选择指定%Net.POP3实例的以下属性：

• port -指定要使用的端口；默认值为110。
• timeout 超时-指定读取超时(以秒为单位)；默认值为30秒。
• StoreAttachToFile-指定在读取邮件时(当邮件包含Content-Disposition；附件标题时)是否将每个附件保存到文件。默认值为False。请注意，除非还设置了AttachDir，否则此设置不起任何作用。
• StoreInlineToFile-指定在读取邮件时(当邮件包含Content-Disposition；内联标题时)是否将每个内联附件保存到文件中。默认值为False。请注意，除非还设置了AttachDir，否则此设置不起任何作用。
• AttachDir-指定将附件保存到的目录。没有违约。根据操作系统的不同，确保使用斜杠(/)或反斜杠(\)结束目录名称。还要确保该目录已经存在，并且用户对其具有写访问权限。

第五章 向邮件添加附件

向邮件添加附件

可以将附件添加到电子邮件或消息部分(具体地说，是添加到%Net.MailMessagePart或%Net.MailMessage的实例)。要执行此操作，请使用以下方法：

这些方法中的每一种都会将附件添加到原始邮件(或邮件部分)的Parts数组中，并自动将IsMultiPart属性设置为1。

AttachFile()

method AttachFile(Dir As %String, 
                  File As %String, 
                  isBinary As %Boolean = 1, 
                  charset As %String = "", 
                  ByRef count As %Integer) as %Status

将给定文件附加到电子邮件。默认情况下，文件以二进制附件的形式发送，但您可以将其指定为文本。如果文件是文本，还可以指定该文件使用的字符集。

具体地说，此方法创建%Net.MailMessagePart的实例，并根据需要将文件内容放在BinaryData或TextData属性中，并根据需要设置CharSet属性和TextData.TranslateTable属性。

第四章 收发电子邮件

本主题描述如何使用InterSystems IRIS发送和接收MIME电子邮件消息。

注意:本主题中的示例是经过组织的，因此管理电子邮件的方法可以用于不同的电子邮件服务器，这在测试和演示期间非常有用。这不一定是最适合生产需要的代码组织。

支持电子邮件协议

电子邮件使用标准协议通过Internet发送消息。 InterSystems IRIS支持以下三种协议:

• InterSystems IRIS提供MIME电子邮件的对象表示形式。它支持文本和非文本附件、单部分或多部分邮件正文，以及ASCII和非ASCII字符集的标题。
• 可以通过SMTP服务器发送电子邮件。SMTP(简单邮件传输协议)是发送电子邮件的Internet标准。
• 还可以通过POP3从电子邮件服务器检索电子邮件，POP3是从远程服务器检索电子邮件的最常用标准。

注意：InterSystems IRIS不提供邮件服务器。相反，它提供了连接到邮件服务器并与之交互的功能。

InterSystems IRIS如何表示MIME电子邮件

首先，了解InterSystems IRIS如何表示MIME电子邮件非常有用。

通常，多部分MIME邮件由以下部分组成：

• 一组邮件标头，每个标头都包含邮件发送到的地址等信息。这还包括整个消息的Mime-Type标头和Content-Type标头。

第三章 发送HTTP请求

发送HTTP请求

创建HTTP请求后，使用以下方法之一发送该请求：

Delete()

method Delete(location As %String = "", 
              test As %Integer = 0, 
              reset As %Boolean = 1) as %Status

发出HTTP DELETE请求。

Get()

method Get(location As %String = "", 
           test As %Integer = 0, 
           reset As %Boolean = 1) as %Status

发出HTTP GET请求。此方法使Web服务器返回请求的页面。

Head()

method Head(location As %String, 
            test As %Integer = 0, 
            reset As %Boolean = 1) as %Status

发出HTTP Head请求。此方法使Web服务器仅返回响应头，而不返回正文。

IRIS 单元测试

第一章 单元测试概述☆☆☆☆

第二章 使用%UnitTest进行单元测试☆☆☆☆

第三章 执行测试☆☆☆

第四章 使用Setup和tear Down方法执行测试☆☆☆

前言

IRIS提供了用于对应用程序进行单元测试的类的%UnitTest包。该包为快速开发单元测试类、执行测试和创建报告提供了便利。可以直接使用该包，也可以扩展其类来自定义单元测试工具。%UnitTest在结构上与用于单元测试的xUnit框架非常相似。熟悉这些框架的开发人员使用%UnitTest会特别容易。

本教程提供对%UnitTest包的快速实践介绍。本教程的第一部分和第二部分是相互独立的，可以按任何顺序完成。

• 完成本教程的第一部分，了解单元测试和集成测试之间的区别、xUnit框架和%UnitTest之间的结构相似性，以及单元测试在敏捷应用程序开发方法中的作用。
• 完成本教程的第二部分，学习如何使用%UnitTest中的类为InterSystems IRIS应用程序创建和执行单元测试。

注意：本教程假定基本熟悉ObjectScript和InterSystems IRIS的面向对象开发。

预告

下一期系列将用一个月的时间连载，《Caché 网络实用工具》，敬请期待。

交流群

• QQ群号：410039091
• 笔者QQ：454115408
• 公众号：技术理科直男
• intersys版主：姚鑫

第四章 使用Setup和tear Down方法执行测试

示例：使用Setup和tear Down方法执行测试

以通常的方式执行新的单元测试。

1. 在一直在使用的命名空间中打开终端。
2. 将^UnitTestRoot的值设置为包含测试类的目录的父级：

USER> Set ^UnitTestRoot="c:\unittests"

3. 使用%UnitTest.Manager执行测试：

USER> Do ##class(%UnitTest.Manager).RunTest("mytests")

4. IRIS加载测试类、编译类、执行测试并向终端发送报告。

===============================================================================
Directory: C:\unittests\mytests\cls\MyPackage\
===============================================================================
mytests\cls\MyPackage begins .
Load of directory started on 01/09/2018 14:36:57 '*.xml;*.XML;*.cls;*.mac;*.int;*.

第三章 执行测试

示例：执行测试

现在使用%UnitTest.Manager.RunTest执行单元测试。以下是方法：

1. 在包含单元测试的名称空间中打开终端；在本例中为用户。如果终端未在正确的命名空间中打开，请使用ZN更改命名空间。
2. 将^UnitTestRoot全局值设置为包含导出的测试类的目录的父级。

DHC-APP>Set ^UnitTestRoot="d:\Temp"

3. 使用方法%UnitTest.Manager.RunTest执行测试。

DHC-APP>do ##class(%UnitTest.Manager).RunTest("test")

4. IRIS从XML文件加载测试类，编译类，执行测试，从服务器删除测试代码，并向终端发送报告。

HC-APP>do ##class(%UnitTest.Manager).RunTest("test")
 
===============================================================================
Directory: D:\Temp\test\
===============================================================================
  test begins .

第二章 使用%UnitTest进行单元测试

本教程的第二部分介绍了如何使用%UnitTest包对InterSystems IRIS代码进行单元测试。完成本教程的这一部分后，将能够：

• 解释%UnitTest包中三个主要类的角色。
• 列出基于%UnitTest包的单元测试类和方法的要求。
• 创建并执行方法的单元测试。
• 浏览%UnitTest.Manager创建的测试报告。
• 执行单元测试时，使用%UnitTest.TestCase方法初始化和还原数据库数据。

什么是%UnitTest？

%UnitTest包是一组为IRIS提供测试框架的类。在结构上，它类似于xUnit测试框架。%UnitTest为创建和执行以下各项的单元测试提供类和工具：

• 类和方法
• ObjectScript例程(routines)
• InterSystems SQL脚本
• Productions

创建和执行单元测试套件

以下是创建和执行一套单元测试的基本步骤：

1. 创建一个(或多个)包含要测试的方法的类。
2. 创建扩展%UnitTest.TestCase的测试类(或多个测试类)。
3. 将方法添加到将测试方法输出的测试类。在每个方法中至少使用一个断言(AssertX宏)。每个测试方法名称都以Test开头。
4. 将测试类导出到文件。
5. 打开终端并切换到包含要测试的类的名称空间。

第一章 单元测试概述

本教程的第一部分概述了单元测试。完成本教程的这一部分后，将能够：

• 定义单元测试并区分单元测试和集成测试
• 列出单元测试的几个好处
• 描述InterSystems IRIS %UnitTest包和xUnit测试框架之间的相似性。
• 列出软件开发中测试优先方法经常声称的几个好处。

什么是单元测试?

单元测试是对单个代码模块的正确性的测试，例如，方法或类的测试。通常，开发人员在开发代码时为其代码创建单元测试。典型的单元测试是一种执行方法的方法，该方法测试并验证该方法是否为给定的一组输入生成了正确的输出。

单元测试不同于集成测试。集成测试验证了一组代码模块交互的正确性。单元测试仅单独验证代码模块的正确性。一组代码模块的集成测试可能会失败，即使每个模块都通过了单元测试。

为什么要进行单元测试？

单元测试提供了许多好处，包括：

• 提供代码模块是否正确的验证。这是单元测试的主要原因。
• 提供自动回归测试。更改代码模块后，应重新运行单元测试，以确保代码模块仍然正确。也就是说，应该使用单元测试来确保更改没有破坏代码模块。理想情况下，所有代码模块的单元测试都应该在更改任何一个模块之后运行。
• 提供文档。通常，代码模块的单元测试与代码模块一起交付。检查单元测试提供了大量有关代码模块如何工作的信息。

XUnit测试框架

单元测试框架是为开发和执行单元测试提供支持的类包。

Caché Global

第一章 简介global☆☆☆☆☆

第二章 全局变量结构（一）☆☆☆☆☆

第二章 全局变量结构（二）☆☆☆☆☆

第三章 使用多维存储(全局变量)（一）☆☆☆☆☆

第三章 使用多维存储(全局变量)（二）☆☆☆☆☆

第三章 使用多维存储(全局变量)（三）☆☆☆☆☆

第三章 使用多维存储(全局变量)（四）☆☆☆☆☆

第四章 多维存储的SQL和对象使用（一）☆☆☆☆☆

第四章 多维存储的SQL和对象使用（二）☆☆☆☆☆

第五章 管理全局变量（一）☆☆☆☆☆

第五章 管理全局变量（二）☆☆☆☆☆

第六章 临时全局变量和IRISTEMP数据库☆☆☆☆☆

前言

经过快一个月的连载 《Caché Global》 共12篇。对于刚接触M的语言的同学，由浅入深帮助你快速进步，对于老手，丰富更多的细节

涵盖以下主题：

• “简介”概述了全局变量的功能和用途。
• “全局变量结构”描述了全局变量是如何存储在磁盘上的，它们是如何命名和引用的，以及它们的结构。
• “使用多维存储(全局)”介绍如何以编程方式使用全局变量。
• “多维存储的SQL和对象使用”描述了对象和SQL引擎如何使用全局变量存储数据。
• “管理全局变量”介绍了主要从管理门户管理全局的工具。
• “临时全局变量和TEMP数据库”描述了如何使用临时全局变量来帮助进行复杂的处理。

第六章 临时全局变量和IRISTEMP数据库

对于某些操作，可能需要全局变量的功能，而不需要无限期保存数据。例如，可能希望使用全局对某些不需要存储到磁盘的数据进行排序。对于这些操作，InterSystems IRIS提供了临时全局机制。该机制的工作方式如下：

• 对于应用程序名称空间，可以定义一个全局映射，以便将具有特定命名约定的全局变量映射到IRISTEMP数据库，该数据库是一个特殊的数据库，如下所述。

例如，可以定义一个全局映射，以便将名称为^AcmeTemp*的所有全局变量映射到IRISTEMP数据库。

• 当代码需要临时存储数据并再次读取它时，代码将向使用该命名约定的全局变量写入数据，并从全局变量读取数据。

例如，要保存值，代码可能会执行以下操作：

 set ^AcmeTempOrderApp("sortedarray")=some value

然后，稍后代码可能会执行以下操作：

 set somevariable = ^AcmeTempOrderApp("sortedarray")

通过使用临时全局变量，可以利用IRISTEMP数据库没有日志记录这一事实。因为数据库没有日记记录，所以使用该数据库的操作不会产生日记文件。日志文件可能会变得很大，并可能导致空间问题。但是，请注意以下几点：

不能回滚修改IRISTEMP数据库中的全局变量的任何事务；此行为特定于IRISTEMP。

第五章 管理全局变量（二）

在全局变量中查找值

“查找全局变量字符串”页使可以在下标或选定全局变量的值中查找给定的字符串。

要访问和使用此页，请执行以下操作：

1. 显示“全局变量”页。
2. 选择要使用的全局变量。为此，请参阅“全局页简介”一节中的步骤2和3。
3. 单击查找按钮。
4. 对于查找内容，输入要搜索的字符串。
5. (可选)清除大小写匹配。默认情况下，搜索区分大小写。
6. 单击Find First或Find All。

然后，页面显示选定全局变量中下标或值包含给定字符串的第一个节点或所有节点。该表左侧显示了节点下标，右侧显示了相应的值。

7. 如果使用的是Find First，请根据需要单击Find Next以查看下一个节点。
8. 完成后，单击关闭窗口。

执行批量更换

注意:在进行任何编辑之前，请确保知道IRIS使用哪个全局系统，以及应用程序使用哪个全局系统；参见“一般建议”此选项会永久更改数据。不建议在生产系统中使用。

出于开发目的，“查找全局字符串”页面还提供了对全局节点中的值进行整体更改的选项。要使用此选项:

1. 显示“全局”页面。
2. 选择要使用的全局。为此，请参见“全球页面简介”一节中的步骤2和3
3. 单击替换按钮。
4. 使用此页面查找上一节中描述的值。
5. 为“替换为”指定一个值。
6. 单击全部替换。
7. 单击确定确认此操作。然后，页面会显示变更的预览。
8. 如果结果可以接受，请单击保存。
9. 单击确定确认此操作。