JIOPi v0.2 规范概述

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标注，屏蔽了模块使用的细节，简化了使用模块的学习曲线。