第二十章 源代码文件 REST API 参考（二）

GetMetaData

此方法返回命名数据库的 METADATA.zip 文件的二进制内容。 Atelier 使用此文件来存储索引信息，以便为将来的会话保留此信息。

URL

GET http://server:port/api/atelier/v1/%25SYS/metadata/database

注意：因为 是 URL 特殊字符，所以要指定文字 %，必须在其后跟 （百分号字符的十六进制代码）。因此，必须使用 来指定文字 。

HTTP 返回码

• HTTP 200 如果正常。
• 如果源代码文件不存在，则返回 HTTP 404。
• HTTP 500 如果发生意外错误（详细信息将在状态错误数组中）。

GetCSPApps

此方法返回在服务器上定义或为服务器上指定命名空间定义的 应用程序列表。

URL

其中：

指定命名空间的名称。如果未指定命名空间，则此方法返回所有命名空间的 应用程序。

注意：因为 是 特殊字符，所以要指定文字 %，必须在其后跟 （百分号字符的十六进制代码）。因此，必须使用 来指定文字 。

URL Parameters

可以传递 参数 以返回包含更详细描述应用程序的对象的数组。

JSON Messages

以下返回的内容是一个列出已定义

根据日期范围查询的SQL性能让你失望？  我有一个比较特别的技巧，可能会帮助你解决这个问题! (SQL开发人员讨厌这个!)*

如果你有一个类，在添加数据时记录时间戳，那么这些数据将与你的IDKEY值保持顺序--也就是说，当且仅当ID1<ID2时，表内所有ID和时间戳值的TimeStamp1<TimeStamp2--那么你可以利用这一知识来提高对时间戳范围的查询性能。  考虑一下下面这个表:

Class User.TSOrder extends %Persistent 
{ 

Property TS as %TimeStamp;

Property Data as %String (MAXLEN=100, MINLEN=200);

Index TSIdx on TS;

Index Extent [type=bitmap, extent];

}

用过去30天内的30,000,000条随机行来填充，每天将得到1,000,000条行。 现在，如果我们想查询某一天的信息，你可以这样写：

SELECT ID, TS, Data 
FROM TSOrder
WHERE 
     TS >= '2016-07-01 00:00:00.00000' AND 
     TS <= '2016-07-01 23:59:59.999999'

第十九章 源代码文件 REST API 参考（一）

源代码文件 REST 接口支持以下方法：

• GetServer：返回有关服务器的信息。
• HeadServer：返回服务器的 HttpHeader。
• GetJobs：返回正在运行的列表。
• GetMetaData：返回命名数据库的 文件的内容。
• GetCSPApps：返回 应用程序列表。
• ：返回有关特定命名空间的信息。
• ：返回源代码文件名列表。
• ：返回自数据库具有指定哈希值以来已修改的源代码文件列表。
• ：保存提供的源代码文件。
• ：返回指定源代码文件的文本。
• ：删除命名的源代码文件。
• ：返回命名源代码文件的 。
• ：返回所有指定源代码文件的文本。
• ：删除命名源代码文件列表。
• 编译：编译您指定的源代码文件。
• 索引：返回有关指定源代码文件的摘要信息。
• 查询：对任何表执行 查询并返回结果。
• 搜索：在数据库中搜索源代码文件。
• ：返回用于创建作品的类的名称列表。可以指定要获取的类的类型，例如业务服务类。
• ：返回适配器的输入和输出类型。

GetServer

此方法返回有关服务器的信息，包括服务器上可用的 源代码文件 版本和名称空间。

URL

JSON Messages

{
  "status": {
    "errors": [],
    "summary": ""
  },
  "console": [],
  "result": {
    "content": {
      "version": "IRIS for Windows (x86-64) 2018.1.1 (Build 515U) Mon Feb 5 2018 08:24:13 EST",
      "id": "98E1697E-13F9-4D6A-8B73-827873D1D61C",
      "api": 2,
      "features": [
...
      ],
      "namespaces": [
        "%SYS",
        "USER"
      ]
    }
    }
}

