CN114490136A - 服务调用和提供方法、装置、电子设备、介质和程序产品 - Google Patents

服务调用和提供方法、装置、电子设备、介质和程序产品 Download PDF

Info

Publication number
CN114490136A
CN114490136A CN202210139670.6A CN202210139670A CN114490136A CN 114490136 A CN114490136 A CN 114490136A CN 202210139670 A CN202210139670 A CN 202210139670A CN 114490136 A CN114490136 A CN 114490136A
Authority
CN
China
Prior art keywords
service
information
unitized
module
architecture
Prior art date
Legal status (The legal status is an assumption and is not a legal conclusion. Google has not performed a legal analysis and makes no representation as to the accuracy of the status listed.)
Pending
Application number
CN202210139670.6A
Other languages
English (en)
Inventor
关海超
夏龙飞
颜高飞
Current Assignee (The listed assignees may be inaccurate. Google has not performed a legal analysis and makes no representation or warranty as to the accuracy of the list.)
Industrial and Commercial Bank of China Ltd ICBC
Original Assignee
Industrial and Commercial Bank of China Ltd ICBC
Priority date (The priority date is an assumption and is not a legal conclusion. Google has not performed a legal analysis and makes no representation as to the accuracy of the date listed.)
Filing date
Publication date
Application filed by Industrial and Commercial Bank of China Ltd ICBC filed Critical Industrial and Commercial Bank of China Ltd ICBC
Priority to CN202210139670.6A priority Critical patent/CN114490136A/zh
Publication of CN114490136A publication Critical patent/CN114490136A/zh
Pending legal-status Critical Current

Links

Images

Classifications

    • GPHYSICS
    • G06COMPUTING; CALCULATING OR COUNTING
    • G06FELECTRIC DIGITAL DATA PROCESSING
    • G06F9/00Arrangements for program control, e.g. control units
    • G06F9/06Arrangements for program control, e.g. control units using stored programs, i.e. using an internal store of processing equipment to receive or retain programs
    • G06F9/46Multiprogramming arrangements
    • G06F9/54Interprogram communication
    • G06F9/547Remote procedure calls [RPC]; Web services

Landscapes

  • Engineering & Computer Science (AREA)
  • Software Systems (AREA)
  • Theoretical Computer Science (AREA)
  • Physics & Mathematics (AREA)
  • General Engineering & Computer Science (AREA)
  • General Physics & Mathematics (AREA)
  • Management, Administration, Business Operations System, And Electronic Commerce (AREA)

Abstract

本公开提供了一种基于单元化架构的服务调用方法、服务提供方法、装置、电子设备、介质和计算机程序产品。上述方法和装置可用于分布式计算和金融技术领域。服务调用方法包括:提出服务请求,其中,所述服务请求包括目标服务事项的事项信息;获取与所述目标服务事项对应的服务事项的存根信息;解析所述存根信息的接口定义中的注解信息,以得到所述注解信息中的属性值;加载与所述注解信息中的属性值对应的类;执行所述类的方法,以获取客户特征值;根据所述客户特征值,确定能够提供所述目标服务事项的单元化模块;以及对能够提供所述目标服务事项的单元化模块发起调用请求。

Description

