HTTPCaller
通过HTTP或HTTPS访问URL,执行GET,PUT,POST,DELETE,HEAD,贴片或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方法。大多数请求将使用得到方法。要求其上传数据将使用放,POST要么补丁方法。该头部,删除和选项访问REST API时的方法可能是有用的。
此参数标识将由变压器进行访问的URL。变压器可以访问HTTP和HTTPS的URL。该URL可以直接在变压器输入,或从属性值建立起来。
查询字符串参数
此表可用于创建附加的URL查询参数。该参数将被追加到给定的URL请求URL参数。访问这需要许多参数的REST API端点时,这可能是有用的。的参数名称和值可以直接输入或从属性值构成。
头
这个表可以被用于创建将与请求一起被发送自定义的HTTP标头。这可以用于自定义FME将对服务器的请求。标题名称和值可以直接输入或从属性值构成。此外,该名称列提供了常用的头名的列表。
身体
该组中的参数才会启用时,HTTP方法参数设置为放,POST要么补丁。
该参数标识将要上传的数据的类型。该变压器可以上传文件时,一个字符串值,或文件和字符串值的多部分组合。
上传数据可使用此参数输入。的数据可以被直接输入到变压器或从属性值构成。
在上传文件时,这个参数提供的文件路径。该路径可以被直接输入到变压器或从一个属性值进行设置。
当上传一个字符串值或一个文件,该参数提供了数据内容类型。这个参数的值将在内容类型请求头中发送。下拉列表中包含了一些常用的内容类型值。如果需要不同的值,其可以被键入到文本字段中,或从一个属性值导出。
此表被用来构建多上传。在一个多载每个部分都必须有一个名字,这是第一列给出。第二列识别部件的类型 - 无论是一个文件或字符串值。第三列提供了用于部分中的数据和MIME类型。
响应
该参数允许用户设置为HTTP响应身体的目的地。正文可以保存到属性或文件中。
注意:如果使用HTTPCaller下载非常大的响应主体,建议将其保存到文件中。这避免了在特性上创建一个大的属性。
当将响应体保存到属性时,此参数命名将使用的属性。默认属性名是_反应体。当执行HTTP头请求时,此属性将为空。
此参数用于指示目标属性的字符编码。默认情况下,属性编码将从HTTP响应头自动确定。或者,可以从列表中选择特定的编码。下载二进制数据时,应将参数设置为二元的要么从http头自动检测。
保存响应体到文件
此参数控制转换器将响应主体保存到文件中的方式。有两种模式:
- 不:响应正文将保存到输出文件名参数。
- 是的:将为每个功能创建一个新文件,并保存在输出文件夹参数。
当为每个特性创建一个新文件参数设置为不,转换器将把HTTP响应主体保存到此参数中指定的文件中。文件可以直接选择,也可以从属性中设置。注意,如果直接选择该文件,则通过转换器传递的每个特性都会覆盖该文件。如果有多个特性通过转换器,建议将文件路径设置为惟一的属性值,或者将转换器配置为为每个特性创建一个新文件。
当为每个特性创建一个新文件参数设置为是的,转换器将为通过转换器的每个特性创建一个新文件。文件将保存在此参数中指定的文件夹中。
如果为每个特性创建一个新文件是是的,此参数指定新文件名的文件类型扩展名。从常见文件类型列表中选择,手动键入,或根据HTTP响应中的Content-Type头自动设置。
将响应主体保存到文件后,将把此参数中命名的属性设置为文件路径。
响应头和状态
这个参数是可选的。如果将其设置为列表属性名,则服务器返回的HTTP头信息将存储在列表属性中。标题将被分成名称和值。例如:
' _headers{0}.name'有值' X-XSS-Protection'
“_headers {0}。value' has value `1;模式=块'
' _headers{1}.name'有值' Date'
“_headers {1}。value' has value `Wed, 25 May 2011 17:20:20 GMT'
' _headers{2}.name'有值' Transfer-Encoding'
“_headers {2}。value' has value `chunked'
' _headers{3}.name'有值' Content-Type'
“_headers {3}。value' has value `text/html;charset = iso - 8859 - 1 '
' _headers{4}.name'有值' Cache-Control'
“_headers {4}。value' has value `private, max-age=0'
这个参数是可选的。如果将其设置为属性名,则服务器返回的HTTP响应代码将存储在属性中。
这个参数是可选的。如果发生错误,该特性将通过
HTTP客户端选项
如果将此参数设置为是的,与正在访问的URL相对应的任何已保存的cookie将随请求一起发送。此外,响应中包含的任何cookie都将保存起来,以供后续HTTP请求使用。
保存的cookie将在翻译期间保持—它们不能用于后续的翻译。
当web服务保持“会话”时,保存cookie非常有用。然后可以使用以下操作序列:
- httpcaller转换器用于登录到web服务并保存会话cookie。
- 使用第二个HTTPCaller转换器来访问web服务,使用保存的会话cookie。
- 第三个HTTPCaller用于退出web服务,这会使保存的cookie无效。
如果将此参数设置为是的,转换器将遵循它遇到的任何URL重定向,并向新位置发出第二个请求。
如果将此参数设置为是的,转换器将验证SSL证书。这需要两个阶段:
- 确保证书是针对我们要连接的主机的。
- 确保证书有效。
此参数可用于设置HTTP连接请求的超时。如果在给定的秒数内无法创建到服务器的连接,则请求将失败,并将通过
此参数可用于设置HTTP传输的超时。如果传输数据的时间超过给定的秒数,则请求将失败,并将通过
验证参数
转换器以两种方式支持用户身份验证:命名连接和用户名/密码身份验证。
当使用用户名和密码进行身份验证时,支持基本、摘要和NTLM访问身份验证方法:
- 基本(HTTP基本认证):这是默认的选择,也是唯一被广泛使用和支持的方法。这将以纯文本的形式通过网络发送用户名和密码,很容易被其他人捕获。
- 消化(HTTP摘要身份验证):在公共网络上,摘要身份验证比基本方法更安全。
- NTLM(HTTP NTLM认证):NTLM是微软发明和使用的一种专用协议。它使用类似于Digest的质询-响应和散列概念来防止密码被窃听。
注意:注意,尽管访问HTTP基本身份验证是一种机制,旨在允许客户机提供凭证服务器假设它们之间的连接是信任和安全,请注意,任何凭证从客户端传递到服务器可以很容易地截获通过一个不安全的连接。
编辑变压器参数
使用一组菜单选项,变压器参数可以通过引用在工作区中的其它元件来分配。更先进的功能,如高级编辑,算术编辑,也是一些变压器可用。要进入这些选项的菜单上,单击适用的参数旁边。欲了解更多信息,请参阅变压器参数菜单选项。
变压器分类
FME许可级别
FME专业版及以上
搜索FME知识中心
搜索样品和有关该变压器上的信息FME知识中心。
标签关键词:URLFetcher