Openfire插件开发

转载 2013年12月05日 14:29:14

http://blog.csdn.net/dyflovexlp/article/details/4578929

声明:只是一个菜鸟的学习笔记,以供日后使用

 

开发openfire插件其实很简单,在openfire/documentation/docs/index.html的这个页面中也有详细的Plugin Develper Guide 插件开发指南。

一、开发插件的目的

在实际需求中,可能会需要一些openfire本身没有提供的功能,比如没有QQ或者MSN的个性签名。如果需要为openfire用户提供个性签名,目前所知有两种做法:第一种修改openfire源码,继承BasicModule或者实现Module,然后在XMPPServer的loadModules方法中启动自定义的Module;第二种做法那当然是插件做法,这样既方便同事之间的合作,又方便以后的openfire升级。

 

二、插件的目录结构

PluginDir

       | -- plugin.xml 必不可少

       | -- classes 用于存放class文件,跟lib是互为可选

       | -- lib 跟lib是互为可选

       | -- web 可选

       | -- database可选

       | -- i18n可选

lib存放你的插件用到的一些jar文件。你可以把自己的class文件打包成jar文件放在lib目录下,这时也就没有必要有classes文件夹了。lib文件夹可以没有,但此时必须要有classes文件夹。

       web文件夹下目录结构必须与正常的web应用有一样的结构。

       Database下存放的是*.sql文件,而且sql文件名的格式必须是PluginName_DBtype.sql。pluginName就是你的插件名称,与上文的pluginDir名字一样。

其实也可以在plugin.xml文件中的databaseKey配置它,配置后就可以为databaseKey_DBtype.sql。DBtype则是数据库的类型,比如mysql,oracle,db2,sqlserver,postgresql,hsqldb和sysbse。一般情况下,我们只需布置一个sql文件。如果你想让你的插件能够适用多种数据库,那应该编写多个文件,毕竟各种数据库间的sql写法还是多少有点区别,而且openfire会判断你配置的数据库类型选择合适的sql文件。

       i18n 下存放的是国际化资源和一些硬性配置的properties文件。

       当然该目录下还可以放其他的乱七八糟的东西,但是openfire加载插件时是不会理会的。

 

三、  plugin.xml配置文件的结构

该文件只是配置一些openfire加载该插件时必须的东西,所以也不用写什么dtd或者shema,只要是份良好有效的xml文档就行。Openfire使用SAXReader来解析该文件。

       简单示例:

 

<?xml version="1.0" encoding="UTF-8"?>
<plugin>
    <!-- Main plugin class -->
    <class>org.example.ExamplePlugin</class><!—- 必须 -->
    <!-- Plugin meta-data -->
    <name>Example Plugin</name> <! –- 可选 -->
    <description>This is an example plugin.</description><! –- 可选 -->
    <author>Jive Software</author><! –- 可选 -->
 
    <version>1.0</version><! –- 可选 -->
    <date>07/01/2006</date><! –- 可选 -->
    <url>http://www.igniterealtime.org/projects/openfire/plugins.jsp</url>
    <minServerVersion>3.0.0</minServerVersion><! –- 可选 -->
    <licenseType>gpl</licenseType><! –- 可选 -->
    < parentPlugin/><! –- 设置父插件,其实就是共用该插件的classLoader,有点类似类的继承,所以子插件可以使用父插件中的任何class -->
 
    <!-- Admin console entries -->
    <adminconsole><! –- 可选 -->
        <!-- More on this below -->
    </adminconsole>
</plugin>

      

       class定义的是插件的入口,必须实现org.jivesofware.openfire.container.Plugin接口。

       minServerVersion 则是你的插件要求openfire的最低版本

四、管理控制台添加页面

如果你的插件需要在控制台配置,则可以修改 the Admin Console。看下文档就应该很容易做到了。你也许发现了,当你登陆http://localhost:9090/后会发现它使用了jsp页面,你可能会认为openfire也是一个web服务器,能够处理http请求,能够解析jsp页面?其实不是的,openfire中要使用的jsp页面事先已经使用jsper-compile.jar编译好了,并且把编译成的servlet配置在web.xml中。运行时根据请求的路径来实例化那些servlet,再调用service方法,处理http请求。

你自己的插件如果有jsp页面也可以把jsp页面先编译好,放到classes根目录下。  或者打包成jar文件放到lib下。Openfire源码提供了的build文件,可以帮助你自动打

包,并且自动帮你在web.xml文件中映射这些servlet。

 

五、实现自己的插件plugin类

你的plugin可以走四条路:

1.       拦截器方式,在你的插件中添加包拦截器,在拦截器中实现你的功能。通过InterceptorManager.getInstance().addInterceptor()添加。

2.       component方式,在插件中添加component。通过ComponentManager.getInstance().addComponent()添加。

