# 查询组件
本章节详细说明查询组件的功能及属性,具体如下:
# Rest Client
功能介绍:该组件用于使用 RESTful 服务。REST 是一种无状态客户端-服务器体系结构,在该体系结构中,web服务被视为资源,并可以通过其URL进行标识。
使用场景:REST客户端转换步骤使您能够使用RESTful服务。具象状态传输(Representational State Transfer, REST)是一种关键的设计风格,它包含无状态的客户机-服务器体系结构,在这种体系结构中,web服务被视为资源,可以通过它们的url来标识。
注意:输入字段的数据可以通过Calculator步骤和Mask XML内容与字符串A或Escape HTML内容的函数进行转义。
图标:
组件界面:
《基础配置》
是否从字段获取URL:否
是否从字段获取HTTP方法:否
是否从字段获取URL:是
此时URL字段需要从上级节点输出的字段list中选择定义。
是否从字段获取HTTP方法:是
此时HTTP方法字段需要从上级节点输出的字段list中选择定义。
《认证、代理配置》
《请求头、参数》
参数说明:
参数 | 说明 |
---|---|
节点名称 | 当前创建的节点名称,由用户自定义且不可为空。命名可包含字母、数字、下划线。 |
是否从字段获取URL | 指定资源的路径,该路径由传入PDI流中的字段定义。如果选择此选项,则URL可从上级节点的字段名中选择。 |
URL | “是否从字段获取URL”为否时,输入指定REST客户端资源的路径。 |
URL字段 | “是否从字段获取URL”为是时,从之前组件传入的PDI流中选择该字段。该字段应该包含资源的路径。 |
是否从字段获取HTTP方法 | 如果选择此选项,则HTTP方法可从上级节点的字段名中选择。 |
HTTP方法 | 选择当前步骤如何与资源交互。您可以从以下可能的操作中选择: GET:检索资源; POST:创建一个新的资源; PUT:创建或更新现有资源; DELETE:删除资源; HEAD:只检索资源的头部信息; OPTIONS:描述服务器支持的其他方法和操作; PATCH:对资源进行部分更新。 |
HTTP方法字段 | 选择定义HTTP方法的字段。此选项仅在选择“是否从字段获取HTTP方法”为“是”时可用。 |
Body字段 | 选择定义包含POST、PUT和PATCH方法的请求主体的字段。 |
Content-type | 选择资源内容对应的应用类型。 |
结果字段 | 返回的结果所指定的输出字段名称,用户可以自己定义名称。 |
HTTP状态码 | 返回的HTTP状态码结果所指定的字段名,用户可以自己定义名称。 |
响应时间(ms) | 返回的响应时间结果所指定的字段名,用户可以自己定义名称。 |
响应头字段 | 返回的响应头结果所指定的字段名,用户可以自己定义名称。 |
账号 | 资源访问时使用的用户名。 |
密码 | 与HTTP登录用户名关联的密码。 |
优先启用 | 选择在服务器给出未经授权的响应之前发送身份验证凭据。 |
代理主机 | 如果需要代理身份验证,请指定代理主机的名称。 |
代理端口 | 当需要代理认证时,指定代理主机的端口号。 |
选择类型 | 证书文件可以从服务所在机器磁盘路径读取,也可以从 HDFS 读取。 |
证书文件 | 输入访问需要SSL证书认证的资源的详细信息:指定证书文件的位置。 |
证书文件 | 输入访问需要SSL证书的密码。 |
请求头配置 | 此表定义现有PDI字段中任何HTTP头的内容。 字段名:来自传入PDI流的包含报头信息的字段; 输出名:该步骤输出PDI字段的名称。 |
请求参数配置 | 定义POST、PUT、DELETE和PATCH请求的参数值。(GET方法的参数应该直接成为URL的一部分。) |