技术文档 — Quarkus IRIS Monitor System

1. 目的与范围

此模块支持在基于 Quarkus 的 Java 应用程序与 InterSystems IRIS 的原生性能监控功能之间进行集成。
它使开发者可以通过 @PerfmonReport 对方法添加注释，这样可以在执行方法时自动触发 IRIS 的 ^PERFMON 例程，以生成性能报告，而无需人工干预。

2. 系统组件

2.1 注释：@PerfmonReport

• 定义为 CDI InterceptorBinding。
• 可应用于方法或类。
• 指示使用 IRIS 监控逻辑包装方法执行的框架。

2.2 拦截器：PerfmonReportInterceptor

• 拦截对带注释的方法的调用。

• 执行流程：

  1. 记录启动事件 (LOG.infof("INIT: …"))
  2. 调用 monitorSystem.startPerfmon()
  3. 继续执行 context.proceed()
  4. 在 finally 块中：
     • 调用 monitorSystem.generateReportPerfmon(...)
     • 调用 monitorSystem.stopPerfmon()
     • 记录结束事件及执行时间

• 确保即使抛出异常，监控也始终结束。

2.3 DAO Bean：MonitorSystem

提示：本文包含在Java中通过JDBC Driver对Caché/IRIS数据库进行查询的示例代码。

近期有客户反应使用Java从老版本Caché中读取数据时，如果数据中包含long varchar, Caché数据库中与之对应的属性类型为%Stream.GlobalCharacter，即使实际上该流数据长度非常小，也会成十几倍的降低性能。

大家先来看一段代码, 

1、java如何连接cache2016数据库

2、java如何调用cache的函数

"Backup.General", "ExternalFreeze",

尽管IRIS和HealthConnect拥有全面的互操作特性，但在实际工作中，还是有可能遇到需要使用遗留类库，dll SDK等方式与外部应用通信的情况。例如IRIS中并没有内嵌国密算法SM2、SM3和SM4，而开源社区中不乏通过Java、Python和C++等语言完成的具体实现。本文就将以调用SM4的Java实现为例展示ObjectScript程序与第三方语言通信的过程。

Github地址：https://github.com/LinZhuISC/javademo.SM4

跨编程环境调用设计要点

在开始实际操作之前，希望读者先针对整个调用过程中的主调方和被调方思考两个现象：

1. ObjectScript作为主调方，Java程序对它来说是个黑盒，它既不能直接访问Java虚拟机堆栈中的变量，也不能直接操纵被调代码的行为，例如限制内存使用、控制日志输出等。
2. Java程序作为被调方，其设计目的是通过Java容器运行或被其他Java程序调用，开发过程中通常并不会考虑其自身如何与另一个语言环境交互，因此不能确保异常信息能被主调方捕获与跟踪。

针对这两个现象，开发者需要思考，在哪一侧需要做什么样的一些工作以便调用过程能够顺畅进行。

在这个背景下，当我们需要让ObjectScript与Java相互通信和调用时，就不得不解决几个技术问题：

第二十七章 S 开头的术语

存储接口 (storage interface)

对象（Objects）

使用自定义存储或编写自己的存储类时必须实现的一组方法。

存储策略 (storage strategy)

对象（Objects）

类使用的存储策略在编译时评估为存储定义，决定数据的存储方式。

存储过程 (stored procedure)

SQL

存储过程允许你从 ODBC 或 JDBC 执行查询或类方法。

流接口 (stream interface)

对象（Objects）

IRIS 流接口用于在 ObjectScript、SQL 和 Java 中操作流。

流 (stream)

对象（Objects）

流提供了一个接口，用于操作和存储大量数据。IRIS 流接口可在 ObjectScript、SQL 和 Java 中用于操作流。

超级服务器 (superserver)

系统

监听指定端口的服务器，用于接收对 IRIS 的传入连接并将其分发到适当的子系统。默认的超级服务器端口是 1972；如果 1972 不可用，超级服务器将从 51773 开始监听下一个可用端口。要设置超级服务器端口号，请使用管理门户（系统管理 > 配置 > 系统配置 > 内存和启动）中的内存和启动页面的超级服务器端口号字段。

滑动 (swizzling)

对象（Objects）