服务调用和提供方法、装置、电子设备、介质和程序产品
技术领域
本公开涉及分布式计算和金融技术领域,更具体地,涉及一种基于单元化架构的服务调用方法、服务提供方法、装置、电子设备、计算机可读存储介质和计算机程序产品。
背景技术
在传统的分布式架构中,某一个服务的所有提供者节点在逻辑上是平等的,消费者要调用该服务,根据RPC框架提供的负载均衡策略任选一个提供者发起调用即可,不用做其他考量。
但在单元化架构中,情况发生了变化。某一个服务的提供者被划分到了多个单元内,每个单元内都部署了一整套功能完备的提供者集群和对应的数据库资源。在这种场景下,一个单元内的消费者要调用该服务,必须要先计算应该调用哪个单元的提供者,这可能有两种结果:一是调用本单元的提供者,这种情况直接发起RPC调用即可;二是调用其他单元的提供者,这种情况就需要跨单元调用。
在微服务广泛流行的今天,集中式的配置中心是一个非常自然的选择。服务提供者将自己提供的所有服务的单元化特征写入配置中心,消费者从配置中心获取特征并缓存到本地,在运行时直接读取Key-Value结构的特征信息做目标单元识别,然后调用本单元内或其他单元的服务提供者。
发明内容
有鉴于此,本公开提供了一种依赖性小、运维和代码维护成本低以及代码维护难度小的基于单元化架构的服务调用方法、服务提供方法、装置、电子设备、计算机可读存储介质和计算机程序产品。
本公开的一个方面提供了一种基于单元化架构的服务调用方法,所述单元化架构包括多个单元化模块,所述多个单元化模块中部署服务提供者和服务消费者,每个所述服务提供者提供服务事项,每个所述服务事项具有对应的存根信息,所述存根信息包括该服务事项的接口定义,所述服务调用方法应用于所述服务消费者,所述方法包括:提出服务请求,其中,所述服务请求包括目标服务事项的事项信息;获取与所述目标服务事项对应的服务事项的存根信息;解析所述存根信息的接口定义中的注解信息,以得到所述注解信息中的属性值;加载与所述注解信息中的属性值对应的类;执行所述类的方法,以获取客户特征值;根据所述客户特征值,确定能够提供所述目标服务事项的单元化模块;以及对能够提供所述目标服务事项的单元化模块发起调用请求。
根据本公开实施例的基于单元化架构的服务调用方法,通过解析存根信息的接口定义中的注解信息,可以得到定义了如何从目标服务事项的事项信息中解析出客户特征值的属性值,通过执行与属性值对应的类的方法即可解析出客户特征值,从而根据客户特征值确定能够提供目标服务事项的单元化模块,与现有技术相比,服务消费者无需每次启动后再从配置中心拉取配置,减少甚至消除了服务消费者对配置中心的强依赖;另外,本方法架构简单,不再需要引入第三方数据同步工具,减少运维成本;此外,开发者无需再同步更新单元化特征,降低了代码维护的难度和成本。
在一些实施例中,所述事项信息包括请求参数;所述执行所述类的方法,以获取客户特征值包括:执行所述类的方法,从所述请求参数中解析出所述客户特征值。
在一些实施例中,所述客户特征值包括所述请求参数中用户的地址信息。
在一些实施例中,所述根据所述地址信息,确定能够提供所述目标服务事项的单元化模块包括:计算与所述地址信息对应的单元化模块的编号;以及根据所述编号确定能够提供所述目标服务事项的单元化模块。
本公开的另一方面提供了一种基于单元化架构的服务调用装置,所述单元化架构包括多个单元化模块,所述多个单元化模块中部署服务提供者和服务消费者,每个所述服务提供者提供服务事项,每个所述服务事项具有对应的存根信息,所述存根信息包括该服务事项的接口定义,所述装置包括:请求模块,所述请求模块用于执行提出服务请求,其中,所述服务请求包括目标服务事项的事项信息;获取模块,所述获取模块用于执行获取与所述目标服务事项对应的服务事项的存根信息;解析模块,所述解析模块用于执行解析所述存根信息的接口定义中的注解信息,以得到所述注解信息中的属性值;加载模块,所述加载模块用于执行加载与所述注解信息中的属性值对应的类;执行模块,所述执行模块用于执行所述类的方法,以获取客户特征值;确定模块,所述确定模块用于执行根据所述客户特征值,确定能够提供所述目标服务事项的单元化模块;以及调用模块,所述调用模块用于执行对能够提供所述目标服务事项的单元化模块发起调用请求。
本公开的另一方面提供了一种基于单元化架构的服务提供方法,所述单元化架构包括多个单元化模块,所述多个单元化模块中部署服务提供者和服务消费者,每个所述服务提供者提供服务事项,所述服务提供方法应用于所述服务提供者,所述方法包括:为所述服务事项的接口定义添加注解信息,其中,所述注解信息包括属性值;根据添加注解信息后的接口定义生成存根信息;以及发布所述存根信息。
根据本公开实施例的基于单元化架构的服务提供方法,通过为服务事项的接口定义添加注解信息,注解信息的属性值可以定义如何从目标服务事项的事项信息中解析出客户特征值,将根据添加注解信息后的接口定义生成存根信息,发布存根信息后,服务消费者即可获取存根信息,由此解析出客户特征值,从而便于服务消费者根据客户特征值确定能够提供目标服务事项的单元化模块。服务消费者无需每次启动后再从配置中心拉取配置,减少甚至消除了服务消费者对配置中心的强依赖;另外,本方法架构简单,不再需要引入第三方数据同步工具,减少运维成本;此外,开发者无需再同步更新单元化特征,降低了代码维护的难度和成本。
在一些实施例中,所述发布所述存根信息为将所述存根信息发布至存储仓库。
本公开的另一方面提供了一种基于单元化架构的服务提供装置,所述单元化架构包括多个单元化模块,所述多个单元化模块中部署服务提供者和服务消费者,每个所述服务提供者提供服务事项,所述装置包括:添加模块,所述添加模块用于执行为所述服务事项的接口定义添加注解信息,其中,所述注解信息包括属性值;生成模块,所述生成模块用于执行根据添加注解信息后的接口定义生成存根信息;以及发布模块,所述发布模块用于执行发布所述存根信息。
本公开的另一方面提供了一种电子设备,包括一个或多个处理器以及一个或多个存储器,其中,所述存储器用于存储可执行指令,所述可执行指令在被所述处理器执行时,实现如上所述方法。
本公开的另一方面提供了一种计算机可读存储介质,存储有计算机可执行指令,所述指令在被执行时用于实现如上所述的方法。
本公开的另一方面提供了一种计算机程序产品,包括计算机程序,所述计算机程序包括计算机可执行指令,所述指令在被执行时用于实现如上所述的方法。
附图说明
通过以下参照附图对本公开实施例的描述,本公开的上述以及其他目的、特征和优点将更为清楚,在附图中:
图1示意性示出了根据本公开实施例的可以应用方法、装置的示例性系统架构;
图2示意性示出了根据本公开实施例的基于单元化架构的服务调用方法的流程图;
图3示意性示出了根据本公开实施例的执行类的方法,以获取客户特征值的流程图;
图4示意性示出了根据本公开实施例的根据客户特征值,确定能够提供目标服务事项的单元化模块的流程图;
图5示意性示出了根据本公开实施例的根据地址信息,确定能够提供目标服务事项的单元化模块的流程图;
图6示意性示出了根据本公开实施例的基于单元化架构的服务调用装置的结构框图;
图7示意性示出了根据本公开实施例的基于单元化架构的服务提供方法的流程图;
图8示意性示出了根据本公开实施例的发布存根信息至存储仓库示意图;
图9示意性示出了根据本公开实施例的基于单元化架构的服务提供装置的结构框图;
图10示意性示出了根据本公开实施例的单元化架构的布局示意图;
图11示意性示出了根据本公开实施例的电子设备的方框图。
具体实施方式
以下,将参照附图来描述本公开的实施例。但是应该理解,这些描述只是示例性的,而并非要限制本公开的范围。在下面的详细描述中,为便于解释,阐述了许多具体的细节以提供对本公开实施例的全面理解。然而,明显地,一个或多个实施例在没有这些具体细节的情况下也可以被实施。此外,在以下说明中,省略了对公知结构和技术的描述,以避免不必要地混淆本公开的概念。
在本公开的技术方案中,所涉及的用户个人信息的获取,存储和应用等,均符合相关法律法规的规定,采取了必要保密措施,且不违背公序良俗。在本公开的技术方案中,对数据的获取、收集、存储、使用、加工、传输、提供、公开和应用等处理,均符合相关法律法规的规定,采取了必要保密措施,且不违背公序良俗。
在此使用的术语仅仅是为了描述具体实施例,而并非意在限制本公开。在此使用的术语“包括”、“包含”等表明了所述特征、步骤、操作和/或部件的存在,但是并不排除存在或添加一个或多个其他特征、步骤、操作或部件。
在使用类似于“A、B或C等中至少一个”这样的表述的情况下,一般来说应该按照本领域技术人员通常理解该表述的含义来予以解释(例如,“具有A、B或C中至少一个的系统”应包括但不限于单独具有A、单独具有B、单独具有C、具有A和B、具有A和C、具有B和C、和/或具有A、B、C的系统等)。术语“第一”、“第二”仅用于描述目的,而不能理解为指示或暗示相对重要性或者隐含指明所指示的技术特征的数量。由此,限定有“第一”、“第二”的特征可以明示或者隐含地包括一个或者更多个所述特征。
在传统的分布式架构中,某一个服务的所有提供者节点在逻辑上是平等的,消费者要调用该服务,根据RPC框架提供的负载均衡策略任选一个提供者发起调用即可,不用做其他考量。
但在单元化架构中,情况发生了变化。某一个服务的提供者被划分到了多个单元内,每个单元内都部署了一整套功能完备的提供者集群和对应的数据库资源。在这种场景下,一个单元内的消费者要调用该服务,必须要先计算应该调用哪个单元的提供者,这可能有两种结果:一是调用本单元的提供者,这种情况直接发起RPC调用即可;二是调用其他单元的提供者,这种情况就需要跨单元调用。
在微服务广泛流行的今天,集中式的配置中心是一个非常自然的选择。服务提供者将自己提供的所有服务的单元化特征写入配置中心,消费者从配置中心获取特征并缓存到本地,在运行时直接读取Key-Value结构的特征信息做目标单元识别,然后调用本单元内或其他单元的服务提供者。
集中式的配置中心存在的主要缺陷如下:一是单元化特征需要由消费者每次启动后从配置中心拉取,对配置中心是强依赖;二是架构复杂,为了解决配置中心的单点问题,需要引入第三方数据同步工具,运维成本高;三是服务提供者的单元化特征跟代码在物理上隔离,服务的代码更新后,开发者容易忘记同步更新单元化特征,增加了代码维护的难度和成本。
本公开的实施例提供了一种基于单元化架构的服务调用方法,单元化架构包括多个单元化模块,多个单元化模块中部署服务提供者和服务消费者,每个服务提供者提供服务事项,每个服务事项具有对应的存根信息,存根信息包括该服务事项的接口定义,服务调用方法应用于服务消费者,基于单元化架构的服务调用方法包括:提出服务请求,其中,服务请求包括目标服务事项的事项信息;获取与目标服务事项对应的服务事项的存根信息;解析存根信息的接口定义中的注解信息,以得到注解信息中的属性值;加载与注解信息中的属性值对应的类;执行类的方法,以获取客户特征值;根据客户特征值,确定能够提供目标服务事项的单元化模块;以及对能够提供目标服务事项的单元化模块发起调用请求。
需要说明的是,本公开的基于单元化架构的服务调用方法、服务提供方法、装置、电子设备、计算机可读存储介质和计算机程序产品可用于分布式计算技术领域,也可用于除分布式计算技术领域之外的任意领域,例如金融领域,这里对本公开的领域不做限定。
图1示意性示出了根据本公开实施例的可以应用基于单元化架构的服务调用方法、服务提供方法、装置、电子设备、计算机可读存储介质和计算机程序产品的示例性系统架构100。需要注意的是,图1所示仅为可以应用本公开实施例的系统架构的示例,以帮助本领域技术人员理解本公开的技术内容,但并不意味着本公开实施例不可以用于其他设备、系统、环境或场景。
如图1所示,根据该实施例的系统架构100可以包括终端设备101、102、103,网络104和服务器105。网络104用以在终端设备101、102、103和服务器105之间提供通信链路的介质。网络104可以包括各种连接类型,例如有线、无线通信链路或者光纤电缆等等。
用户可以使用终端设备101、102、103通过网络104与服务器105交互,以接收或发送消息等。终端设备101、102、103上可以安装有各种通讯客户端应用,例如购物类应用、网页浏览器应用、搜索类应用、即时通信工具、邮箱客户端、社交平台软件等(仅为示例)。
终端设备101、102、103可以是具有显示屏并且支持网页浏览的各种电子设备,包括但不限于智能手机、平板电脑、膝上型便携计算机和台式计算机等等。
服务器105可以是提供各种服务的服务器,例如对用户利用终端设备101、102、103所浏览的网站提供支持的后台管理服务器(仅为示例)。后台管理服务器可以对接收到的用户请求等数据进行分析等处理,并将处理结果(例如根据用户请求获取或生成的网页、信息、或数据等)反馈给终端设备。
需要说明的是,本公开实施例所提供的基于单元化架构的服务调用方法和服务提供方法一般可以由服务器105执行。相应地,本公开实施例所提供的基于单元化架构的服务调用装置和服务提供装置一般可以设置于服务器105中。本公开实施例所提供的基于单元化架构的服务调用方法和服务提供方法也可以由不同于服务器105且能够与终端设备101、102、103和/或服务器105通信的服务器或服务器集群执行。相应地,本公开实施例所提供的基于单元化架构的服务调用装置和服务提供装置也可以设置于不同于服务器105且能够与终端设备101、102、103和/或服务器105通信的服务器或服务器集群中。
应该理解,图1中的终端设备、网络和服务器的数目仅仅是示意性的。根据实现需要,可以具有任意数目的终端设备、网络和服务器。
以下将基于图1描述的场景,通过图2~图5对本公开实施例的基于单元化架构的服务管理方法进行详细描述。
图2示意性示出了根据本公开实施例的基于单元化架构的服务调用方法的流程图。
根据本公开实施例的基于单元化架构的服务调用方法,应用于服务消费者,其中,单元化架构包括多个单元化模块,多个单元化模块中部署服务提供者和服务消费者,每个服务提供者提供服务事项,每个服务事项具有对应的存根信息,存根信息包括该服务事项的接口定义。
可以理解的是,单元化架构的多个单元化模块可以根据划分规则划分,划分规则可以为用户属性,用户属性可以包括用户ID、用户类型、用户数量和用户等级中的至少一个,但是并不限于此。其中,用户ID可以理解为用户的账户地址;用户类型可以理解为商家、消费者或者监管者等等,上述仅为举例说明,并不能理解为对用户类型的限制,用户类型还可以为其它分类;用户等级可以理解为用户的级别,例如一星级客户、二星级客户、三星级客户等等,星级越高,客户等级越高,客户优惠和权限越大,上述仅为举例说明,并不能理解为对用户等级的限制,用户等级还可以为其它分类。
由此,可以根据需求选择根据用户ID、用户类型、用户数量和用户等级中的至少一个划分多个单元化模块,以存放对应划分规则的用户。下面以根据用户ID划分多个单元化模块为例进行详细说明。
假设有100个用户,用户1的用户ID为00001,用户2的用户ID为00002,用户3的用户ID为00003,用户4的用户ID为00004,用户5的用户ID为00005,以此类推,用户100的用户ID为00100。根据上述100个用户,划分规则可以为将用户ID后三位为001~020的用户划分为一个单元化模块,将用户ID后三位为021~040的用户划分为一个单元化模块,将用户ID后三位为041~060的用户划分为一个单元化模块,将用户ID后三位为061~080的用户划分为一个单元化模块,将用户ID后三位为081~100的用户划分为一个单元化模块。
进而,通过将用户ID、用户类型、用户数量和用户等级中的至少一个作为用户属性,根据用户属性在单元化架构中划分多个单元化模块,使得可以根据特定场景和需要划分单元化模块,从而使得单元化模块的划分更加实用和灵活。
如图2所示,本实施例的基于单元化架构的服务调用方法包括操作S210~操作S270。
在操作S210,提出服务请求,其中,服务请求包括目标服务事项的事项信息。
在操作S220,获取与目标服务事项对应的服务事项的存根信息。可以理解的是,在多个单元化模块中,每个单元化模块中均可以部署服务提供者提供同一服务事项,当提出服务请求后,可以根据服务请求的目标服务事项匹配到对应的服务事项,进而获取到该服务事项的存根信息。
在操作S230,解析存根信息的接口定义中的注解信息,以得到注解信息中的属性值。需要说明的是,属性值中定义了如何从目标服务事项的事项信息中解析出客户特征值。
在操作S240,加载与注解信息中的属性值对应的类。需要说明的是,类可以为java编程语言中的类。
在操作S250,执行类的方法,以获取客户特征值。可以理解的是,由于属性值中已经定义了如何从目标服务事项的事项信息中解析出客户特征值,因此执行与属性值对应的类的方法,即可获取客户特征值。
作为一种可能实现的方式,事项信息可以包括请求参数。如图3所示,操作S250执行类的方法,以获取客户特征值包括操作S251:执行类的方法,从请求参数中解析出客户特征值。
作为一种可能实现的方式,客户特征值可以包括请求参数中用户的地址信息。例如,请求参数可以为“用户ID:00043;用户密码:111”,执行类的方法后,可以得到客户特征值“用户ID:00043”。通过将事项信息包括请求参数、客户特征值包括请求参数中用户的地址信息和操作S251,可以便于实现执行类的方法,以获取客户特征值。
在操作S260,根据客户特征值,确定能够提供目标服务事项的单元化模块。在一些具体的示例中,如图4所示,操作S260根据客户特征值,确定能够提供目标服务事项的单元化模块可以理解为操作S261:根据地址信息,确定能够提供目标服务事项的单元化模块。
作为一种可能实现的方式,如图5所示,操作S261根据地址信息,确定能够提供目标服务事项的单元化模块包括操作S2611和操作S2612。
在操作S2611,计算与地址信息对应的单元化模块的编号。
在操作S2612,根据编号确定能够提供目标服务事项的单元化模块。
继续以上述100个用户为例,在根据100个用户的用户ID划分单元化模块时,可以给每个单元化模块编号,例如将用户ID后三位为001~020的用户划分为一个单元化模块,该单元化模块的编号为1;将用户ID后三位为021~040的用户划分为一个单元化模块,该单元化模块的编号为2;将用户ID后三位为041~060的用户划分为一个单元化模块,该单元化模块的编号为3;将用户ID后三位为061~080的用户划分为一个单元化模块,该单元化模块的编号为4;将用户ID后三位为081~100的用户划分为一个单元化模块,该单元化模块的编号为5。
其中,计算与地址信息对应的单元化模块的编号时可以根据划分规则计算,也即得到客户特征值“用户ID:00043”后,可以得到用户ID的后三位为043,与用户ID的后三位为043对应的单元化模块的编号为3,因此,根据编号3可以确定能够提供目标服务事项的单元化模块。通过操作S2611和操作S2612可以便于实现根据地址信息,确定能够提供目标服务事项的单元化模块。
在操作S270,对能够提供目标服务事项的单元化模块发起调用请求。
根据本公开实施例的基于单元化架构的服务调用方法,通过解析存根信息的接口定义中的注解信息,可以得到定义了如何从目标服务事项的事项信息中解析出客户特征值的属性值,通过执行与属性值对应的类的方法即可解析出客户特征值,从而根据客户特征值确定能够提供目标服务事项的单元化模块,与现有技术相比,服务消费者无需每次启动后再从配置中心拉取配置,减少甚至消除了服务消费者对配置中心的强依赖;另外,本方法架构简单,不再需要引入第三方数据同步工具,减少运维成本;此外,开发者无需再同步更新单元化特征,降低了代码维护的难度和成本。
基于上述单元化架构的服务调用方法,本公开还提供了一种基于单元化架构的服务调用装置10。以下将结合图6对基于单元化架构的服务调用装置10进行详细描述。
图6示意性示出了根据本公开实施例的基于单元化架构的服务调用装置10的结构框图。单元化架构包括多个单元化模块,多个单元化模块中部署服务提供者和服务消费者,每个服务提供者提供服务事项,每个服务事项具有对应的存根信息,存根信息包括该服务事项的接口定义。
基于单元化架构的服务调用装置10包括请求模块1、获取模块2、解析模块3、加载模块4、执行模块5、确定模块6和调用模块7。
请求模块1,请求模块1用于执行操作S210:提出服务请求,其中,服务请求包括目标服务事项的事项信息。
获取模块2,获取模块2用于执行操作S220:获取与目标服务事项对应的服务事项的存根信息。
解析模块3,解析模块3用于执行操作S230:解析存根信息的接口定义中的注解信息,以得到注解信息中的属性值。
加载模块4,加载模块4用于执行操作S240:加载与注解信息中的属性值对应的类。
执行模块5,执行模块5用于执行操作S250:执行类的方法,以获取客户特征值。
确定模块6,确定模块6用于执行操作S260:根据客户特征值,确定能够提供目标服务事项的单元化模块。
调用模块7,调用模块7用于执行操作S270:对能够提供目标服务事项的单元化模块发起调用请求。
由于上述基于单元化架构的服务调用装置10是基于单元化架构的服务调用方法设置的,因此上述基于单元化架构的服务调用装置10的有益效果与基于单元化架构的服务调用方法的相同,这里不再赘述。
另外,根据本公开的实施例,请求模块1、获取模块2、解析模块3、加载模块4、执行模块5、确定模块6和调用模块7中的任意多个模块可以合并在一个模块中实现,或者其中的任意一个模块可以被拆分成多个模块。或者,这些模块中的一个或多个模块的至少部分功能可以与其他模块的至少部分功能相结合,并在一个模块中实现。
根据本公开的实施例,请求模块1、获取模块2、解析模块3、加载模块4、执行模块5、确定模块6和调用模块7的至少一个可以至少被部分地实现为硬件电路,例如现场可编程门阵列(FPGA)、可编程逻辑阵列(PLA)、片上系统、基板上的系统、封装上的系统、专用集成电路(ASIC),或可以通过对电路进行集成或封装的任何其他的合理方式等硬件或固件来实现,或以软件、硬件以及固件三种实现方式中任意一种或以其中任意几种的适当组合来实现。
或者,请求模块1、获取模块2、解析模块3、加载模块4、执行模块5、确定模块6和调用模块7中的至少一个可以至少被部分地实现为计算机程序模块,当该计算机程序模块被运行时,可以执行相应的功能。
以下将基于图1描述的场景,通过图7和图8对本公开实施例的基于单元化架构的服务提供方法进行详细描述。
图7示意性示出了根据本公开实施例的基于单元化架构的服务提供方法的流程图。
根据本公开实施例的基于单元化架构的服务提供方法,单元化架构包括多个单元化模块,多个单元化模块中部署服务提供者和服务消费者,每个服务提供者提供服务事项,服务提供方法应用于服务提供者。
如图7所示,本实施例的基于单元化架构的服务提供方法包括操作S310~操作S330。
在操作S310,为服务事项的接口定义添加注解信息,其中,注解信息包括属性值,可以在属性值中定义如何从目标服务事项的事项信息中解析出客户特征值。
在操作S320,根据添加注解信息后的接口定义生成存根信息。
在操作S330,发布存根信息。
根据本公开实施例的基于单元化架构的服务提供方法,通过为服务事项的接口定义添加注解信息,注解信息的属性值可以定义如何从目标服务事项的事项信息中解析出客户特征值,将根据添加注解信息后的接口定义生成存根信息,发布存根信息后,服务消费者即可获取存根信息,由此解析出客户特征值,从而便于服务消费者根据客户特征值确定能够提供目标服务事项的单元化模块。服务消费者无需每次启动后再从配置中心拉取配置,减少甚至消除了服务消费者对配置中心的强依赖;另外,本方法架构简单,不再需要引入第三方数据同步工具,减少运维成本;此外,开发者无需再同步更新单元化特征,降低了代码维护的难度和成本。
在本公开的一些实施例中,如图8所示,发布存根信息为将存根信息发布至存储仓库。其中,存储仓库可以为mawen仓库,由此可以便于发布存根信息,服务消费者要调用服务提供者提供目标服务事项时,可以从mawen仓库中拉取存根信息,从而可以实现解析存根信息的接口定义中的注解信息。
基于上述单元化架构的服务提供方法,本公开还提供了一种基于单元化架构的服务提供装置20。以下将结合图9对基于单元化架构的服务提供装置20进行详细描述。
图9示意性示出了根据本公开实施例的基于单元化架构的服务提供装置20的结构框图。单元化架构包括多个单元化模块,多个单元化模块中部署服务提供者和服务消费者,每个服务提供者提供服务事项。
基于单元化架构的服务提供装置20包括添加模块21、生成模块22和发布模块23。
添加模块21,添加模块21用于执行操作S310:为服务事项的接口定义添加注解信息,其中,注解信息包括属性值。
生成模块22,生成模块22用于执行操作S320:根据添加注解信息后的接口定义生成存根信息。
发布模块23,发布模块23用于执行操作S330:发布存根信息。
由于上述基于单元化架构的服务提供装置20是基于单元化架构的服务提供方法设置的,因此上述基于单元化架构的服务提供装置20的有益效果与基于单元化架构的服务提供方法的相同,这里不再赘述。
另外,根据本公开的实施例,添加模块21、生成模块22和发布模块23中的任意多个模块可以合并在一个模块中实现,或者其中的任意一个模块可以被拆分成多个模块。或者,这些模块中的一个或多个模块的至少部分功能可以与其他模块的至少部分功能相结合,并在一个模块中实现。
根据本公开的实施例,添加模块21、生成模块22和发布模块23的至少一个可以至少被部分地实现为硬件电路,例如现场可编程门阵列(FPGA)、可编程逻辑阵列(PLA)、片上系统、基板上的系统、封装上的系统、专用集成电路(ASIC),或可以通过对电路进行集成或封装的任何其他的合理方式等硬件或固件来实现,或以软件、硬件以及固件三种实现方式中任意一种或以其中任意几种的适当组合来实现。
或者,添加模块21、生成模块22和发布模块23中的至少一个可以至少被部分地实现为计算机程序模块,当该计算机程序模块被运行时,可以执行相应的功能。
下面参照图10详细描述根据本公开实施例的基于单元化架构的服务提供方法和服务调用方法。值得理解的是,下述描述仅是示例性说明,而不是对本公开的具体限制。
对于不同的服务,计算其提供者所在单元的方法往往是不同的。假设现在有一个单元化架构部署的分布式系统,该系统采用客户ID作为单元分割的依据。在这个系统中,对于查看客户信息的服务,服务消费者要从服务请求中解析出客户ID,再判断该客户ID所属的单元号,进而调用对应单元的提供者。而对于统计客户总数这样的服务,服务消费者无需解析客户ID(实际上服务请求中也不会有客户ID),直接调用本单元的提供者即可。
在上面这个例子中,哪些服务需要计算目标单元,哪些不需要,都是服务提供者决定的,对于需要计算目标单元的服务,如何从请求参数中解析出客户ID,不同的服务解析方式也不同。这里面涉及到很多细节问题,其实可以看作是目标服务在单元化场景下的单元化特征,这些特征都需要服务提供者通过某种方式告知服务消费者,服务消费者才能在运行时调用到正确的服务提供者。
本文描述的就是如何更优雅地管理服务的单元化特征,主要包含两个方面,一是服务提供者如何定义单元化特征,二是服务消费者如何获取服务的单元化特征。
值得说明的是,本文有一个基本前提,那就是所有的服务都是基于某一个RPC框架部署的分布式系统,单元化架构可以理解成一种更加先进的分布式系统模型。
本公开的核心思路是,服务提供者借助Java语言中的注解功能,将服务的单元化特征填充到特定注解中,并通过服务存根的方式分发给服务消费者。服务消费者在运行时解析服务存根中的特定注解,获得单元化特征的内容,然后计算目标单元,完成服务调用。
下面我们分两部分来介绍,第一部分是开发环节服务提供者如何基于注解为服务配置单元化特征并分发给服务消费者,也即基于单元化架构的服务提供方法;第二部分是服务消费者在运行环节如何解析注解获取单元化特征,也即基于单元化架构的服务调用方法。
一、开发环节
假设现在有一个业务系统,基于客户ID的最后2两位,将服务提供者划分到5个单元。更具体一点描述,一种可能的划分方案是,客户ID最后2位是0~19的请求要调用1号单元的提供者,最后两位是20~39的请求2号单元的提供者,依次类推,最后2位是80~99的请求要调用5号单元的提供者。为了实现在运行时对流量进行这样的分配,RPC框架、服务提供者、服务消费者均需要做一些工作,下面按照具体实施步骤,具体介绍各个角色需要做的工作。
1)RPC框架根据业务场景,定义单元化注解。在我们上面描述的这个例子中,单元化注解中要指明“如何从请求参数中解析客户ID”。这个注解可以按照如下方式实现:
该注解用于provider侧标示自己的服务,用于interface级别。
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public@interface ZoneIdentify{//从参数中解析用户标识cid的方法Class<?extends CidParser>cidParser()default CidParser.class;}
RPC框架定义上面这样一个注解,该注解的名称=ZoneIdentify,注解内部只有一个属性=cidParser,用来告诉服务消费者如何从入参中解析出用户ID(消费者和提供者都是基于RPC框架开发的,这个解析动作实际上是框架做的,只不过是在消费者这一方来执行)。
2)服务提供者使用RPC框架提供的单元化注解标记自己发布的服务,根据服务的具体特征。在这个例子中,提供者在注解中填写不同服务的cidParser。假设现在有一个提供者发布了2个服务,这2个服务的接口和对应的注解示例如下。
代码注释:修改用户的登录密码服务,该接口的第1个参数是用户ID。这个接口的业务含义是把userId指定的用户密码改成新密码newPassword。在注解ZoneIdentify中,指定cidParser是一个类,该类的作用从其类名就可以知道:解析出第1个参数。
代码注释:向特定用户发放优惠券服务,该接口的第2个参数是用户ID。这个接口的业务含义是向userId指定的用户发放优惠券(couponId是优惠券在系统内部的编号ID)。在注解ZoneIdentify中,指定cidParser是一个类,该类的作用从其类名就可以知道:解析出第2个参数。必须指明的是,上面的ParserFirstParam和ParserSecondParam这两个类也是要服务提供者实现的,并作为服务存根的一部分,连同接口定义一起发送给消费者。针对提供者的其他复杂接口,还可以有更加复杂的类来从参数中解析用户ID,这些类的具体实现是纯粹的Java编程技巧问题,且不同业务场景各不相同,故这里不再赘述。
上面提到的“将服务存根发送给服务消费者",在实际开发过程中一般是将服务存根发布到maven仓库,这是现在分布式开发的基本操作,具体操作细节不再赘述。
3)服务消费者更新自己的服务存根。这是现在分布式开发的基本操作之一,常见的是从maven仓库中拉取,具体的操作细节不再赘述。
4)服务消费者发起请求,解析注解的过程由RPC框架负责,对消费者的业务代码零侵入。关于RPC框架如何解析注解,请看下文运行环节的描述。
二、运行环节
消费者无需对调用方式做任何调整,单元化注解的解析工作完全由RPC框架默默完成。假设消费者现在要调用modifyUserPassword这个接口,请求参数是userId=10220826,newPassword=“123icbc*”。业务代码将请求提交给RPC框架后,框架的处理流程如下。
1)框架从请求上下文中获取到调用的目标服务的存根,存根中包含了目标服务的接口定义。
2)框架利用Java编程语言的反射机制,获取服务接口上的单元化注解。在上面的例子中,modifyUserPassword接口上有单元化注解ZoneIdentify,框架会解析出来,并且读取到注解中cidParser属性的值=ParserFirstParam.class。
3)框架从服务存根中找到并加载ParserFirstParam这个类,然后执行这个类的方法,从入参中解析出用户ID=10220826。
4)框架根据客户ID,计算提供者所在的单元号。在这个例子中,用户ID最后2位是26,应该把这个请求发给2号单元的提供者。这是单元化架构下的RPC框架需要具备的能力。
5)框架对目标单元的提供者发起调用,在这个例子中,就是向2号单元的提供者发起调用。
图11示意性示出了根据本公开实施例的适于实现上述方法的电子设备的方框图。
如图11所示,根据本公开实施例的电子设备900包括处理器901,其可以根据存储在只读存储器(ROM)902中的程序或者从存储部分908加载到随机访问存储器(RAM)903中的程序而执行各种适当的动作和处理。处理器901例如可以包括通用微处理器(例如CPU)、指令集处理器和/或相关芯片组和/或专用微处理器(例如,专用集成电路(ASIC))等等。处理器901还可以包括用于缓存用途的板载存储器。处理器901可以包括用于执行根据本公开实施例的方法流程的不同动作的单一处理单元或者是多个处理单元。
在RAM 903中,存储有电子设备900操作所需的各种程序和数据。处理器901、ROM902以及RAM 903通过总线904彼此相连。处理器901通过执行ROM 902和/或RAM 903中的程序来执行根据本公开实施例的方法流程的各种操作。需要注意,所述程序也可以存储在除ROM 902和RAM 903以外的一个或多个存储器中。处理器901也可以通过执行存储在所述一个或多个存储器中的程序来执行根据本公开实施例的方法流程的各种操作。
根据本公开的实施例,电子设备900还可以包括输入/输出(I/O)接口905,输入/输出(I/O)接口905也连接至总线904。电子设备900还可以包括连接至I/O接口905的以下部件中的一项或多项:包括键盘、鼠标等的输入部分906;包括诸如阴极射线管(CRT)、液晶显示器(LCD)等以及扬声器等的输出部分907;包括硬盘等的存储部分908;以及包括诸如LAN卡、调制解调器等的网络接口卡的通信部分909。通信部分909经由诸如因特网的网络执行通信处理。驱动器910也根据需要连接至输入/输出(I/O)接口905。可拆卸介质911,诸如磁盘、光盘、磁光盘、半导体存储器等等,根据需要安装在驱动器910上,以便于从其上读出的计算机程序根据需要被安装入存储部分908。
本公开还提供了一种计算机可读存储介质,该计算机可读存储介质可以是上述实施例中描述的设备/装置/系统中所包含的;也可以是单独存在,而未装配入该设备/装置/系统中。上述计算机可读存储介质承载有一个或者多个程序,当上述一个或者多个程序被执行时,实现根据本公开实施例的方法。
根据本公开的实施例,计算机可读存储介质可以是非易失性的计算机可读存储介质,例如可以包括但不限于:便携式计算机磁盘、硬盘、随机访问存储器(RAM)、只读存储器(ROM)、可擦式可编程只读存储器(EPROM或闪存)、便携式紧凑磁盘只读存储器(CD-ROM)、光存储器件、磁存储器件、或者上述的任意合适的组合。在本公开中,计算机可读存储介质可以是任何包含或存储程序的有形介质,该程序可以被指令执行系统、装置或者器件使用或者与其结合使用。例如,根据本公开的实施例,计算机可读存储介质可以包括上文描述的ROM 902和/或RAM 903和/或ROM 902和RAM 903以外的一个或多个存储器。
本公开的实施例还包括一种计算机程序产品,其包括计算机程序,该计算机程序包含用于执行流程图所示的方法的程序代码。当计算机程序产品在计算机系统中运行时,该程序代码用于使计算机系统实现本公开实施例的方法。
在该计算机程序被处理器901执行时执行本公开实施例的系统/装置中限定的上述功能。根据本公开的实施例,上文描述的系统、装置、模块、单元等可以通过计算机程序模块来实现。
在一种实施例中,该计算机程序可以依托于光存储器件、磁存储器件等有形存储介质。在另一种实施例中,该计算机程序也可以在网络介质上以信号的形式进行传输、分发,并通过通信部分909被下载和安装,和/或从可拆卸介质911被安装。该计算机程序包含的程序代码可以用任何适当的网络介质传输,包括但不限于:无线、有线等等,或者上述的任意合适的组合。
在这样的实施例中,该计算机程序可以通过通信部分909从网络上被下载和安装,和/或从可拆卸介质911被安装。在该计算机程序被处理器901执行时,执行本公开实施例的系统中限定的上述功能。根据本公开的实施例,上文描述的系统、设备、装置、模块、单元等可以通过计算机程序模块来实现。
根据本公开的实施例,可以以一种或多种程序设计语言的任意组合来编写用于执行本公开实施例提供的计算机程序的程序代码,具体地,可以利用高级过程和/或面向对象的编程语言、和/或汇编/机器语言来实施这些计算程序。程序设计语言包括但不限于诸如Java,C++,python,“C”语言或类似的程序设计语言。程序代码可以完全地在用户计算设备上执行、部分地在用户设备上执行、部分在远程计算设备上执行、或者完全在远程计算设备或服务器上执行。在涉及远程计算设备的情形中,远程计算设备可以通过任意种类的网络,包括局域网(LAN)或广域网(WAN),连接到用户计算设备,或者,可以连接到外部计算设备(例如利用因特网服务提供商来通过因特网连接)。
附图中的流程图和框图,图示了按照本公开各种实施例的系统、方法和计算机程序产品的可能实现的体系架构、功能和操作。在这点上,流程图或框图中的每个方框可以代表一个模块、程序段、或代码的一部分,上述模块、程序段、或代码的一部分包含一个或多个用于实现规定的逻辑功能的可执行指令。也应当注意,在有些作为替换的实现中,方框中所标注的功能也可以以不同于附图中所标注的顺序发生。例如,两个接连地表示的方框实际上可以基本并行地执行,它们有时也可以按相反的顺序执行,这依所涉及的功能而定。也要注意的是,框图或流程图中的每个方框、以及框图或流程图中的方框的组合,可以用执行规定的功能或操作的专用的基于硬件的系统来实现,或者可以用专用硬件与计算机指令的组合来实现。
本领域技术人员可以理解,本公开的各个实施例和/或权利要求中记载的特征可以进行多种组合和/或结合,即使这样的组合或结合没有明确记载于本公开中。特别地,在不脱离本公开精神和教导的情况下,本公开的各个实施例和/或权利要求中记载的特征可以进行多种组合和/或结合。所有这些组合和/或结合均落入本公开的范围。
以上对本公开的实施例进行了描述。但是,这些实施例仅仅是为了说明的目的,而并非为了限制本公开的范围。尽管在以上分别描述了各实施例,但是这并不意味着各个实施例中的措施不能有利地结合使用。本公开的范围由所附权利要求及其等同物限定。不脱离本公开的范围,本领域技术人员可以做出多种替代和修改,这些替代和修改都应落在本公开的范围之内。

