地理信息+目录服务规范.pdf

i c s0 7 0 4 0 ；3 5 2 4 0 7 0 a7 5 蝠亘 中华人民共和国国家标准化指导性技术文件 g b z2 5 5 9 8 2 01o 地理信息目录服务规范 g e o g r a p h i ci n f o r m a t i o n c a t a l o g u es e r v i c es p e c i f i c a t i o n 2 0 1 0 1 2 0 1 发布 2 0 11 0 3 0 1 实施 中华人民共和国国家质量监督检验检疫总局岩寿 中国国家标准化管理委员会仅1 1 1 目次 前言 1 范围 2 规范性引用文件 3 术语和定义及缩略语- - 3 1 术语和定义 3 2 缩略语- 4 目录服务模型 4 1 概述 4 2 功能模型- 4 3 信息模型- 4 4 接口模型 4 5 消息协议 5 目录服务接口定义- 5 1 公共接口 5 2 发现接口- 5 3 管理接口 附录a ( 资料性附录)与i s 02 3 9 5 0 ：1 9 9 8 的关系 附录b ( 规范性附录) 一致性测试要求 附录c ( 规范性附录)目录服务接口x m ls c h e m a 描述 附录d ( 资料性附录)目录服务属性集编码规则 附录e ( 资料性附录) 检索串示例 参考文献 g b z2 5 5 9 8 2 0 1 0 1 ，1 2 2 2 2 2 2 3 3 3l蛊卯跎强盯 刖暑 g b z2 5 5 9 8 2 0 1 0 本指导性技术文件的附录a 、附录d 和附录e 为资料性附录，附录b 和附录c 为规范性附录。 本指导性技术文件由国家测绘局提出。 本指导性技术文件由全国地理信息标准化技术委员会( s a c t c2 3 0 ) 归口。 本指导性技术文件主要起草单位：国家信息中心、武汉大学、中国标准化研究院。 本指导性技术文件主要起草人：徐枫、宦茂盛、常娜、石雯雯、王子亮、龚健雅、高文秀、李小林。 地理信息目录服务规范 g b z2 5 5 9 8 2 0 1 0 1 范围 本指导性技术文件规定了建立地理信息目录服务的技术要求，包含目录服务模型和目录服务接口 定义。 本指导性技术文件适用于地理信息元数据的发现和管理，以及地理信息目录服务系统的设计和 建立。 2 规范性引用文件 下列文件中的条款通过本指导性技术文件的引用而成为本指导性技术文件的条款。凡是注日期的 引用文件。其随后所有的修改单( 不包括勘误的内容) 或修订版均不适用于本指导性技术文件，然而，鼓 励根据本指导性技术文件达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用 文件，其最新版本适用于本指导性技术文件。 g b t1 7 6 9 4 2 0 0 9地理信息术语( i s 0 t s1 9 1 0 4 ：2 0 0 8 ，i d t ) g b t1 9 7 l o 一2 0 0 5地理信息元数据( i s 01 9 1 1 5 ：2 0 0 3 ，m o d ) i s 02 3 9 5 0 ：1 9 9 8 信息和文献信息检索( z 3 9 5 0 ) 应用服务定义和协议规范 3 术语和定义及缩略语 3 1 术语和定义 下列术语和定义适用于本指导性技术文件。 3 1 1 地理信息资源 g e o g r a p h i ci n f o 珊a t i o nr 酷o u r s e 能满足某种需求的地理信息相关的资产或手段。 3 1 2 目录服务c a t a l o g u es e r v i c e 提供地理信息资源描述信息发现和管理功能的服务。 3 1 3 操作o p e n t i o n 对象可以被调用执行的转换和查询的规范。 注：一个操作包括名称和一系列参数。 g b t1 7 6 9 42 0 0 9 ，定义b 3 3 2 3 1 4 接口 i n t e r f a c e 描述实体行为特征的命名操作集合。 g b t1 7 6 9 4 2 0 0 9 ，定义b 2 6 0 3 1 5 状态s t a t e 持续数据对象，反映某一对象在给定时间的所有成员属性的内部值或可量测的描述。 注：状态通常与对象的标识和对象的时间戳记相关。 g b z2 5 5 9 8 2 0 1 0 3 1 6 元数据m e t a d a t a 关于数据的数据。即数据的标识、覆盖范围、质量、空间和时间模式、空间参照系和分发等信息。 g b t1 9 7 1 02 0 0 5 ，定义4 5 3 2 缩略语 c l p 目录互操作协议( c a t a l o g u ei n t e r o p e r a b m t yp r o t o c 0 1 ) o g c开放地理信息联盟( o p e ng e o s p a t i a lc o n s o r t i u m ) s r u通过u r l 检索提取( s e a r c h r e t r i e v a lv i au r l ) x m l可扩展标记语言( e x t e n s i b l em a r k u pl a n g u a g e ) 4 目录服务模型 4 1 概述 目录服务模型包括功能模型、信息模型、接口模型和消息协议四个层面的内容。 功能模型用于限定目录服务的服务范围，信息模型用于限定目录服务管理的数据，接口模型用于规 定目录服务的服务手段，消息协议规定目录服务的交互形式。 4 2 功能模型 目录服务提供发现和管理两种基本功能( 如图l 所示) ：发现功能用来对元数据进行检索，管理功能 实现元数据管理。 图1目录服务的功能模型 该功能模型与i s o2 3 9 5 0 ：1 9 9 8 的关系参见附录a 。 4 3 信息模型 目录服务信息模型用于描述目录提供的地理信息资源，其具体体现即地理信息元数据。 地理信息元数据应遵照g b t1 9 7 1 0 一2 0 0 5 ，对于特定领域内的地理数据资源，可在g b t1 9 7 1 0 一 2 0 0 5 的基础上制定专用标准。 4 4 接口模型 目录服务包含有三个主要接口：公共接口、发现接口和管理接口。其中，公共接口是将发现接口和 管理接口中基础性的操作定义成一个公有接口，在使用发现接口和管理接口时需要先对服务进行初始 化，接着通过服务自描述接口对发现接口和管理接口进行描述，完成目录查询和元数据管理之后，再调 用目录服务终止接口，结束一次目录服务的操作。这三类接口共同实现了地理信息资源的发现功能和 管理功能。 a ) 公共接口 提供会话管理功能和服务自描述功能，包含目录服务初始化接口、目录服务终止接口和服务自描述 接口。 目录服务的客户端和服务器端的通讯建立在会话基础上，会话通过请求消息和响应消息来完成，每 2 g b z2 5 5 9 8 2 010 一个请求消息都有相对应的响应消息。 b ) 发现接口 提供元数据检索功能和元数据检索结果提取功能，包括目录检索接口以及目录检索结果提取接口。 c ) 管理接口 提供元数据管理的功能，包括元数据的增加、删除和修改。 4 5 消息协议 目录服务各个接口操作均是通过客户端和服务器端之间传递的请求响应消息对来实现。请求消 息和响应消息是一一对应的，即对每一个请求消息有且只有一个响应消息产生。 本指导性技术文件规定的目录服务可通过h t t p 协议方式实现，协议消息使用x m l 编码，本指 导性技术文件的将来版本可提供支持其他协议方式的接口。 5 目录服务接口定义 凡遵照本指导性技术文件设计并实现的目录服务，应满足附录b 中的一致性测试要求。 5 1 公共接口 5 1 1 目录服务初始化( i n i t c a t a l o g u e s e r v i c e ) 5 1 1 1 概述 目录服务初始化接口用来建立客户端和服务器端之间的会话，该操作将产生唯一的标识符用来跟 踪会话。 5 1 1 2 目录服务初始化请求( i n i t r e q u e s t ) 目录服务初始化请求消息用来请求建立客户端和服务器端之间的会话，其参数如表l 所示。 表1 初始化请求参数表 参数名称约束条件 参数含义 客户端支持的协议实现版本。由客户端在请求中指出其支持的所有版 o r o t o c o i v e r s i o n 丑 必选本，服务器端在响应中也同样指出其支持的所有版本。会话将以双方都支 持的最高相同版本实现。如果没有相同所支持的版本，则初始化被拒绝 认证信息，包含用户身份标识及其密码，用于服务器端对用户身份进行 i d a u t h e n t l c a t i o n 6 可选 验证 i m 口l e m e n t a t l o n i d 可选客户端实现标识，由目录服务实现厂商自行定义 l m p l e m e n t a t i o n n a m e可选客户端实现名称，由目录服务实现厂商自行定义 i m p l e m e n t a t i o n v e r s i o n 可选客户端实现版本，由目录服务实现厂商自行定义 o t h e r i n f 0可选其他信息，用于客户端和服务器端传递自定义信息 8 版本参数p r o t o c o l v e r s i o n 由1 或多个正整数组成，各个正整数之间由逗号分隔，其形式为“l ，2 ”。 b 认证信息i d a u t h e n t i c a t i o n 参数中的用户身份标识及其密码之间用冒号分开，其形式为“u s e r i d ：p a s s w 。r d ，。 “目录服务初始化请求”的组成结构如图2 所示。 l j一_ * 0 喊 。 女w * * m - - ； m u t k m 龃n 。n i “镕 ? 唧h 1 m i ，竺竺l 斟阿 # p 女m # m 一? w m m m i # p # 女e g # ：5州”瑚m w 、 i # p 女目$ 一量三五：】 # m 自t i 口自 图2目录服务初始化请求的模型圈 请求消息的x m ls c h 定义片段如下( 完整的x m ls c h 定义见附录c ) l 一粪女标符”i n l t 8 掣t 白勺r 一) x s d ：e l 删= ”i n l t r 叫t ”t ”l n l t r 删t 1 卸e ”) t x s d - 删a t l o n ( x s d ；d n t a t 一) 目i 务自始化请球( x s d ：e n t a t 一 ( x s d - 删a t 一) x s de l x s d + 一p 1 “t 卵= ”1 m t r 删t 即驴“ t x s d c a t l o n ) ( x s d - d n a t 一) 目i 务韧始化请求的粪定r 。c x 鲥6 t a t l o n ) ，x s d o o n ， ( x s d 一e ) ( x s d ：e l 州r e f = ”p 帆o l v e r n n ) ( x s d e l 咖= ”1 蚴e a t l ”o c = ”0 ”) t x s d - a t 一) x s d ：d 。c 衄曲t a t l o n “证信自( x s dd o c t a t l 。n ， x s d ：吣t l o n ) l ，一：一， ( 船d - e 1 “1 叩l 吣t l o n i d ht 嬉e = ”x s d ；s h l n g “ 蛐= ”o ”) x s d m 呲a t l o n ( x s dd t a t l o n ) # p 端；# 识( x s d ：d 。c 叽t a t 一 x s d ：a t l o n ) ( de l t ) x 5 de l 一= “1 1 p l t a t l m e 什t “x 8 ds t r l 凹”。c 2 ”0 ” ( ”d a t l o n ) ( x s d ：d 。c m t l o 兀、g p 端实现名称x 州：d t a t 一) ( x s da 1 0 n ) ( x 日d ：e l n t ) g b z2 5 5 9 8 2 010 ( x s d ：e l 锄e n tn a 鹏2 “1 p l 锄e n t a t i o n v e r s l 。n ”t y p e = ”船d ：s t r l n 矿m i n o c c u r s2 “o ”) ( x s d ：a n n o t a t i o n ( 船d ：妇叫e n t a t i o n ) 客户端实现舨本( 船d ：d o c u m 印t a t i o n ) ( x s d ：e l e m e n t ) ( x s d ：e l 锄tr e f = ”o t h e r i n f o ”m i n o c c u r s = “o “) ( x s d ：s e q u e n c e ) ( x s d ：c 伽p l e x t y p e ) ( ! 一类型标识符”p r o t o c o l v e r s i 。n ”的定义一 ( x s d ：e l 锄e n tn 柚e = ”p r o t o c o l v e r s i o n ”t y p e = ”x s d ：s t r i n g ”d e f a u l t = ”l ”) x s d ：a n n o t a t i o n ) ( x s d ：d o c u e n t a t i o n 协议版本，本实现对应的协议版本 ( x s d ：d t a t l o n ) 目r 服* 自镕m 目女定i 。( x 5 d ：l a t ( x s d 删a t l o n c x 5 d - e m e ( x s d ：e 1 tr “；”r e f c e id n ) ( 骞散r e f e i d g 自 z ，n z 、o 一9 目# 他 符# 。一) ( x s d ；e l 酬r e f = ”p o t o c o l ”e r 8 1 0 n ” ( x s d ：e l 帅e = “r e s u l r t 弹8 = “x s d b o l e “ x 蛐t 一) 话建i 镕* ( 船d ：d e n t a t l o m ( x 8 d a t 一) ( x s de l t ) i 一参mr e s u l t r 值女日m 女。“t “e ”m 建女会话成自，“f a l s e ”表i 建i 会失败n h r e c e i d r * i 。一) ( x s d ：e l t m e = “1 1 p 1 一t a t i d n t “ e 2 “x s ds t r l t 】g ”蛐= ”o “) ( x 州- a 1 0 n ( x s d ：d t a t l ) m 务端宴日标* x 5 d ：蛐n t n ( x 5 d 删a t l o n ) ( x s d - e ( x s d ；e l 一“1 ”p t a t e ”t y 睥。”x s ds t r l “9 1 眦s 。“0 1 ) 6 x s dm t l ) c x s d t a t 一) 噩务端实目名称x s dd o c 删a ) ( x s d ：a m ) ( x s d - e 1 一t ) ( x 5 d ：e l 虬= “p l 衄锄t a t l 。n v e r n 1t y p e = “船d ：5 t “田1 一“0 1 ( x s d t a t l 硼) ( x s d ：t a 【l o n ) 服舟端实m 版车x s d ：t a t l 。n ) ( x s d ：t a t l o n ) ( x s d - 幽e n t ) ( x s d e 1 锄“ tr “= “o 口i n f o ”m 1 咄= “0 “) ( f 一其他信息月f 客户端# 服务# 端传递自定r 信自。一e 发异常，使月本参数传递详的异常信 息给g 户端。一) ( x s d ：c e ) ( x s d ：c 0 1 p 1 目蛳) 512 目录服务终止( c l o s e c a t a i o g u e s e 州i c e ) 5 121 概述 目录服务终止接口用来终止客户端和服务器端之间的当前会话。 5 22 目录服务终止请求( c j o * r e q u b t ) 目录服务终止请求消息用来申请终止当前的会话该请求消息从客户端发送到目录服务器端，当月5 务器端收到该消息，目录月务器将执行终止操作，停止该会话的所有进程。目录服务终止请求的参数如 表3 所示。 表3 终止请求参数表 参数名杵 月f 识别一个请求所自动* 镕# m ，口话镕* # p 端t m 女挺供g 月 日t其他信息月十g p 端自* # 传4 自r 信e 。参数r e f n c e i d 表i 会话标* 是自a 也az 、og 目，其他 # 无# 。 “目录服务终止请求”的组成结构如图4 所示 围4 且录服务终止请求的模型圈 请求消息的x m ls c h 定义片段如下( 完整的x m ls c h e m a 定义见附录c ) 1 一类目标* 符”c l e 8 e 叩e s t “ 定r 一) x g d ：e 1 e = 1 c l r 。掣8 s t ”t ”c l 一知掣8 s t t y p e “ ( x s d o t a t l o n ) c 日z2 5 5 9 8 2 0 f o ( x s d ：o n ) 目i 股* 终a 请$ 。( ”d d 洲a t l 口n ) ( s d u t - o n ( ，x s d - e l t ) ( x 鲥：c 锄p 1 嘲洲2 2 ”c l 。s “e 舭“ t t 挣e n ) ( x - 一) ( x s dd 协t 一) 目t 务终t 请求的娄女定r 。，船d ：6 。c 州蛐) ( x s d ：硼。t a t ) ( x s d ：c e ( x s de 1 tr e f = 1 r e f e i d l ) f 砧de l e = c i 。s 酿“”埘d s 扛1 n r 1 呻0 ”) ( x s d 删a t l ) c x s d ：d n t a t l 蜘) 终m 目( x s d 蛐n l a ) ( x s d a ) x s d - e l t ) ( x s de l 曲郫tr “= o t h i n f o ”血= “0 ”，) x s d ) x s d ：一p l e 订弹。) 512 3且录服务终止晌应( c j 惦e r 洲) 目录服务终止响应消息请求服务器端返回目录服务终止响应其参数的具体说明如表4 所示 表4 终止响应参数表 “目录服务终止响应”的组成结构，如图j 所示 c l 雠r q “州 f 三三二亭埏i 兰匹：j ； “”i 一一! 竺竺一- ； 图5目录服务终止响应的模型圈 请求消息的m ls c h 定义片段如下( 完整的x m ls c h 定义见附录c ) ： ( t 一女镕* # 1 c 1 口s e r e 8 口一”窟r ( 。s d ：e e = “c l 。g 印e s p o “s e ”t 搿41 “o s e r e s p 一咖f ) t x 5 a - a ， ( x $ d ：d b t 一) 目i m 舟终m 响应。( x s d ：蛐n t a t i 。n ) t ，x s a a ， 、，x g d 、dc 0 p j 似t 扭n a = ”c j o 幽p o n s e 哪e ” ( x s d t a t l o n ， x s d ：d 删a ) 日i 女终t 自类g 定义。x s dd 协t l o n ) ( x s dm t ) x 3 d e | 】c e ) x 5 d ：e = ”c l o s b t a t 口s ”t y 计。“h ds t 一”帆= ”0 。) ( x 日d e a t l o n ) ( x s dd 删a t l 。n ) 镕止会话状女( x s d ：蛐t a t l ) c x s d t a t l ) ( x s d - t ( 参数d 蛐r 值为“目腻e s s ”表 * 目舍* 墟自 “叫蚶表i * 目话* r x s d ；啪c “ x s d ：c o 9 l e r ”e ) 513 目录服务自描述( c a t a l o g c a p a b j m i e s ) 5131 概谜 目录服务自描述接口用来提供目录服务自身的各种描述性信息。 513 2 目录服务自描述请求( t a j o g c 4 p a b i l i t i 嚣3 e q u 始t ) 目录服务自描述请求消息由客户端产生并发送到目录服务器，用来请求目录服务的相关描述信息 其参数定义如表j 所示。 表5目录服务自描谜请求参数表 参数名称约束条件寥投含义 月f 识别千请求所启动的操作的标* ，目会话标识 其m 信自月f # p 端自服* # 传递自r 义信息 “参数r e f e r e n c e l d 丧i 的会* 标m b 自a _ z az 、o9 目皿，其他 # 无* “目录服务自描述请求”的组成结构如图6 所示 闰6目录服务自描述请求的模型图 “目录服务自描述请求”的x m ls c h 定义片段如下( 完整的x m ls c h e m a 定义见附录c ) ： 1 一女镕识# ”c a t a i “i i t 、e s r 哪t 什女) n d d 蛐= 。c a 叫础n l t l r 自e s t ”b 伴= ”n l 啦盥“1 1 唧吼船”) ( x “a t l ) x s d ：棚e n t a t 一 目i 服女自镕镕请求 ( x s d ：d 口c 酬a t i o n ) l x s d t a t ) ( x s d - e n t ) ( x s d p m = ”c a l a l 。g o p 曲1 l l l l e s r 删t 靴”) ix s da t 一， ( x s d ：d n t a t l ) 目 务自描请求类r 。x s d6 t a t l o n ) x s d - a ) ( x s d - 一) ( x 5 d - e f = ”r e f e e i d x 日d ：e 1 f = ”o n f o “姚u 5 = 0 “) ( x $ d ：c e ) ( x s d p l m “ e ) 513 3目录服务自描谜响应( c a h l 帕p a b j l i t i 器r p o s e ) 接收到客户端的目录服务自描述请求后，服务器端产生目录服务自描述响应消息，再通过该响应返 回给客户端各项目录服务自描述信息。 “目录服务自描述响应”的参数定义如表6 所示。 g b z2 5 5 9 8 2 010 表6 目录服务自描述响应参数表 参数名称约束条件参数含义 r e f e r e n c e i d i 必选用于识别一个请求所启动的操作的标识，即会话标识 d a t a b a s e l i s t 5 必选用来返回目录服务关联的一个或多个元数据库信息列表 功能选项，用来描述服务所支持的各项功能，包含有目录服务初始化、目录服 务终止、服务自描述、目录检索、目录检索结果提取、元数据管理功能。由客户 必选 端在请求中建议目录服务需要提供的功能，服务器端根据自身的实现情况决定 提供哪些功能 s e r v i c e n a m e 6 必选用于说明服务名称，由目录服务实现厂商自行定义 s e r v i c e a b s t r a c t 必选服务内容的简单说明，由目录服务实现厂商自行定义 s e r v i c e i d 。必选 服务的唯一标识。由服务注册机构统一分配 s e r v i c e p r o v l d er f 必选用来说明服务的提供者信息，由目录服务实现厂商自行定义 s e r v i c e u r l 8 必选用来说明服务的网络地址，由目录服务实现厂商自行定义 s e r v i c e t y p e “ 必选用于说明服务所属类型，由目录服务实现厂商自行定义 o t h e r i n f o 可选 其他信息，用于客户端和服务器端传递自定义信息 8 参数r e f e r e n c e i d 表示的会话标识是由a _ z 1a _ z 、o 一9 组成，其他字符无效。 6 参数d a t a b a s e l i s t 是复合型，包含有元数据库标识( d a t a b a s e i d ) 、元数据库名称( d a t a b a s e n a m e ) 、元数据库描述 ( d a t a b a s e d e s c r i b e ) 等主要信息。详细内容见表8 ：“元数据库d a t a b a s e 参数表”。 。参数o p t i o n s 的取值是枚举型，可以包含一个或多个功能参数值，诸如i n i t 、c l o s e 、c a p b i l i t i e s 、s e a r c h 、p r e s e n t 、 m e t a d a t a m a n a g e 。具体参见“服务自描述响应”的x m ls c h e m a 定义。 4 参数s e r v i c e n a m e 的默认取值“地理信息目录服务”。 。参数s e r v i c e i d 的标识符须唯一，由字母( 含下划线“一”、短划线“、点“”) 或数字组成，一般由系统自动随机产 生。诸如c a t a l o g s e r v i c la 0 0 0 3 4 v g 3 4 7 。 1 参数s e r v i c e p r o v i d e r 是复合型，只需要包含一个参数s e r v i c e p r o v i d e r n a m e ，表示提供服务的地理信息共建部门 名称。 8 参数s e r v i c e u r l 的形式为h t t p ：1 9 2 1 6 8 o o ：8 0 8 0 c a t a l o g c a t s e r v i c e 。 “参数s e r v i c e t y p e 的固定取值为“c a t a l o g s e r v i c e ”。 1 0 “目录服务自描述响应”的组成结构，如图7 所示 m n t d a h 9 ” 巨= = = l j 喜# m l “目m ：蕊 巫互扫琶蟹哥卅再暮硼 “2 ； 一* 。； l ! 黑羔。 i m * $ # 4 亚j “、忡蛳，r b h ：= t 五四 t 互型卫 e 卫 * # m f 1 ，f 号兰粤p 驾_ 五四 & * u r l j 卫 女g 专出= i # 自x 镕n 图7目录服务自描述响应的模型国 “目录服务自描述响应”的x m ls c h 定义片段如下( 完整的x m ls c h 定义见附录c i 一类标* 符”c a t a l 。g 白p 曲1 l n l e 5 8 叩一“z 一 x s d ：e 1 = c a t a l 睥b l l l t l e s 睡s p o n s e ht y 畔= ”c a t a l 。g 凸p 曲i 1 1 一r 叩一船” t x s d a t 一， x s dd 。c 删a t 一) 目i 服务自描述响应( x s d ：d n t a t 一) x e d t a t 一) ，x s de l t ) x s dc 椰p l e 灯e = 1c a e a 】 x s d a t 一 ( x s d ：d 删a t l ) 目i 服* 自描e 响的类! 定r 。x s d ：d t a ，x s d a t l o n ， h d ：啪唧c e ， x s d e l 伽目tr “= “r e f c e i d n ) x s d ：e l 州”蛐s 吐1 s t ”t “d a h h s 吐1 s t 船“) ( x s d t 一 c x 州t a t l ) i 散据库表t x s d ：d 一僦1 们) ( x s da | m t l o n ) ( x 5 d ：e l ) ( x s d ：山e f = 1 。p s “) g b z2 5 5 9 8 2 0 1 0 x s d ：e l 锄e n t 咖e = ”s e r v i c e n 柚e ”t y p e = ”船d ：s t r i n g ”d e f a u l t = ”地理信息目录服务”) ( x s d ：a d n o t a t l o n ) ( x s d ：d o c l 】m e n t a t i o n ) 服务名称x s d ：d o c 衄e n t a t l o n ) x s d ：a n n o t a t i o n ( x s d e l e m e n t ) ( x s d ：e l e m e n td a m e = ”s e r v i c e a b s t r a c t ”t y p e = ”x s d ：s t r i l l g “) ( x s d ：a n n o t a t i o n ) ( x s d ：e l e m e l l tn 锄e = “s e 竹i c e 工d ”t 弹e = ”船d ：s t r i n r ) 服务标识( x s d ：d o c u m e n t a t i 。n ) ( x s d ：a n n o t a t i o n ) x s d ：e l 衄e t ) x s d ：e l 衄e n tn 柚e2 ”s e r v l c e p r o v i d e r ”t y p e 。”s e r v i c e p r 。v i d e 咖e ”m a x o c c u r s = u n b o u n d e d ”) x s d ：a n n o t a t i o n ) ( x s d ：e l e m e n tn 拙e 2 ”s e r v i c e u r l ”t y p e = ”x s d ：s t r i n g ) 服务u r l ( x s d ：e l 印衄tn e = ”d a t a b a s e n e ”t y p e2 ”x s d ：s t r i n g ”) ( x s d ：a 曲o t a t i o n ) 1 2 g b z2 5 5 9 8 2 0 1 0 ( x s d ：a n n o t a t i o n ) ( x s d ：e l 锄e n t ) ( x s d ：e l 锄e n tn 硼e = ”d a t a b a s e d e s c r i b e ”t y p e = ”x s d ：s t r i n g ” ( x s d ：a 皿o t a t i o n ) ( x s d ：d o c u m 卸t a t i o n ) 元数据库描述 ( ! 一类型标识符”o p t i o n s ”的定义一) ( x s d ：e l 鲫e n tn 柚e = ”o p t l o n s ”t y p e = ”o p t i o n s t y p e “) ( x s d ：a r 】1 1 0 t a t i o n ) ( x 如e l 曲一“1 衄。v l d 口n a 衅“t ”x s d 扎r 1 凹” cx s d 删a t l o n ) ( x 州蛐一 噩务提供部门名称( x s d ：t a t 一) x s d 0 n ， ( ，x s d 二e l t ) b ) 元数据库列表参数( d a t a b a s e l l s t ) 用于描述目录服务支持的所有元数据库信息，包含多个d a t a b a s c 参数。d a t a b a s e 参数是复合型参 数包含元数据库标识( d a t a b a s e i d ) 、元数据库名称( d a t a b n ) 、元数据库描述( d a t a b a s e d e s c r l b c ) 等主要信息。参数d a t a b a s e 的具体内容如表8 所示。 表8 元数据库d a t 曲a s e 参数表 参数g 称柬条件参数i 月f 标识十元女库白勺标识# 自元* 库供女i 义 月f m 口i 据g # ，自e 据4 供* i 月f 供i 散据库$ # * 信息自i 散* 镕* 女2 女。诸，元n 自# 、目、月# 3 参散d m h 蝴d 表i 自# 识符b 自az 、az 、o9 目，其 符无效。 目录服务自描述响应中的“元数据库列表d a t a b a s e i s t ”的组成如圈9 所示 三亘三二 日 e # # & 国9目录服务自描述响应中“元数据库列表参数”的模型圉 目录服务自描述响应中的“元数据库列表d a t a b a s e s t ”的x m ls c h 定义片段如下( 完整的 x m ls c h 定义见附录c ) ： ( x s d ：c 帆p 1 自t y 砷”d a t a b s e 乙l s 竹弹e n ) 船d a t l o n ( x 5 d ：e n t a ) 元数* & ( x s d ；n t a t l 。n ) 1 4 g b z2 5 5 9 8 2 010 x s d ：a r m o t a t l o n ) ( x s d ：s e q u e n c e ( x s d ：e l 鲫凹tn 锄e = ”d a t a h s e ”t y p e = ”d a t a b a s e 聊e ”m i n o c c l l r s = ”o ” a x o c c u r s = ”u r l b o u r e d ”) ( x s d ：a r m o t a t i o n ( x s d ：d o c u e n t a t l o n ) 元数据库( x s d ：d 。c u m e n t a t i o n ) ( x s d ：越m o t a t i a n x s d ：e l 鲫e n t ) ( x s d ：s e q u e n c e ) ( x s d ：c 伽p l e _ 7 y p e ) ( x s d ：e l e m e n t ( x s d ：e l e e n tn a m e = ”出t a b a s e n a e ”t y p e = ”x s d ：s t r i “g ” ( x s d ：a n n o t a t i o n ( x s d ：a n r l o t a t i o n ( x s d ：e l e m e n t ) ( x s d ：e l e e n tn a 皿e = ”d a t a b a s e d e s c r l b e ”t y p e = ”x s d ：8 t r i n g ”) ( x s d ：a r m o t a t i o n ) ( x s d ：d o c u m e n t a t i o n ) 元数据库描述( x s d ：d o c u m e n t a t l o n ) ( x s d ：a 衄o t a t i o n ) x s d ：e l e m e n t x s d ：s e c h e n c e ) ( x s d ：c o m p l e x t y p e 5 2 发现接口 5 2 1 目录检索( s e a r c h c a t a l o g u e ) 5 2 1 1 概述 目录检索是目录服务器根据客户端指定的检索条件，在服务器端从元数据库中检索并标识出匹配 的元数据记录，并将元数据记录保存在结果集中的过程。 每一个会话可进行多次目录检索，产生多个结果集。 5 2 1 2 目录检索请求( a r c h r e q e s t ) “目录检索请求”参数的详细说明如表9 所示。 表9 目录检索请求参数表 参数名称 约束条件 参数含义 r e f e r e n c e i 小 必选用于识别一个请求所启动的操作的标识，即会话标识 结果集覆盖标志，客户端指定的检索结果集如果已经存 r e p l a c e i n d i c a t o r b 必选 在，根据结果集覆盖标志，服务器端作不同的处理 r e s u l t s e t i d 。必选由客户端定制检索结果集名称 由客户端指定待检索的一个或多个元数据库名称。因 目录服务可以关联多个元数据库( 元数据库信息均通过服 d a t a b a s e n a m e s 4必选 务自描述接口直接获取到客户端) ，故需要客户端指定检 索的元数据库 q u e r y 。 必选 由客户端定制的检索语甸 表9 ( 续 参散名称约束条件 参数吉i p t e f e r r e d r e c o r d 卸n t a # p * 2 女镕* 目日女女 其m 信，月f # 户螭# & 务8 传递自2 r 信自 a $ r e f n c e i d & i 台* 镕m g 自az 、zo 9 目其他 符i 效。 6 参数r o l a c e i n d m m n 值为布m 目“呲e ”& i a * 疆i # * 4 ，* f 镕$ # b 存# 结 # ；“f a l s e ”& i r * i e 存结集，将导致检索操作失败。 。” 参数r e s u h & t i d g 命g 结* $ g # i 目，女ir e p l a c e i n d c a m 参& 央是自疆i 结* 集。 4 参敷d a t a b a s e n s 4 台，自个或多十d a t 拈8 s e n 参散，月十* * 一十$ 十i # $ g # 。 。$ q u e r y 女$ # et y p l 目，* 月= & t e ( r p n ) 作自检索口该参散复合，其镕目# 自# t “女$ 参散q u e r y ”# 日。 参数p e f e m d r e c or d s y “t a x 白勺r “取“x m l ”& i # p 端女# $ 日方z 月x m i 。目录检索请求”的组成结构，如图l o 所示 ；- _ _ _ _ - - 一 - 出= ；：= = ：= ： i _ j 口 l “i n 蛐8 呻自廿 七互j 二眯已框至互 ： * 女i t 赫# g # m i t 辫# 日t $ n m jm n 刊r 岫i i 厂鬲忑f 4 * 日j女$ * 咿l l _ 二- - - i 一乏- = 坚：j 图1 0 目录检索请求的槿型图 “目录检索请求”的x m ls c h 定义片段如下( 完整的x m ls c h 定义见附录c ) ： 粪标* 符“觚删t ”2 r 一) x s de 1 。删七nt 衅= ”删t t 押e ” ( d t a t 一) “ d 咖一) 目 索请求x 5 d ：d w m t l 。n ) ( x s d - t l o n x s d ：e 1 g b z2 5 5 9 8 2 0 1 0 ( x s d ：c 衄p l e x t y p ei l a m e = ”s e a r c h r e q l 】e s t t y p e ”) ( x s d ：a n r l o t a t i o n ( x s d ：d o c u m 曲t a t i o n ) 目录检索请求的类型定义。x s d ：d o c u m 锄t a t i o n ) ( x s d ：a n n o t a t i o n ) ( x s d ：s e q l l e n c e ( x s d ：e l 锄e n tr e f = ”r e f e r e n c e i 矿) ( x s