HTTPCaller
通过HTTP或HTTPS访问URL,执行GET、PUT、POST、DELETE、HEAD、PATCH或OPTIONS操作。
这个转换器替换了HTTPFetcher、HTTPUploader、HTTPFileUploader、HTTPMultipartUploader、HTTPDeleter和HTTPHeader转换器。
输出
HTTP响应主体可以保存到属性或文件中。属性标识的属性响应主体属性参数。
方法命名的属性中存储HTTP响应状态代码状态码属性参数。默认情况下这是_http_status_code属性。有关HTTP状态码的更多信息,请参阅http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.
属性指定的列表属性中保存HTTP响应标头响应标头的列表属性参数。默认情况下,标头存储在_headers {}属性列表。有关常见HTTP响应头的列表,请参阅http://en.wikipedia.org/wiki/List_of_HTTP_header_fields.
如果在访问URL时发生错误,将通过
参数
请求
访问服务器的HTTP方法。大多数请求将使用得到方法。上传数据的请求通常使用把,帖子或补丁方法,虽然也可以提供上载主体删除方法。的头,删除,选项方法在访问REST API时非常有用。
此参数标识将由转换器访问的URL。转换器可以访问http和https url。URL可以直接在转换器中输入,也可以由属性值构建。
查询字符串参数
此表可用于创建其他URL查询参数。属性中给出的URL将附加这些参数请求URL参数。这在访问需要许多参数的REST API端点时非常有用。可以直接输入参数名和值,也可以根据属性值构造参数名和值。
头
此表可用于创建将随请求一起发送的自定义HTTP标头。这可以用来定制FME向服务器发出的请求。头名称和值可以直接输入或由属性值构造。此外,Name列提供了一个常用头名称的列表。
身体
这些参数仅在以下情况下启用HTTP方法是把,帖子,删除,或补丁.不需要上传主体;例如,删除请求通常没有上传主体。
此参数标识将要上载的数据类型。转换器可以上载文件、字符串值或文件和字符串值的多部分组合。
可以使用此参数输入上载数据。数据可以直接输入到转换器中,也可以由属性值构造。
上传文件时,此参数提供文件路径。路径可以直接输入到转换器中,也可以从属性值中设置。
上传字符串值或文件时,此参数提供数据内容类型。此参数的值将在Content-Type请求头中发送。下拉列表包含许多常用的内容类型值。如果需要不同的值,可以将其输入文本字段,或者从属性值派生。
此表用于构造多部分上传。多部分上传中的每个部分都必须有一个名称,该名称在第一列中给出。第二列标识部件的类型——文件或字符串值。第三列提供了该部分的数据和MIME类型。
响应
此参数允许用户设置HTTP响应主体的目标。正文可以保存到属性或文件中。
注意:如果使用HTTPCaller下载非常大的响应主体,建议将其保存到文件中。这避免了创建要素上大属性。
当保存的响应身体的属性,此参数名称将被使用的属性。默认属性名称_response_body.当执行HTTP HEAD请求,该属性将是空的。
此参数用来指示目标属性的字符编码。默认情况下,属性的编码将被自动地从HTTP响应报头确定。可替代地,特定的编码可以从列表中选择。当下载的二进制数据,参数应设置为二进制或自动检测HTTP头文件.
将响应体保存到文件中
此参数控制中,变压器将响应主体保存到文件的方式。有两种模式:
- 没有:响应体将被保存到输出文件名参数。
- 是的:将为每个特性创建一个新文件,并保存在导出目录参数。
当。。。的时候创建一个新的文件中,每个功能参数设置为没有,变压器将HTTP响应体保存到这个参数中指定的文件。该文件可以被直接选择的,或从一个属性集。请注意,如果该文件是直接选择,该文件将被覆盖由通过变压器的每个功能。如果有多个功能通过变压器,建议的文件路径设置为一个独特的属性值,或变压器被配置为创建各功能的新文件。
当。。。的时候创建一个新的文件中,每个功能参数设置为是的,变压器将为通过变压器各功能的新文件。该文件将被保存在这个参数中指定的文件夹中。
如果创建一个新的文件中,每个功能是是的,该参数指定为新的文件名的文件类型的扩展名。从常见的文件类型的列表中选择,手动输入或自动设置基于在HTTP响应中的Content-Type头。
响应体已被保存到一个文件后,在此参数命名的属性将被设置为文件路径。
响应头和状态
此参数是可选。如果它被设置为一个列表属性名称,然后HTTP头由服务器返回将被存储在列表中的属性。标头将分为名称和值。例如:
`_headers {0}。名称 '具有值'X-XSS-保护'
`_headers {0}。价值”具有值'1;模式=块”
`_headers {1}。名称 '具有值'日期'
`_headers {1}。价值 '具有值'星期三,2011年5月25日17点二十○分20秒GMT'
`_headers {2}。名称“具有值'传送编码”
`_headers {2}。价值 '具有值'分块'
`_headers {3}。名称“具有值'内容 - 类型”
`_headers {3}。价值”具有值'text / html的;字符集= ISO-8859-1'
`_headers {4}。名称“具有值'缓存控制”
`_headers {4}。价值”具有值'私人,最大年龄= 0'
此参数是可选。如果它被设置到一个属性名称,然后由服务器返回的HTTP响应代码将被存储在所述属性。
此参数是可选。如果出现错误,该功能将通过输出
HTTP客户机选项
如果这个参数设置为是的,变压器将按照所遇到的任何URL重定向,使得第二请求到一个新的位置。
如果这个参数设置为是的,变压器将验证SSL证书。这两个阶段完成:
- 确保证书是针对我们要连接的主机的。
- 确保证书有效。
此参数可用于设置HTTP连接请求超时。如果与服务器的连接不能秒的给定数量的内创建,该请求将失败,并且该特征将被输出经过
该参数可用于设置HTTP传输的超时。如果数据停止被传送超过几秒钟的给定数目的,请求将失败,并且该特征将被输出经过
验证参数
有两种方式则Transformer支持用户认证:命名连接和用户名/密码认证。
命名连接选项允许选择存储的命名连接,该连接将使用适当的Web服务对用户进行身份验证。要添加一个新的命名连接,从命名连接下拉菜单中选择“添加连接…”。指定连接选项允许使用受支持的Web服务进行OAuth2身份验证。
当使用用户名和密码进行身份验证时,支持基本、摘要和NTLM访问身份验证方法:
- 基本(HTTP基本认证):这是默认的选择,也是唯一被广泛使用和支持的方法。这将以纯文本的形式通过网络发送用户名和密码,很容易被其他人捕获。
- 消化(HTTP摘要身份验证):在公共网络上,摘要身份验证比基本方法更安全。
- NTLM(HTTP NTLM认证):NTLM是微软发明和使用的一种专用协议。它使用类似于Digest的质询-响应和散列概念来防止密码被窃听。
注意:注意,尽管访问HTTP基本身份验证是一种机制,旨在允许客户机提供凭证服务器假设它们之间的连接是信任和安全,请注意,任何凭证从客户端传递到服务器可以很容易地截获通过一个不安全的连接。
编辑变压器参数
使用一组菜单选项,可以通过引用工作空间中的其他元素来分配transformer参数。更高级的功能,如高级编辑器和算术编辑器,也可以在一些转换器中使用。要访问这些选项的菜单,请单击在可适用的参数旁边。有关更多信息,请参见变压器参数菜单选项.
变压器的分类
FME授权级别
FME专业版及以上
技术的历史
关联的FME函数或工厂:HTTPFactory
FME社区搜索:亚搏国际在线官网
有关此变压器的示例和信息,请参阅FME社亚搏国际在线官网区.
标签关键词:URLFetcher