Claims (11)

1.一种基于单元化架构的服务调用方法,所述单元化架构包括多个单元化模块,所述多个单元化模块中部署服务提供者和服务消费者,每个所述服务提供者提供服务事项,每个所述服务事项具有对应的存根信息,所述存根信息包括该服务事项的接口定义,其特征在于,所述服务调用方法应用于所述服务消费者,所述方法包括:
提出服务请求,其中,所述服务请求包括目标服务事项的事项信息;
获取与所述目标服务事项对应的服务事项的存根信息;
解析所述存根信息的接口定义中的注解信息,以得到所述注解信息中的属性值;
加载与所述注解信息中的属性值对应的类;
执行所述类的方法,以获取客户特征值;
根据所述客户特征值,确定能够提供所述目标服务事项的单元化模块;以及
对能够提供所述目标服务事项的单元化模块发起调用请求。
2.根据权利要求1所述的方法,其特征在于,所述事项信息包括请求参数;
所述执行所述类的方法,以获取客户特征值包括:执行所述类的方法,从所述请求参数中解析出所述客户特征值。
3.根据权利要求2所述的方法,其特征在于,所述客户特征值包括所述请求参数中用户的地址信息。
4.根据权利要求3所述的方法,其特征在于,所述根据所述地址信息,确定能够提供所述目标服务事项的单元化模块包括:
计算与所述地址信息对应的单元化模块的编号;以及
根据所述编号确定能够提供所述目标服务事项的单元化模块。
5.一种基于单元化架构的服务调用装置,所述单元化架构包括多个单元化模块,所述多个单元化模块中部署服务提供者和服务消费者,每个所述服务提供者提供服务事项,每个所述服务事项具有对应的存根信息,所述存根信息包括该服务事项的接口定义,其特征在于,所述装置包括:
请求模块,所述请求模块用于执行提出服务请求,其中,所述服务请求包括目标服务事项的事项信息;
获取模块,所述获取模块用于执行获取与所述目标服务事项对应的服务事项的存根信息;
解析模块,所述解析模块用于执行解析所述存根信息的接口定义中的注解信息,以得到所述注解信息中的属性值;
加载模块,所述加载模块用于执行加载与所述注解信息中的属性值对应的类;
执行模块,所述执行模块用于执行所述类的方法,以获取客户特征值;
确定模块,所述确定模块用于执行根据所述客户特征值,确定能够提供所述目标服务事项的单元化模块;以及
调用模块,所述调用模块用于执行对能够提供所述目标服务事项的单元化模块发起调用请求。
6.一种基于单元化架构的服务提供方法,所述单元化架构包括多个单元化模块,所述多个单元化模块中部署服务提供者和服务消费者,每个所述服务提供者提供服务事项,其特征在于,所述服务提供方法应用于所述服务提供者,所述方法包括:
为所述服务事项的接口定义添加注解信息,其中,所述注解信息包括属性值;
根据添加注解信息后的接口定义生成存根信息;以及
发布所述存根信息。
7.根据权利要求6所述的方法,其特征在于,所述发布所述存根信息为将所述存根信息发布至存储仓库。
8.一种基于单元化架构的服务提供装置,所述单元化架构包括多个单元化模块,所述多个单元化模块中部署服务提供者和服务消费者,每个所述服务提供者提供服务事项,其特征在于,所述装置包括:
添加模块,所述添加模块用于执行为所述服务事项的接口定义添加注解信息,其中,所述注解信息包括属性值;
生成模块,所述生成模块用于执行根据添加注解信息后的接口定义生成存根信息;以及
发布模块,所述发布模块用于执行发布所述存根信息。
9.一种电子设备,其特征在于,包括:
一个或多个处理器;
一个或多个存储器,用于存储可执行指令,所述可执行指令在被所述处理器执行时,实现根据权利要求1~4或6~7中任一项所述的方法。
10.一种计算机可读存储介质,其特征在于,所述存储介质上存储有可执行指令,该指令被处理器执行时实现根据权利要求1~4或6~7中任一项所述的方法。
11.一种计算机程序产品,其特征在于,包括计算机程序,所述计算机程序包括一个或者多个可执行指令,所述可执行指令被处理器执行时实现根据权利要求1~4或6~7中任一项所述的方法。
CN202210139670.6A 2022-02-15 2022-02-15 服务调用和提供方法、装置、电子设备、介质和程序产品 Pending CN114490136A (zh)