3.       Handler方式,通过XMPPServer.getInstance().getIQRouter().addHandler(yourHandler);

4.       PropertyEventListener方式:通过                                          

PropertyEventDispatcher.addListener(yourPropertyEventListner)添加。

简单拦截器方式示例:

public class ArtWeaverPlugin implements Plugin

{

    private PacketInterceptor ic = null;

    @Override

    public void initializePlugin(PluginManager pluginManager, File pluginDirectory)

    {

       ic = new PresenceSignatureInterceptor();

       InterceptorManager.getInstance().addInterceptor(ic);

    }

    @Override

    public void destroyPlugin()

    {

       if(ic != null)

       {

           InterceptorManager.getInstance().removeInterceptor(ic);

       }

    }

    private class PresenceSignatureInterceptor implements PacketInterceptor

    {

       @Override

       public void interceptPacket(Packet packet, Session session,

              boolean incoming, boolean processed) throws PacketRejectedException

       {

           if(!processed && packet instanceof Presence && incoming)

           {

              //在这添加你自己的对packet的处理

           }

    }

}

 

六、最后打包成jar或者war文件

示例使用ant:

<target name = "release" depends="init,clean">

       <jar destfile="${target.plugin}/artweaver.jar"

           basedir="work">

       </jar>

       <antcall target="clean-all"></antcall>

       <antcall target = "copy2openfire"/>

       <antcall target = "copyAll2openfirePlugin"/>

</target>

解释一下:先把classes、plugin.xml、lib等一些东西copy到work文件夹下,jar后删掉work目录。然后把做好的jar文件copy到openfire的目录下。如果你的openfire是启动的开发模式,则openfire会马上把你插件解压,然后马上启动,不用重启服务器就能测试你的plugin了。

 

 

打完收工!!!^_^

openfire_插件开发-helloworld

1.openfire编译运行正常,参见:http://blog.csdn.net/xhcbird/article/details/20458449 2.插件开发,帮助文档很详细,在openfire_s...
  • u013025459
  • u013025459
  • 2014年03月04日 15:08
  • 1113

openfire_插件开发-jsp/servlet

1.openfire编译运行正常,helloworld工作。参见:openfire_插件开发-helloworld 2.openfire_src/src/plugins/xhcplugin/src/增...
  • u013025459
  • u013025459
  • 2014年03月05日 18:48
  • 1305

OpenFire源码学习之十五:插件开发

Plugin接口规范 插件是openfire功能的增强表现,它的主要任务: l  在XMPP协议中作为附加功能实现 l  动态修改控制管理台 l  使用openfire api作为新功能添加到...
  • huwenfeng_2011
  • huwenfeng_2011
  • 2015年02月02日 22:28
  • 6208

【插件开发三】开发继承IQHandler的插件

OF的插件开发有四种方式,下面讲述如何Register a plugin as an IQHandler。IQ handlers相应包中特定的元素名或命名空间。继承IQHandler的插件,需要注册到...
  • majian_1987
  • majian_1987
  • 2013年08月07日 10:09
  • 4111

Openfire安装部署及插件的开发

先说明本人菜鸟一枚,这是我的第一篇博客,记录下我今天辛苦了一天的成果吧,Openfire的安装部署及插件的开发,因为一个小项目的需求需要接触到openfire,网上资料也挺多,但就是太多了,没有一篇,...
  • fOrLOveDoit
  • fOrLOveDoit
  • 2016年04月21日 23:18
  • 1052

openfire插件开发(plugin sevlet)入门

近来几天为了写一个openfire的小插件可谓脑袋都大了。。。自己又是出血
  • u011254308
  • u011254308
  • 2014年05月13日 21:50
  • 2321

Openfire插件开发实例

目的:主要是为了监控Openfire各类message,然后对message body做进一步扩展,让Openfire更适合当前的业务需求。 局限:因为时间有限,本插件并没有对Openfire mes...
  • qiu_11
  • qiu_11
  • 2016年12月23日 11:15
  • 744

Eclipse下OpenFire4.0.2源码配置+简单插件开发

==============源码配置 begin================== 1.下载:地址 2.解压到当前文件夹openfire_src,进入openfire_src>b...
  • lc0817
  • lc0817
  • 2016年05月11日 23:55
  • 4370

(4)-openfire-IntelliJ IDEA插件环境搭建

openfire-IntelliJ IDEA插件环境搭建
  • QXC1281
  • QXC1281
  • 2017年03月31日 22:03
  • 823

(3)-openfire-MyEclipse插件开发环境搭建

openfire-MyEclipse插件开发环境搭建
  • QXC1281
  • QXC1281
  • 2017年03月31日 19:36
  • 439
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Openfire插件开发
举报原因:
原因补充:

(最多只允许输入30个字)