ICS35.100.05 L79 中华人民共和国国家标准 GB/T32419.1—2015 信息技术 SOA技术实现规范 第1部分:服务描述 Informationtechnology—SpecificationforSOAtechnicalimplementation— Part1:Servicedescription 2015-12-31发布 2017-01-01实施 中华人民共和国国家质量监督检验检疫总局 中国国家标准化管理委员会发布目 次 前言 Ⅲ ………………………………………………………………………………………………………… 1 范围 1 ……………………………………………………………………………………………………… 2 规范性引用文件 1 ………………………………………………………………………………………… 3 术语和定义 1 ……………………………………………………………………………………………… 4 服务描述元素分类 1 ……………………………………………………………………………………… 5 基本描述 1 ………………………………………………………………………………………………… 5.1 综述 1 ………………………………………………………………………………………………… 5.2 服务标识符 1 ………………………………………………………………………………………… 5.3 服务名称 1 …………………………………………………………………………………………… 5.4 服务基本说明 2 ……………………………………………………………………………………… 5.5 服务分类 2 …………………………………………………………………………………………… 5.6 服务版本号 2 ………………………………………………………………………………………… 5.7 服务注册日期 2 ……………………………………………………………………………………… 5.8 服务提供者信息 2 …………………………………………………………………………………… 6 功能描述 2 ………………………………………………………………………………………………… 6.1 综述 2 ………………………………………………………………………………………………… 6.2 外部功能 2 …………………………………………………………………………………………… 6.3 消息 3 ………………………………………………………………………………………………… 6.4 内部特性 3 …………………………………………………………………………………………… 6.5 实现特性 3 …………………………………………………………………………………………… 7 非功能描述 4 ……………………………………………………………………………………………… 7.1 综述 4 ………………………………………………………………………………………………… 7.2 服务粒度适合性 4 …………………………………………………………………………………… 7.3 松耦合性 4 …………………………………………………………………………………………… 7.4 可复用性 4 …………………………………………………………………………………………… 7.5 可扩展性 4 …………………………………………………………………………………………… 7.6 互操作性 4 …………………………………………………………………………………………… 7.7 可用性 4 ……………………………………………………………………………………………… 7.8 可管理性 4 …………………………………………………………………………………………… 8 统计特性描述 4 …………………………………………………………………………………………… 8.1 综述 4 ………………………………………………………………………………………………… 8.2 服务访问次数 5 ……………………………………………………………………………………… 8.3 服务访问频率 5 ……………………………………………………………………………………… 8.4 日/周/月最高访问量 5 ……………………………………………………………………………… 8.5 成功服务次数 5 ……………………………………………………………………………………… ⅠGB/T32419.1—2015 前 言 GB/T32419《信息技术 SOA技术实现规范》拟分为以下部分: ———第1部分:服务描述; ———第2部分:服务注册与发现; ———第3部分:服务管理; ———第4部分:数据服务接口; ———第5部分:服务集成开发; ———第6部分:服务交互通信; ———第7部分:服务编制; ———第8部分:身份管理服务。 本部分为GB/T32419的第1部分。 本部分按照GB/T1.1—2009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本部分由全国信息技术标准化技术委员会(SAC/TC28)提出并归口。 本部分起草单位:北京航空航天大学、中国电子技术标准化研究院、中国人民解放军后勤学院、北 京大学、中国软件评测中心、上海普元信息技术有限公司、北京东方通科技股份有限公司。 本部分主要起草人:赵永望、马殿富、袁媛、王潮阳、董建、杨云、赵俊峰、孟晓、钱军、徐宝新、田忠。 ⅢGB/T32419.1—2015 信息技术 SOA技术实现规范 第1部分:服务描述 1 范围 GB/T32419的本部分给出了服务描述元素的分类及说明。 本部分适用于SOA应用的设计、开发、运行和维护。 本部分是制定具体SOA应用的技术实现标准、质量测评标准及工程标准的依据。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文 件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 GB/T29262 信息技术 面向服务的体系结构(SOA) 术语 3 术语和定义 GB/T29262界定的术语和定义适用于本文件。 4 服务描述元素分类 服务描述元素可分为4种类型: a) 基本描述; b) 功能描述; c) 非功能描述; d) 统计特征描述。 注:本部分给出的服务描述元素不是完备的,可根据实际的使用情况进行扩展或限定。同时,本部分具体使用时, 可根据实际情况剪裁使用。 5 基本描述 5.1 综述 服务的基本描述是指服务的基本属性。基本描述应包含服务标识符、服务名称、服务基本说明等元 素,可包含服务分类、服务版本号、服务注册日期和服务提供者信息等元素。具体使用时,可对服务的基 本描述进行扩展。 5.2 服务标识符 在给定的命名空间中唯一的标识,用以确定一个服务。服务标识符应符合组织的命名规范。 5.3 服务名称 由组织正式公布的服务的名称,服务名称应包含一定的意义,能够从服务名称中了解服务的作用或 1GB/T32419.1—2015 者功能。 5.4 服务基本说明 对服务进行描述的一段文本说明。 5.5 服务分类 描述服务所在的分类,分类信息应包含服务的分类名称、分类法、分类编码及类别值。 注:分类可参考GB/T4754—2002、联合国标准产品与服务分类代码UNSPSC等,具体应依据应用特征进行选择。 5.6 服务版本号 服务版本的标识号。 注:服务的一个版本代表了一个服务的功能集。 5.7 服务注册日期 服务在注册中心注册/发布的日期。 5.8 服务提供者信息 服务提供者的详细信息,可包含提供者名称、提供者类别、提供者电话、提供者地址、提供者传真、提 供者网络访问地址、提供者Email等。 6 功能描述 6.1 综述 服务的功能描述指服务的外部和内部功能特性。功能描述应包含外部功能、消息、实现特性,也可 包含内部特性。具体使用时,可对服务的功能描述进行扩展。 6.2 外部功能 6.2.1 综述 外部功能应包含服务功能名称、输入参数、输出参数和故障,也可包含服务功能说明、前置条件和后 置结果。 6.2.2 服务功能名称 服务对外提供的功能的名称。 注:一个服务对外可提供多个功能(接口)。 6.2.3 服务功能说明 对服务功能的一段文本说明。 6.2.4 输入参数 一个服务功能被调用时,对外可接受的参数及类型。输入参数可以是0个、1个或者多个。输入参 数的类型应符合服务实现技术相关的类型定义,如Web服务的输入参数应符合XMLSchema定义的 类型。 2GB/T32419.1—2015 6.2.5 输出参数 服务返回给服务使用者时,返回的参数及类型,输出参数可以是0个、1个或者多个。输出参数的 类型应符合服务实现技术相关的类型定义,如Web服务的输入参数应符合XMLSchema定义的类型。 6.2.6 前置条件 服务被调用之前,必须满足的前提条件。 6.2.7 后置结果 服务被调用之后,产生的结果。 6.2.8 故障 服务执行过程中可能产生并返回给服务使用者的故障,故障信息应包含故障编码、故障名称及 描述。 6.3 消息 6.3.1 综述 服务的消息描述应包含消息结构和消息交换模式。 6.3.2 消息结构 服务使用者和服务提供者之间传递消息的结构,需独立于特定的编程语言和运行平台。 6.3.3 消息交换模式 指服务使用者和服务提供者之间传递消息的模式,常见的有如下4种: a) 请求/响应; b) 单向;