当嵌入和持久对象被引用时，自动将其拉入内存的过程。也称为懒加载。

第十三章 I 开头的术语

安装目录 (install-dir)

系统

在通用引用 IRIS 安装目录时，文档使用术语 install-dir。在示例中，文档使用 C:\MyIRIS\。章节“默认安装目录”描述了 IRIS 在所有受支持操作系统上的安装位置。

实例 (instance)

对象（Objects）

表示特定实体的类的实现。术语“实例”和“对象”可以互换使用。

实例认证 (Instance Authentication)

系统

本地认证系统：用户会被提示输入密码，输入的密码的哈希值会传递到 IRIS 服务器，并与服务器中存储的现有密码的哈希值进行比较。如果两个值相同，IRIS 将授予用户对其有权限的资源的访问权限。

此机制在管理门户中列为“密码认证”。

实例方法 (instance method)

对象（Objects）

从类的特定实例调用的方法，并执行与该实例相关的某些操作。

实例化 (instantiate)

对象（Objects）

将对象实例放入内存中，以便程序可以对其进行操作。

中间源代码 (intermediate source code)

ObjectScript

第十一章 F - H 开头的术语

文件流 (file stream)

对象（Objects）

文件流提供了一个接口，用于在外部文件中操作和存储大量基于文本或二进制的数据。IRIS 的流接口可以在 ObjectScript、SQL 和 Java 中用于操作文件流。

最终类 (final class)

对象（Objects）

不能被扩展或子类化的类。

最终方法 (final method)

对象（Objects）

不能被重写的方法。

最终属性 (final property)

对象（Objects）

不能被重写的属性。

外键 (foreign key)

InterSystems SQL

外键约束表中的一列指向另一表中的另一列。为第一列提供的值必须存在于第二列中。

基础 (foundation)

医疗保健（Health care）

在 InterSystems IRIS for Health™ 和 HealthShare® 中，启用了医疗保健互操作性的命名空间。

以 G 开头的术语

全局 (global)

系统

多维存储结构。全局在 IRIS 数据库中使用平衡树技术实现。

全局数据库 (globals database)

系统

IRIS 的基础逻辑和物理数据存储结构，其中所有数据都存储在称为“全局”的多重下标数组系统中。

全局目录 (global directory)

系统

第七十七章 设备特殊变量

^%IS 的更多功能

^%IS 还可用于执行以下任务：

• 右边距抑制 — 可以设置终端线，以便每当选择该设备时，都会抑制右边距问题;默认值是自动假定的。
• 自动设备选择 - 如果在调用 ^%IS 实用程序时存在变量 IOP，则实用程序会自动尝试打开该设备，而不是请求设备。如果 ^%IS 不成功，则将变量 POP 设置为 1。
• 预配置的终端 — 使用 Management Portal，可以配置不向用户请求任何设备信息的设备。

^%IS Global 的结构

^%IS 全局变量存储在 %SYS 命名空间中。它包含两个下标。第一个下标是在 Management Portal 中为设备配置的助记词名称。选择 System Administration、Configuration > Device Settings、IO Settings 以显示不同设备类型的默认助记词。第二个下标可以是 0 或 1。

节点 0 的内容

节点 0 包含设备面板 Location 值：

^%IS(mnemonic,0) = Location

节点 1 的内容

节点 1 包含其他 Device panel 字段值，用插入符号 （^） 分隔：

第七十六章 使用 ^%IS - 示例

示例

调用 CURRENT^%IS 后，将 $X 和 $Y 设置为 DX 和 DY 以定位光标。

  DO CURRENT^%IS
  WRITE *27,*61,*DY+32,*DX+32 
  SET $X=DX,$Y=DY

IN^%IS 入场点

IN 是 ^%IS 中的一个内部入口点，可以由仅计划从设备进行 input 的例程调用。此入口点可用于确保您不选择仅输出设备，例如打印机。

%SYS> Do IN^%IS