cache的题目资源，类似于Oracle的OCP试题那种，能反应出对基础概念的掌握。

第十八章 源代码文件 REST API 教程（三）

编译文件

Compile 方法编译传入 JSON 数组中名称指定的源代码文件。例如，要编译 xyz.mac，请发布以下内容：

http://localhost:52773/api/atelier/v1/INVENTORY/action/compile

使用以下 消息：

["xyz.mac"]

该方法返回：

{
  "status": {
    "errors": [],
    "summary": ""
  },
  "console": [
    "",
    "Compilation started on 08/14/2016 15:25:20 with qualifiers 'cuk'",
    "xyz.int is up to date. Compile of this item skipped.",
    "Compilation finished successfully in 0.008s."
  ],
  "result": {
    "content": []
  }
}

对于一些源代码文件，例如类， 在返回的内容中返回存储信息。

删除文件

DeleteDoc 方法删除 中指定的文件。 方法与

第十七章 源代码文件 REST API 教程（二）

获取在命名空间中定义的源代码文件

要获取有关命名空间中源代码文件的信息：

• 首先，使用 GetDocNames 方法获取文件的名称。
• 然后用GetDoc 方法获取一个文件的内容，也可以用GetDocs 方法获取多个文件的内容。
• 如果要提高应用程序的网络效率，可以保留源代码文件的名称和内容的本地缓存，并使用 GetModifiedDocNames 方法仅获取内容发生变化的源代码文件的名称或使用带有 标头的 GetDoc 方法。

方法返回映射到命名空间的所有数据库中的所有源代码文件的名称。

{
  "status": {
    "errors": [],
    "summary": ""
  },
  "console": [],
  "result": {
    "content": [
      {
        "name": "%Api.DocDB.cls",
        "cat": "CLS",
        "ts": "2016-08-03 20:01:42.000",
        "upd": true,
        "db": "IRISLIB",
        "gen": false
      },
      ...
      {
        "name": "EnsProfile.mac",
        "cat": "RTN",
        "ts": "2003-09-19 13:53:31.000",
        "upd": true,
        "db": "INVENTORYR",
        "gen": false
      },
      ...
      {
        "name": "xyz.mac",
        "cat": "RTN",
        "ts": "2016-08-11 15:05:02.167",
        "upd": false,
        "db": "INVENTORYR",
        "gen": false
      }
    ]
  }
}

Production是指Ensemble/HealthShare Health Connect/IRIS/IRIS for Health产品中提供的互操作功能模块，更多关于Production介绍，可参见在线文档，
https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=AFL_productions#AFL_productions_quicklook

Production中访问外部数据库常用的适配器Adapter有两个，一个是用于Business Service中的Enslib.SQL.InboundAdapter，另一个是用于Business Operation中的Enslib.SQL.OutboundAdapter,
更多关于这两个Adapter的使用说明可以参见在线文档"Using SQL Adapters in Productions",

本文主要涵盖以下内容

1. 基本配置步骤（仅涉及与JDBC连接相关配置）
2. JDBC Gateway和Java Gateway Service的区别
3. 常见的问题类型
4. 常用基本故障排查

基本配置步骤

前提，在配置之前请您首先确认您的环境中已经正确安装了Java。
1.

第十六章 源代码文件 REST API 教程（一）

本章提供了一个简短的教程，通过一系列示例演示如何使用源代码文件 REST API。它包含以下部分：

API 基础

Atelier 用于访问 IRIS 源代码文件的 API 使用 架构风格。 的名字来源于“Representational State Transfer”。与许多 一样 源代码文件 使用 、、、 和 方法，并将 用于传入和传出消息体。

要调用 方法，需要了解以下内容：

• HTTP 方法——它是以下之一：GET、POST、、 或 。
• 标头——为调用提供上下文信息。此 中使用的 包括：
  • 授权，它提供对服务器的访问。除非安装了具有最低安全性的服务器，否则需要提供用户名和密码才能访问 API。
  • Content-Type application/json，指定入站负载以 JSON 格式提供。必须为所有 POST 和 方法指定此标头。
  • ，它允许 或 PutDoc 调用检查源代码文件自上次访问以来是否被修改。
