java如何使用IRIS sdk这个方法创建MIRROR

第五十八章 File 输入 输出 - WRITE 命令

WRITE 命令

在定位的 READ 或 WRITE 之后，后续的 READ 或 WRITE 操作将按顺序进行，直到下一个带有 position 参数的 USE 命令。

WRITE 命令将数据（一次一条记录）写入作为当前设备的顺序文件。

语法

WRITE x

• x 变量 x 中的数据将作为一条记录写入顺序文件中。

CLOSE 命令

CLOSE 命令放弃对顺序文件的所有权。

如果指定的文件未打开或不存在，则 IRIS 将忽略 CLOSE 并返回而不发出错误。

语法

CLOSE file 
CLOSE file:"D" 
CLOSE file:("R":newname)

• file 文件 任何有效的文件规范，用引号括起来。指定的文件必须已打开。在 UNIX 路径名中，可以使用波形符 （~） 扩展来指示当前用户的主目录。例如：~myfile 或 ~/myfile。
• "D" 关闭并删除具有参数中指定的名称的文件。
• ("R":newname) 使用参数中指定的名称关闭文件，并将其重命名为 newname。

CLOSE-Only 命令关键字

下表描述了仅使用 CLOSE 命令控制顺序文件的关键字。

顺序文件的 CLOSE-only 命令关键字

/DELETE[=n] /DEL[=n]

0，除非文件在打开时标记为删除。

许多使用InterSystems IRIS的用户在调试代码的时候习惯使用命令行的方式，比如运行一个函数查看输出或者查看代码运行过程中保存在global中的数据等等。

对于将 InterSystems IRIS 安装在 Windows 操作系统的用户，只需要点击右下角图标选择Terminal 就可以很方便的使用。

但是对于将其安装到 Linux 或者Docker 容器中的用户，要使用命令行却不那么方便，下面我将会介绍在我们 Openexchange 中的一个应用 -- Web Terminal。

也就是说可以在网页中直接执行Terminal中的命令。

或者查看SQL执行结果：

可以在其中输入 /help ，获取更多帮助信息

安装

1. 点击进入项目下载页面，选择下载最新的版本。

2. 在任意的命名空间下导入下载的xml文件。

注意在这里选择导入文件的同时也要勾选上 “编译导入的项”

3. 之后会出现下面提示导入成功的提示

如果出现类似于下面的错误提示：

请将下载的 WebTerminal-v4.9.3.xml 文件编辑做下面修改

1 . 第1611行：修改为 

set requiredRole = "%DB_IRISSYS"

2. 第1730行：修改为

set dbPrefix = "IRIS"

重新导入就可以了。

使用

Web Terminal 已经存在相当长一段时间了，但它存在诸多限制，并非所有功能都能正常使用。它不支持 shell，也没有诸如嵌入式 Python 支持这样的最新功能。对于那些需要编程模式的工具来说，存在一些问题。基本身份验证也不如简单的登录页面便捷，使用登录页面的话，倘若你想要改变登录应用程序的方式（比如使用单点登录，即 SSO），你还可以自行添加登录页面。

通过将最初的iris terminal 封装到一个网页表单中，利用在网络领域应用极为广泛且同样被像 Visual Studio Code（VSCode）这类工具所使用的 xterm.js，并借助 Python 施展的一些 “魔法”（这些 “魔法” 有助于实现进程间的终端交互），我们就能在网络上完整地实现终端功能了。

安装方法

在

zn"%SYS"
zpm "install iterm"

为了测试它是如何在web中工作的，可以执行 term routine，如下

现有一个数据表的数据像这样：

我们的需求是基于表中的Item列新增一个status字段，如果item的内容是第一次出现，那么status列就是New，反之显示Old,

比如，应该是下面的显示内容

在原文章的回复中， Robert Cemper给出了下面的建议

新建一个存储过程，并在SELECT查询语句中生效：

/// Return NEW for first occurance of item /// otherwise return OLDClass User.ItemStat Extends%RegisteredObject
{
ClassMethod NewOld(item As%String = "") As%String [ SqlProc ]
{
    if item=""quit"?"if$d(^||list(item)) quit"OLD"if$i(^||list(item)) quit"NEW"
}
}

使用下面SELECT语句使之生效：