Device: 3 
Right margin: 132= <RETURN>
[you can't read from this device] 
Device: <RETURN>  
Right margin: 80= <RETURN>
%SYS>

OUT^%IS 入口点

OUT 是 ^%IS 中的一个内部入口点，可以由仅计划向设备输出的例程调用。

Spooling

IRIS 假脱机独立于您的操作系统执行的假脱机。IRIS 中的假脱机是一种技术，可让自动将程序的输出保存在全局中，而不是立即打印。稍后可以通过将 global 的内容发送到打印机来打印输出。

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

我们公司在和其他公司合作，需要从Cache2016的数据库中执行sql获取数据

sql的内容是调用存储过程

CALL DHCXXXXice.MKPIQuery_QueryXXXX('K007XXXX.JJR','2024-08-01','2024-08-01')

在java代码中执行会报错误如下

但是通过数据库连接工具却能查询到结果

通过数据库连接工具查询到 该存储过程，可接收参数为8个

尝试  CALL DHCXXXXice.MKPIQuery_QueryXXXX('K007XXXX.JJR','2024-08-01','2024-08-01',null,null,null,null,null)

在通过java连接查询时，依然报Parameter list mismatch错误

通过jdbc连接工具依然能查出结果

第九章 创建和使用策略 - 创建并附加策略

创建并附加策略

要创建策略并将其附加到Web 服务或客户端，请创建并编译配置类。有多种方法可以创建此类：

• 使用 GeneratePolicyFromWSDL() 方法从 WSDL 生成配置类。如果 Web 服务或客户端类已存在，并且您不想重新生成，则适用此选项。
• 为现有的 Web 服务或客户端手动创建配置类。

如果从 WSDL 生成策略类，则可能需要按下一节所述对其进行编辑。

从 WSDL 生成策略

在某些情况下，可能已经有客户端类，但没有相应的配置类。例如，如果从 WSDL 生成客户端类，而 WSDL 后来被修改为包含 WS-Policy 信息，则可能会发生这种情况。在这种情况下，可以使用 %SOAP.WSDL.Reader中的实用程序方法单独生成配置类，如下所示：

1. 创建 %SOAP.WSDL.Reader 的实例。
2. 根据需要设置该实例的属性。请参阅 %SOAP.WSDL.Reader 类文档。

不要使用 Process() 方法。

3. 调用实例的 GeneratePolicyFromWSDL() 方法。

此方法具有以下签名：

第六章 设置和其他常见活动 - 编辑 IRIS 凭证集

编辑 IRIS 凭证集

创建 IRIS 凭证集后，可以按如下方式编辑它：

1. 在管理门户中，选择系统管理 > 安全 > X.509 凭证。
2. 在凭证集表中，别名列的值用作标识符。对于要编辑的凭证集，请单击编辑。
3. 根据需要进行编辑。有关这些字段的信息，请参阅上一节。
4. 单击“保存”以保存更改。

无法更改凭证集的别名或证书；也无法添加、更改或删除关联的私钥。要进行此类更改，请创建新的凭证集。

通过编程方式检索凭证集

执行加密或签名时，必须指定要使用的证书。为此，可以选择 IRIS 凭证集。

当手动创建 WS-Security 标头时，必须以编程方式检索凭据集并使用它。

作为参考，本节讨论以下常见活动：

• 如何检索存储的凭证集
• 如何从入站消息中检索凭证集

检索存储的凭证集

要检索 %SYS.X509Credentials的实例，请调用 GetByAlias() 类方法。此方法返回包含证书和其他信息的 IRIS 凭证集。例如：

 set credset=##class(%SYS.X509Credentials).GetByAlias(alias,password)

• alias 是证书的别名。
• pwd 是私钥密码；这仅适用于拥有证书的情况。仅当关联的私钥已加密且您在加载私钥文件时未加载密码时，才需要此密码。

如果不拥有该证书，则无法以任何形式访问私钥。

InterSystems IRIS、Health Connect和上一代的Ensemble提供了优秀的互操作架构，但即便有低代码开发能力，很多开发者还是希望能用自己的技术栈语言在InterSystems的产品上开发互操作产品。

考虑到互操作产品本身的开放性要求和各个技术栈背后庞大的生态价值，InterSystems IRIS和Health Connect提供了Production EXtension (PEX)架构，让开发者使用自己的技术栈语言来开发互操作解决方案。目前PEX支持Java、.net、Python。

这里我们介绍使用Java利用PEX进行互操作产品的开发。

一 InterSystems IRIS上使用Java开发的基础

在进入PEX主题前，需要简单介绍一下Java在InterSystems IRIS上开发的各种技术选项，因为PEX也是以这些技术选项为基础的。

这是Java 编程比赛的相关文章。
我决定推出一个基于 IRIS Native API for Java 的 CRUD++  Global编辑器。
++因为它不仅仅是C reate、 R ead、 U pdate、 D elete
Global可视化对于立即查看结果始终很重要。

• 为此，我使用模仿 ZWrite 的树查看器扩展了 API，并且还允许检查子树。
• $Query Style Navigator 正向和反向操作可轻松找到感兴趣的全局节点。
• 最后，ZKill 添加了一个选项，可以删除全局节点的内容而不删除下面的子树。

这需要在服务器端有一个小的帮助器类作为默认 API 的扩展

我的策略是拥有一个可从命令行使用的相当适度的界面
就像在 Docker 控制台或终端上一样，并使其尽可能简单。
花哨的图形界面只会分散示例的基本内容。

如果有任何默认值或先前的值，则会在输入提示中显示。
在 Docker 容器中，编辑器已经可以使用了。

• docker-compose exec iris java gedi docker-compose exec iris java gedi

您首先连接到服务器

Hi 开发者们，

我们非常高兴地邀请大家参加新的 InterSystems 在线编程竞赛，重点关注 Java 及其衍生产品！

🏆 InterSystems Java 编程大赛🏆

时间： 2023年11月13日至12月3日（美国东部时间）

奖金池： 14,000 美元

What is the reason for this error?
 

从哪里可以下载到cache-2016的安装包？包括windows、macOS以及Linux

根据IDC的报道，超过80%的信息是基于NoSQL的，尤其是文本文件。当数字服务或应用程序不能处理所有这些信息时，企业就会遭受损失。为了面对这一挑战，可以使用OCR技术。OCR使用机器学习和/或训练的图像模式将图像像素转化为文本。这一点很重要，因为许多文件被扫描成PDF格式的图像，或者许多文件中包含有文本的图像。因此，OCR是一个重要的步骤，可以从文件中获得所有可能的数据。

为了实现OCR，可以使用开源解决方案Google Tesseract，这是Python和Java社区中最流行的解决方案。Tesseract支持100多个习语，并且可以用新的模型进行训练以识别车牌、验证码等等。Tesseract是在C++中创建的，可以通过Java套用Tess4J构成一个中介层来使用它。下面的代码展示了调用过程。

预测平台入场服务器配置

平台服务器入场配置预测应用，以java连接iris并使用其IntegratedML技术完成对医院门诊量，服务数，消息数，消息保存时间等数据分析，可以在医院集成平台入场前，对医院入场平台所需的服务器配置进行预测，为客户提供便利。

模拟数据

平台服务器入场配置预测应用 使用IntegratedML技术，通过JDBC连接IRIS，并可使用业务流程流转消息。先导入数据，然后初始化模型，对模型进行训练，然后输入相应的条件对服务器配置进行预测。

操作步骤

• 1. 在IRIS中导入代码并进行编译

• 2. 启动 Production

• 3.运行jar包（修改配置文件）

1. 输入正确的IP端口和命名空间名称

• 4. 访问 http://localhost:9097/swagger -Ui.html

最近在换吃饭的家伙(笔记本)，整理了一下当前开发使用的环境和工具，如下以目录展示，想问问社区的各位老师和同学，你们开发的各个环节使用的是什么工具，同时希望展示一下你们的硬件设备😁😁😁

1 Java环境

1.1 JDK-1.8

1.2 开发工具-IDEA

1.3 MySQL数据库

1.4 版本管理工具-git/svn

1.5 nacos

1.6 spring cloud alibaba

2 前端vue环境

2.1 node

2.2 vue

2.3 浏览器

2.3.1 谷歌

2.3.2 Firefox

2.3.3 Edge

3 esb环境--IRS

3.1 IRS for Heath 2023

3.2 Postman/ApiPost

3.3 SOAPUI

3.4 7Edit.2.x

3.5 Json&XML可视化工具

MissionKitEnt2014/Altova XMLSpy 2014

3.6 开发工具 VSCode

4 虚拟机环境

4.1 VMware Workstation Pro

4.2 镜像

4.2.1 Ubuntu20.04镜像

4.2.2 Windows 2012 R2镜像

4.2.3 Windows 10 镜像

4.3 Docker

4.4 FinalShell

5 远程链接

5.1 向日葵

5.2 ToDesk

6 数据环境

6.1 dbeaver

6.2 navicat

7 办公环境

7.1 腾讯会议

7.2 钉钉

我在官网上提供的java方式访问cache下载了一个示例代码 下载地址为：https://gettingstarted.intersystems.com/language-quickstarts/java-quick…

我在示例代码中看到有这样一种调用 irisNative.functionString("functionName", "routineName") ，请问functionName和routineName主要指什么东西，我在studio中创建了routine，但是也不需要通过functionName来访问呀。

SSH框架是Java一个的比较有代表性的框架，是多年前比较流行的一个。有struts+spring+hibernate和springMVC+spring+hibernate两种，当然我大学时候使用的是第二种。倘使我能把IRIS作为一个库，联结到Hibernate那么理论上是不是也代表IRIS也可以使用SSH框架开发呢？

工具及环境

JDK 1.8

       Maven

       Hibernate 5.X.X

       IRISHealth-2022.1.3

       intellij idea

       Windows 10 64位

1、创建数据库

       用代码的方式创建几个表

如图所示：

2、创建一个Spring的项目

       File—New—Project....

next

给项目起名，选择jdk版本

Next

系统：windows 内存：64GB

环境：jdk11 代码：

1. 概述

鉴于国内医疗市场上，还有一些遗留系统使用PB9，Delphi7等开发技术，为加快开发进度，使第三方能尽快调用由Ensemble提供的标准HL7 V2的webservice服务，先提供几种常见语言调用Ensemble的HL7 V2 webservice接口例子。请大家根据实际情况测试并使用

假设在Production中加入了EnsLib.HL7.Service.SOAPService.CLS这个预制的Business Service并将其命名为PeiXunHl7SoapIn，那么，外部系统可以通过如下endpoint访问HL7 V2 Webservice

http://localhost:57772/csp/peixunpro/EnsLib.HL7.Service.SOAPService.CLS?CfgItem=PeiXunHl7SoapIn

连接前准备：

1. Java 开发环境
2. InterSystems JDBC 驱动
3. Connection String

步骤：

Spring Boot 是最常用来创建 REST API 和微服务的 Java 框架。 它可用于部署 Web 应用程序、可执行 Web 应用程序或桌面自包含应用程序，其中应用程序和其他依赖项打包在一起。 Spring Boot 允许执行许多功能，请参见：

注：要了解有关 SpringBoot 的信息，请参见官方网站 - https://spring.io/quickstart

要创建具有一个或多个微服务的 Web api 应用程序，可以使用 Spring IDE for Eclipse/VSCode，并使用向导配置上述将在应用程序中使用的技术，请参见：

您可以选择技术并创建项目。 所有技术都将通过 maven 导入。 它就像一个可视化的 zpm。

所创建的项目有一个类用于为应用程序提供支持，其中包含所有所需内容（Web 和应用程序服务器，以及所有依赖项、微服务概念）。

此项目的完整源代码在以下 open exchange 项目中： https://openexchange.intersystems.com/package/springboot-iris-crud。

首先要配置 IRIS JDBC 驱动程序和 IRIS Hibernate 支持，为此，请将 jar 文件复制到 resources 文件夹，请参见：

打开 pom.xml 以配置这些 jar 文件的依赖项，请参见：

//迭代取值
IRISIterator subscriptIter = irisNative.getIRISIterator("^liubo.clazz.personD");
System.out.println("================迭代开始===================");
while (subscriptIter.hasNext()) {
    String subscript = subscriptIter.next();
    //此处怎么获取此节点的字符串进行解析呢，另外java可以直接访问ensemble的global么

    System.out.println(node);

}

我现在在使用object script。如果把代码从 objectscript转成 Java 我需要做些什么?

以下示例代码可实现在Java中通过JDBC向IRIS数据库中写入Stream数据，插入的该Stream大小约为4M，对应在IRIS中字段类型为%Stream.GlobalCharacter。以下代码在IRIS2021上测试成功，供大家参考，

Java代码，