文章
· 八月 12, 2022 阅读大约需 3 分钟

第二十五章 源代码文件 REST API 参考(七)

第二十五章 源代码文件 REST API 参考(七)

Query

此方法对 IRIS 表执行 SQL 查询并返回结果。请求正文是指定查询的 JSON 对象。它返回一个匹配查询条件的对象数组。每个返回的对象都包含与查询返回的一行相关的信息。

URL

POST http://server:port/api/atelier/v1/namespace/action/query

SQL 查询在 URL 请求的正文中指定。查询必须在指定的命名空间中指定一个数据库。

此调用需要标头 Content-Type application/json。

JSON Messages

返回内容是一个对象数组。错误将出现在每个源代码文件对象的状态属性中:

{
  "status": {
    "errors": [],
    "summary": ""
  },
  "console": [],
  "result": {
    "content": [
      {
        "ID": "%all",
        "Description": "The Super-User Role"
      },
      {
        "ID": "%db_%default",
        "Description": "R/W access for this resource"
      },
      {
        "ID": "%db_irislocaldata",
        "Description": "R/W access for this resource"
      },
      ...
      {
        "ID": "%sqltunetable",
        "Description": "Role for use by tunetable to sample tables irrespective of row level security"
      }
    ]
  }
}

HTTP 返回码

  • HTTP 200 如果正常。
  • 如果传递的内容类型不是 application/json,则 HTTP 415
  • HTTP 500 如果发生意外错误(详细信息将在状态错误数组中)。

Search

此方法在 IRIS 数据库中查找具有指定内容的文件。 Search 方法在 API 的第 2 版中可用。此方法以旨在向用户显示的格式返回搜索结果。

URL

POST http://server:port/api/atelier/v2/namespace/action/search

URL Parameters

  • 必需的 URL 参数 ?query=expression 指定要在指定文件中搜索的正则表达式或文本字符串。
  • 必需的 URL 参数 ?files=file-list 提供以逗号分隔的文件或文件掩码列表,例如 al*.mac,以搜索指定的表达式。
  • 可选的 URL 参数 ?regex=1 指定查询 URL 参数包含正则表达式并且是默认值。 ?regexp=0 指定查询包含文本字符串,不应被解释为正则表达式。
  • 可选的 URL 参数 ?sys=1 指定在搜索中包括系统文件。默认值为 ?sys=0,不包括系统文件。
  • 可选的 URL 参数 ?gen=1 指定在搜索中包含生成的文件。默认值为 ?gen=0,它不包括生成的文件。
  • 可选的 URL 参数 ?max=integer 指定要返回的最大结果数。默认值为 ?max=200

JSON Messages

以下搜索 REST 调用在所有 .cls.mac 文件中搜索单词“Email”,前面和后面都有一个空格。 (在正则表达式中,\s 由空格字符匹配。)

GET localhost:52773/api/atelier/v2/SAMPLES/action/search?query=.*\sEmail\s.*&files=*.cls,*.mac

此调用返回以下消息。返回消息可能因 SAMPLES 命名空间的内容而异。

{
    "status": {
        "errors": [],
        "summary": ""
    },
    "console": [
        "",
        "Searching for '.*\\sEmail\\s.*' in '*.cls,*.mac'",
        "Wasabi.Data.Employee.cls(Email): Property Email ",
        "Wasabi.Person.API.Employee.cls(Email): Property Email ",
        "ZAUTHENTICATE.mac(175): Properties(\"EmailAddress\") - Email address",
        "Found 3 occurrence/s in 3 file/s."
    ],
    "result": [
        {
            "doc": "Wasabi.Data.Employee.cls",
            "matches": [
                {
                    "member": "Email",
                    "text": "Property Email "
                }
            ]
        },
        {
            "doc": "Wasabi.Person.API.Employee.cls",
            "matches": [
                {
                    "member": "Email",
                    "text": "Property Email "
                }
            ]
        },
        {
            "doc": "ZAUTHENTICATE.mac",
            "matches": [
                {
                    "line": "175",
                    "text": "Properties(\"EmailAddress\") - Email address"
                }
            ]
        }
    ]
}

HTTP 返回码

  • 如果请求有效,则为 HTTP 200
  • 如果缺少必需的 URL 参数,则为 HTTP 400
讨论 (0)1
登录或注册以继续