SELECT *, ItemStat_NewOld(item) asStatusFROM items orderby2

结果如下：

第五十七章 File 输入 输出 - READ 命令

在定位的 READ 或 WRITE 之后，后续的 READ 或 WRITE 操作将按顺序进行，直到下一个带有 position 参数的 USE 命令。

READ 命令从当前设备读取数据，一次读取一条记录。读取超过文件末尾会导致错误。

语法

READ x#n:timeout

• x 该变量将保存从文件中读取的记录。
• n 可选 – 对于可变长度读取，为要读取的字符数，指定为整数。对于固定长度的读取，此参数将被忽略。
• timeout 超时 可选 – 在超时之前等待读取操作完成的秒数。整数值或解析为整数的变量。

timeout 参数虽然是可选的，但强烈建议使用，因为如果指定了 timeout，则 READ 的成功或失败由 $TEST 特殊变量的值指示。如果读取尝试在超时到期之前成功，则 $TEST 设置为 1;如果超时到期，则 $TEST 设置为 0。

以下示例显示了从 Windows 顺序文件中读取固定长度记录的 READ 操作。它创建一个顺序文件，将数据写入该文件，然后关闭该文件。然后，它会打开此文件以进行 4 个字符的固定长度读取 （“RF”：4）。它将 USE position 参数设置为第一条记录（记录 0）;每个读取操作都会推进此位置。FOR 循环将每个四字符的记录读取到下标变量中。然后，ZWRITE 命令显示所有这些下标局部变量及其值。

第五十六章 File 输入 输出 - USE 命令

US 命令

USE 命令使打开的顺序文件成为当前设备。可以打开多个顺序文件，但一次只能使用一个顺序文件。

语法

USE file:position

• file 文件

任何有效的文件规范，用引号括起来。指定的文件必须已打开。在 UNIX 路径名中，可以使用波形符 （~） 扩展来指示当前用户的主目录。例如：~myfile 或 ~/myfile。

• position 位置

可选 — 文件中下一个 READ 或 WRITE 的位置。position 值是一个数字表达式，其含义取决于文件的记录格式。对于固定长度的记录，position 是相对于零的绝对记录号，其中每条记录都包含在前面的 OPEN 命令中指定的字符数。对于流或可变长度记录，position 是相对于零的绝对字节位置。默认设置是从文件开头开始按顺序读取或写入记录。

可以使用 $ZSEEK 函数设置文件位置，该位置由字符数相对于顺序文件的开头、当前位置或结尾的偏移量指定。$ZPOS 特殊变量包含从顺序文件开头开始的当前字符计数位置。

USE-only 命令关键字

除了上面列出的与 OPEN 共享的命令关键字外，USE 命令还有自己的一组关键字：

顺序文件的 USE-only 命令关键字

/POSITION=n

技术支持团队在不同的项目中发现了类似中间人攻击的情况， 和各位分享一下。

我们的系统一般是安装在内网里，没有恶意的中间人攻击的风险。但是在有些医院发现了这样的情况：IT在网络中安装了某种网络监控或者嗅探的设备， 它会在通信通道中模拟其中一方，或者双方的通信节点， 以截获通信双方的网络流量。通常它不影响双方的通信，但偶尔，它会中断双方的连接， 造成业务的中断。实质上这也是一种中间人攻击的情况，只不过这是用户允许的行为，偶然出现了故障。 

我们看看以下的例子:

以下的wireshark抓包截图中， 172.18.1.131和172.18.1.145在正常的通信过程中， 忽然收到了RST消息，造成了TCP连接上的复位。

其中172.18.1.131是intersystems的health connect系统， 它在序号50134的包里面首先发送了RST，因此客户怀疑是不是Health Connect出错，中断了连接，也就把问题提交了InterSystems的技术支持。

1.Caché数据库有没有办法配置然后用sql读取数据库实时变化的数据，类似于mssql那样？我看了可以写类去读取global获取journal的值，但是怎么用sql读呢？

2.不行的话，那用什么方式可以读取到journal日志文件，并输出日志文件的内容？

先谢谢大家了！！！

第五十五章 File 输入 输出 - 与非 InterSystems IRIS 软件的交互

与非 InterSystems IRIS 软件的交互

