转【jspf】

【原文链接：http://blog.51cto.com/yaocoder/563347】
简介：
jspf (Java Simple Plugin Framework) 是一个插件框架，用于减少小型项目的的开发时间，增加代码的可维护性。他完全隐藏了组件的详细实现，只用到他们的接口。加载组件所需要的代码也很少，便于编写。
jspf框架完全基于java注释实现
@PluginImplementation,@InjectPlugin,@PluginLoaded,@Timer
和@Thread等.
（关于java注释：元数据从metadata一词译来，就是“关于数据的数据”的意思。越来越的开源框架都提供了“元数据”支持，其实也就是注释支持。Annotation是从java5开始在语言级别提供的一项新特性，Annotation提供了一条与程
序元素关联任何信息或者任何元数据（metadata）的途径。从某些方面看，annotation就像修饰符一样被使用，并应用于包、类型、构造方法、方法、成员变量、参数、本地变量的声明中。这些信息被存储在annotation的“name=value”结构对中。annotation类型是一种接口，能够通过java反射API的方式提供对其信息的访问。）
支持：从JAR文件加载插件，从一个目录加载多个插件，自动加载classpath中所有的插件，通过HTTP加载插件。线程安全。类型安全。支持缓存。插件可以使用一个单独的ClassLoader进行可以分离。
相应接口说明
PluginManager pm=PluginManagerFactory.createPluginManager();
pm.addPluginsFrom(new File(“myPluginDir/”).toURI());
/PluginManagerFactory类是为了创建一个新的插件管理中心，这是使用jspf的入口和开始点。/
public void addPluginsFrom(URI url, AddPluginsFromOption… options);
（@param1 url就是指加载插件的路径
@param2 忽略不使用）
/插件管理器从指定路径加载一个插件，这个路径可以是文件夹下的zip文件，jar文件，也可以是类文件。插件管理器将寻找含有@PluginImplementation 注释的类（classes），并且根据这个注释来初始化插件/
addPluginsFrom(new URI(“classpath://*”))
加载所有插件在当前的类路径
addPluginsFrom(new File(“plugins/”).toURI())
加载所有指定路径内的插件
addPluginsFrom(new File(“plugin.jar”).toURI())
加载一个jar格式的插件
addPluginsFrom(new URI(“http://sample.com/plugin.jar“))
从网络路径上下载并且加载插件
addPluginsFrom(new ClassURI(ServiceImpl.class).toURI())
直接加载一个插件实现的类文件
public

P getPlugin(Class

plugin, GetPluginOption… options);
（@param1 plugin就是指插件的类文件，如plugin1.class….
@param2 忽略不使用）
如何使用：
通过http://code.google.com/p/jspf/downloads/list
下载文件，在java工程中导入jspf.core-1.0.0.jar，仿照下面介绍的简单例子就可以实现一个简单的插件管理程序。
代码示例：利用jspf框架加载两个插件的实现
1． 创建一个java接口文件CoolPlugin，代码如下：
package coolplugin;
import net.xeoh.plugins.base.Plugin;
public interface CoolPlugin extends Plugin
{
public String sayCool();
}
（extends Plugin其中Plugin是jspf.core-1.0.0.jar中package net.xeoh.plugins.base中提供的public interface Plugin）
创建一个java类文件，CoolPluginImpl，代码如下：
package impl;
import coolplugin.CoolPlugin;
import net.xeoh.plugins.base.annotations.PluginImplementation;
@PluginImplementation
public class CoolPluginImpl implements CoolPlugin
{
public String sayCool()
{
return “Hello!Cool!”;
}
}
（上述插件接口的实现@PluginImplementation不可少）
这样就完成了第一个Cool插件的编写
2． 创建一个java接口文件HotPlugin，代码如下：
package hotplugin;
import net.xeoh.plugins.base.Plugin;
public interface HotPlugin extends Plugin
{
public String sayHot();
}
创建一个java类文件，HotPluginImpl，代码如下：
package impl;
import hotplugin.HotPlugin;
import net.xeoh.plugins.base.annotations.PluginImplementation;
@PluginImplementation
public class HotPluginImpl implements HotPlugin
{
public String sayHot()
{
return “Hello!Hot!”;
}
}
这样就完成了第二个Hot插件的编写
3.编写插件管理中心main,代码如下
public static void main(String[] args) throws MalformedURLException
{
PluginManager pm = PluginManagerFactory.createPluginManager();
/load classpath/
pm.addPluginsFrom(new File(“bin/”).toURI());
CoolPlugin plugin1 = pm.getPlugin(CoolPlugin.class);
System.out.println(plugin1.sayCool());
HotPlugin plugin2 = pm.getPlugin(HotPlugin.class);
System.out.println(plugin2.sayHot());
}
运行后得到的结果是
“Hello!Cool!”
“Hello!Hot!”
利用”addPluginsFrom(“…”,new OptionReportAfter());”监视方法，可以获得详细信息:
Class Report <<<
*.CoolPluginImpl (status:’SPAWNED’; dependencies:”; origin:’file:**;)
*.HotPluginImpl (status:’SPAWNED’; dependencies:”; origin:’file*/’;)

Object Report <<<
**.CoolPluginImpl @162db76 (status:’ACTIVE’)
**.HotPluginImpl @21a14e (status:’ACTIVE’)
说明两个插件加载成功