引用
ajen
的 Openfire插件开发
本文来自CSDN博客,转载请标明出处:http://blog.csdn.net/dyflovexlp/archive/2009/09/22/4578929.aspx
开发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了。
分享到:
相关推荐
NULL 博文链接:https://beautyofprogram.iteye.com/blog/772281
目的:主要是为了监控Openfire各类message,然后对message body做进一步...局限:因为时间有限,本插件并没有对Openfire message协议进行扩展,都是基于原生的xml协议,因此后续开发还需要进行更加深入的二次开发操作。
NULL 博文链接:https://zfms.iteye.com/blog/1702309
Openfire插件开发人员指南
openfire插件开发指南,官网原版翻译,对插件开发有一定的帮助,不错的资源。
该资源实现了Openfire插件开发的入门,即实现了对jsp的访问和servlet的访问。主要是目录结构。哈哈,就说这些吧。
OpenFire插件开发从入门到精通,适用于移动互联聊天服务器搭建。
openfire插件开发.pdf
这是一个文档,内容是如何编写Openfire开发插件、部署源码
这是为openfire服务器开发插件的简单demo,参照博客:http://blog.csdn.net/ibm_hoojo/
openfire插件开发(plugin sevlet)入门 了解简单示例,有助于快速开发插件。 快速方便地使用build.xml进行ant打包编译
openfire第一个插件开发以及源码说明,QQ群:28588322
XMPP协议及其服务器端的Openfire插件开发XMPP背景知识XMPP是一种基于XML的协议,它继承了在XML环境中灵活的发展性。因此,基于XMPP的应用具有超强的可扩展性。绊过扩展以后的XMPP可以通过发送扩展的信息来处理用户的...
NULL 博文链接:https://zxs19861202.iteye.com/blog/2095407
openfire3.6.3插件开发方法说明: winxp/myeclipse6.5/jdk1.5&1.6/mysql5.0/openfire3.6.3 开发步骤:1. 布署openfire3.6.3源码(请参考openfire3.6.3导入eclipse项目实现方法)
openfire shell插件
openfire插件基本代码,可以重复利用
自己从openfire官网上下的openfire插件。
让人快速上手openfire插件的开发,让你节省更多时间了解源码。