• - 由以下部分组成：
  • ——在本章中，我们假设 在本地服务器上运行并使用端口 。
  • ——这是由具有 调度类的 应用程序定义的。
  • 标识方法和目标的 部分。

推荐一篇文章，南方医院HIS系统的更换与建设探索！

今天推荐一篇智能病历诊断方面的文章（点击阅读全文）。

开发者们，大家好！

在此向您介绍开发者社区的一个新特性—— InterSystems开发者关键问题（Key Questions）.

我们增加了一个新的 #Key Question 标签（#关键问题），用以显著标识与InterSystems数据平台有关的、影响重大的提问/问题。

每个月，InterSystems专家会选择一些这类问题，提出这些问题的社区成员将被授予荣誉奖励！

有哪些荣誉呢？详情如下！ 

Hi 社区成员们，

我们希望你正在经历一个激情而又鼓舞人心的夏天（你所在的地方也有可能是冬天：D）！

今天我们在开发者社区启动“探索之夏”活动，详情如下：

第十五章 源代码文件 REST API 简介

源代码文件 REST API 简介

此 REST API 提供对源代码文件的访问。我们开发此 API 是为了允许 Atelier（我们基于 的 ）访问 服务器上的 代码文件。可以使用 执行访问 代码文件所需的操作。这些行动包括：

• 获取 IRIS 实例上可用的命名空间
• 查找命名空间中定义的类定义和例程
• 获取类和例程的文本定义
• 更新类定义或例程
• 创建新的类定义或例程
• 删除类定义或例程
• 编译 IRIS 类或例程
• 通过对表执行 查询来发现 环境的属性

这些操作提供了访问 IRIS 源代码文件的机制。为了创建 开发环境，应该了解此 API 并全面了解 源代码文件如何在 中使用。

这是一个特殊用途的 。如果正在创建开发环境或处理类似的应用程序，例如类浏览器，可能会发现此 很有用。但是，它不是用于访问 IRIS 对象的通用 。

本文档描述了 源代码文件 的版本 和 。 的未来版本可能支持此 的更高版本，提供额外的调用，但将始终能够调用早期版本。版本 的 在 中包含 ，版本 的 包含 。可以通过调用 方法找出 提供的此 的版本。

下面介绍 的主要功能以及提供这些功能的方法：

• 获取有关服务器环境的信息：

  • GetServer 方法提供有关服务器的重要信息，包括服务器上的命名空间。
  • GetNamespace

第十四章 手动创建 REST 服务（二）

指定数据格式

可以定义 REST 服务以处理不同格式的数据，例如 JSON、XML、文本或 。 调用可以通过在 请求中指定 元素来指定它期望发送的数据的形式，并且可以通过在 请求中指定 元素来请求返回数据格式。

在 示例中， 方法检查 REST 调用是否使用以下内容请求 数据：

If $Get(%request.CgiEnvs("HTTP_ACCEPT"))="application/json"

本地化 服务

服务返回的任何字符串值都可以本地化，以便服务器以不同语言存储多个版本的字符串。然后，当服务接收到包含 HTTP 标头的 请求时，服务会使用相应版本的字符串进行响应。

本地化 服务：

1. 在实现代码中，不要包含硬编码的文字字符串，而是使用 $$$Text 宏的实例，为宏参数提供如下值：

• 默认字符串

如何在Ensemble中对字段类型为GlobalCharacterStream进行字符串搜索？String的可以搜索，但是Stream类型的就不行。

第十三章 手动创建 REST 服务（一）

本附录描述了如何通过继承 %CSP.REST 类来手动创建 REST 服务；此过程创建了一个手动编码的 REST 服务，它不能与所有 管理工具一起使用。

手动创建 服务的基础知识

要手动定义 服务，请执行以下操作：

