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

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

文章目录

​​第二十一章 源代码文件 REST API 参考（三）​​​​GetDocNames​​

​​URL​​​​URL Parameters​​​​JSON Messages​​​​HTTP 返回码​​

​​GetModifiedDocNames​​

​​URL​​​​JSON Messages​​​​HTTP 返回码​​

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

GetDocNames

此方法返回源代码文件名列表。可选的 ​​cat​​​ 和 ​​type​​ 约束源代码文件的类型。

URL

​​GET 指定类别代码：​​CLS = class​​​;​​RTN = routine​​​；​​CSP = CSP 文件​​​；​​OTH = other​​​。默认为​​*​​。​​type​​​ 指定源代码文件类型。可以是​​*​​​ 通配符或文件类型。对于​​CLS​​​，类型必须是​​*​​​。对于​​RTN​​​，类型可以是​​mac、int、inc、bas 、mvi 或 mvb​​​。对于​​CSP​​​，​​type​​​ 可以是​​js​​​ 或​​css​​​ 等文件类型的列表，以逗号分隔。默认为​​*​​。

URL Parameters

​​URL​​​ 参数​​'generated=1'​​ 指定应包含生成的源代码文件。​​URL​​​ 参数​​'filter'​​​ 提供了一个可用于匹配名称的​​SQL​​ 过滤器。

JSON Messages

以下是返回的内容，源代码文件描述符数组：

{ "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 } ] }}

HTTP 返回码

​​HTTP 200​​ 如果正常。​​HTTP 500​​ 如果发生意外错误（详细信息将在状态错误数组中）。

GetModifiedDocNames

此方法返回自数据库具有指定哈希值以来已修改的源代码文件列表。它以 ​​JSON​​​ 数组的形式传递数据库键和哈希列表。哈希值用于确定该键定义的数据库中是否有任何更改。通常，首先使用一个空数组调用此 ​​API​​​ 作为传入的 ​​JSON​​​ 消息。这将返回命名空间中所有源代码文件的名称以及每个文件的数据库键和哈希。然后可以发布 ​​dbname​​​ 和 ​​dbhash​​ 以发现自上次调用以来在服务器上修改了哪些源代码文件。

发布要检查的源代码文件列表，如以下示例所示：

[ { "dbname" : "USER", "dbhash" : "KWAGbOdnRblPzANaiv1Oiu0BZLI" }, ... ]

URL

POST - 将源代码文件类型指定为 * 或三字母代码、​​ls、mac、int、inc、bas 或 mvi​​​。默认为​​*​​​。此调用需要标头​​​Content-Type application/json​​。

JSON Messages

以下是返回的内容，源代码文件描述符数组：

[ { "dbname" : "USER", "dbhash" : "Qx1zuNaulq3b_1yR9ahZAfjkc-", "crhash" : "47763751EC", "docs": [{ "name": "User.NewClass1.cls", "ts": "2016-01-04 14:00:04.000", "gen": false, "depl": false }, ... ] }, ... ]

如果在指定的 ​​dbhash​​ 之后删除了源代码文件，则在列表中返回该文件，并将时间戳设置为空字符串：

"ts": ""

如果由于映射而包含数据库并且删除了映射，则 ​​dbhash​​​ 和 ​​crhash​​​ 都将返回​​“000”​​​值，并且 ​​docs​​ 作为空数组返回。

HTTP 返回码

​​HTTP 200​​ 如果正常。如果发布的内容为空或类型不是​​CLS​​​，则​​HTTP 400​​。如果内容类型不是应用程序​​/json​​​，则为​​HTTP 415​​。​​HTTP 500​​ 如果发生意外错误（详细信息将在状态错误数组中）。

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。