第六章 使用嵌入式 Python （三）

从 ObjectScript 调用嵌入式 Python 代码

使用 Python 库

嵌入式 Python 让可以轻松访问数以千计的有用库。通常称为“包”，它们需要从 Python 包索引 (PyPI) 安装到 <installdir>/mgr/python 目录中，然后才能使用。

例如，ReportLab Toolkit 是一个用于生成 PDF 和图形的开源库。以下命令使用软件包安装程序 irispip 在 Windows 系统上安装 ReportLab：

C:\InterSystems\IRIS\bin>irispip install --target C:\InterSystems\IRIS\mgr\python reportlab

在基于 UNIX 的系统上，使用：

第四章 使用嵌入式 Python （一）

嵌入式 Python 允许使用 Python 作为编程 IRIS 应用程序的本机选项。

预备知识

使用嵌入式 Python 所需的 Python 版本取决于运行的平台。

在 Microsoft Windows 上，IRIS 安装工具包安装正确版本的 Python（当前为 3.9.5），仅用于嵌入式 Python。如果在开发机器上并希望将 Python 用于一般用途，建议从 https://www.python.org/downloads/ 下载并安装相同的版本。

第二章 嵌入式Python概述（二）

从 Python 调用 IRIS API

如果使用的是嵌入式 Python 并且需要与 IRIS 交互，可以使用 Python shell 中的 iris 模块，或者使用 Python 编写的 IRIS 类中的方法。要遵循本节中的示例，可以使用 ObjectScript 命令 do ##class(%SYS.Python).Shell() 从终端会话启动 Python shell。

当启动终端会话时，将被放置在 IRIS 的 USER 命名空间中，将看到提示 USER>。但是，如果从 GitHub 加载了示例类，则需要在 SAMPLES 命名空间中才能访问它们。

第二十三章 使用 %Status 值

许多类使用 %Status 数据类型类来表示状态信息，并且它们的方法返回表示成功或错误的 %Status 值（状态）。如果状态表示一个错误（或多个错误），则状态值还包括有关错误的信息。

还可以返回自己的状态值。

本文讨论状态值以及如何使用它们。

使用状态值的基础知识

如上所述，许多 类中的方法返回一个状态以指示成功或错误。例如，%Library.Persistent中的%Save()方法返回一个状态。对于任何此类方法，请务必获取返回值。然后检查状态，然后适当地继续。基本工具如下：
- 要检查状态是表示成功还是错误，请使用以下任一方法：
-$$$ISOK和$$$ISERR宏，在包含文件%occStatus.inc中定义。此包含文件在所有对象类中自动可用。
-$SYSTEM.Status.IsOK()和$SYSTEM.Status.IsError()` 方法，它们在终端（不能使用宏）中特别方便。

第二十一章 使用工作队列管理器（四）

分离和附加工作队列

通常，初始化一组工作程序，将工作项排队，然后等待工作程序完成工作项。但是，可能会遇到工作人员作业完成工作项所需的时间比预期更长的情况，或者无法将单个进程专门用于等待。因此，工作队列管理器使能够将工作队列与进程分离，然后将工作队列附加到同一进程或不同的进程。

例如，假设队列引用了初始化的工作队列。还假设向工作队列中添加了几个工作项。在调用 Wait() 或 WaitForComplete() 来确定正在处理的工作的状态之前，可以使用以下方法：

Detach()

method Detach(ByRef token As %String, timeout As %Integer=86400) as Status
从初始化工作队列时创建的对象引用中分离工作队列对象。 Detach() 方法使任何正在进行的工作能够继续并保留工作队列的当前状态。

token 参数表示一个安全令牌，可以使用它随后将工作队列附加到另一个进程。 timeout 参数是可选的，它指示系统保留分离的工作队列对象的时间量（以秒为单位）。超时期限过后，系统会删除与工作队列关联的所有工作人员作业和信息。超时的默认值为 1 天。

第十九章 使用工作队列管理器（二）

基本工作流程

可以通过执行以下步骤来使用工作队列管理器：

1. 将ObjectScript 代码划分为工作单元，这些工作单元是满足特定要求的类方法或子例程。
2. 创建一个工作队列，它是 %SYSTEM.WorkMgr 类的一个实例。为此，请调用 %SYSTEM.WorkMgr 类的 %New() 方法。该方法返回一个工作队列。

可以指定要使用的并行worker jobs的数量，也可以使用默认值，这取决于机器和操作系统。此外，如果已创建类别，则可以指定应从中获取job的类别。

创建工作队列时，工作队列管理器会创建以下工件：
- 包含有关工作队列的信息的全局变量，例如工作队列在哪个命名空间中运行
- 工作队列必须处理的序列化工作单元的位置和事件队列
- 在工作队列完成处理工作单元时创建的完成事件的位置和事件队列

第十七章 进程内存

介绍

进程使用许多不同的资源来实现其目标。其中包括部分或全部 CPU 周期、内存、外部存储、网络带宽等。这篇文章是关于内存使用的。具体来说，它处理为数据存储分配的内存，例如：
- 公共和私有变量

当第一次为它们分配值时，它们被分配了内存空间。在局部数组的情况下，局部变量名称加上所有下标的值的组合引用单个变量值。

除了包含极长字符串的变量外，变量会占用与 $STORAGE 相关的空间。包含极长字符串的变量以不同方式存储，并且不占用 $STORAGE 中的空间。

• 对象实例

每当实例化一个对象时，都会分配空间来保存对象的当前内容以及它所引用的对象。删除最后一个对象引用时返回该空间。

• 本地 I/O 缓冲区

将与该进程正在使用的设备相关联的 I/O 缓冲区存储在进程空间中。

第十五章 字符串本地化和消息字典（一）

本文概述了字符串本地化，并描述了如何导出、导入和管理消息字典。

字符串本地化

当本地化应用程序的文本时，会创建一种语言的文本字符串清单，然后当应用程序区域设置不同时，建立约定以另一种语言替换这些消息的翻译版本。

支持以下本地化字符串的过程：

1. 开发人员在他们的代码中包含可本地化的字符串（在REST 应用程序或商业智能模型中）。

这种机制各不相同，但最常见的机制是 $$$Text 宏。代替硬编码的文字字符串，开发人员包含 $$$Text 宏的实例，为宏参数提供如下值：

• 默认字符串
• 此字符串所属的域（将字符串分组为域时，本地化更易于管理）
• 默认字符串的语言代码

write "Hello world"

替换为

第十三章 信号（三）- 示例演示

运行示例

Main、Producer 和 Consumer 这三个类中的每一个都有自己的 Run 方法，最好在各自的终端窗口中运行它们。每次运行时，它都会显示它为日志生成的消息。一旦用户通过提供它正在等待的输入来响应 Main 类，Main 的 Run 方法将终止删除信号量。然后，用户可以通过键入命令查看所有进程的合并日志文件的显示

  Do ##class(Semaphore.Util).ShowLog()

注意：以下所有示例都假定所有类都已在“USER”命名空间中编译。

示例 1 - 创建和删除信号量

最简单的例子演示了信号量的创建和销毁。它使用 Semaphore.Main 类。请执行下列操作：