数据上传服务
用户可以上传源数据或其他基于文件的资源,FME Server的工作区。
在FME服务器Web用户界面,文件上传可用于表示由工作区所使用的文件公布的参数的任何工作空间。欲了解更多信息,请参阅上传数据文件。
注意:当.zip文件时,我们建议使用支持Unicode文件名现代压缩实用程序。如果文件名不统一,你可以指定DEFAULT_ZIP_CODEPAGEWeb应用程序性能。
一旦数据被上传,用户可以选择工作区使用上传的数据。上传的文件存储在访问FME Server,但不是用户的私人位置。
上传文件的保质期
默认情况下,文件被删除1日,他们被上传后。若要更改,Web用户界面的系统清理页面上更新任务Delete_DataUpload_Files。欲了解更多信息,请参阅清理FME Server的日志和其他文件。
请求要素
支持的请求方法
本节将介绍可用于上传数据服务进行交互的各种方法。支持发送文件的方法是PUT和POST。支持用于浏览已上传文件的HTTP GET方法。
请记住,只有易失性存储器支持,所有请求都必须与FME Server工作区相关联。
请求 |
请说明 |
HTTP方法 |
目标URI |
---|---|---|---|
上传单个文件 |
您可以使用HTTP PUT方法上传文件。 |
放 |
HTTP://主机[:端口] / fmedataupload /
|
上传单个文件或多个文件 |
您可以使用一个使用HTTP POST一个简单的表单提交上传单个文件或多个文件 |
POST |
HTTP://主机[:端口] / fmedataupload /
|
浏览上传的文件 |
您可以通过一个GET请求到同一URI获得的一个会话所有上传的文件的列表,最初用来上传文件,或者在档案的情况下,追加到该范围内的存档文件和/或文件路径 archive for a listing of files there. 您可以使用可选的路径组件在最后显示的存档文件中的子文件夹的内容。仅报告归档文件的根目录,省略可选路径的一部分。 例如,请求URI /fmedataupload/Samples/austinWFS.fmw/myfile.zip/pictures/ |
得到 |
HTTP://主机[:端口] / fmedataupload /
|
服务特定请求参数
名称 |
值 |
描述 |
---|---|---|
opt_fullpath |
真| false |
当启用该服务响应包括每个文件的FME引擎可以使用物理或绝对路径。 |
opt_extractarchive 此参数是不是在HTTP GET可用,因为解压文件是操作,而不是一个状态标志。 |
真| false |
如果启用该服务提取上传的zip文件,并返回的zip文件里面的文件内容。 |
opt_responseformat |
XML | json |
定义响应的语言。文本必须全部小写。 |
opt_pathlevel |
-1 | 0 | n |
该参数表示递归的多层次有多深,显示文件和文件夹的信息。 |
保留会话状态
Java EE的可以显式指定的请求URL的会话ID。这是正确的会话状态保存会话时的cookies不能正常工作或技术规范保证不可用。简单地附加以下参数立即请求URI的路径部分以下内容:
; JSESSIONID =
响应元素
元件 |
子元素 |
值 |
描述 |
---|---|---|---|
statusInfo |
状态 |
成功| failure |
服务状态 |
文件,文件夹,档案 |
名称 |
串 |
这是上传的文件名 |
尺寸 |
长整型 |
在文件大小uploaded.The元件的字节大小并不适用于文件夹和不存在的文件夹元件的下方。 |
|
路径 |
串 |
该文件的绝对或物理路径(其用于通过FME发动机) |
|
会议 |
没有 |
串 |
其总是包括在每个数据上传响应作为一个HTTP cookie以及在响应的主体中的会话标识符。 |
注意:总是会有一个空的name属性的文件夹节点。此文件夹节点是包含上传的文件由当前用户会话,工作区名和存储库名称所定义的范围的目录中的占位符。此占位符可以在以后请求全路径时检索完整路径父目录范围内的全部上传的文件中。
如果opt_extractarchive设置为false,在下列情况下的结果:
- 如果请求的路径检查一个zip或归档文件的内容,然后一个错误的响应结果。
- 如果所请求的路径是有效的,但opt_pathlevel是2或更高,然后1:1的路径级是隐含的。