• 创建一个 REST 服务类 — %CSP.REST 的子类。在子类中：
  • 定义一个 URL 映射，该映射指定为 REST URL 和 HTTP 方法执行的 方法。
  • 可以选择指定 参数。此参数控制每个 调用是在其自己的 Web 会话下执行还是与其他 调用共享一个会话。
  • （可选）覆盖错误处理方法。

如果想将实现代码与调度代码分开，可以在单独的类中定义实现 REST 服务的方法，并从 URL 映射中调用这些方法。

• 定义一个使用 服务类作为其调度类的 应用程序。

要定义 应用程序及其安全性，请转至 应用程序页面（单击System Administration > Security > Applications > Web Applications）。

定义 应用程序时，将 设置为 REST 服务类的名称。

此外，将应用程序的名称指定为 调用的 的第一部分。示例名称为 或 ，但可以指定 中允许的任何文本。

可以在一个命名空间中定义多个 服务类。每个拥有自己入口点的 服务类都必须拥有自己的

近日遇到客户反映在Business Operation中使用SQL Outbound Adapter调用Oracle存储过程时，无法获取CLOB完整的返回内容。借此在这里介绍下该如何调用，话不多说，直接上代码。

注意，以下代码片段直接应用于Business Operation中，

set pIn = 4
set pIn(1) = "aaaa"
set pIn(1,"IOType") = 1    // 1：input , 4:output
set pIn(1,"SqlType") = 12  // 12: varchar

set pIn(2,"IOType") = 4     
set pIn(2,"SqlType") = 4   // 4: integer

set pIn(3,"IOType") = 4     
set pIn(3,"SqlType") = 12  

set pIn(4,"IOType") = 4     
set pIn(4,"SqlType") = 2005   // CLOB
set pIn(4,"LOB") = 1

set tQuery = "{ call test_hc(?,?,?,?) }"  /// the first one parameter is input parameter, the last three are all output parameters.

set tSC = ..Adapter.ExecuteProcedureParmArray(.tRS,.pOut,tQuery,"iooo",.pIn)

set cnt = pOut.Count()

// you will get this stream data 
if cnt >1
{
  for i=1:1:cnt
  {
     set ov = pOut.GetAt(i))
     $$$TRACE("pOut("_i_")="_ov)

     /// the third one is the CLOB output.
     if (i = 3)
     {
        while 'ov.AtEnd 
        { 
          $$$TRACE(ov.Read())
        }
     }
  }
}

第十二章 使用中的 OpenAPI 属性

本附录列出了 API 管理工具在生成 REST 服务类时使用的 OpenAPI 2.0 规范的属性。此处未列出的属性将被忽略。有几个扩展属性；它们的名称以 x-ISC 开头。

• basePath

• consumes

• host

• (请注意， 管理工具在生成代码时不使用 对象的任何属性)

• (for details, see “Parameter Object”)

• (for details, see “Path Item Object”)

• info (for details, see “Info Object”)

• swagger (must be "2.0")

有关这些属性的详细信息，请参阅 https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#swagger-object。

Info Object

• title

• x-ISC_RequiredResource

在这篇文章中，我试图找出多个领域来开发我们能够使用python和机器学习的功能。

每家医院都在努力利用技术和服务来提高其服务质量和效率。

医疗保健部门是一个非常大的、可供选择的服务领域，而python是做机器学习的最好技术之一。

在每个医院里，人们都会有一些感觉，如果这种感觉能够被计算机理解，使用技术就有机会提供更好的服务。

在这里，我们可以把这两者结合起来，在医疗部门，我正试图理解/识别各种选择，以提供更好的服务。

首先，我们可以尝试使用python的机器学习来识别人并了解他们目前的感受。比如，在医院信息系统中，每个病人至少有一张照片，使用该照片我们可以识别病人，然后一旦病人到达医院，使用视频监控和机器学习技术需要识别这个人的感觉。

在医院设施中会看到多种类型的感觉。

1）紧张

2）平静和冷静

3)   哭泣

4)  暴力的病人/亲属

5)  生病的病人

6)  高烧鉴定

像上面的情况，我们可以看到多种不同的类型。

