当前位置: 首页 > 工具软件 > JIOPi > 使用案例 >

JIOPi v0.2 规范概述

司寇研
2023-12-01

JIOPi v0.2 建立了类加载模型的基本规则

 

说明:如未特殊说明,下文中的 JIOPi 均指 JIOPi v0.2 规范

 

JIOPi主题:蓝图初现
在模块程序中增加非运行时JIOPi标注或Jar文件中增加xml配置,模块Jar既可作为JIOPi模块使用,也可作为POJO模块用于其它程序。

 

JIOPi v0.2在继承了 JIOPi v0.1POJO兼容的基础上,增加了JIOPi蓝图的全面支持,新增了以下特征和编程风格

  • 无需了解实现模块代码细节,按接口API规范使用实现模块
  • 接口名短名称注册机制,避免使用冗长接口名
  • 模块间自由依赖,依赖模块运行时自动安装部署
  • 免部署方式编码风格简化,可直接将变量、函数注册为短名称进行调用
  • 模块程序通过标注与实现接口绑定
  • 可定义模块类的实例化方式(单例/原型),获取方式(构造函数/工厂方法),以及指定初始化方法
  • 模块库增加蓝图部署,以保证同一版本的蓝图使用完全相同的程序

JIOPi的一个重要思想是,开发人员需要使用的是API蓝图,而不是模块,因此,开发人员只需了解蓝图的使用,指定蓝图的实现模块名,即可使用该蓝图,而无需了解实现的细节,如类的实例化方式,相关依赖等。

 

为了实现这个目标,JIOPi选择使用配置文件来指定运行时的对象加载规则,并提供了非运行时标注来简化配置文件的编写, 非运行时标注可以使得包含JIOPi标注的Java类依然可以运行于非JIOPi环境,而不会出现任何异常。

 

JIOPi标注分为 Blueprint 和 Module 两类,Blueprint 类标注用于定义和蓝图使用相关的信息,如提供类、方法、变量的短名称访问注册等,Module 类标注是用于 模块开发的,用于定义模块的执行策略,如将实现类与接口绑定,指定实例化方式,工厂方法等,下面将对这些标注逐一介绍。

 

Blueprint类标注

@Target(ElementType.TYPE)

public @interface Blueprint

指定蓝图的名称,版本和版本类

String name(); 定义蓝图的名称

String version(); 定义蓝图的版本

Class<?> versionInterface(); 定义包含蓝图版本信息的接口类

 

 

@Target({ElementType.TYPE,ElementType.METHOD,ElementType.FIELD})

public @interface RegisterControlPanel

进行短名称注册,简化调用代码

String value() default ""; 注册名

 

Module类标注

 

@Target(ElementType.TYPE)

public @interface Instantiation

指定类对象的实例化方式

InstanceType type() default InstanceType.PROTOTYPE; 单例模式/原型模式

String factoryMethod() default ""; 使用工厂方法获取对象还是默认构造器

String initMethod() default ""; 定义初始化方法,将在对象被实例化后调用

 

@Target({ElementType.TYPE})

public @interface RegisterModule

将当前实现类与其实现的接口进行绑定,以便JIOPi容器可以通过接口名查询实现类

String[] value() default {}; 在默认情况下,JIOPi容器会将其与所有实现接口或继承类进行绑定,但有时候可能需要将一个接口的父类和子类指定不同的实现类,这时就必须填写具体要与哪个接口进行绑定

 

蓝图库

蓝图库增加蓝图配置

<blueprints url-format="http://www.example.org/libroot/jiopi-config-blueprint-${blueprint}.xml"/>

其余配置方式同模块

 

 

总结

JIOPi v0.2定义了JIOPi风格的蓝图的基本使用,通过在模块中加入JIOPi标注,屏蔽了模块使用的细节,简化了使用模块的学习曲线。

 类似资料: