第八十九章 参数关键字 - Final

指定此参数是否为final(不能在子类中重写)

用法

要指定参数为final最终参数，请使用以下语法：

Parameter name As parameter_type  [ Final ] = value;

否则，请省略此关键字或将该词放在该关键字之前。

详解

标记为Final的类成员不能在子类中被重写。

默认

如果省略此关键字，则该参数不是最终参数。

第九十章 参数关键字 - Flags

修改此参数的用户接口类型(在Studio中)。

用法

要修改此参数的用户接口类型(在Studio中)，请使用以下语法：

Parameter name As parameter_type  [ Flags = flags ] = value;

其中，flags 为以下值之一：

• ENUM-该参数是由Constraint关键字(逗号分隔列表)指定的值之一。检查器将提供这些值的下拉列表。
• LIST -参数值是由逗号分隔的项目列表组成的字符串。

请注意，不使用EDIT、EMPTY和SYS。

详解

修改参数的用户界面类型(在Studio中)。Studio使用此类型为检查器中的参数提供输入验证。类编译器忽略此关键字。

默认

如果省略此关键字，则Studio只允许该参数使用单个值(并且不提供选项下拉列表)。

第九十一章 映射关键字 - Internal

指定此投影定义是否是内部的(不显示在类文档中)。

第八十五章 方法关键字 - WebMethod

指定此方法是否为web method。仅适用于定义为web service或web客户端的类。

用法

要指定此方法是web方法，请使用以下语法:

Method name(formal_spec) As returnclass [ WebMethod ] 
{    //implementation }

否则，省略此关键字或将单词Not放在关键字的前面。

详解

此关键字指定此方法作为web方法可用，并且可以通过SOAP协议调用。

重要:在大多数情况下，web方法应该是实例方法，而不是类方法。

默认

如果省略此关键字，则该方法不能作为web method使用。

生成的类

当将此关键字添加到方法并编译类时，类编译器将生成一个额外的类:Package.OriginalClass.MethodName。Package.OriginalClass是包含web方法的类，MethodName是web方法的名称。

例如，从类ROBJDemo.DocLiteralWS开始。然后添加一个名为add的方法。当将WebMethod关键字添加到该方法并进行编译时，类编译器将生成类ROBJDemo.DocLiteralWS.Add。

不要修改或直接使用这个生成的类; 仅供内部使用。

WSDL的关系

对于web服务，该关键字还会影响生成的WSDL，后者现在包含表示此web方法所需的附加元素。

第八十一章 方法关键字 - SoapRequestMessage

当多个web方法具有相同的SoapAction时使用此方法。 在默认场景中，该关键字指定请求消息的SOAP正文中的顶级元素的名称。 仅适用于定义为web服务或web客户端的类。

用法

要在请求消息的SOAP体中指定顶级元素的名称，请使用以下语法:

Method name(formal_spec) As returnclass [ WebMethod, SoapAction = "MyAct", SoapRequestMessage="MyReqMessage" ] 
{    //implementation }

其中soaprequestmessage是有效的XML标识符。

详解

注意:此关键字仅对包装的文档/文字document/literal消息有效。

对于包装的文档/文字消息，该关键字指定请求消息的SOAP主体中的顶部元素的名称。(默认情况下，包装文档/文字消息。

如果对同一web服务中的多个web方法使用相同的SoapAction值，请指定此关键字。否则，一般不需要这个关键字。

与WSDL的关系

SoapRequestMessage关键字影响web服务的WSDL的部分。

• rpc —这个web方法使用rpc(远程过程调用)风格的调用。

使用这种绑定风格，SOAP消息被格式化为具有多个部分的消息。

在SOAP消息中，元素包含一个子元素，其名称取自相应的操作名称。这个元素是一个生成的包装元素，它为方法的参数列表中的每个参数包含一个子元素。

重要提示:对于手动创建的web服务，该关键字的默认值通常是合适的。

第七十三章 方法关键字 - Requires

指定用户或进程调用此方法必须拥有的权限列表。

用法

要指定此方法应限于具有指定权限的用户或进程，请使用以下语法:

Method name(formal_spec) As returnclass [ Requires = privilegelist ] 
{    //implementation } 

其中，privilegelist 要么是单个特权，要么是用引号括起来的以逗号分隔的特权列表。 每个权限都采用resource:permission的形式，其中permission是Use、Read或Write(或单字母缩写U、R或W)。

若要为一个资源resource指定多个权限，请使用单字母缩写。

详情

用户或进程必须拥有权限列表中的所有权限才能调用该方法。 调用没有指定权限的方法会导致错误。

如果方法从超类继承了Requires关键字，则可以通过设置关键字的新值将其添加到所需特权的列表中。 不能以这种方式删除所需的特权。

默认

如果忽略此关键字，则调用此方法不需要特殊权限。

示例

下面的方法需要对Sales数据库的读权限和对Marketing数据库的写权限。 (注意，如果一个数据库有写权限，它会自动有读权限。

第六十九章 方法关键字 - PlaceAfter

指定此方法在为类生成的例程中相对于其他方法的顺序。

用法

要指定类编译器应该将此方法放在它为类创建的例程中列出的方法之后，请使用以下语法:

Method name(formal_spec) As returnclass [ PlaceAfter = methodlist ] 
{    //implementation } 

其中methodlist是单个方法名或用逗号分隔的方法名列表，用括号括起来。

详解

此关键字指定类编译器应该将此方法放在它为类创建的例程中列出的方法之后。此关键字用于极少数需要控制类编译器为方法生成代码的顺序的情况。

默认

如果省略此关键字，类编译器将使用其正常逻辑来确定它生成的例程中方法的顺序。

第七十章 方法关键字 - Private

指定此方法是否为私有方法(只能由该类或其子类的方法调用)。

用法

要指定该方法为私有方法，请使用以下语法：

Method name(formal_spec) As returnclass [ Private ] 
{    //implementation }

否则，请省略此关键字或将该词放在该关键字之前。

详情

私有类成员只能由同一类(或其子类)的其他成员使用。请注意，其他语言经常使用protected这个词来描述这种可见性，使用private这个词来表示不可见子类。

可以使用%SYS.Journal.File类中的ByTimeReverseOrder查询，以及%SYS.Journal.Record类中的List查询来实现。

下面是这两个查询的具体作用：

A) %SYS.Journal.File类中的ByTimeReverseOrder查询
这个查询会获取journal日志文件名并按降序排列

USER>set rs=##class(%ResultSet).%New("%SYS.Journal.File:ByTimeReverseOrder")
 
USER>do rs.Execute()
 
USER>while rs.Next() { write rs.Name,! }
c:\intersystems\cache\mgr\journal\20190620.003
c:\intersystems\cache\mgr\journal\20190620.002
c:\intersystems\cache\mgr\journal\20190620.001
c:\intersystems\cache\mgr\journal\20190610.001

B) %SYS.Journal.Record类中的List查询
这个查询可以从指定journal日志文件中获取日志记录

USER>set rs2=##class(%ResultSet).

第六十五章 方法关键字 - GenerateAfter

指定何时生成此方法。仅当方法是方法生成器时适用。

用法

要指定在生成其他方法后调用此方法的生成器，请使用以下语法:

Method name(formal_spec) As returnclass [ CodeMode = ObjectGenerator, GenerateAfter = methodlist ] 
{    //implementation } 

其中methodlist是单个方法名或用逗号分隔的方法名列表，用括号括起来。

详解

在方法生成器方法的情况下，指定生成器应在生成列出的方法后调用。当需要控制方法生成器的调用顺序时，此关键字非常有用。

第六十六章 方法关键字 - Internal

指定此方法定义是否是内部的(不显示在类文档中)。

用法

要指定此方法是内部的，请使用以下语法:

Method name(formal_spec) As returnclass [ Internal ] 
{    //implementation }

否则，省略此关键字或将单词Not放在关键字的前面。

详解

内部类成员不会显示在类文档中。如果想让用户看到一个类，但不看到它的所有成员，这个关键字很有用。

第六十七章 方法关键字 - Language

指定用于实现此方法的语言。

第六十一章 方法关键字 - Deprecated

指定不推荐使用此方法。该关键字被类编译器忽略，只是提供了一个人类可读的指示符，表明该方法已被弃用。

用法

要指定不推荐使用此方法，请使用以下语法:

Method name(formal_spec) As returnclass [ Deprecated ]  
{    //implementation }

否则，省略此关键字或将单词Not放在关键字的前面。

第六十二章 方法关键字 - ExternalProcName

当此方法在外部数据库中用作存储过程时，指定其名称。仅当方法被投影为存储过程时适用。

若要在方法用作外部数据库中的存储过程时重写该方法的默认名称，请使用以下语法:

ClassMethod name(formal_spec) As returnclass [ SqlProc, ExternalProcName = MyProcedure ] 
{    //implementation }

其中MyProcedure是一个不带引号的字符串。

详解

当此方法在外部数据库中用作存储过程时，此关键字允许定义此方法的名称。

默认

如果省略此关键字，方法名将用作存储过程名

第六十三章 方法关键字 - Final

指定此方法是否为最终方法(不能在子类中重写)。

第五十七章 索引关键字 - Unique

指定索引是否应强制唯一性。

用法

要指定IRIS应强制此索引所基于的属性具有唯一性，请使用以下语法：

Index name On property_expression_list [ Unique ];

否则，请省略此关键字或将该词放在该关键字之前。

详情

如果存在UNIQUE关键字，则表示这是唯一索引。

由唯一索引索引的属性(或多个属性)被约束为在定义索引的类(表)的范围(所有对象的集合)内具有唯一值(即，没有两个实例可以具有相同的排序值)。

唯一索引不能也是位图索引。

示例

Index SSNIdx On SSN [ Unique ] ;

默认

如果省略此关键字，IRIS不会强制此索引所基于的属性具有唯一性。

第五十八章 方法关键字 - Abstract

指定这是否是抽象方法。

用法

要指定此方法是抽象的，请使用以下语法:

Method name(formal_spec) As returnclass [ Abstract ] {    //implementation }

否则，省略此关键字或将单词Not放在关键字的前面。

详解

抽象方法没有实现，也没有为其生成的可执行代码。抽象方法的存在仅仅是为了定义一个可以在一个或多个子类中被覆盖和实现的方法签名(或接口)。抽象方法的一些例子是在 IRIS类库中定义的但没有实现的各种回调方法。

第五十三章 索引关键字 - PrimaryKey

指定此索引是否定义表的主键。

用法

要指定该表的主键由该索引所基于的属性构成，请使用以下语法:

Index name On property_expression_list [ PrimaryKey ];

否则，省略此关键字或将单词Not放在关键字的前面。

详解

此关键字指定应通过SQL将此索引报告为此类(表)的主键。

PrimaryKey索引的行为也类似于唯一索引。 也就是说，对于在此索引中使用的属性(或属性组合)，InterSystems IRIS强制唯一性。 在这个索引定义中，允许将Unique关键字指定为true，但这是多余的。

示例

Index EmpIDX On EmployeeID [ PrimaryKey] ;

默认

如果忽略此关键字，则该表的主键不是由索引所基于的属性构成的。

第五十四章 索引关键字 - ShardKey

指定这个类的分片键。

用法

在分片类完全实现之前，InterSystems建议从SQL创建分片表，而不是从对象端。 但是，如果你查看一个通过创建一个分片表生成的类，你可能会看到如下代码:

/// ShardKey分片表索引，由DDL CREATE table语句自动生成
Index ShardKey On DeptNum [ Abstract, CoshardWith = User.

第四十九章 索引关键字 - Data

指定其值将存储在此索引中的属性列表。

用法

要在索引, 中存储属性值，请使用以下语法:

Index name On property_expression_list [ Data = stored_property_list ];

其中，stored_property_list 是单个属性名称或括号中以逗号分隔的属性 , 列表。

详解

此关键字指定属性列表，其值将存储在此索引中。

不能将此关键字与位图索引一起使用。

默认

如果省略此关键字，属性值将不会存储在索引中。

示例

Index NameIDX On Name [ Data = Name ];

Index ZipIDX On ZipCode [ Data = (City,State) ];

第五十章 索引关键字 - Extent

定义范围索引。

用法

要指定这是范围索引，请使用以下语法:

Index State [ Extent ];

否则，省略此关键字或将单词Not放在关键字的前面。

注意:如果使用位图索引，则会自动维护一个范围索引，无需定义。

详解

extent index范围索引用于跟踪哪些对象实例属于某个子类。

默认

范围关键字的默认值为假。

第五十一章 索引关键字 - IdKey

指定此索引是否定义表的对象标识值。

如这文件内容 <?xml version="8.0"?>
<root xmlns="test" xmlns:mc="test1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="test2">
    <!--这个是说明测试哦-->
    <id code="test3"/><root>

我需要获取到<?xml version="8.0"?> 以及 root 节点的所有属性和他们的值比如xmlns，它的值是test，需要获取到id的说明 内容“这个是说明测试哦”

第四十五章 外键关键字 - SqlName

为外键指定一个SQL别名。

用法

要覆盖此外键的默认SQL名称，请使用以下语法:

ForeignKey keyname(key_props) References pkg.class(ref_index) [ SqlName = alternate_name ];

其中备用名是一个SQL标识符。

详解

此关键字允许在通过SQL引用时定义此外键的替代名称。

默认

如果省略此关键字，外键的SQL名称就是外键定义中指定的keyname。

第四十六章 索引关键字 - Abstract

指定索引是抽象的。

用法

要指定索引是抽象的，请使用以下语法:

Index MyIndex [ Abstract ];

注意:创建分片表时，会自动生成一个抽象分片键索引，无需定义。

详解

抽象索引仅用于分片表。它们不包含数据，因此没有存储(没有全局索引)。分片表只有一个抽象索引，称为分片键索引。分片键索引的目的是作为决定行所在分片的键。

如果索引被定义为抽象的，则不能通过方法或SQL访问或使用该索引。如果将此索引标记为唯一的，或者尝试在主键中使用它，这些约束将被忽略。

不能将IdKey索引定义为抽象索引。如果这样做，将会导致类编译错误。

可以在现有索引上使用此关键字，使其变得抽象。这不会删除索引中的任何现有数据。

默认

抽象关键字的默认值为false。

第四十一章 外键关键字 - Internal

指定此外键定义是否为内部定义(不显示在类文档中)。

用法

要将此外键定义标记为内部，请使用以下语法:

ForeignKey keyname(key_props) References pkg.class(ref_index) [ Internal ];

否则，省略此关键字或将单词Not放在关键字的前面。

详解

内部类成员不会显示在类文档中。如果想让用户看到一个类，但不看到它的所有成员，这个关键字很有用。

默认

如果省略此关键字，此外键定义将显示在类文档中。

第四十二章 外键关键字 - NoCheck

指定是否应该检查这个外键约束。

用法

要防止检查该外键定义的约束，请使用以下语法:

ForeignKey keyname(key_props) References pkg.class(ref_index) [ NoCheck ];

否则，省略此关键字或将单词Not放在关键字的前面。

详解

NoCheck关键字禁止检查外键约束(换句话说，它指定外键约束永远不被检查)。

默认

如果省略这个关键字，会检查外键约束。

第四十三章 外键关键字 - OnDelete

指定当外部表中删除的记录被当前表中的记录引用时，此外部键应在当前表中引起的操作。

亲爱的社区开发者们，大家好！

我们真诚邀请您参加 Online Meetup：InterSystems 开发者竞赛（人工智能与机器学习）!

时间: 2021年7月30日（周五） 11:00 AM （美东时间）23:00 （北京时间）

在这场在线Meetup，您将了解到：

• 此次优胜者的个人履历；
• 获奖Application的简短Demo；
• 有关应用技术的开放探讨、问答，以及下次竞赛的一些计划。

亲爱的社区开发者们，大家好！

 InterSystems 开发者竞赛：人工智能与机器学习 圆满结束，现已决出优胜者！

让我们把掌声送给以下开发者！

[toc]

第三十七章 类关键字 - SqlTableName

指定此类投影到的SQL表的名称。仅适用于持久类。

用法

要覆盖此类所投影到的SQL表的默认名称，请使用以下语法:

Class MyApp.Person Extends %Persistent [ SqlTableName = DBTable ]  { //class members }

其中DBTable是有效的SQL标识符。

详解

此关键字指定此类被投影到的SQL表的名称。默认情况下，SQL表名与类名相同。

通常，当类名是SQL保留字(并不少见)或希望SQL表包含类名不支持的字符(如“_”字符)时，可以使用此关键字。

对子类的影响

此关键字不是继承的。

默认

如果省略此关键字，类名将用作SQL表名。

[toc]

第三十八章 类关键字 - StorageStrategy

指定哪个存储定义控制此类的持久性。仅适用于持久类和串行类。

用法

要指定该类使用的存储定义，请使用如下语法:

Class MyApp.MyClass Extends %Persistent [ StorageStrategy = MyStorage ] 
{ //class members }

其中MyStorage是此类中存储定义的名称。

详解

此关键字指定哪个存储定义用于定义此类使用的存储结构。

重要提示:对于手动创建的web服务，该关键字的默认值通常是合适的。

第二十九章 类关键字 - PropertyClass

向该类添加属性参数。

用法

要向该类添加属性参数，请使用以下语法:

Class PropClass.MyClass Extends %RegisteredObject [ PropertyClass = PropClass.MyPropertyClass ] { //class members }

其中·propertyclasslist·是下列之一:

[ PropertyClass = PropClass.MyPropertyClass ]

• 用逗号分隔的类名列表，用括号括起来。

详情

如果需要添加自定义属性参数，请执行以下操作:

1. 定义并编译一个定义一个或多个类参数的类。例如:

Class PropClass.MyPropertyClass
{

Parameter MYPARM As %String = "XYZ";

}

这些类参数在下一步中成为属性参数。

2. 在定义属性的类中，指定PropertyClass关键字。

对子类的影响

子类继承这个关键字添加的自定义行为。如果子类为关键字指定了一个值，则该值会指定一个或多个为该类的属性指定参数的附加类。

第三十章 类关键字 - ServerOnly

指定此类是否被投影到Java客户端。

用法

要覆盖将类投影到Java客户端的默认方式，请使用以下语法:

Class Sample.

以下步骤展示如何显示 /api/monitor 服务提供的指标列表示例。

在上个帖子中，我概述了以 Prometheus 格式显示 IRIS 指标的服务。 该贴介绍了如何在容器中设置和运行 IRIS 预览版 2019.4，然后列出了指标。

本帖假定您已安装 Docker。 如果未安装，现在就为您的平台安装吧 :)

步骤 1. 下载并运行 docker 形式的 IRIS 预览版

按照预览发行版的下载说明下载预览版许可证密钥和 IRIS Docker 映像。 例如，我选择了 InterSystems IRIS for Health 2019.4。

按照 Docker 容器中的 InterSystems 产品初见中的说明操作。 如果您熟悉容器，请跳转到标题为“下载 InterSystems IRIS Docker 映像”的部分。

以下终端输出说明了我用来加载 docker 映像的过程。 docker load 命令可能需要几分钟的时间才能运行；

$ pwd
/Users/myhome/Downloads/iris_2019.4

$ ls
InterSystems IRIS for Health (Container)_2019.4.0_Docker(Ubuntu)_12-31-2019.ISCkey  irishealth-2019.4.0.379.0-docker.

# <center> 第二十五章 类关键字 - NoExtent

指定是否阻止编译器为此类生成继承类(如果不这样做的话)。

# 用法

要防止编译器为此类生成继承类，请使用以下语法:

```
Class MyApp.MyClass [ NoExtent ]  { //class members }
```

否则，省略此关键字或将单词`Not`放在关键字的前面。

# 详解

如果该关键字为真，则该类没有 `extent`。不能创建此类的实例。通常，这样的类会扩展或覆盖从`%Library.Persistent`继承的标准持久接口。

# 对子类的影响

此关键字不是继承的。

# 默认

如果省略此关键字，类可以有一个`extent`。

# <center> 第二十六章 类关键字 - OdbcType

指定通过`ODBC`或`JDBC`公开此数据类型时使用的类型。每个数据类型类都必须指定一个`ODBC`类型。此关键字仅适用于数据类型类。

# 用法

要指定通过ODBC或JDBC投影此数据类型时要使用的类型，请使用以下语法：

```
Class MyApp.

# <center> 第二十一章 类关键字 - Hidden

指定此类是否隐藏(未在类引用中列出)。

# 用法

要隐藏类，请使用以下语法:

```java
Class MyApp.Person [ Hidden ]  { //class members }
```
否则，省略此关键字或将单词Not放在关键字的前面。

# 详解

如果一个类是隐藏的，当使用Visual Studio代码的对象脚本扩展时，它不会在类引用中列出，也不会在studio检查器的工作区窗口中列出，也不会在对象脚本资源管理器窗格中列出。(但是，如果在“打开”对话框中键入该类的名称，或者在使用VS Code - ObjectScript时将其保存到本地工作区，仍然可以在Studio中打开该类。)

# 对子类的影响

此关键字不是继承的。

# 默认

如果省略此关键字，则该类不会被隐藏。

# <center> 第二十二章 类关键字 - Inheritance

指定此类的超类的继承顺序。

# 用法

要为此类的超类指定继承顺序，请使用以下语法:

```java
Class MyApp.

第十七章 类关键字 - DependsOn

指定此类应在编译器使其他(指定的)类可运行后编译。

用法

要指示类编译器应该在其他类可运行后编译此类，请使用以下语法:

Class MyApp.MyClass [ DependsOn = classlist ]  
{ //class members }

其中classlist是下列之一:

• 类名

[ DependsOn = MyApp.Class1 ]

• 用逗号分隔的类名列表，用括号括起来。

[ DependsOn = (MyApp.Class1,MyApp.Class2,...) ]

详情

此关键字指定类编译器应该在使指定的类可运行后编译此类。

如果此类的编译使用方法生成器逻辑中的这些其他类，则此关键字非常有用。如果类包含调用其他类的初始表达式，这也很有用。

此关键字仅影响编译顺序，不影响运行时行为。

注意:DependsOn关键字只影响具有System关键字的公共值的类。

此外，如果一个类有DependsOn=ClassA，那么它也有CompileAfter = ClassA也是多余的。

对子类的影响

这个关键字继承自所有超类。如果子类为关键字指定了一个值，该值指定了在子类被编译之前必须运行的附加类。

默认

默认情况下，不指定该关键字。

第十八章 类关键字 - Deprecated

# <center> 第十三章 类关键字 - ClientDataType

指定将此数据类型投影到客户端技术时使用的客户端数据类型。仅适用于数据类型类。

# 用法

要指定将此数据类型投影到客户端技术时要使用的客户端数据类型，请使用以下语法:
```java
Class MyApp.MyString [ ClientDataType = clienttype ]  
{ //class members }
```

其中clienttype是下列之一:

- `BIGINT`
- `BINARY`
- `BINARYSTREAM`
- `BOOLEAN`
- `CHARACTERSTREAM`
- `CURRENCY`
- `DATE`
- `DECIMAL`
- `DOUBLE`
- `FDATE`
- `FTIMESTAMP`
- `HANDLE`
- `INTEGER`
- `LIST`
- `LONGVARCHAR`
- `NUMERIC`
- `STATUS`
- `TIME`
- `TIMESTAMP`
- `VARCHAR` (默认)

# 详解

此关键字指定将此类投影到客户端技术时使用的客户端数据类型。每个数据类型类都必须指定一个客户端数据类型。

# 对子类的影响

这个关键字是从主超类继承的。子类可以覆盖关键字的值。

# 默认

默认的客户端数据类型是`VARCHAR`。

第九章 触发器定义

描述触发器定义的结构。

介绍

触发器是在SQL中发生特定事件时执行的代码段。InterSystems IRIS支持基于执行INSERT、UPDATE和DELETE命令的触发器。根据触发器定义，指定的代码将在相关命令执行之前或之后立即执行。每个事件可以有多个触发器，只要它们被分配了执行顺序。

可以向持久类添加触发器定义。它们在其他类中没有意义。

详情

触发器定义具有以下结构:

/// description 
Trigger name [ keyword_list ]  
{ implementation }

• description 描述(可选)旨在显示在“类参考”中。默认情况下，描述为空白。
• name(必需)是触发器的名称。这必须是有效的类成员名称，并且不能与任何其他类成员名称冲突。
• keyword_list(必需)是以逗号分隔的关键字列表，用于进一步定义触发器。
• implementation 实现(必需)是零行或多行ObjectScript代码，用于定义触发触发器时要执行的代码。

第五章 参数定义

描述参数定义的结构。

介绍

参数定义定义了一个给定类的所有对象都可用的常数值。创建类定义时(或在编译前的任何时候)，可以设置其类参数的值。默认情况下，每个参数的值都是空字符串，但是可以在参数定义中指定一个非空值。在编译时，为类的所有实例建立参数值。除了极少数例外，该值不能在运行时更改。

详解

参数定义具有以下结构:

/// description 
Parameter name As parameter_type [ keyword_list ] = value ;

• description描述(可选)旨在显示在“类参考”中。默认情况下，描述为空白。
• name(必需)是参数的名称。这必须是有效的类成员名称，并且不能与任何其他类成员名称冲突。
• parameter_type(可选)指定参数的用户界面类型，由Studio用于在检查器内为参数提供输入验证。

这不是类名；参见下一节。在大多数情况下，编译器会忽略这个关键字。

如果省略参数类型，也要省略单词As

• value(可选)指定参数的值。如果省略值，也要省略等号=
• keyword_list(可选)是以逗号分隔的关键字列表，用于进一步定义参数。

如果省略此列表，也要省略方括号。

参数的允许类型

参数类型parameter_type 选项可以是下列值之一:

• BOOLEAN — true(1)或false(0)值。

InterSystems极客俱乐部线上直播课“Health Connect系统运维培训”回放已准备好，欢迎您点击报名，扫码看回放！

第一章 类定义

描述类定义的结构。

介绍

一个类可以包含熟悉的类元素，如属性、方法和参数(在其他类语言中称为常量)。它还可以包含通常不在类中定义的项，包括触发器、查询和索引。

详细

类定义具有以下结构:

Import import_ppackage_list  
Include include_code  
IncludeGenerator include_generator_code  

/// description 
Class package.shortclassname Extends superclass_list [ class_keyword_list ] 
{  
    Class_members
}

• import_package_list(可选)指定类从中导入的任何包的名称。会影响编译器解析短类名的方式。

如果指定了此选项，则它可以是单个包的名称，也可以是多个包的逗号分隔列表，用括号括起来。

如果import_package_list为空，则不要在类定义的开头添加import行。

注意:如果一个类导入任何包，该类不会自动导入用户包。

导入的包继承自所有超类。如果一个子类指定了一个或多个导入包，这些导入包将被添加到由超类定义的任何导入包中。

• include_code(可选)指定 include (.inc)。编译此类时使用的文件。

第七章 将文件内容复制到另外文件

示例

本例显示了一个使用本文前面介绍的几个%Library.File方法的样例类。

在示例类Demo.FileDemo中，ProcessFile()方法接受输入文件和输出文件，并调用SetUpInputFile()和SetUpOutputFile()打开文件，一个用于读取，另一个用于写入。然后，它逐行读取输入文件，并调用ProcessLine()对每行的内容执行一个或多个替换，将每行的新内容写入输出文件。

/// 设置输入文件
/// 1. 创建文件对象
/// 2. 打开文件阅读
/// 3. 返回文件对象的句柄
ClassMethod SetUpInputFile(filename As %String) As %File
{
    Set fileObj = ##class(%File).%New(filename)
    Set status = fileObj.Open("RU")
    if $$$ISERR(status) { 
        do $system.Status.DisplayError(status) 
        quit $$$NULLOREF
    }
    quit fileObj
}

/// 设置输出文件
/// 1. 为文件创建目录结构
/// 2. 创建文件对象
/// 3.