如果一个已经登记的病人发高烧，那么使用闭路电视识别这个病人的情况，并捕捉温度热像仪，护理人员可以给予更好的支持，这在接待服务领域是非常大的区别。

如果这个发高烧的人已经是一个登记的病人，如果利用现有的照片识别这个病人，那么我们可以做多件事情。

1)如果该病人今天有预约，我们可以自动到达该病人处。

第十一章 /api/mgmnt/ API 参考

此参考列出了 /api/mgmnt/ 服务中的端点，所有这些端点都适用于较新的 REST 服务。下表总结了端点并指出它们是否也适用于手动编码的 REST 服务。

什么时候使用索引

索引提供了一种机制，通过维护常用数据的分类子集来优化查询。确定哪些字段应该被编入索引需要一些思考：太少或错误的索引，关键查询会运行得太慢；太多的索引会减慢INSERT和UPDATE的性能（因为索引值必须被设置或更新）。

索引什么

为了确定添加索引是否能提高查询性能，从管理门户的SQL界面运行查询，并在Performance中注意 global引用的数量。添加索引，然后重新运行查询，注意 global引用的数量。一个有用的索引应该减少 global引用的数量。你可以通过使用%NOINDEX关键字作为WHERE子句或ON子句条件的前言来阻止索引的使用。

你应该对JOIN中指定的字段（属性）进行索引。例如，LEFT OUTER JOIN从左表开始，然后查看右表，因此，你应该对右表的字段进行索引。在下面的例子中，你应该为T2.f2编制索引。一个INNER JOIN应该在两个ON子句字段上都有索引。

  FROM Table1 AS T1 LEFT OUTER JOIN Table2 AS T2 ON T1.f1 = T2.f2

如果查询计划中的第一个项目是 "read master map"，或者查询计划调用的模块的第一个项目是 "read master map"，那么查询的第一个map就是master map而不是索引map。

第十章 发现和记录 REST API

本章讨论如何发现实例上可用的 REST 服务以及如何为 REST 服务生成文档。

使用 /api/mgmnt 服务发现 服务

/api/mgmnt 服务包括可用于发现 服务类和启用 REST 的 应用程序的调用。

发现 服务

要使用 服务来发现实例上可用的 REST 服务，请使用以下 调用：

• 对于 HTTP 操作，选择或指定 GET。
• 对于 ，请指定以下形式的 ：

http://localhost:52773/api/mgmnt/v2/

或者，如果只想检查一个命名空间：

http://localhost:52773/api/mgmnt/v2/:namespace

其中 是服务器的名称， 是运行 的 服务器端口，命名空间是要检查的命名空间。

（请注意，这些调用会忽略手动编码的 服务。要发现手动编码的 应用程序，请使用调用 和 。）

如果调用成功， 以 格式返回一个列出 服务的数组。例如：

[
  {
    "name": "%Api.Mgmnt.v2",
    "webApplications": "/api/mgmnt",
    "dispatchClass": "%Api.Mgmnt.v2.disp",
    "namespace": "%SYS",
    "swaggerSpec": "/api/mgmnt/v2/%25SYS/%Api.Mgmnt.v2"
  },
  {
    "name": "myapp",
    "webApplications": "/api/myapp",
    "dispatchClass": "myapp.disp",
    "namespace": "USER",
    "swaggerSpec": "/api/mgmnt/v2/USER/myapp"
  }
]

应用集成平台市场上产品众多，商家专家观点纷纭，莫衷一是。Gartner公司从用户角度出发，搭建了Peer Insight “大众点评”平台，让用户能够为自己使用的产品发声，对各个产品打分。以下是来自用户的声音，供参考。

第一款产品是微软的BizTalk，综合得分3.9。

第二款产品是InterSystems的Ensemble，综合得分4.6。

第三款产品是IBM的WebSphere Enterprise Service Bus，综合得分3.8。