在 Windows 系统上，在 IRIS 中打开顺序文件以进行 “WL” 写入访问通常会阻止非 IRIS 应用程序打开顺序文件进行写入访问。同样，非 IRIS 应用程序打开顺序文件进行写入访问通常会阻止 IRIS 进程并发 “WL” 写入访问。

但是，某些非 IRIS 应用程序，包括记事本和写字板应用程序，会打开一个文件，在共享模式下复制文件，然后立即关闭它。因此， IRIS 进程仍然可以以 “WL” 模式打开文件。当这些非 IRIS 应用程序之一尝试将其副本中的更改保存到原始文件，或尝试重新打开原始文件时，将发生错误。更严重的情况可能发生如下：如果这些非 IRIS 应用程序之一打开了一个文件，然后 IRIS 打开、修改和关闭文件，然后非 `` 应用程序保存对文件的更改，两个进程所做的更改都被保存，文件数据的完整性可能会受到损害。

在 UNIX 系统上，在 IRIS 中打开一个顺序文件以进行 “WL” 写访问通常不会影响非 IRIS 应用程序的行为。您必须使用锁来可靠地限制来自非 IRIS 应用程序的写入访问。

示例

第五十四章 File 输入 输出 - OPEN 参数关键字

OPEN 参数关键字

下表描述了顺序文件的 OPEN 命令参数关键字：

顺序文件的 OPEN关键字参数

/PARAMS=str /PAR=str

No defaul

对应于 parameters 位置参数。（它提供了一种以与位置无关的方式指定参数字母代码字符串的方法）。

/RECORDSIZE=int /REC=int

无默认值

对应于 reclen 位置参数，该参数为固定长度记录建立记录大小。（目前仅针对 READ 操作实现。

/TERMINATOR=str /TER=str

无默认值

对应于 terminators 位置参数，该参数建立用户定义的终止符。str 是一串用户定义的记录终止符，仅适用于 Stream 模式。它们允许覆盖默认终止符：回车符、换行符和换页符。用户定义的终止符仅适用于输入，它们不会影响数据写入文件的方式（终止符作为特殊字符写入文件）。如果有多个用户定义的终止符，则会将其视为终止符列表，而不是用作单个终止符的多字符序列。

OPEN 模式锁定

当两个进程尝试打开同一个顺序文件时，第二个 OPEN 会根据第一个OPEN 使用的模式成功或失败。下表显示了使用独占 （“L”） 和非独占读取和写入模式的两个打开之间的交互。请注意，这些交互的解释取决于平台。为 Windows 操作系统和 UNIX 操作系统提供了表。

第五十三章 File 输入 输出 - OPEN模式参数

A /APPEND /APP

Append：WRITE 操作将数据附加到现有文件的末尾。默认设置是覆盖现有数据，而不是 append。

S /STREAM

流格式，回车符、换行符或换页符作为默认终止符。S、V、F 和 U 模式是互斥的。Stream record format 是默认格式。

V /VARIABLE

请勿尝试在可变长度顺序文件末尾以外的任何位置插入记录;WRITE 将使文件中的所有数据从 WRITE 之后的点开始无法访问。S、V、F 和 U 模式是互斥的。流记录 （S） 格式是默认格式。

使用转换表写入的可变长度记录（例如使用 UTF8 转换的 Unicode 数据）可能会导致存储的记录具有与输入数据不同的字符串长度。IRIS 在读取此记录时使用原始输入字符串长度。

F /FIXED /FIX

