GB/T29811.1-2013
信息技术学习、教育和培训学习系统体系结构与服务接口第1部分：抽象框架与核心接口
Informationtechnology-Learning,educationandtraining-Learningsystemarchitectureandserviceinterface-Part1:Abstractframeworkandcoreinterface
- 中国标准分类号（CCS）L67
- 国际标准分类号（ICS）35.240.99
- 实施日期2014-05-01
- 文件格式PDF
- 文本页数156页
- 文件大小1.93M
以图片形式预览信息技术学习、教育和培训学习系统体系结构与服务接口第1部分：抽象框架与核心接口
信息技术学习、教育和培训学习系统体系结构与服务接口第1部分：抽象框架与核心接口
国家标准 GB/T29811.1一2013 信息技术学习、教育和培训 学习系统体系结构与服务接口 部分抽象框架与核心接口 Informationteehmology一Learming，edeatioandtraining Learnmingsystemarchitectureandserviceinterface Part1:Abstractframeworkandcoreinterface 2013-11-12发布 2014-05-01实施 国家质量监督检监检疫总局 发布 国家标准花管理委员会国家标准
GB/T29811.1一2013 目 次 前言 引言 范围 规范性引用文件 术语和定义 框架 服务的分层结构 共性服务接口 教育服务接口 30 附录A(资料性附录)JAVA接口 68 参考文献" 151
GB/T29811.1一2013 前 言 GB/T29811《信息技术学习、教育和培训学习系统体系结构与服务接口》分为以下3个部分 -第1部分:抽象框架与核心接口; 第2部分:教育管理信息服务接口; 第3部分:学习资源访问服务接口
本部分为GBy/T29811的第1部分 本部分按照GB/T1.1一2009给出的规则起草 请注意本文件的某些内容可能涉及专利
本文件的发布机构不承担识别这些专利的责任 本部分由全国信息技术标准化技术委员会(SAc/TC28)提出并归口. 本部分起草单位;清华大学、华东师范大学、华中师范大学、标准化研究院、电子技术标准 化研究院
本部分主要起草人;郑莉、张新钰,刘京,吴永和,刘清堂、王绚、刘银涛.许磊、李玉山,余云涛,刘颖、 张荫芬、隋媛
GB/T29811.1一2013 引 言 信息技术的发展带来了学习、教育和培训技术的全面革新,数字化学习越来越广为接受,成为传统 学习、教育和培训模式的新发展
GB/T29811的本部分重点解决信息技术学习、教育和培训标准体系中学习资源的互操作以及学 习系统间的互操作问题
它从多个角度描述了数字化学习系统的软件体系结构,、服务的分层结构,以及 服务的接口定义,解决学习系统之间组件级共享与交换问题,实现系统的互操作
GB/T29811.1一2013 信息技术学习教育和培训 学习系统体系结构与服务接口 第1部分抽象框架与核心接口 范围 GB/T29811的本部分规定了学习系统的软件体系结构模型,以及服务的抽象框架,用于描述系统 的上下文以及服务和接口的抽象表示,同时本部分按照该体系结构模型框架,定义了数字化学习系统软 件中的核心服务接口
本部分适用于不同的数字教育学习平台通用服务和接口的定义及数字教育学习平台的接口规 范化
规范性引用文件 下列文件对于本文件的应用是必不可少的
凡是注日期的引用文件,仅注日期的版本适用于本文 件
凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件 GB/T5271.36信息技术词汇第36部分;学习、教育和培训(GB/T5271.362011.Iso/ IEC2382-36:2008,IDT GB/T16264.8信息技术开放系统互连目录第8部分:公钥和属性证书框架 术语和定义 GB/T5271.36中界定的以及下列术语和定义适用于本文件
3.1 互操作性interoperabiity 两个或多个系统间交换信息或协同工作的能力 注互操作性关注的是系统间的信息交换,规范中并未对通信系统中数据如何管理做任何假设 3 服务seryiee 定义明确、具有自包含特性的功能单元,它的存在不依赖于系统的上下文或者其他服务的状态
3.3 分层layering 搭建数字教育学习平台系统所需要的全部服务集合被划分为一组层次模型,每一层提供一组清晰 定义的服务
一个特定的层次会使用下层提供的服务,同时为上层实体提供服务
框架 逻辑框架 图1中展示的是基于分层抽象的学习系统逻辑框架
等效的物理架构模型在图2中
GB/T29811.1一2013 在逻辑框架中包括以下层次 a)用户;学习系统的用户包括学生、教师、管理员等,这些用户通过适当的用户代理对系统进行 访问; b用户代理:将服务递送给用户; 工具;工具可以让服务以方便而友好的方式被访问,这包括著作工具、仿真工具等; c dD 教育服务;面向教育领域的服务本身; 共性服务:对于一些非数字教育学习平台系统同样可能需要用到的一些基础服务,例如认证、 资源发现服务等; 数字资源库,对数字化资源素材的存储,可以是数据库,网络服务器、文件等形式; I 通信设施;基本的网络和数据传输服务,实现信息的端到端的递送
逻辑框架的物理表示包括以下的核心结构 rnet在内的连接核心计算机系统的主要网络,是逻辑框架中通信设施的 核心网络:包括如Intern -部分; 接人网络;连接传输设备和核心网络的网络设施,典型的例子是电报网络,无线网络、公共开关 b 电话同络(PsTN)等
接人网络同样是通信设能的一个组成部分 数字资源库:系列数字资源可以通过各种数字资源库获得,如数据库、网络服务器等,对应逻辑 框架中的数字资源库; 服务递送引擎;这些系统负责提供所有的教育服务,其对应于逻辑框架中的教育服务及支撑 服务; 传输设备;设备及其客户端可以将学习资料传递并展示给用户,逻辑框架中的工具及用户代理 主要提供这些功能
学生 教师 用户 用户代理 应用程序 工具 教育服务 共性服务 服务 数字资源库 通信没 学习系统逻辑框架
GB/T29811.1一2013 接入网络 传着设各 数字资源体 核心网络 服务递送引擎 图2学习系统物理结构 4.2功能模型 4.2.1概述 -个学习系统可以从几个不同视点分析其功能,这里给出两种视点的功能模型 内容视角;描述数字教育学习平台系统中,内容及相关信息流如何管理， a b个体视角;描述数字教育学习平台系统中,关于个体的信息流如何管理
这些功能视点指出了学习系统内的互操作点,就是图3箭头所示
源生成器 核心学习活动 课程 目标 学习计划 学习对象 计划 内容创作工具 课租 计划 学习者注册 注册信息 注册信息 注册信息 学习对象 学习对象 内容资濒库及 内容妆配工具 递送环境 学习者概况管理 课程目录 活动信息 注册信息 记录事件 协作环境 学习课程 活动信息 目录管理 注册信息 评估对象 评估" 测试引擎 结果信息 图3内容视角 4.2.2内容视角 如图3所示,内容视角共有四个关键的功能设计
GB/T29811.1一2013 内容资源库以及课程目录的源生成器:包括内容对象的创作工具、内容装备工具和目录管理 a b)内容资源库以及课程目录;学习资料的存储以及列表描述这些资料的目录 核心学习活动作为履行学习过程的结果,将会产生学习者概况的变化,这些活动是 学习计划计划在什么时间完成什么样的学习内容 1 2) 学习者注册;在所提供的适当课程中进行注册; 3)递送环境针对学习资料完成学习; 4 协作环境;与课程的其他参与者协作学习 5)评估/测试引擎:对已完成的学习内容进行评估
d 学习者概况管理;管理学习者个人的概况信息
4.2.3 个体视角 共有4个关键的功能配置,如图4所示 个人信息和工作的源生成器;包括文体创作工具,资格学力许可(QCL)权眼和伸裁 a 个人信息资源库;管理个人维护的资源库中的学习者信息
b 核心活动;作为履行学习过程的结果,将会产生学习者概况的变化,这些活动是 1)训练计划;计划在什么时间完成什么样的学习内容; 学习递送;训练(关注协作和训练)和教育(关注资格)的递送 2) 3学习话动;正常的工作话动,可以为学档体验产生一定拖围内的材料 4评估/测试引擎;对已完成的学习内容进行评估
人力资源库;管理人力资源系统中的学习者信息
D 核心活动 源生成器 目标 文档 学力 文档创作 训练计划 工H 计划 计划 学力 学习递送 0CL 学力 资格学力许可 个人信息资源库 人力资源库 QcL)权限 安排 学档 学习活动 学档 伸拔 注册信息 仲裁 结果信息 评估/ 渊试引攀 结果信息 图4个体视角 4.3软件体系结构 图5以分层模型描述了学习系统的软件体系结构
GB/T29811.1一2013 用户 学习者 指导者 用户代果 学习内容臂理 学习管理 评测 其他 教育应用 学习对 学习活 题库 内容包装 学习设计 评价 动管进 象管理 其他 教育服务 元数批 其他 其他 考试 其他 瞥理 认证 授权 数据库管理 版权管理 目录 文件 共性服务 标识 日程 日志 消息 工作流 其他 基础 基础设随 数据库 通讯系统 日录服务 其他 学习资源 学习记录 数字资源库 通伯设施 图5学习系统的软件体系结构 a)教育应用层;这一层是一些核心应用以及其他应用,用于将适当的教育服务呈现给用户,例如 学习内容管理系统,评测系统
应用程序可以使用一个或多个教育服务,必要的时候可以跨层 调用共性服务 示例1;评估系统;用于评估人们对某一特定内容领域的理解水平,形式上可以分为小测验和正式的考试 示例2;内容著作工具:支持学习内容开发的应用程序
著作的类型包括支持本地XM内容和通过可重用的 内容集来创建新的内容
示例3;学习内容管理系统;能够更加灵活地管理学习资源(如内容包装中的个人资源文件)中的素材(如图 ,动画等 ,可能涉及作为XMl描述内容存储的个人资源,它们被动态转换成其他表现 像、文 来包装成内容包装中的资源 形式.如 第 者信息,学习过程,以及学习成果报告的应用程序
学习管理系统的任 示5 个系统会维护所有和学生学习相关的信息,同时也会和 学生信鼠的管理信息系统
这 示伤例 教育服务层;为教育应用提供数字教育平台领域必需功能，一个教育服务可能使用一个或多个 共性服务,并可能会跨层调用基础设施中的功能 共性服务层:提供基础的、公共的功能,为教育服务层提供支持; 基础设施层;为教育服务和共性服务提供端到端的事务处理和通信服务,包括各种软硬件支 持,如数据库管理系统、操作系统、目录服务器、应用服务器、网络环境等
GB/T29811.1一2013 服务的分层结构 5.1服务框架 图6描述了与学习系统软件体系结构模型相对应的服务框架,该框架采用分层结构来组织共性服 务和教育服务
核心应用 教育应用 其他应用 评测 学习内客管理 教学设讲 课程管那 学习管理" 电子学档 内容包转 教育服务 学历管理 学习设计 学习者 其他 文件 工作流 数据库臂理 目录 日志 共性服务 版权臂理 认证 茄础 授权 其他 基础设施 数据库 通讯系统 目录服务 其他 图6服务框架 5.2共性服务层 下面所列出的共性服务并非完备集合,但可以表明所列的服务都是不同应用程序或教育服务将会 需要用到的 基础(Base)服务 a 认证(Authenticeation)服务 b c)授权(Authorization)服务; d数据库管理(DatabaseManugememt)服务 e 版权管理(DigitalRightsManagement)服务; 目录(Direetory)服务; 文件(FileManagement)服务; 标识(Identification)服务; 日程(Scheduling)服务; 日志(L.ogging)服务; k消息(UserMessaging)服务
GB/T29811.1一2013 工作流(workflow)服务; mXML服务
5.3教育服务层 教育服务层的目的是为了指出核心的教育服务集合,仅有部分教育服务列出了细节,这些服务可以 直接用于数字教育学习平台应用程序的开发
目前确定的教育服务核心集有: 评估Assessment)服务; a D 班级管理(ClasManagememt)服务 日历(Calendar)服务; c d)协作(Collaboration)服务 学历管理(CompetencyManagement)服务; 课程管理(CourseManagement)服务; 学习对象管理(L.earnmingOobjectManagemen)服务 内容包装(ContentPackaging)服务; h 组管理(GroupManagement)服务 学习设计(I .earningDesign)服务; k 学习活动管理(IearnerProgressionMa anagement)服务; 成员管理(MembershipManagement)服务 m元数据管理(Meta-dataManagement)服务; 电子学档管理(PortfolioManagenment)服务; n 偏好管理(ProfleManag gement)服务; p)编列(Se ieequencing)服务; 仿真(Simulation)服务
q 5.4教育应用层与服务的关系 教育应用层是一些与学习相关的应用程序,应用程序可以使用一个或多个教育服务,必要的时候可 以跨层调用基础服务
5.5基础设施层与服务的关系 为基础服务和教育服务提供端到端的事务处理和通信服务,包括各种软硬件支持,如数据库管理系 统、操作系统、目录服务器、应用服务器、网络环境等
5.6分层结构与核心服务接口的关系 本部分所给出的核心服务接口按照服务的分层结构进行定义,且所定义的服务接口与服务的分层 一个服务的功能由多个接口来构成
结构中的服务有着直接的对应关系， 接口给出的是系统行为模型,并不强制绑定到某种具体语言
为了便于理解和直接用于开发,附录 A给出了服务接口的Java语言绑定
本部分所给出的是服务接口的核心集
根据服务的分层结构的分层,将核心服务接口分为;共性服 务接口和教育服务接口
GB/T29811.1一2013 共性服务接口 6 基础(Base)服务 6.1.1服务描述 基础服务提供的是一些基础接口,供其他接口使用,这些接口通常会被继承
6.1.2Maager接口 Manager是将应用程序绑定到具体服务实现的关键,接口的描述需要定义一个接口扩展Manm nager， 而接口的实现要求以一个类实现具体的Ma1 应用程序直接或间接通过Mant nager访问服务对象
anager
Manager接口定义如表1所示
表1 Manager定义 成 员 明 参数说明 返回值/类型 说 无 CeltsContext 获得传递的上下文内容 getContext assignContext 空 eontext;CeltsContext 给上下文赋值 assignConfigurationm 办 configuration:Properties 对环境参数赋值 6.1.3Properties接口 Properties接口用于返回对象的一些只读属性,这些属性通过一系列串行化的值得到,并用关键码 标记
Properties接口定义如表2所示
表2Properties定义 员 明 成 返回值/类型 参数说明 说 无 getType CeltsType 获得属性类型 可序列化对象 key;属性的关键码,可序获得属性 getProperty 列化对象 得到属性的关键码 无 getKeys Ojeetlterator 6.1.4CetsContext接口 CeltsContext包含应用程序共用的语境信息
CeltsContext接口定义如表3所示
表3CetsContext定义 员 明 成 返回值/类型 参数说明 说 key字符串 为CdtsContex!的语境信息的内 无 assignContext context;可序列化对象 容赋值 getContext 可序列化对象 key:字符串 得到CeltsContext的语境信息
GB/T29811.1一2013 6.1.5 lterator接口 lterator提供的是迭代器接口,用于数据的批量读取,对于具体的对象类型,将通过继承Itt erator 类 实现自己的迭代器接口
lterat tor接口定义如表4所示
表4Iterator定义 员 明 返回值/类型 参数说明 说 成 布尔值 是香还有下一个元素 hasNext 无 容 无 取下一个元素 Next 6.1.6 Propertieslterator接口 PropertiesIterator接口定义如表5所示
表5PropertiesIterator定义 成 员 参数说明 明 返回值/类型 说 布尔值 是否还有下一个属性 无 hasNextProperties 无 取下一个属性 Properties nextProperties 6.1.7CetsIype接口 CeltsType接口按照事物的基本概念进行分类,被用于各个接口中
CeltsType的精确定义由使用 者确定.CeltsType接口的形式也有利于分类,CeltsType有4个字符串属性:authority.domain、 keyword以及description,前3个元素被isEqual成员用来判断两个CeltsType对象是否相等,deserip tion用来阐明实例的语义
CeltsType接口定义如表6所示 表6CeltsIype定义 成 员 返回值/类型 参数说明 说 明 getAuthority 无 字符串 获得CeltsType的authority 字符串 得到cedltsType的描述 getDescription 字符串 得到使用域 getDomain getKeyword 无 字符串 得到关键字 布尔值 判断两个cesType对象是否相同 isEqual celtsType2:CeltsType 6.1.8Typelterator接口 Typelerator接口定义如表7所示
GB/T29811.1一2013 表7Iypelterator定义 明 返回值/类型 参数说明 员 成 说 布尔值 无 是否还有下一个类型 hasNextType 无 取下一个类型 nextType CeltsType IdIterator接口 IdIterator接口定义如表8所示 表8IdIterator定义 员 明 返回值/类型 参数说明 说 成 无 hasNextld 布尔值 是香还有下一个D nextld ld 无 取下一个ID 6.1.10Objeetlterator接口 Objectlterator接口定义如表9所示
表9Objeetlterator定义 员 参数说明 明 说 返回值/类型 成 hasNextObjeet 无 是否还有下一个对象 布尔值 nextObjeet 可序列化对象
无 取下一个对象 6.2认证(Authentication)服务 6.2.1服务描述 认证服务从学习代理处收集必要的认证信息,以确保认证的真实性
这样调用此服务的应用程序 就可以确定并处理学习代理的认证状态,而不必管理一个特定机构环境的细节内容
此服务需要建立 在各种认证设施之上,并基于cookie的单点签人技术,如web1so
-些应用程序依靠用户名/密码进行认证,也有的是基于授权证书,大部分用户认证是本地化的,但 也有一些是远程认证
这种范围在接口上使用认证类型的概念来表示
并且一个机构范围内会有一个 默认类型和经常使用的一些通用认证方法
学习代理,通过一个或多个这样的类型得到认证
很多情况下,在一次会话中一个代理可能会进行 多次认证
这主要发生在一个学习代理从一种学习活动转向另一种学习活动的时候
例如检查班级进 度日程,可能只要用户名和密码就足够了,而更新最终的学习成绩宜需要的是GB/T16264.8证书 (X.509)以确保更高水平的安全认证
6.2.2AuthentieationManager接口 AuthenticationManager接口定义如表10所示
10
GB/T29811.1一2013 定义 表10 AuthenticationManager 成 员 说 返回值/类型 参数说明 明 getAuthenticationTypes 无 Typelterator 获得认证类型 根据认证类型对用户认证 authenticateUser authenticationType:CeltsType isUserAuthenticated 布尔值 判断用户是否已经过认证 aie.CTe authenticat getUserld Id 得到认证用户的ID authenticationType:CeltsType 清除认证记录 空 destroyAuthentication destroyAuthentieationFor 空 authenticationType:CetsType 清除同类型的认证记录 Type 数据库管理(Database management)服务 6.3.1服务描述 数据库管理服务提供了数据库管理的基本操作,包括对关系数据库中常用数据类型的封装定义,以 及存取操作及结果表达的定义
6.3.2Bob接口 Bob是关系数据库中常用的一种类型,在BHob列中可以存放大数据量的二进制数据,如图片,音 频数据等,该接口提供对数据表中Blob列的访问
Blob会记录当前的读写位置,是一个长型整数 Bob接口如表11所示
表11Blob定义 成 员 返回值/类型 参数说明 说明 ength 无 长型整数 返回该Blob数据的长度,单位字节 字节数组 pos;长型整数 从po指定的位置开始,读取length字节的数 getBytes length:整型 据,结果以字节数组形式返回 setBytes 整型 position:长型整数 将bytes所含数据写人该Blob中从position开 始的地方 bytes;字节数组 整型 position:长型整数 将ye中从oIse开始的长度为length的数 setBytes bytes;字节数组 据写入该Blob中从position开始的地方 ofIset;整型 length;整型 6.3.3Clob接口 Cob是关系数据库另一种常用的类型,在Clob列中可以存放大量的字符数据,如大量的文本,该 接口提供对数据表中Clob列的访问
Clob接口定义如表12所示
11
GB/T29811.1一2013 表12CIob定义 成 员 参数说明 说明 返回值/类型 无 长型整数 返回该Clob数据的长度,单位字节 length 长型整数 W 字符串 人p0os指定的位置开始,读取length个字符,结 getSubString pos:t length:整型 果以字符串返回 setString 整型 pos;长型整数 将string字符串写人该Clob中从position开 string;字符串 始的地方,返回成功写人的字符数 setString 整型 pos;长型整数 将string字符串中从ofset开始的长度为 string;字符串 lenth的子字符串写人该Clob中从pwsiton开 offset:整型 始的地方,返回成功写人的字符数 lengh整型 6.3.4Connection接口 Connection接口代表了一个到数据库的连接,通过该连接可以执行数据库的查询、修改操作,另外 不再使用的数据库连接可以释放,以节省数据库连接资源
Connection接口定义如表13所示
表13Conneetion定义 员 返回值/类型 参数说明 说 成 执行sq所表示的查询语句,结果以Re ResultTable sl字符串 executeQuery sultTable返回 execeuteQuerywithParams ResultTable sql;字符串 执行sql所表示的查询语句,sql中的占位 params;字符串数组符使用params提供的具体值替换结果 以ResulTable返回 executeUpdate 整型 Sql:字符串 执行sql所表示的更新语句 eexecuteQuerywithParams 整型 sql:字符串 执行sq所表示的更新语句,sql中的占位 params字符串数组符使用params提供的具体值替换 关闭该连接 close ResultMetaData接口 6.3.5 ResultMetaData接口可以获取关于一个ResultTable的列的信息,如类型、列名称等;ResultMeta Data通过ResultTable的getMetaData方法获取,提供关于对应ResultTable的元信息
ResultMeta Data提供如下信息;列数目、,列名称、,列类型,列显示时需要的宽度(字符宽度),是否接受NULL值等
ResultMetaData接口定义如表14所示
12
GB/T29811.1一2013 表14ResutMetaData定义 员 说 明 成 返回值/类型 参数说明 无 getColumnCount 整型 获取列数目 getColumnName 字符串 columnlndex:整型获取列columnlndex的名称 getColumnType 整型 columnlndex;整型获取列columnlndex的类型常量 getTableName columnlndex:整型获取列columnlndex原先所属的表名 字符串 getColumnDisplaySize 整型 columnlndex;整型获取列columnlndex显示时需要多少字符宽度 布尔值 columnlndex整型 判断列columnhndex是否可接受NULL 值 isNullable 判断列columnlndex 布尔值 是否只读 isRead(Onlv columnlndex整型 iswritable 布尔值 columnlndex;整型 判断列columnlndex是否可写 isSearehable columnlndex;整型判断列columnlndex是否可以被搜索 布尔值 ResulIable接口 6.3.6 ResultTable用来表示数据库查询结果,提供方法获得结果表格中每条记录的数据
ResultTable 继承cn.edu.celtsc.intf.common.base.Iterator,可以依次遍历ResultTable中的各个记录(行),进而读 取数据
ResultTable接口定义如表15所示
继承;lterator接口
表15 sultIable定义 ReSu 明 员 返回值/类型 参数说明 成 ResultMetaData 获得结果表格的原数据,如表名等 无 getMetaData getBooleanm 布尔值 columnlndex;整型 获得当前行列序号为columnlndex的布尔值 getlnt 整型 columnlndex;整型 获得当前行列序号为columnlndex的整型值 getDouble 双精度型 columnlndex:整型 获得当前行列序号为columnlndex的双精度值 get字符串 columnlndex;整型 获得当前行列序号为colunmnlndex的字符串值 字符串 获得当前行列序号为mhdx的D饭 字符串 getDate columnlndex整型 获得当前行列序号为columnlndex的Time值 字符串 columnlndex格型 getTime etBlob Blob nlndex;整型 1columnlndex的Blob值 获得当前行列序号为c colummnl &er getClob Clob columnlndex:整型 获得当前行列序号为columnlndex的Clob值 getBytes columnlndex;整型 字节数组 以字节数组的形式获得当前行列序号为 x的值 columnlnde 无 wasNul 布尔值 判断结果表格是否为空 iisFirst 无 布尔值 判断当前位置是否在表格的第一行 isLast 布尔值 无 判断当前位置是否是表格的最后一行 6.3.7soLFactory接口 sQLFactory接口提供工厂方法用来获取到数据库的连接,使用该连接即可进行多种数据库相关的 操作,可以通过两种方法获得一个数据库连接
sQLFactory接口定义如表16所示
13
GB/T29811.1一2013 表16sQLFacory定义 明 返回值/类型 参数说明 成 员 说 url;字符串 createConnection Connection 根据题提供的url字符串创建 个数据库连接 url;字符串 根据提供的url字符串,用户名 Conneetion createConnection uwser;字符串 wser以及密码password创建 password字符串 个数据库连接 6.4文件(FileManagemment)服务 6.4.1服务描述 文件服务提供一种静态内容的存储和检索的方法
它是文件系统与应用程序之间的一个抽象层 次
文件服务也可能采用单个逻辑文件的多个物理拷贝提供自动恢复的功能
6.4.2Direetory接口 y hreetory接口表示文件系统中的一个目录，目录用来组织文件，,目录中可以包含子目录和文件
该接口提供方法供在目录树的不同层次间进行移动,如getParent()，getDirectories()等;该接口提供 了在本目录中创建子目录和文件的方法createSubDirectory(),ereateFile();另外该接口还支持目录的 拷贝和删除操作等
Directory接口定义如表17所示
表17Direetory定义 返回值/类型 成 员 参数说明 说 明 获得该目录的父目录,根目录则返回空 getParent Directory 无 布尔值 检测该目录是香为根目录 isRoot getPath Path 无 获得该目录对应的Path Copy 空 dest:Path,目录将被拷贝将本目录及其子内容拷贝到des所指定 到的目的路径 的目标目录 Delete 空 无 删除该目录及其内容 ereateSubDireectory Direetory dirName:字符串,将要创在该目录下创建名称为dirName的子 建的子目录名称 目录 ereateFile File filename;字符串,将要创在该目录下创建名称为fileName的文件 建的文件名称 无 getDirectoryRoot Path 返回该目录所属的根目录 getName 无 字符串 获得该目录名称 获取该目录所含文件的列表,返回代表该 getFiles File[ 列表的数组 获取该目录下所有的子目录列表,返回代 getDirectories 无 Direetory口 表该列表点额数组 14
GB/T29811.1一2013 6.4.3File接口 File接口用来表示一个文件,提供基本的面向字节的文件读写操作,并且提供用于访问和设置文件 基本信息的接口,如读取和更改文件的创建时间等,判断文件是否可写等;另外文件还提供MIME信 息,便于在网络环境下使用
File接口定义如表18所示
表18File定义 员 明 返回值/类型 参数说明 说 成 空 dest;Path 将该文件拷贝到dest所示的目录 copy 空 dest;Path 将该文件拷贝到des所示的目录,新文件名称 copy newName;字符串 为newName 容 newName:字符串 将文件拷贝到同一目录下,用文件名newName copy 保存 容 无 delete 删除文件 无 isReadable 布尔值 检查文件是否可读 无 isWritable 布尔值 检查文件是否可写 getMimeType 无 字符串 获取文件的MIME type;字符串 设置文件的MIME updateMimeType 空 空 将文件设置为只读 updateReadOnly 无 updatewtritable 将文件设置为可写 空 无 长型整数 返回文件的大小,以字节为单位 length read 整型 buffer:字节数组 从文件当前位置读取count个字节的内容,读 offset:整型 取内容放人buffer中offset起始的空间 count;整型 无 整型 从文件当前位置读取一个字节的内容 read 容 bufer;字节数组 将buffer中的数据写人文件当前位置 write write 空 b:字节 将字节b写人文件当前位置 无 flush 空 无 关闭文件 close 空 获得文件路径 getPath Path 获得文件所处的目录 getDirectory Directory getCreationTinme 无 字符串 获取文件创建时间 setCreationTime 空 tinme;字符串 修改文件创建时间为time getl.astAccessTime 字符串 无 获取文件上次访问时间 空 setLlastAccessTime time:字符串 修改文件上次访问时间为time 字符串 获取文件上次修改时间 getlastWriteTime time;字符串 修改文件上次修改时间 setlastWriteTime 空 15
GB/T29811.1一2013 6.4.4Path接口 Path接口表示文件或者目录的路径,可以是相对路径或者绝对路径,提供方便的方法对路径进行 操作,如获取一个路径的目录名,文件名,绝对路径等
File服务中的File和Directory接口都是通过 Path进行标识,它们的实例都包括一个对Path实例的引用
Path接口定义如表19和表20所示
表19Path定义常量部分) 明 类型 常量定义 值 说 路径中目录间的分隔符，通常在 字符 direetorySeparatorChar 八或" windows系统中该字符为'\',在UNIX 系统中为'" 字符数组 不允许出现在路径中的字符,这些字符 invalidPathChars /'，\' 称为非法字符 字符 多个路径之间的分隔符;像Java中常用 pathSeparator 的环境变量ClassPath通常包括多个路 径,用来在多个位置寻找可能的类,这 些路径之间使用pathSeparator进行分 隔,大多数系统中该字符为' volumeSeparator 字符 卷标分隔符 表20Path定义(函数成员 成 员 参数说明 说 明 返回值/类型 字符串 无 getDirectoryName 获取父目录名 字符串 无 getName 获取路径名 字符串 无 getExtension 获取后缀 字符串 无 getFullPath 获取路径全名 字符串 无 getPath 获取当前路径的抽象路径 无 isAbsolutePath 布尔值 判断是否为绝对路径 无 isDirectory 布尔值 判断是否为目录 isFile 布尔值 无 判断是否为文件 6.4.5 FieMamuer接口 FileManager采用工厂化方法(是软件工程的设计模式当中的一种)负责此服务中其他接口实例的 创建,可以分别创建Path,File和Directory的实例,FileManager接口定义如表21所示 16
GB/T29811.1一2013 表21rieMaer定义 返回值/类型 参数说明 明 成 员 说 createPat山h Path path字符串,表示文件系统中的一个路径 openFile ile ftlePath;Path,代表将要被打开的文件位置 createFile File location:Path,表示将要创建的文件的路径 openDirectory Direetory dirPath:Path,代表将要被打开的目录位置 createDirectory Direetory ath:Path,将要创建的文件的路径 6.5标识(Identifrieation)服务 6.5.1服务描述 标识服务负责产生一个全局或局部的用户标识
6.5.2Id接口 Id接口定义如表22所示
表22Id定义 成 员 返回值/类型 参数说明 说明 getldString 字符串 无 获取ID的字符串 isEqual 布尔值 id:ld 判断两个ID是否相等 6.5.3IdMManager接口 ldManager接口定义如表23所示
表23IaMamuer定义 员 成 返回值/类型 参数说明 说明 创建一个id实例,如果创建过程发生错误,则抛出cetscException createld I id;字符串 通过表示d的字符串获得相应d实例,如果此d还没有实例创建,则 getld 创建一个实例 6.6日志(Logging)服务 6.6.1服务描述 日志服务可以记录其他的服务和相应的信息、事件,目的是支持整个系统的日志,从而进行系统诊 断和性能分析;如安全性、数据采集、性能、倾向分析等
6.6.2Entry接口 包括被写人日志的项目(item),以及格式类型,优先级类型和被写人日志的时间
Entry接口定义 如表24所示
17
GB/T29811.1一2013 表24Entry定义 明 返回值/类型 参数说明 员 成 说 获取格式类型 getFormatType CeltsType 可序列化对象 获取Item getltem getPriorityType CeltsType 获取优先级类型 getTimestamp 无 长整型数 获取时间截 6.6.3EntryIterator接口 Entrylterator为一组Entry提供顺序访问,每次只能访问一个
Entrylterator接口定义如表25所示 表25EntryIterator定义 员 明 成 返回值/类型 参数说明 说 hasNextEntry 布尔值 无 是否还有下一个Entry nextEntry Entry 无 取下一个Entry 6.6.4ReadableLg接口 adableLg接口定义如表28所示. ReadableLog接口对日志进行读操作
Read 表26ReadableLog定义 明 员 返回值/类型 参数说明 成 说 字符串 获取显示名字 getDisplayName getEntrie Entrylterator 以后进先出的顺序获取所有 formatType:CetsType 条目 priorityType;CeltsType 6.6.5WritableLog接口 wiabhlog接口允许对日志的条目,类型,时间截等进行写操作,共有两种追加日志的方法 writableL.og接口定义如表27所示
表27writableLog定义 成 员 参数说明 明 返回值/类型 说 appendlog entryltem:可序列化对象 追加日志 空 appendl.ogWithTypes 空 entryltem;可序列化对象 追加有类型的日志,包括其格式 formatType;CeltsType 类型以及优先级类型 priorityType;CeltsTy ype 空 assignFormatType formatType:CeltsType 设置格式类型 assignPriorityType 空 priorityType:CeltsType 设置优先级类型 字符串 getDisplayName 获取显示名字 18
GB/T29811.1一2013 6.6.6LoggingManager接口 I.oggingManager接口负责创建、删除、访问日志
Logging.Entry接口定义如表28所示
表28loggng.Entry定义 员 明 成 返回值/类型 参数说明 说 writabeL
logName:字符串 创建一个writableLog createlog Log 容 deetelog logName:字符串 删除一个日志 无 getFormatTypes Typelterator 获取这个实现的所有格式类型 getl.ogForRReading Readablelog logName:字符串 为读操作打开一个日志 为写操作打开一个日志 getl.ogForWriting Writablel.og logName:字符串 gelL.ogNamesForReadlng字符串达代器 获取所有可以读的日志的名字 无 orwitins字符申选代器 获取所有可以写的日志的名字 getlogNamesFo 无 获取所有可用的优先级类型 elterator Tu getPriorityTIypes supportsReading 无 布尔值 该方法返回值表明当前的实现 是否支持ReadableLog接口 和 L.oggingManager接口的方法: getLogForReading,getlogNames ForReading 授权(Authorization)服务 6.7.1服务描述 授权服务允许教育应用和教育服务建立和查询授权
一个授权有3个组成部分;授权的代理、授权 代理所要完成的功能,以及代理表现其功能所需限定的上下文
6.7.2Qualifier接口 Qualfier接口定义如表29所示
表29Qualifier定义 员 说 成 返回值/类型 参数说明 明 为该Qnlifer添加一个父结点 空 addParent parentQualifierld:ld 容 oldParentld;ld changeParent 改变该Qualifier的父结点 newParentld:ld 无 getChildrenm Qualiferlterato 获取该Qualifer的所有子结点 无 getDescription 字符串 获取该Qualifier的描述 ld 无 getld 获取该Qualifier的ld getParents Qualifierlterator 无 获取该Qualifier的所有父结点 获取该Qalifer的限定器类型 getQualifierType CeltsType 无 19
GB/T29811.1一2013 表29(续 明 返回值/类型 参数说明 成 员 说 字符串 获取该OwlH的附定引用各 无 getRefereneeName isChildOf 布尔值 parentld:ld 是否是结点parentld的子结点 isDescendantOf 布尔值 ancestorld:ld 是否是结点ancestorld的子孙结点 isParent 布尔值 是否有子结点 removeParent 空 arentQuaifierld;ld 移除一个父结点 updateDeseription 空 description;字符串 更新该Qualifier的描述 6.7.3 Qualirierlterator接口 Qualiferlterator为一组Qualifier提供顺序访问,每次只能访问一个
Qualifierlterator接口定义 如表30所示
表30Qualifierlerator定义 员 明 参数说明 说 返回值/类型 成 无 hasNextQualifier 布尔值 是否还有下一个Qualifier 无 nextQualifier Qualifier 取下一个Qualifier 6.7.4Function接口 Function由ld、显示名字(displayName)、描述description、类别(category)和限定器类型Qual ferType)组成
d是在外部定义的,具体实现应保证1a的唯一性
Funeion接口定义如表31所示 表31 Function定义 员 明 成 说 返回值/类型 参数说明 字符串 获取该Function的措述 getDescription CaliType 无 getFunetionType 获取该Function的类型 无 getld ld 获取该Function的ld 字符串 获取该Function的固定引用名 无 getRefereneeName 更新该Function dectpion.字符中 n的描述 updateDescription 6.7.5Funetionlterator接口 Functionlterator为一组Funetion提供顺序访问,每次只能访问一个
Funetionlterator接口定义 如表32所示
心
GB/T29811.1一2013 表32Funetionlterator定义 明 返回值/类型 参数说明 员 成 说 布尔值 是否还有下一个Funetion hasNextFunction 无 无 取下一个Function nextFunction Function 6.7.6Authorization接口 Authorization指明一个 agentld在Qualifier上下文中如何执行一个Funetion
Authorization接 口定义如表33所示 表33Authorization定义 员 明 返回值/类型 参数说明 说 成 ld 获取该Auhorization相关联的Agenld getAgentld getEffeetiveDate 长整型数 获取该Authorization的生效日期 无 getExpirationDate 长整型数 获取该Authorization的失效日期 无 getFunetion Function 获取该Authorization的Funetion 心 getModifiedBy 获取修改该Authorization的ld 长整型数 获取该Auhorization的修改日期 getModifiedDate Qualfier getQualifier 获取该Authorization的Qualifier 该 布尔值 isActiveNow Authorization 当前是否生效 无 isExplieit 布尔值 该Authorization是否显式存储,有的授权是显式 的 ,有些是隐式的 容 updateEfeetiveDate effeetiveDate: 更新该Authorization生效日期 长整型数 容 updateExpirationDate expirationDate: 更新该Authorization失效日期 长整型数 6.7.7 Authorizationlterator接口 Authorizationlterator 为一组Authorization提供顺序访问,每次只能访问一个
Authorizationlte- rator接口定义如表34所示
表34Authorizationlterator定义 明 返回值/类型 参数说明 成 布尔值 是否还有下一个Authorization hasNextAuthorization 无 无 Authorization 取下一个Authorizationm nextAuthorization 6.7.8AuthorizationManager接口 授权管理器(AuthoriationManager)允许一个应用程序创建授权(Ahorizaton),为授权设置标 21
GB/T29811.1一2013 谁,查询授权以决定一个agenld在Qualifrer上下文中如何执行一个Funei ion Authorization中的主要对象有Authorization、Funeion、agentld和Qualifer
其他对象还有 FunetionType和Qualifiertype. ld是在外部定义的,具体实现应保证ld的唯一性
有两种方法创建Authorization
一种是使用agentld,Funetion和Qualifier;另一种是添加生效日 期(effectivedate)和失效日期(expiration ndate)
如果没有生效日期和失效日期,则生效日期为当天,且 永不失效
AuthorizationManager接口定义如表35所示
表35 Authorization nManager定义 成 员 说 明 返回值/类型 参数说明 agentExists 布尔值 agentld:ld 用户是否存在 createAuthorization Authorization agentld:ld. funetionld;ld 创建Authorization aualifierldld 创建带日期的" createDatedAuthorization Authorization Authorization agentld:ld functionld;ld gualfierld:lad effeetiveDate;长整型数 expirationDate;长整型数 createFunction Function functionldld 创建 Function isplayName;字符串
description:字符串. functionType;CeltsType ualifierHierarchyld:ld ereateQualfier Qualifier qualifierld:ld 创建Qualifier isplayName;字符串、 description:字符串 qualifierType;CeltsType parentld:ld ereateRootQualifier Qualifier qualifierld;ld. 创建根Qualifer isplayName;字符串， ddescription;字符串， CcdhsTyme qalifierType; qualifierlHierarchyld:ld deeteAuthorization 空 authorization:Athorization删除Authorization deleteFunetion 空 functionld:ld 删除Functionm deleteQualifier 空 qualifierld:ld 删除Qualifier EtAINMZ 获取所有 Autlhorizationlterator Authorization agentld:ld， functionld;ld qualifierld:ld， isAetiveNowOnly;布尔值 22
GB/T29811.1一2013 表35(续 明 返回值/类型 参数说明 说 员 成 getAIAZAByFuncType Autlhorizationlterator 根据丽数类型获取所有 Au agentld:ld ecslaTye thorization functionType: qualifierld;ld isActiveNowO)nly;布尔值 EtAUrXZ公 functionldld. 获取所有用户 Authorizationlterator Authorization qualifierld:ld， 布尔值 isActiveNowOnly; tAlUserAZsByFune 根据丽数类型获取所有用 Authorizationlterator scCdlTywe get functionType; Type qualifierld:ld Authorization isAetiveNowOnly;布尔值 getExplieitAZ 获取所有显式Authorization Authorizationlterator agentld;ld. functionld:ld qualifierld;ld is.ActiveNow(Only;布尔值 getExplieitAZsByFune entld:ld 根据函数类型获取所有显 Authorizationlterator agent Type funetionType;CeltsType 式Authorization qgualifierld;ld Only;布尔值 isActiveNow( getExplieitUserAZs Authorizationlterator functionld:ld 获取所有显式用户 Autlhoriza qualifierld:ld. ionm isActiveNowOnly;布尔值 getExplieitUserAZsBy Authorizationlterator functionType:CeltsType" 根据函数类型获取所有显式 ualifetd.d. 用户 Authorization FuneType is.ActiveNow(Only;布尔值 getExplicitUserAZs Authorizationlterator implicitAuthorization: 为隐式授权获取显式用户Au Authorization ForrmplicitAZ thorization getFunetion Funetionm functionld;ld 获取Function getFunetions Functionlterator functionType:CeltsType 获取所有Function 获取所有函数类型 无 getFunctionTypes Typelterator 获取所有Qualifier Qualifier getQualifier qualifierldld getQualifierChildren Qualifierlterator 获取限定器子结点 qualifierld:ld getQualfierDescendants Qualiferlterato gqualifierld:ld 获取限定器子孙结点 无 getQualifierHierarehies Idlterator 获取限定器层次结构 无 getQualifierTypes Typelterator 获取所有限定器类型 getRootQualifiers gualifierHlierarchyld:ld 获取所有根限定器 Qualifierlterator 用户是香能在某上下文执行 dterator getwhoCanDo unetionldld. gualifierld:ld 某丽数 23
GB/T29811.1一2013 表35(续 成 员 说 明 返回值/类型 参数说明 isAuthorized 布尔值 agentld:ld 是否授权 functionldld qualifierld:ld isUserAuthorized 布尔值 functionld:ld 用户是否授权 qualifierld:ld 无 supportsDesign 布尔值 是否支持设计,即是否支持以 下方法 createFunetion. deleteFunction supportsMaintenance 布尔值 无 是否支持维护,即是否支持以 下方法 createAuthorization createDatedAuthorization， createQualifier createRootOualifier
Authorization
etFunctionIypcs getQuaifierChildren. getQualifierDescendents getQualifierHIierarchies getQualifierTypes getRootQualifiers., getwWhoCanDo 6.8工作流(worklow)服务 6.8.1服务描述 工作流服务支持学习过程的自动控制,允许定义一组过程规则,并通过一定数量的参与人员和支撑 系统加以执行
6.8.2 sion接口 Expreshi ssion标识一个在工作步被执行之前应满足的输人条件
Expression接口定义如表36所示
Expres 表36Espressio定义 员 明 成 返回值/类型 参数说明 说 无 getDescription 字符串 获取该Expression的描述 getDisplayName 无 字符串 获取该Expression的显示名字 getType CetsType 无 获取该Expression的类型 24
GB/T29811.1一2013 6.8.3Epressionlterator接口 Expressionlterator为一组Expression提供顺序访问,每次只能访问一个
Expressionlt tterator 接 口定义如表37所示
表37Espressionlterator定义 员 明 成 返回值/类型 参数说明 说 无 hasNextExpression 布尔值 是否还有下一个Expression nextExpression Expression 无 取下一个Expressionm 6.8.4Step接口 工作步(sep)是进醒(Proes)中的关键元素
Processes 由若干个Step组成
一个Step包括与 其他Step的连接,输人条件和输出状态
Step接口定义如表38所示
表38step定义 成 员 返回值/类型 参数说明 说 明 addPredecessor 空 stepld;ld 获取前驱Step 无 getDescription 字符串 获取描述 无 getDisplayName 字符串 获取显示名字 获取Ial ld getld 无 获取输人条件 getInputConditions Expressionlterator 字符串迭代器 获取输出状态 get(OutputStates 无 getPredecessors Steplterator 获取所有前驱 心 无 getRoleld 获取与此Step相关联的角色ld getSuccessors Steplteraton 无 获取所有后继 无 isInitial 布尔值 该Step是否为Process的第一 isTerminal 布尔值 无 该Sitep是否为Process的最后 移除前驱 removePredecessor 空 stepa,d 容 description;字符串 更新描述 updateDes escriptionm updateD)splayName 空 isplayName;字符串更新显示名字 updatelnputConditions 空 inputConditions: 更新输人条件 Expression updateOutputStates 空 outputStates 更新输出状态 字符串数组 空 updateRoleld roleld:ld 更新角色ld 6.8.5Steplterator接口 Steplterator为一组Step提供顺序访问,每次只能访问一个
Steplter 接口定义如表39所示
erator 25
GB/T29811.1一2013 表39seplterator定义 成 员 参数说明 明 返回值/类型 说 布尔值 是否还有下一个step hasNextStep 无 取下一 nextStep Step 无 一个Step 6.8.6workEvent接口 个workEvent是Step的一个输出状态,与一个 Agent和时间戳相关联
workEvent接口定义 如表40所示
表40workEvent定义 员 成 返回值/类型 参数说明 说明 getAgentld 无 ld 获取执行该事件的用户ld getOutputState 字符串 无 获取输出状态 getStep Step 获取Step 长整型数 获取该事件发生的时间截 getTimestamp 6.8.7workEventlterator接口 workEventlterator为一组workEvent提供顺序访问,每次只能访问一个
workEventlterator接 口定义如表41所示
表41workEventlterator定义 员 明 成 返回值/类型 参数说明 说 hasNextworkEvent 无 是否还有下一个workEvent 布尔值 nextWorkEvent workEvent 无 取下一个WorkEvent 6.8.8work接口 work是Step的集合,与一个或多个角色相关联
work接口定义如表42所示
表42Work定义 员 明 返回值/类型 参数说明 说 成 字符串 获取描述 getDescription getDisplayName 字符串 获取显示名字 无 getHistory WorkEventlterator 获取历史 心 无 getld 获取ld getNextSteps Steplteraton 无 获取所有角色的后继Step 获取某角色的后继step getNextStepsForRole Steplterator roleld:ld 26
信息技术学习、教育和培训学习系统体系结构与服务接口第1部分：抽象框架与核心接口GB/T29811.1-2013
信息技术对于现代教育的发展和推动起到了举足轻重的作用，信息技术学习、教育和培训学习系统的建设成为了当今社会的一个重要课题。在这样的背景下，信息技术学习、教育和培训学习系统体系结构与服务接口第1部分：抽象框架与核心接口GB/T29811.1-2013应运而生。
作为一个基于标准化的技术规范，GB/T29811.1-2013定义了信息技术学习、教育和培训学习系统的体系结构和服务接口，为各类应用程序提供了统一的调用方式和数据格式。这对于信息技术学习、教育和培训学习系统的开发、维护和管理都有着重要的意义。
在GB/T29811.1-2013中，抽象框架是信息技术学习、教育和培训学习系统的核心部分，它定义了系统的组成、功能和相互关系。其中包括了系统的基本组件：用户界面（UI）、业务逻辑层（BLL）和数据访问层（DAL），以及系统的主要功能模块：用户管理、课程管理、测验管理等。而核心接口则是系统不同模块之间互相调用的约定，它规定了数据传输格式、方法参数、返回值等细节。
通过GB/T29811.1-2013的引入，信息技术学习、教育和培训学习系统的开发者可以依照标准化的方式进行开发，从而保证了系统的可靠性、稳定性和可扩展性。同时，这也促进了信息技术的普及和应用，推动了教育行业的数字化转型。
总之，信息技术学习、教育和培训学习系统体系结构与服务接口第1部分：抽象框架与核心接口GB/T29811.1-2013是信息技术学习、教育和培训学习系统的重要标准，它为系统的开发、维护和管理提供了统一的规范和标准。