BizTalk  by MicroSoft	Ensemble  by InterSystems	WebSphere Enterprise Services Bus by IBM
总体评价：57%的用户愿意推荐该产品	总体评价：88%的用户愿意推荐该产品	总体评价：55%的用户愿意推荐该产品
分项评分	分项评分	分项评分
综合能力得分	综合能力得分	综合能力得分
评估与签约     3.3 定价灵活性     4.0 理解需求的能力	评估与签约     4.2 定价灵活性     4.6 理解需求的能力	评估与签约     3.5 定价灵活性     4.0 理解需求的能力
集成与部署   3.4 部署便利性   3.

InterSystems SQL支持在InterSystems IRIS数据平台数据库中将流数据存储为BLOB（Binary Large Objects 二进制大对象）或CLOB（Character Large Objects字符大对象）的能力。

InterSystems SQL支持两种流字段：

• 字符流：用于大量的文本。
• 二进制流：用于图像、音频或视频。

BLOBs和CLOBs可以存储多达4GB的数据（JDBC和ODBC规范规定的限制）。除了在通过ODBC或JDBC客户端访问时如何处理字符编码转换（如Unicode到多字节）外，BLOB和CLOB的操作在各方面都是相同的：BLOB中的数据被视为二进制数据，决不转换为其他编码，而CLOB中的数据被视为字符数据，在必要时进行转换。

如果一个二进制流文件（BLOB）包含单一的非打印字符$CHAR(0)，它被认为是一个空的二进制流。它相当于""空二进制流值：它存在（不是空的），但长度为0。

从对象的角度来看，BLOB和CLOBs被表示为流对象。更多信息请参见定义和使用类中的 "与流合作 "一章。

定义流数据字段

InterSystems SQL支持流字段的各种数据类型名称。这些InterSystems的数据类型名称是对应于以下的同义词。

• 字符流：数据类型LONGVARCHAR，映射到%Stream.

定义 Stored Procedures

可以使用以下方式定义stored procedures

1. 使用DDL定义存储过程
2. 使用类方法定义存储过程

使用DDL定义存储过程

CREATE PROCEDURE 可以创建一个查询，它总是作为一个存储过程被预测。一个查询可以返回一个单一的结果集。

CREATE PROCEDURE AgeQuerySP(IN topnum INT 10, IN minage INT 20)
BEGIN
SELECT TOP ：topnum Name, Age FROM Sample.Person
WHERE Age > :minage;
END

列表中的每个参数声明包括（按顺序）。指定参数模式是IN（输入值），OUT（输出值），还是INOUT（修改值）。如果省略，默认的参数模式是IN，参数名称是区分大小写的。

CREATE QUERY 可以创建一个可以选择作为存储过程投射的查询。一个查询可以返回一个单一的结果集，这个查询可能是也可能不是作为存储过程公开的。要创建一个作为存储过程公开的查询，你必须指定PROCEDURE关键字作为其特征之一。你也可以使用CREATE PROCEDURE语句来创建一个作为存储过程公开的查询。

为了创建一个查询，你必须拥有%CREATE_QUERY管理权限，正如GRANT命令所指定的那样。

第九章 REST 服务安全

如果 REST 服务正在访问机密数据，应该对服务使用身份验证。如果需要为不同的用户提供不同级别的访问权限，还要指定端点所需的权限。

为 REST 服务设置身份验证

可以对 IRIS REST 服务使用以下任何形式的身份验证：

• HTTP 身份验证标头 — 这是 REST 服务的推荐身份验证形式。
• Web 会话身份验证 — 其中用户名和密码在 URL 中的问号后面指定。
• 身份验证 - 请参阅以下小节。

应用程序和

要通过 OAuth 2.0 对 应用程序进行身份验证，请执行以下所有操作：