Priority Applications (1)

Application Number Priority Date Filing Date Title
CN202210139670.6A CN114490136A (zh) 2022-02-15 2022-02-15 服务调用和提供方法、装置、电子设备、介质和程序产品

Applications Claiming Priority (1)

Application Number Priority Date Filing Date Title
CN202210139670.6A CN114490136A (zh) 2022-02-15 2022-02-15 服务调用和提供方法、装置、电子设备、介质和程序产品

Publications (1)

Publication Number Publication Date
CN114490136A true CN114490136A (zh) 2022-05-13

Family

ID=81480603

Family Applications (1)

Application Number Title Priority Date Filing Date
CN202210139670.6A Pending CN114490136A (zh) 2022-02-15 2022-02-15 服务调用和提供方法、装置、电子设备、介质和程序产品

Country Status (1)

Country Link
CN (1) CN114490136A (zh)

Cited By (1)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
CN114885030A (zh) * 2022-06-02 2022-08-09 中国工商银行股份有限公司 服务调用方法、装置、设备、存储介质和程序产品

Cited By (1)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
CN114885030A (zh) * 2022-06-02 2022-08-09 中国工商银行股份有限公司 服务调用方法、装置、设备、存储介质和程序产品

Similar Documents

Publication Publication Date Title
US20190325074A1 (en) Application programing interface document generator
Yadav et al. LARAVEL: a PHP framework for e-commerce website
CN115587575A (zh) 数据表创建方法、目标数据查询方法、装置及设备
CN114237651A (zh) 云原生应用的安装方法、装置、电子设备和介质
CN114490136A (zh) 服务调用和提供方法、装置、电子设备、介质和程序产品
CN113515271A (zh) 服务代码生成方法、装置、电子设备及可读存储介质
CN113010561A (zh) 基于超级账本的数据获取方法、装置、计算机系统
CN113535565B (zh) 一种接口用例生成方法、装置、设备和介质
CN114218283A (zh) 异常检测方法、装置、设备、介质
CN114677114A (zh) 基于图形拖拽的审批流程生成方法及装置
CN111400623B (zh) 用于搜索信息的方法和装置
CN113741888A (zh) 一种业务处理方法和装置
CN114780807A (zh) 业务检测方法、装置、计算机系统及可读存储介质
CN113448578A (zh) 页面数据处理方法、处理系统、电子设备和可读存储介质
CN113641633A (zh) 文件处理方法、装置、电子设备、介质和计算机程序
CN112860344A (zh) 组件处理方法、装置、电子设备和存储介质
CN114237624A (zh) 基于Go语言的错误处理方法、装置、设备、介质和产品
CN115421873A (zh) 字典构建方法、基于字典的文件评估方法及装置、设备
CN114817314A (zh) 数据处理方法、装置、电子设备及存储介质
CN114049211A (zh) 请求指令处理方法、装置、设备及介质
CN116069312A (zh) 页面渲染方法及装置、电子设备和计算机可读存储介质
CN114201214A (zh) 文件生成方法、装置、电子设备、介质和程序产品
CN113971610A (zh) 额度体系配置方法、装置、存储介质和程序产品
CN116483654A (zh) 数据检测方法、装置、电子设备和介质
CN115658749A (zh) 基于有向无环图的基金产品排序方法、装置和电子设备

Legal Events

Date Code Title Description
PB01 Publication
PB01 Publication
SE01 Entry into force of request for substantive examination
SE01 Entry into force of request for substantive examination