简介：

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 extends Plugin> P getPlugin(Class<P> 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')

说明两个插件加载成功