• 将包含 REST 应用程序的资源服务器配置为 OAuth 2.0 资源服务器。
• 允许对 进行委派身份验证。
• 确保将 应用程序（用于 应用程序）配置为使用委托身份验证。
• 在 命名空间中创建一个名为 的例程。 提供了一个示例例程 ，可以复制和修改它。此例程是 GitHub (https://github.com/intersystems/Samples-Security) 上 Samples-Security 示例的一部分。可以按照“下载用于 IRIS 的示例”中的说明下载整个示例，但在 上打开例程并复制其内容可能更方便。

在例程中，修改 的值并根据需要进行其他更改。

指定使用

第七章 在 REST 服务中支持 CORS

概述

本节提供 CORS 的概述以及如何在 IRIS REST 服务中启用 CORS 的概述。

CORS 简介

跨域资源共享 () 允许在另一个域中运行的脚本访问服务。

通常，当浏览器从一个域运行脚本时，它允许对同一个域进行 调用，但在对另一个域进行调用时不允许它们。此浏览器行为限制某人创建可滥用机密数据的恶意脚本。恶意脚本可能允许用户使用授予用户的权限访问另一个域中的信息，但随后在用户不知道的情况下，将机密信息用于其他用途。为了避免这种安全问题，浏览器一般不允许这种跨域调用。

在不使用跨域资源共享 (CORS) 的情况下，具有访问 REST 服务的脚本的网页通常必须与提供 服务的服务器位于同一域中。在某些环境中，将带有脚本的网页与提供 REST 服务的服务器放在不同的域中是很有用的。 支持这种安排。

下面提供了浏览器如何使用 处理 的简化描述：

1. 域 DomOne 中的网页中的脚本包含对 DomTwo 域中的IRIS REST 服务的 。 具有 的自定义标头。
2. 用户查看此网页并运行脚本。用户的浏览器检测到与包含网页的域不同的域的 。
3. 用户的浏览器向 服务发送一个特殊请求，该请求指示 的 请求方法和原始网页的域，在本示例中为 。
4. 如果请求被允许，则响应包含请求的信息。否则，响应仅包含指示

本章介绍了使用InterSystems IRIS作为企业服务总线，描述了InterSystems IRIS ESB架构，并提供了部署ESB的概述。

企业服务总线的概念

企业服务总线（ESB）提供了一个单点来访问和管理具有SOAP、REST或其他网络API的应用程序。ESB提供了以下功能。

• 提供一个中心来发现和访问服务。

• 将应用程序与服务隔离开来，允许你在一个地方改变服务的描述，而不需要更新所有依赖它的应用程序。例如，你可以改变服务器的地址，甚至服务的API，并在ESB中处理这些变化。这为你的应用程序提供了协议独立性。如果一个应用程序是使用SOAP API开发的，但一个新的服务用REST API提供了额外的功能，ESB可以使新的REST服务作为REST和SOAP API可用，允许你添加新服务的功能，同时保持对现有应用程序的兼容性。

• 提供一种机制来组织和跟踪企业使用的应用程序以及这些应用程序之间的依赖关系。。

ESB架构

InterSystems IRIS ESB架构有以下组成部分。

• 将传入的请求与服务器连接起来的路由机制。这是由具有专门业务服务（BS）和业务操作（BO）的 production实现的，也可以选择业务流程（BP）。

Hi 大家好!

我们很荣幸地宣布InterSystems 将在剑桥总部举办 推动女性健康-FemTech不止是利基市场 高层论坛，论坛将在线上线下同步举行!

⏱ 时间: 7月 29日, 5:30 AM – 7:30 AM ，北京时间（July 28，5:30 PM – 7:30 PM ，EDT/美国东部时间）
📍 地点: InterSystems 总部，1 Memorial Drive, Cambridge, MA

第六章 修改规范（SPEC）类

概述

下表列出了修改规范类的原因并简要总结了所需的更改：

无论何时编译规范类，编译器都会在同一个包中重新生成调度类并更新实现类。

覆盖内容类型、响应字符集或输入流处理

只需将类参数添加到规范类并重新编译，就可以覆盖 REST 服务的几个关键方面。

• 默认情况下，REST 服务需要 application/json 内容类型。要覆盖它，请将以下内容添加到规范类：

Parameter CONTENTTYPE = "some-content-type";

其中 some-content-type 是 MIME 内容类型。

• 默认情况下， 服务的响应消息采用 格式。要覆盖它，请将以下内容添加到规范类：

Parameter CHARSET = "some-character-set";