Fixed length：每条记录都是 reclen 参数中指定的长度。例如：OPEN “myfile”:(“RF”：4） USE “myfile”：0 READ x：5此示例将前 4 个字符的记录读入变量 x。这仅适用于 READ 操作（不适用于 WRITE 操作）。S、V、F 和 U 模式是互斥的。

U /UNDEFINED

第五十二章 File 输入 输出 - OPEN模式参数

OPEN 模式参数

可以通过以下两种方式之一指定 OPEN 模式参数

• 用引号字符括起来的字母代码字符串，如 “VRWN”。每个字母都指定一个参数。字母代码可以按任何顺序指定;因为 IRIS 按照从左到右的顺序执行它们，所以在某些情况下，字母代码之间的交互可能会决定首选顺序。
• 一系列 /keyword 参数，未加引号。这些参数用冒号分隔。关键字参数可以按任意顺序指定;因为 IRIS 以从左到右的顺序执行它们，所以在某些情况下，参数之间的交互可能会决定首选顺序。

指定字母代码参数和关键字参数的组合时，请先指定字母代码字符串，然后指定关键字参数，用冒号分隔。以下示例指定三个字母代码参数，后跟两个关键字参数，后跟 reclen 和 timeout 参数。

  OPEN "mytest":("WNS":/OBUFSIZE=65536:/GZIP=0:32767):10

N /NEW

新建文件。如果指定的文件不存在，则系统创建该文件。如果指定的文件已作为 ReadOnly 文件存在，则系统会删除旧文件并将其替换为同名的新文件（权限允许）。请注意，应使用文件锁定来防止使用此参数的并发进程覆盖同一文件。

第五十一章 File 输入 输出 - 文件路径名工具

文件路径名工具

如果当前设备是顺序文件，则$ZIO包含该文件的完整路径名。

可以使用$ZSEARCH返回指定文件或目录的完整文件规范（路径名和文件名）。文件名可能包含通配符， $ZSEARCH使用通配符返回一系列满足通配符的完全限定路径名。

%Library.File 类包含许多提供文件系统服务的方法。这些包括：

• NormalizeDirectory()，返回指定文件或目录的完整路径名。
• NormalizeFilenameWithSpaces()，根据主机平台的情况处理路径名中的空格。如果路径名包含空格字符，则路径名处理取决于平台。 Windows 和 UNIX® 允许路径名中包含空格字符，但包含空格的整个路径名必须用一组附加的双引号 (") 字符括起来。这与 Windows cmd/c语句一致。有关详细信息，请指定cmd / ?在 Windows 命令提示符下。

波形符 (~) 扩展

在 Windows 路径名中，波形符 (~) 表示长名称的 8.3 压缩。例如： c:\PROGRA~1\ 。要转换压缩目录名称，请使用 %Library.File 类的 NormalizeDirectory() 方法。

在 UNIX 路径名中，可以使用波形符 (~) 扩展来指示当前用户的主目录或指定用户的主目录：

第五十章 File 输入 输出

本页介绍在 IRIS 数据平台中使用顺序文件。

重要：在大多数情况下，可以使用 %Library.File 类提供的 API，而不需要此页面上的详细信息。请参阅使用 %Library.File 。

介绍

所有操作系统都将磁盘 I/O 文件视为顺序文件。 Windows 系统将打印机视为顺序文件 I/O 设备（除非打印机通过串行通信端口连接）。 UNIX® 系统将打印机视为终端 I/O` 设备。有关打印机的更多详细信息，请参阅打印机。

本节讨论 IRIS 如何处理顺序文件。它提供了顺序文件 I/O 的介绍以及相关命令的说明。

第四十九章 终端输入 输出 - 转义序列编程

转义序列编程

转义序列的 ANSI 标准使智能终端的编程变得实用。字符串中转义字符及其后面的所有字符不会显示在屏幕上，但会更新$X和$Y 。使用WRITE *语句将转义序列发送到终端，并通过直接设置$X和$Y来保持它们最新。

ANSI 标准建立了转义序列的标准语法。特定转义序列的效果取决于使用的终端类型。

每次READ之后在$ZB中查找传入的转义序列。 IRIS 将 ANSI 标准转义序列和任何其他使用 ANSI 形式的转义序列放入$ZB中。 IRIS 可识别两种形式的转义序列：

常规形式

• An ESC.
• 可选字符“O”（字母），十进制值 79。
• 零个或多个十进制值为 32–47 的字符。
• 十进制值 48–126 的一个字符。

控制形式

• ESC字符，十进制值 27。
• “[”字符，十进制值 91。
• 零个或多个十进制值为 48–63 的字符。
• 零个或多个十进制值为 32–47 的字符。
• 十进制值 64–126 的一个字符。

此外，序列不能超过 16 个字符。违反这些形式或规则的转义序列设置$ZA的位 8，其值为 256。

示例

假设正在对一个终端进行编程，其帮助键发送两个字符序列Escape-? （ ?的十进制值为 63）

第四十八章 终端输入 输出 - PRINT 和 ZPRINT 命令

PRINT 和 ZPRINT 命令

将当前加载的 IRIS 例程的一行或多行写入当前设备。

ZPRINT与PRINT`具有相同的效果和参数。

语法

PRINT 
ZPRINT 
PRINT x 
ZPRINT x 
PRINT x:y 
ZPRINT x:y

示例

此示例打印当前例程的第一行、从 INIT 开始的四行以及从 FINI 到结尾的所有行：

INIT
  SET a=1
  SET b=2
  SET c=3
  SET d=4
FINI
  SET x=24
  SET y=25
  SET z=26
  PRINT +1,INIT:INIT+3,FINI:+9999

对终端进行编程

使用 IRIS 对格式化 CRT 屏幕进行编程

终端 I/O 的几个功能有助于对格式化屏幕进行编程：

第四十七章 终端输入 输出 - DTM PC 控制台的助记符空间

DTM PC 控制台的助记符空间

IRIS 提供 IRIS 例程 %XDTM 来匹配开发 DTM 应用程序时使用的助记符。该助记词空间可用，但未设置为终端默认助记词空间。如果您将为 DTM 创建的应用程序移植到 IRIS，可以：

• 在管理门户中将 ^%XDTM 配置为终端（ MnemonicTerminal ）的默认助记词空间，或者
• 在OPEN或USE命令中引用 ^%XDTM 助记符空间。

DTM 示例

UNIX

  OPEN "/dev/tty04/"::"^%XDTM"

Windows

  OPEN "c:\sys\user"::"^%XDTM"

然后 IRIS 可以正确解释WRITE /mnemonic命令中的 DTM 控制助记符，如下表所示。

DTM PC 控制台的控制助记符

第四十六章 终端输入 输出 - CLOSE 命令

CLOSE 命令

释放设备的所有权，这是通过OPEN命令获得的。

语法

CLOSE device

终端预定义助记符空间

IRIS 提供了两个预定义的助记符空间供终端使用：

• ^%X364 用于 ANSI X3.64 终端
• ^%XDTM 用于 DTM PC 控制台

如果激活这些助记符空间之一，则可以在WRITE /mnemonic命令中使用与它们关联的控制助记符。还可以创建自己的助记符空间。有关助记符空间的更多信息，请参阅使用助记符空间控制设备。

以下部分描述了这些助记符空间的控制助记符。

X3.64的助记符空间

IRIS 为 ANSI X3.64 定义提供内置助记符空间。该助记符空间是管理器命名空间中的 IRIS 例程 %X364。要使用例程 %X364，请执行以下任一操作：

• 让 IRIS 系统管理员在IO Settings配置设置中输入 %X364 作为默认助记符空间。从管理门户中，选择“系统管理” 、 “配置” 、 “设备设置” 、 “IO 设置” 。
• 发出指定此助记符空间的OPEN命令：

 OPEN "terminal"::"^%X364"

下表列出了助记符。

第四十五章 终端输入 输出 - WRITE 命令

WRITE 命令

将零个或多个字符写入终端

语法

WRITE *variable 
WRITE *-n
WRITE # 
WRITE /mnemonic

第四十四章 终端输入 输出 - 特殊协议字符影响终端 I O

特殊协议字符影响终端 I O

每个操作系统都会拦截某些协议字符 (UNIX) 或组合键（例如 Windows 平台上的CTR-ALT-DEL ），以防止这些字符影响 IRIS。 Windows 控制台不会尝试覆盖这些操作系统特征。

其他特殊字符可以改变例程的执行方式，但不会出现在READ命令变量中。在图像模式下操作终端会取消这些效果，并使 IRIS 像对待任何其他字符一样对待这些字符。

READ受输出和输入控制字符的影响。 READ只是读取除终止字符之外的所有其他控制字符。它不回应他们。

输出控制字符影响例程的流程和输出。下表对此进行了描述：

输出控制字符

第四十三章 终端输入 输出 - READ 命令

Read 命令

从键盘读取 0 到 32 KB 的内容到指定变量中。超时参数是可选的。该命令不能以井号 (#) 或冒号 (:) 结尾

语法

READ variable:timeout                                             ; Variable-length read
READ variable#length:timeout  ; Fixed-length read
READ *variable:timeout                                           ; Single-character read

示例

下表提供了如何使用这些参数的几个示例。

READ 命令参数：示例

第四十二章 终端输入 输出 - 显式终止符

显式终止符

OPEN或USE命令中的终止符参数允许您将特定字符定义为READ或WRITE命令的终止符。这些显式终止符可用于补充指定协议提供的终止符字符。终止符参数还可用于覆盖协议对字符的指定，并将其指定为终止符。将字符重新定义为终止符的能力的例外情况是：ASCII 0 (NULL)、ASCII 3 ( Ctrl-C ) 以及两个输出控制字符Ctrl-Q (XON) 和Ctrl-S (XOFF)。它们保留其功能，并且不能重新定义为终止符。

示例

此示例将 Z、 Backspace和Tab定义为主设备的终止符。下划线是连接运算符。

  USE 0:("":"":"Z"_$CHAR(8,9))

通过对无主终端发出OPEN命令，您可以隐式清除 IRIS 内部显式终止符列表。当出现协议字符串时， IRIS 会执行以下操作：

1. 清除其显式终止符列表。
2. 根据协议字符串设置协议。
3. 将终止符字符串（如果有）复制到显式终止符的内部列表中。

下表给出了显式终止符字符串的示例。

第四十一章 终端输入 输出 - 协议终止符

协议终止符

OPEN 和 USE 协议定义了哪些 READ 输入字符、控制序列和击键被视为隐式终止符。这四种协议是 I（图像模式）、N（正常模式（默认））、R（读取行调用模式）和 T（终止符模式）：

第四十章 终端输入 输出 - 用于OPEN和USE的字母代码协议

用于OPEN和USE的字母代码协议

特殊情况或终端可能需要不同的协议。使用协议字母代码参数（或相应的关键字参数），可以更改 IRIS 与终端通信的规则。协议对正常读取和单字符读取的影响是一样的。

禁用所有特殊协议的正常模式足以满足大多数终端 I/O 的需要。在正常模式下，IRIS 会回显每个传入的 ASCII 字符，并将其发送回以显示在终端上。 Return或有效的转义序列结束READ命令。

对终端发出OPEN会关闭所有先前的协议，除非您使用 + 和 - 选项。

下表描述了有效的协议字符及其效果。

用于开放和使用的字母代码协议

第四十章 终端输入 输出 - OPEN 和 USE 命令的关键字参数

OPEN 和 USE 命令的关键字参数

下表描述了使用OPEN和USE命令控制终端设备的关键字参数。对于每个关键字，该表列出了OPEN和USE相应的字母代码协议。有关使用这些协议的其他信息可以在字母代码协议表中找到。

终端设备的 OPEN 和 USE 关键字参数

第三十九章 终端输入 输出 - terminator

terminator

第三个位置参数：最多八个字符的字符串，其中任何一个都将终止READ 。这些终止符是协议中内置终止符的补充。请参阅使用终止符结束 I/O 操作。

portstate

第 4 个位置参数：按位置顺序最多包含 8 个字节的字符串，用于控制 COM 端口状态。端口状态字节如下（字节从1开始按从左到右的顺序编号）：

第三十八章 终端输入 输出 - USER命令

USER命令

使指定终端成为当前设备。在编程器模式下，同一行代码上的所有后续 I/O 命令都引用该设备。在应用程序模式下，您在USE命令中命名的设备将一直保留为当前设备，直到下一个USE命令为止。

USE 语法

USE命令采用以下参数：

USE terminal:(margin:protocols:terminator):"mnespace"

终端参数可以是一个表达式，其值为终端设备的名称。零 (0) 是该进程的主要设备。 $IO是当前设备。终端的最大长度为 256 个字符。

参数由冒号 (:) 分隔。如果省略参数，则必须指定冒号。命令或其参数列表不得以冒号结束。

可选参数列表包含在括号中，可以包含margin 、 protocols和terminator参数。可以将可选的margin 、 ports和terminator参数指定为位置参数（按所示顺序），或使用语法 /KEYWORD=value 指定为关键字参数。关键字参数可以按任意顺序指定；由于 IRIS 按从左到右的顺序执行参数，因此在某些情况下，参数之间的交互可能决定首选顺序。可以在同一参数列表中混合位置参数和关键字参数。如果指定多个参数，则需要使用括号。

要使用USE命令指定 COM 端口状态和波特率，请使用适当的关键字参数。