书 书 书犐犆犛 ３５ ． ２４０ ． ９９ 犔 ６０ 中华人民共和国国家标准 犌犅 ／ 犜 ２９８１１ ． ３ — ２０１８ 信息技术 　 学习 、 教育和培训学习系统体系结构与服务接口第 ３ 部分 ： 资源访问服务接口 犐狀犳狅狉犿犪狋犻狅狀狋犲犮犺狀狅犾狅犵狔 — 犔犲犪狉狀犻狀犵 ， 犲犱狌犮犪狋犻狅狀犪狀犱狋狉犪犻狀犻狀犵 — 犔犲犪狉狀犻狀犵狊狔狊狋犲犿犪狉犮犺犻狋犲犮狋狌狉犲犪狀犱狊犲狉狏犻犮犲狊犻狀狋犲狉犳犪犮犲狊 — 犘犪狉狋 ３ ： 犚犲狊狅狌狉犮犲犪犮犮犲狊狊犻狀犵狊犲狉狏犻犮犲狊犻狀狋犲狉犳犪犮犲狊 ２０１８  ０６  ０７ 发布 ２０１９  ０１  ０１ 实施 国家市场监督管理总局 中国国家标准化管理委员会 发布书 书 书目 　　 次 前言 Ⅲ ………………………………………………………………………………………………………… １ 　 范围 １ ……………………………………………………………………………………………………… ２ 　 规范性引用文件 １ ………………………………………………………………………………………… ３ 　 术语和定义 １ ……………………………………………………………………………………………… ４ 　 服务接口 １ ………………………………………………………………………………………………… 　 ４．１ 　 概述 １ ………………………………………………………………………………………………… 　 ４．２ 　 学习对象管理服务 ２ ………………………………………………………………………………… 　 ４．３ 　 学习内容包装服务 ３ ………………………………………………………………………………… 　 ４．４ 　 学习设计服务 ５ ……………………………………………………………………………………… 　 ４．５ 　 测试试题信息服务 １４ ………………………………………………………………………………… 　 ４．６ 　 资源统计服务 ４３ ……………………………………………………………………………………… 附录 Ａ （ 资料性附录 ） 　 资源访问服务 ＪＡＶＡ 接口 ４５ ……………………………………………………… Ⅰ 犌犅 ／ 犜 ２９８１１ ． ３ — ２０１８ 前 　　 言 　　 ＧＢ ／ Ｔ２９８１１ 《 信息技术 　 学习 、 教育和培训 　 学习系统体系结构与服务接口 》 分为 ３ 个部分 ： ——— 第 １ 部分 ： 抽象框架与核心接口 ； ——— 第 ２ 部分 ： 教育管理服务接口 ； ——— 第 ３ 部分 ： 资源访问服务接口 。 本部分为 ＧＢ ／ Ｔ２９８１１ 的第 ３ 部分 。 本部分按照 ＧＢ ／ Ｔ１．１ — ２００９ 给出的规则起草 。 请注意本文件的某些内容可能涉及专利 。 本文件的发布机构不承担识别这些专利的责任 。 本部分由全国信息技术标准化技术委员会 （ ＳＡＣ ／ ＴＣ２８ ） 提出并归口 。 本部分起草单位 ： 清华大学 、 上海交通大学 、 中国电子技术标准化研究院 。 本部分主要起草人 ： 郑莉 、 刘聪 、 杜婧 、 申丽萍 、 张新钰 、 徐骏 、 李玉山 、 余云涛 、 王茜 、 张宇 、 李莹 。 Ⅲ 犌犅 ／ 犜 ２９８１１ ． ３ — ２０１８ 信息技术 　 学习 、 教育和培训学习系统体系结构与服务接口第 ３ 部分 ： 资源访问服务接口 １ 　 范围 ＧＢ ／ Ｔ２９８１１ 的本部分依据 ＧＢ ／ Ｔ２９８１１．１ — ２０１３ 规定了数字化学习系统软件中的资源访问服务接口 。 本部分适用于指导不同数字教育学习平台资源访问服务接口的规范化 。 ２ 　 规范性引用文件 下列文件对于本文件的应用是必不可少的 。 凡是注日期的引用文件 ， 仅注日期的版本适用于本文件 。 凡是不注日期的引用文件 ， 其最新版本 （ 包括所有的修改单 ） 适用于本文件 。 ＧＢ ／ Ｔ５２７１．３６ — ２０１２ 信息技术 　 词汇 　 第 ３６ 部分 ： 学习 、 教育和培训 ＧＢ ／ Ｔ２９８１１．１ — ２０１３ 信息技术 　 学习 、 教育和培训 　 学习系统体系结构与服务接口 　 第 １ 部分 ： 抽象框架与核心接口 ３ 　 术语和定义 ＧＢ ／ Ｔ２９８１１．１ — ２０１３ 、 ＧＢ ／ Ｔ５２７１．３６ — ２０１２ 界定的以及下列术语和定义适用于本文件 。 ３ ． １ 服务 　 狊犲狉狏犻犮犲 定义明确 、 具有自包含特性的功能单元 ， 它的存在不依赖于系统的上下文或者其他服务的状态 。 ３ ． ２ 成员 　 犿犲犿犫犲狉 接口所具有的属性定义或动态功能 ， 可以是方法 、 属性 、 事件和索引指示器 。 注 ： 接口定义可以包含零个或多个成员 。 ４ 　 服务接口 ４ ． １ 　 概述 接口给出的是系统行为模型 ， 并不强制绑定到某种具体语言 。 为了便于理解 ， 附录 Ａ 给出了服务接口的 Ｊａｖａ 语言绑定 。 本部分将服务接口分为 ： 学习对象管理服务接口 、 学习内容包装服务接口 、 学习设计服务接口 、 测试试题信息服务接口和资源统计服务接口 。 本部分使用成员 、 返回值类型 、 参数说明和说明等四项定义接口 。 １ 犌犅 ／ 犜 ２９８１１ ． ３ — ２０１８ ４ ． ２ 　 学习对象管理服务 ４ ． ２ ． １ 　 概述 学习对象的管理服务的基本接口应符合 ＧＢ ／ Ｔ２９８１１．１ — ２０１３ 中 ７．４ 和 ８．６ 的规定 ， 包括 Ｆｉｌｅ 接口 、 ＬａｎｇＳｔｒｉｎｇ 接口和 ＬＯＲｏｏｔ 接口等 ， 本部分补充如下 ６ 个接口 ， 包括目录接口 、 版本接口 、 日期类型接口 、 元数据存储公用程序接口 、 元数据上下文接口和元数据检索公用程序接口 。 ４ ． ２ ． ２ 　 目录接口 目录接口 （ Ｃａｔａｌｏｇ 接口 ） 定义如表 １ 所示 。 表 １ 　 犆犪狋犪犾狅犵 接口定义 成员 返回值类型 参数说明 说明 ｇｅｔＣａｔａｌｏｇ Ｓｔｒｉｎｇ ＜ 无 ＞ 获得类别 ｓｅｔＣａｔａｌｏｇ ｖｏｉｄ ｃａｔａｌｏｇ ： Ｓｔｒｉｎｇ 设置类别 （ ｃａｔａｌｏｇ ） ４ ． ２ ． ３ 　 版本接口 版本接口 （ Ｖｅｒｓｉｏｎ 接口 ） 定义如表 ２ 所示 。 表 ２ 　 犞犲狉狊犻狅狀 接口定义 成员 返回值类型 参数说明 说明 ｇｅｔＮａｍｅ Ｓｔｒｉｎｇ ＜ 无 ＞ 获取元素类型名称 ｇｅｔＬａｎｇＳｔｒｉｎｇｓ ＬａｎｇＳｔｒｉｎｇ ［］ ＜ 无 ＞ 获得所有字符串 ｓｅｔＬａｎｇＳｔｒｉｎｇｓ ｖｏｉｄ ｌａｎｇＳｔｒｓ ： ＬａｎｇＳｔｒｉｎｇ ［］ 设置所有字符串 （ ｌａｎｇＳｔｒｓ ） ｇｅｔＢｙＬａｎｇ ＬａｎｇＳｔｒｉｎｇ ｌａｎｇ ： Ｓｔｒｉｎｇ 获得规定语种的字符串 （ ｌａｎｇ ） ｅｍｐｔｙＬａｎｇＳｔｒｉｎｇ ｖｏｉｄ ＜ 无 ＞ 清空所有字符串 ｇｅｔＣｏｎｔｅｎｔＩｎＳｔｒｉｎｇ Ｓｔｒｉｎｇ ＜ 无 ＞ 获得所有字符串内容 ｃｏｎｔａｉｎｓ Ｂｏｏｌｅａｎ ｃｏｎｔｅｎｔ ： Ｓｔｒｉｎｇ 是否包含指定字符串 （ ｃｏｎｔｅｎｔ ） ４ ． ２ ． ４ 　 日期类型接口 日期类型接口 （ ＤａｔｅＴｙｐｅ 接口 ） 定义如表 ３ 所示 。 表 ３ 　 犇犪狋犲犜狔狆犲 接口定义 成员 返回值类型 参数说明 说明 ｇｅｔＤａｔｅＴｉｍｅ Ｓｔｒｉｎｇ ＜ 无 ＞ 获得日期字符串 ｓｅｔＤａｔｅＴｉｍｅ ｖｏｉｄ ｄａｔｅＴｉｍｅ ： Ｓｔｒｉｎｇ 设置日期字符串 （ ｄａｔｅＴｉｍｅ ） ｇｅｔＤｅｓｃｒｉｐｔｉｏｎ Ｓｔｒｉｎｇ ＜ 无 ＞ 获得日期字符串描述信息 ｓｅｔＤｅｓｃｒｉｐｔｉｏｎ ｖｏｉｄ Ｄｅｓｃｒｉｐｔｉｏｎ ： Ｓｔｒｉｎｇ 设置日期字符串描述信息 （ ｄｅｓｃｒｉｐｔｉｏｎ ） ２ 犌犅 ／ 犜 ２９８１１ ． ３ — ２０１８ ４ ． ２ ． ５ 　 元数据存储公用程序接口 元数据存储公用程序接口 （ ＳｔｏｒｅＬＯＭＵｔｉｌ 接口 ） 定义如表 ４ 所示 。 表 ４ 　 犛狋狅狉犲犔犗犕犝狋犻犾 接口定义 成员 返回值类型 参数说明 说明 ｓｔｏｒｅＬＯＭ Ｂｏｏｌｅａｎ ｐａｔｈ ： Ｓｔｒｉｎｇ 将路径 （ ｐａｔｈ ） 中的内容打包成元数据格式 ｓｔｏｒｅＬＯＭ Ｂｏｏｌｅａｎ ｆｉｌｅ ： Ｆｉｌｅ 将文件 （ ｆｉｌｅ ） 中的内容打包成元数据格式 ｐａｒｓｅＬＯＭ ＬＯＲｏｏｔ ｆｉｌｅ ： Ｆｉｌｅ 按照元数据格式解析文件 （ ｆｉｌｅ ） ｇｅｎｅｒａｔｅＬＯＭＢｙＴｅｍｐｌａｔｅ ＬＯＲｏｏｔ ｔｅｍｐｌａｔｅ ： ＬＯＲｏｏｔ 按照模板 （ ｔｅｍｐｌａｔｅ ） 生成元数据 ４ ． ２ ． ６ 　 元数据上下文接口 元数据上下文接口 （ ＬＯＭＣｏｎｔｅｘｔ 接口 ） 定义如表 ５ 所示 。 表 ５ 　 犔犗犕犆狅狀狋犲狓狋 接口定义 成员 返回值类型 参数说明 说明 ｓｅａｒｃｈＢｙＣｒｉｔｅｒｉａ ＬＯＲｏｏｔ ［］ ｃｒｉｔｅｒｉａ ： Ｓｔｒｉｎｇ 按照条件 （ ｃｒｉｔｅｒｉａ ） 检索元数据 ＩｓＳＱＬ Ｂｏｏｌｅａｎ ＜ 无 ＞ 返回是否是 ＳＱＬ 语句 ＩｓＸｐａｔｈ Ｂｏｏｌｅａｎ ＜ 无 ＞ 返回是否是 Ｘｐａｔｈ 语句 ４ ． ２ ． ７ 　 元数据检索公用程序接口 元数据检索公用程序接口 （ ＳｅａｒｃｈＬＯＭＵｔｉｌ 接口 ） 定义如表 ６ 所示 。 表 ６ 　 犛犲犪狉犮犺犔犗犕犝狋犻犾 接口定义