数据存储¶
A data store
包含矢量格式的空间数据。它可以是文件(如shapefile)、数据库(如postgis)或服务器(如 remote Web Feature Service )
/workspaces/<ws>/datastores[.<format>]
¶
控制给定工作区中的所有数据存储。
方法 |
行动 |
状态代码 |
格式 |
默认格式 |
---|---|---|---|---|
GET |
列出工作区中的所有数据存储 |
200 |
HTML、XML、JSON |
HTML |
POST |
新建数据存储 |
201带 |
XML、JSON |
|
PUT |
405 |
|||
DELETE |
405 |
/workspaces/<ws>/datastores/<ds>[.<format>]
¶
控制给定工作区中的特定数据存储。
方法 |
行动 |
状态代码 |
格式 |
默认格式 |
参数 |
---|---|---|---|---|---|
GET |
返回数据存储 |
200 |
HTML、XML、JSON |
HTML |
|
POST |
405 |
||||
PUT |
修改数据存储 |
||||
DELETE |
删除数据存储 |
例外情况¶
例外 |
状态代码 |
---|---|
获取不存在的数据存储 |
404 |
更改数据存储名称 |
403 |
放置数据存储区的更改工作区 |
403 |
根据包含已配置功能类型的数据存储区删除 |
403 |
参数¶
recurse
¶
这个 recurse
参数以递归方式删除指定数据存储引用的所有层。此参数的允许值为“真”或“假”。默认值为“假”。
quietOnNotFound
¶
这个 quietOnNotFound
参数避免在数据存储不存在时记录异常。请注意,404状态代码仍将返回。
/workspaces/<ws>/datastores/<ds>/[file|url|external][.<extension>]
¶
这些端点 (file
, url
和 external
)允许将包含空间数据或映射配置(以应用程序架构数据存储为目标)的文件(通过Put请求)添加到现有数据存储中,或者在不存在的情况下创建新的数据存储。这三个端点用于指定用于上载文件的方法:
file
-从本地源上载文件。请求的主体是文件本身。url
-从远程源上载文件。请求的主体是指向要上载的文件的URL。此URL必须在服务器上可见。external
-使用服务器上的现有文件。请求的主体是现有文件的绝对路径。
方法 |
行动 |
状态代码 |
格式 |
默认格式 |
参数 |
---|---|---|---|---|---|
GET |
已弃用 .以具有mime类型的zip文件的形式检索数据存储区的基础文件 |
200 |
|||
POST |
405 |
||||
PUT |
将文件上载到数据存储 |
200 |
|||
DELETE |
405 |
例外情况¶
例外 |
状态代码 |
---|---|
获取不存在的数据存储 |
404 |
获取不基于文件的数据存储 |
404 |
参数¶
extension
¶
这个 extension
参数指定要上载的数据类型。支持以下扩展:
延伸 |
数据存储 |
---|---|
上海医药 |
Shapefile |
性质 |
文件属性 |
H2 |
H2数据库 |
应用程序架构 |
应用程序架构映射配置 |
备注
文件可以作为独立的或压缩的存档文件放在数据存储中。独立文件仅适用于与单个文件(如GML存储)一起工作的数据存储。使用多个文件的数据存储区(如shapefile存储区)必须作为zip存档发送。
上载独立文件时,请设置 Content-type
基于文件类型。如果要加载zip存档,请设置 Content-type
到 application/zip
.
备注
应用程序模式映射配置可以作为单个文件上载,也可以拆分为多个文件以实现重用性和/或映射约束(例如,需要相同功能类型的多个映射)。如果将多个映射文件作为zip存档上载,则主映射文件的扩展名(包括通过 <includedTypes>
标签)必须是 .appschema
否则,它将不会被识别为数据存储的主文件,并且发布将失败。
定义映射所需的应用程序模式(XSD文件)可以添加到zip存档中,并随映射配置一起上载。存档中包含的所有文件都上载到同一文件夹,因此主映射文件中指定的辅助映射文件和应用程序架构的路径只是包含资源的文件名。
configure
¶
这个 configure
参数控制上传文件时如何配置数据存储。它可以取三个值之一:
first
-( 违约 )仅设置数据存储中可用的第一个功能类型。none
-不要配置任何功能类型。all
-配置所有功能类型。
备注
上载应用程序架构映射配置时,只有主映射文件中映射的功能类型被视为顶级功能,并将在以下情况下自动配置: configure=all
或 configure=first
指定。
target
¶
这个 target
参数确定在服务器上为上载的数据创建新的数据存储时使用的格式或存储引擎。将数据导入现有数据存储时,将忽略该数据。此参数的允许值与 extension parameter ,除了 appschema
,在这种情况下没有意义。
update
¶
这个 update
参数控制在将文件放入已存在且已包含与文件内容匹配的架构的数据存储区时如何处理现有数据。参数接受以下值之一:
append
-正在上载的数据将附加到现有数据。这是默认设置。overwrite
-正在上载的数据将替换任何现有数据。
对于只读的应用程序架构数据存储,忽略该参数。
charset
¶
这个 charset
参数指定要上载的文件的字符编码(例如“ISO-8559-1”)。