1、 ICS01.140.40 A 19 CY 中华人民共和国新闻出版行业标准 CY/T 102.2 2020 代替 CY/T 102.22014 新闻出版 数字内容对象存储、复用 与交换规范 第 2部分:对象封装、存储与交换 Specification of pres and publication digital content object storage, reuse and exchangePart 2: Object encoding, storage and exchange 2020 - 11 - 16发布 2021 - 02 - 01实施 国家新闻出版 署 发布 CY/T 102
2、.22020 I 目 次 前言 . II 引言 . III 1 范围 . 1 2 规范性引用文件 . 1 3 术语和定义 . 1 4 缩略语 . 2 5 数字内容对象封装 . 2 5.1 对象封装方式 . 2 5.2 交换信息包文件结构 . 2 5.3 证实方法 . 5 6 数字内容对象存储 . 5 6.1 信息包存储 . 5 6.2 实例文件存储 . 6 6.3 数据文件存储 . 7 6.4 证实方法 . 8 7 数字内容对象交换 . 8 7.1 交换方式 . 8 7.2 资源标识符获取接口 . 8 7.3 指定资源 IRI获取接口 . 10 7.4 元数据获取接口 . 11 7.5 数据文
3、件 URL获取接口 . 12 7.6 数据流获取接口 . 13 7.7 交换信息包获取接口 . 13 7.8 交换信息包上传接口 . 14 7.9 资源检索接口 . 15 参考文献 . 20 CY/T 102.22020 II 前 言 本文件按照 GB/T 1.1 2020标准化工作导则 第 1部分:标准化文件的结构和起草规则的规定 起草。 本 文件是 CY/T 102新闻出版数字内容对象存储、复用与交换规范的第 2部分。 CY/T 102已经 发布了以下部分: 第 1部分:对象模型; 第 2部分:对象封装、存储和交换; 第 3部分:对象一致性检查方法。 本文件代替 CY/T 102.2 20
4、14数字内容对象存储、复用与交换规范 第 2部分:对象封装、存储 和交换,与 CY/T 102.2 2014相比,除结构调整和编辑性改动外,主要技术变化如下: a) 修改了 本文件 的适用范围,由适用于图书单一出版物类型扩展为适用多类型出版物; b) 修改了数字内容对象的封装方 式。 CY/T 102.2 2014中采用 OAI-ORE资源图文件对符合 PUBO本体模型的数字内容对象进行封装,本次修订采用“ PUBO RDF实例文档( RDF/XML 文档)”对符合本次修订版 PUBO本体模型的出版物数字内容对象进行封装; c) 修改了信息包结构,其内容包括: 1) 将 CY/T 102.2
5、2014中 CONTAINER文件夹下的各级资源图文件及相关文件夹修改为 采用“ PUBO RDF实例文档”进行表示; 2) 修改了清单文件 pubomanifest.xml的内容,除包含 CY/T 102.2 2014中媒体文件清 单 ( dataFileList)之 外,新 增了对象清单( objectList),用 于表示各资源实例作 为主体时,与之相关的客体及语义关系。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由全国新闻出版信息标准化技术委员会( SAC/TC 553) 提出并 归口。 本文件起草单位:北京大学、中宣部机关服务中心(中宣部信息中
6、心)、北京拓标卓越信息技术研 究院、中国科技出版传媒股份有限公司。 本文件主要起草人:王文清、陈鹏飞、刘成勇、刘勇、张沫、南志弘、陆新民、关涛、张志、姜磊、 郭昱锦。 本文 件及其所代替文件的历次版本发布情况为: 2014年 1月首次发布为 CY/T 102.2 2014; 本次为第一次修订。 CY/T 102.22020 III 引 言 随着互联网技术的发展和数字加工与出版相关技术的逐步成熟,传统的新闻出版机构陆续应用信息 技术开展数字出版。在数字加工与出版过程中,图书、期刊等出版内容资源不仅包括可交付印刷或电子 出版与服务的各类媒体对象( 如整书或篇章的 PDF文件,以及期刊某期及某论文的
7、 PDF文件等 )、排 版 或 加工过程中产生的媒体对象(如排版设计源文件等),还包括封面、目次、元数据、各类内容主体、各 类辅文(如参 考文献、摘要、术语表等)数字内容实体构件。对于这些出版内容资源,需要建立一个新 闻出版领域统一的数字内容对象模型,以系统地表示和记录资源的内容结构、特征、表现形式、载体方 式以及资源之间的关联关系,并能按不同粒度进行相关数据的封装、存储、复用与交换。 近年来,在出版内容资源的知识表示与建模领域,受应用需求的驱动,国内外相关行业及企业标准 应运而生。 2017年 11月,数字内容对象存储、复用与交换规范系列国家标准的起草工作正式启动; 2020年 3月,该系列
8、国家标准正式发布,为出版内容资源本体的建立奠定了模型基础。 以 GB/T 38371.1 2020数字内容对象存储、复用与交换规范 第 1部分:对象模型等 3项推 荐性 国家标准为基础,结合新闻出版行业出版内容资源的加工及应用要求 ,本 标 准 的 制 订 需 求 提 上 日 程 。 在 本标准的起草过程中 ,起草组对多项现行国家标准、行业标准及工程标准进行了调研,同时参考了大量 国内外数据标准和模型 ,从 对 象 模 型 、对 象 封 装 、存 储 和 交 换 以 及 对 象 一 致 性 检 查 等 多 个 方 面 给 出 一 套 统一的行业标准,以实现新闻出版领域对出版内容资源的规范化表示
9、,消除数据复用和交换障碍,降低 资源管理和利用成本,推动出版内容资源的融合和深入 利用。 CY/T 102.22020 1 新闻出版 数字内容对象存储、复用与交换规范 第 2部分:对象封装、存储与交换 1 范围 本文件 规 定了 出版内容资源 对象的封装、存储与交换方式 , 并给出了 对象交换服务 接口。 本文件 适用于新闻出版行业 有关数字内容资源的数字化统一管理和共享 。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件, 仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本 文件。 GB/T
10、7408 2005 数据元和交换格式 信息交换 日期和时间表示法( ISO 8601:2000,IDT) GB/T 38371.2 2020 数字内容对象存储、复用与交换规范 第 2部分:对象封装、存储与交换 CY/T 102.1 2020 新闻出版 数字内容对象存储、复用与交换规范 第 1部分:对象模型 CY/T 102.3 2020 新闻出版 数字内容对象存储、复用与交换规范 第 3部分:对象一致性检查方法 3 术语和定义 GB/T 20000.1界定的以及下列术语和定义适用于本文件 。 3.1 信息包 information package 通过打包信息进行封装和 识别的一种逻辑容器 。
11、 来源: GB/T 38371.2 2020, 3.2 3.2 交换信息包 exchange information package; EIP 在 不同系统 之间,用于数据 交换的信息包。 来源: GB/T 38371.2 2020, 3.3 3.3 存档信息包 archive information package; AIP 为资源存档和长期保存而规定的逻辑存储格式。 来源: GB/T 38371.2 2020, 3.4 CY/T 102.22020 2 3.4 PUBO RDF实例文件 PUBO based RDF instance file 基于出版内容资源本体模型的符合 RDF表示规范
12、的实例数据存储文件。 4 缩略语 下列缩略语适用于本文件。 AIP:存档信息包( Archive Information Package) DCOO:数字内容对象本体( Digital Content Object Ontology) EIP:交换信息包( Exchange Information Package) MIME:多用途互联网邮件扩展( Multipurpose Internet Mail Extensions) OAIS:开放档案信息系统( Open Archival Information System) PUBO: 出版内容资源本体( Publication Content
13、Resource Ontology) RDF:资源描述框架( Resource Description Framework) SRU:基于 URL的搜索 /检索( Search/Retrieve via URL) SRW:搜索 /检索 Web服务( Search/Retrieve Web Service) URL:统一资源定位符( Uniform Resource Locator) 5 数字内容对象封装 5.1 对象封装方式 5.1.1 容器级封装 容器级封装用以封装 出版物数字内容对象 及其相关的所有对象信息。 5.1.2 对象级封装 对象级封装用以封装 出版物数字内容对象 及其所包含的单一
14、媒体对象信息。 5.2 交换信息包文件结构 5.2.1 交换信息包类型 根据交换信息包所封装的资源粒度,可分为容器级交换信息包与对象级交换信息包。 5.2.2 容器级交换信息包结构 容器级交换信息包封装了一个完整的容器级封装所包含的所有信息,其结构 如下: Container_Local_ID.zip/ mimetype META-INF/ container.xml pubomanifest.xml CONTAINER/ pubo_rdf_instance.xml( 实例文件 ) dataFile/ CY/T 102.22020 3 audio/ 音频数据 文件 video/ 视频数据 文件
15、 image/ 图 像 数据 文件 text/ 文本数据文件 other/ 其他类型数据 文件 注 1: “ Container_Local_ID” 为容器级封装的本 地 标识 符 ; 交换信息包以 “ Container_Local_ID.zip” 命名 , 采 用 ZIP压缩格式 对信息包 进行 压缩 ; 注 2: 每个交换信息包均含有一个名为 mimetype的文件 , 其中内容 为 固定 值 “ application/pubo+zip” , 用于说明 交换信息包文件的格式 ; mimetype文件不含新行或回车 , 自身不 作 压缩 ; 注 3: “ META-INF” 文件目录用于
16、存放容器级封装相关的信息 , 其中包含 container.xml和 pubomanifest.xml两个 文件 : a) container.xml: 其 文件内容如下 面的 XML片段所示 。 该 XML示例片段中, “ ”元素的属性包括: full-path:当前容器级封装的 PUBO RDF实例文件 的 相对 路径 ; media-type:该交换信息包文件的打开方式 ; package-type: 表示包类型,容器 级交换信息包 类型为 “ pubo-container+xml”。 b) pubomanifest.xml:该清单文件给出了该容器级封装所包含的 媒体对象 文件 (即数据
17、文件) 列表 及 对 象 实 例 关 系 列表 ,文件命名为 “ pubomanifest.xml”。该文件的 根 元素为 “ ”, 其 属性包括: identifier: 取值为 出版物数字内容对象 实例 IRI,在 该 内容清单中是唯一的; version:内容清单的版本号,用来区分 具 有相同标识符的内容清单。 “ ” 下包含子元素 “ ” (数据文件列表) , 示例 XML片段如下所示 : CY/T 102.22020 4 该 XML示例片段中,“ ”元素的属性包括: id: 必备属性;每一个“ item”对 应 一 份 数 据 文 件 , “ id”为 当 前 媒 体 对象 的 IR
18、I(“ ” 表示 应用单位的命名空间取值) ; href: 必备属性;取值为当前媒体对象对应 数据文件 的 相对路径 (相对于 CONTAINER文件目录) ; media-type: 必备属性;取值为当前数据文件的 MIME类型取值 。 “ ” 下包含 的另一个 子元素 “ ” (对象清单) , 示例 XML片段如下所示 : 该 XML示例片段中,“ ” 及“ ” 元素的属性包括: subjectId: 必备属性; 当前主体 对 象 实 例的 IRI(“ ”表 示 应 用 单 位 的 命 名 空 间 取 值 ) ; subjectId来 自于当前 PUBO RDF实例文件( 即 pubo_r
19、df_instance.xml文件) ; predicate: 必备属性; 当 前 “ ” (关系) 所对应的 属 性 类 型 ; objectId: 必备属性;当前客体 对 象 实 例的 IRI; objectId是“ ”中某一个“ ” 的 subjectId。 注 4: “ CONTAINER” 文件目录包含两部分: pubo_rdf_instance.xml:当前 容器 级封装实例 的 PUBO RDF实例文件 ; dataFile文件目录 : 其 下的 文件 子 目录包括 “ audio”“ video”“ image”“ text”“ other”等 ; 每个 文 件 子目录下包含对
20、应类型的数据文件。 5.2.3 对象级交换信息包结构 对象级交换信息包 用以封装 出版物数字内容对象 及其所包含的 单一 媒体 对象(及相关 数据文件 ) 信 息 , 其结构 如下: Object_Local_ID.zip/ mimetype META-INF/ container.xml pubomanifest.xml CONTAINER/ CY/T 102.22020 5 pubo_rdf_instance.xml( 实例文件 ) dataFile/ media_type_label/ 某 一媒 体类 型 数据 文件 注 1: “ Object_Local_ID” 为 出版物数字内容对象
21、 的本地标识符 ;交换 信息包以 “ Object_Local_ID.zip” 命名 , 采用 ZIP压缩格式 对信息包进行压缩 ; 注 2: “ mimetype”文件的内容及要求与容器级交换信息包中同名文件一致; 注 3: “ META-INF” 文件目录用于存放 当前 出版物数字内容对象 相关信息,其中包含 container.xml和 pubomanifest.xml两个文件: a) container.xml: 其 文件内 容如下 面的 XML片段所示 : 该 XML示例片段中,“ ”元素的属性包括: full-path及 media-type属性含义及内容与 容器级交换信息包中对应
22、属性一致; package-type: 表示包类型 ;对象级交换信息包 类型为 “ pubo-object+xml”; class: 在上例中, class属性 表示 当前 对象实例 的 类型 为 DCOO类 或 PUBO新扩展类的某一对象类型 。 b) pubomanifest.xml: 该清单文件的内容格式与容器级交换信息包中同名文件要求一致。 注 4: “ CONTAINER” 文件目录包含两部分: pubo_rdf_instance.xml:当前 对象实例 的 PUBO RDF实例文件 ; dataFile文件目录:其下的文件子目录名“ media_type_label”可为“ aud
23、io” “ video” “ image” “ text” 或“ other” 中的一种;该文件子目录下包含对应类型的数据文件。 5.3 证实方法 出版物数字内容对象 封装的证实方法见 CY/T 102.3 2020的 5.2。 6 数字内容对象存储 6.1 信息包存储 信息包的存储包括 出版物数字内容对象 (及其相关资源 对象 )的 实 例 文 件 及 数 据 文 件 的 存 储 。实 现 这两类文件的逻辑存储结构即为 出版物数字内容对象 存档信息包结构。 CY/T 102.22020 6 6.2 实例文件 存储 6.2.1 文件系统存储 完整的 PUBO RDF实例文件可单独存储于文件系统
24、中。如果文件中涉及媒体对象相关 数据文件的具体 存储位置时,该存储位置可是当前 PUBO RDF实例文件存储位置的相对路径,也可是其他路径。 示例: 当前 PUBO RDF实例文件存储为“ /Base_Path/pubo_rdf_instance.xml”(“ Base_Path”为存储 PUBO RDF实 例文件的基础存储路径)。该实例文件中涉及的媒体对象相关数据文件可存储于同一路径下,其 RDF/XML示例片段如下 所示: dataFile/other/mediaObj_1.pdf 注 1: “ ”表示 应用单位的命名空间取值; 注 2: “ dataFile”是位于“ Base_Path
25、”下的文件子目录。 6.2.2 关系数据库 存储 关系 数据库以二维表结构对实例数据进行组织和存储。 将 PUBO RDF实例文件 存 储 于关系数据 库 中时, 每个 实例作 为 独立的文本 单 元,存 储 于数据 库 表中。 表 结 构 见 表 1所示。 表 1 RDF实例存储表 序号 字段名 说明 类型 非空 备注 1 Id 当前 实 例的本地标识符 字符 串 型 是 主 键 2 IRI 当前 实 例的 IRI 字符串型 是 唯一键 3 Description 某一完整的 rdf:Description节 点 XML片段内容 长文本 型 是 注: IRI字段内容的示例形如:“ examp
26、le/chapter_1”(其中“ ”表示应用单位 的命名空间取值); Description元素内容的 RDF/XML示例片段如下: 章 的名称 实例关系表用于 存储 PUBO RDF实例文件中各个 实 例之 间 的关系。表 结 构 见 表 2。 表 2 实例关系表 序号 字段名 说明 类型 非空 备注 1 Id 当前 关系 的标识符 数 值 型 或字符串型 是 主 键 CY/T 102.22020 7 表 2(续) 序号 字段名 说明 类型 非空 备注 2 subjectId 当前主体 实例对象 的 IRI 字符 串 型 是 取值形如: example/chapter_1 3 predic
27、ate 当前属性的 IRI 字符 串 型 是 取值形如: x60_section 4 objectId 当前客体 实例对象 的 IRI 字符 串 型 是 取值形如: example/section_1 注 1: 该表的存储内容与交换信息包中 pubomanifest.xml的 节点下的内容一致(见 5.2.2); 注 2: 该表采用“ ”简化表示 PUBO命名空间取值“ http:/pubo_authority_domain/standards/pubo#”。 6.2.3 图数据库 存储 PUBO对 象模型具有 图 特性, 当 出版物数字内容对象 及其相关资源 对象 的 实例文件 数据 规 模
28、 较 大 时 , 利用 结构 化数据模型的 传统 管理方式 难 以 满 足低数据冗余与高 查询 性能的要求。以 图 方式管理 RDF实 例 数据不 仅 可避免 RDF逻辑 数据模型与物理模型之 间 的 转换 ,而且可利用成熟的 图 算法 优 化 RDF数据 查询 。 图数据库基于有向图,其理论基础是图论。 PUBO RDF实例文件中的主体(及客体)实例对象视为节 点,主体与客体之间的关系(即属性)视为边,可将 出版物数字内容对象 及其相关资源 对象 的 RDF实例 数据存 储 到 图 数据 库 中 。 常见的 图 数据 库 存储系统 包括: Neo4j、 OrientDB、 JanusGrap
29、h、 Amazon Neptune、 InfiniteGraph、 ArangoDB等 。 6.3 数据文件存储 与 PUBO RDF实例文件相关的数据文件存储于 dataFile文件目录中,按照不同的媒体类型归类 , 存 储 结 构 见 表 3。 表 3 数据文件逻辑存储结构 数据文件根 目录 媒体类型 文件目录 分组 文件目录 说明 dataFile 数据文件根目录 audio 音频数据文件根目录 分组文件目录 video 视频数据 文件根目录 分组文件目录 image 图像数据文件根目录 分组文件目录 text 文本 数据文件根目录 分组文件目录 CY/T 102.22020 8 表 3
30、(续) 数据文件根 目录 媒体类型 文件目录 分组 文件目录 说明 other 其他类型 数据文件根目 录 分组文件目录 注 1: 数据文件或直接存于“媒体类型文件目录”下,或分为多组后存于“分组文件目录”下; 注 2: 当某一类型数据文件数量较多时,在对应 “ 媒体类型文件目录 ” 下,可 根据存储系统能力,有选择性地采用“分 组文件目录”方式进行 组织。 这里 对“分组文件目录”的 必备性、 名称、数量和层级等 未 做要求。 6.4 证实方法 出版物数字内容对象 存储的证实方法见 CY/T 102.3 2020的 7.1和 7.2。 7 数字内容对象 交换 7.1 交换方式 为了支持 出版
31、物数字内容对象 的交换与复用,数字内容对象应用系统之间可通过 FTP/SFTP、接 口 等 方式进行数字内容对象的交换。 对于 FTP/SFTP方式,应用系统之间可直接传送 “交换信息包” 文件。 对于接口交换方式, 资源存储系统 可 提供 以下 8个方面的 接口 , 以 供第三方( 或 外部系统)从 当前 资源存储系统 中获取 出版物数字内容 对象 信息(包括元数据、数据文件等)。 相应的交换 接口 如下所示。 a) 资源标识符获取接口( listIdentifiers): 获取 符合查询条件的资源标识符列表; b) 指定 资源 IRI获取 接口( listIris): 获取 符合查询条件的
32、 资源 容器 级封装 包含 的所有相关 资 源的 IRI列表; c) 元数据 获取 接口( getMetadata):获取指定 IRI的 资源的 元数据。支持多种元数据格式(如 MARC、 DC等格式); d) 数据文件 URL获取 接口( listContentURL):获取指定资源所关联的数据文件的 URL列表; e) 数据流获取接口( getDataStream):获取 数据文件 对应的数字内容的字节流 ; f) 交换信息包获取接口( getEIP):获取指定资源 IRI的 交换信息包 ; g) 交换 信息包上传 接口( uploadEIP):将 交换信息包 上传至 资源存储系统 ; h
33、) 资源检索接口( resRetrieve):在 资源存储系统 中检索资源信息 。 7.2 资源标识符获取接口 7.2.1 资源标识符获取接口定义 资源标识符获取接口( listIdentifiers)定义见表 4。 表 4 资源标识符获取接口定义 项名 说明 名称 listIdentifiers 描述 根据参数 的 不同组合,返回符合查询条件的资源标识 符 的 列表 CY/T 102.22020 9 表 4(续) 项名 说明 句法 http:/hostname:port/listIdentifiers?type=IDType”表示应用单位命名空间取值; 注 3: type取值为对应资源的对象
34、类型值,可为 DCOO类 或 PUBO新扩展类 对象类型、应用单位扩展类型或其他类型。 7.4 元数据获取接口 7.4.1 元数据获取接口定义 元数据获取接口( getMetadata)定义见表 6。 表 6 元数据获取接口 定义 项名 说明 名称 getMetadata 描述 通过资源 IRI获取该资源的 元数据 句法 http:/hostname:port/getMetadata?iri=resourceIRIexample/book_1 响应 说明:通过指定的 IRI,命中 0至多个元数据实例 (dcoo:E20_Metadata),再通过“关联媒体” 属性查找到对应媒体对象实例 (dc
35、oo:E14_MediaObject)的“ 内 容 链 接 ”属 性 ,获 取 到 相 应 的 元 数 据 文 件 (可能存在多种媒体格式类型),并将元数据文件(或元数据文件的 ZIP包)响应给请求方。 7.5 数据文件 URL获取接口 7.5.1 数据文件 URL获取接口 定义 数据文件 URL获取接口( listContentURL)定义见表 7。 表 7 数据文件 URL获取接口定义 项名 说明 名称 listContentURL 描述 根据 参数中的 IRI,返回符合查询条件的 资源封装中的 不同类型的 数据 文件 列表 句法 http:/hostname:port/listConte
36、ntURL?iri=resourceIRI 参数 iri: 必备,资源 对应的 PUBO实例 IRI 证实方法 a) 当请求参数正确,并且必备参数齐备时,响应符合查询条件的数据文件 URL列表; b) 当请求包含错误参数或缺失必备参数时,响应错误代码及描述信息为: badArgument(请求包含错误 参数或缺失必备参数) 7.5.2 数据文件 URL获取接口调用 数据文件 URL获取接口请求响应的示例如下: 请求 : http:/hostname:port/listContentURL?iri=example/book_1 响应 : 2017-08-08T08:55:46Z CY/T 102
37、.22020 13 http:/hostname:port/listContentURL?iri=example/book_1 7.6 数据流获取接口 7.6.1 数据流获取接口定义 数据流获取接口( getDataStream)定义见表 8。 表 8 数据流获取接 口定义 项名 说明 名称 getDataStream 描述 通过 数据文件的内容链接 获取 其 对应的数字内容的字节流 句法 http:/hostname:port/getDataStream?url=contentURL 参数 url: 必备 ;数据文件的内容链接 证实方法 a) 当请求参数正确,并且必备参数齐备时,响应命中数据
38、文件的二进制内容; b) 当请求包含错误参数或缺失必备参数时,响应错误代码及描述信息为: badArgument(请求包含错误参数 或缺失必备参数) 7.6.2 数据流获取接口调用 数据流获取接 口请求响应的示例如下: 请求 : http:/hostname:port/getDataStream?url=http:/hostname:port/book.2434553/CONTAINER/dataFile/ image/2434553-Cover.jpg 响应 : 该 数据文件 对应的 二进制字节内容 。 注: 在本例中, url关联了一个 jpg文件,因此该接口返回该 jpg文件的 二进制内
39、容 。 应用中,需对请求中的 url值进 行 URL编码。 7.7 交换信息包获取接口 7.7.1 交换信息包获取接口定义 交换信息包获取接口( getEIP)定义见 表 9。 CY/T 102.22020 14 表 9 交换信息包获取接口 定义 项名 说明 名称 getEIP 描述 通过资源唯一标识符 IRI获取该资源对应的 EIP,包括 PUBO RDF实例文件 及 数据 文件。即若该资源没有对 应的 数据 文件,则只返回 PUBO RDF实例文件 ,否则该 出版物数字内容对象 及下级资源 对象 的 实 例 文件 和 对应 数据 文件一起打包,打包文件为 ZIP格式 (见 5.2) 句法
40、http:/hostname:port/getEIP?iri=resourceIRI 参数 iri: 必备,资源 对应的 PUBO实例 IRI 证实方法 a) 当请求参 数正确,并且必备参数齐备时,响应命中 EIP( ZIP文件)的二进制内容; b) 当请求包含错误参数或缺失必备参数时,响应错误代码及描述信息为: badArgument(请求包含错误 参数或缺失必备参数) 7.7.2 交换信息包获取接口调用 交换信息包获取接口请求响应的示例如下: 请求 : http:/hostname:port/getEIP?iri=example/book_1 响应 : 该 EIP( ZIP文件)的 二进制
41、内容 。 7.8 交换 信息包上传接口 7.8.1 交换 信息包上传接口定义 交换信息包上传接口( uploadEIP)定义见表 10。 表 10 交换信息包上传接口定义 项名 说明 名称 uploadEIP 描述 将 EIP上传至服务器或数据库 句法 http:/hostname:port/uploadEIP 请求方法 post 发送内容 EIP的二进制内容,以 multipart/form-data方 式编码,对应的 name为 eip_filename; eip_filename为本 地真实文件名 证实方法 a) 当请求参数正确、必备参数齐备,并且文件成功上传时,响应文件上传后的状态为“
42、 true”; b) 当请求包含错误参数或缺失必备参数时,响应错误代码及描述信息为: badArgument(请求包含错误 参数或缺失必备参数); c) 当上传文件格式不符合 EIP结构要求时,响应错误代码及描述信息为: badFile(非法文件) 7.8.2 交换信息包 上传接口调用 交换信息包上传接口请求响应的示例如下: CY/T 102.22020 15 请求 :以如下的 HTML表单为例( POST方法) 响应 : 2017-08-08T08:55:46Z http:/hostname:port/uploadEIP 7.9 资源检索接口 7.9.1 资源检索接口定义 资源检索接口遵循 SRU/SRW协议,实现从资源存储系统中获取元数据信息 。资源检索接口 ( resRetrieve)定义见 表 11。 表 11 资源检索接口定义 项名 说
copyright@ 2008-2019 麦多课文库(www.mydoc123.com)网站版权所有
备案/许可证编号:苏ICP备17064731号-1