Openfire使用与插件开发.doc

Openfire使用与插件开发1、 Openfire安装与配置：下载：点此下载Openfire_src_3_5_1 当前最新版本为3.51配置：1、 把下载出来的压缩包解压存放到工作目录2、 打开Eclipse ,新建一个Project 点击Next 进入如下图：3、 选择第二项点击Browse 选择你Openfire解压出来的目录，Project name里添项目名称，建议和文件夹名一致（复制Directory的项目名字），Finish完成。4、 在新建的项目上右键 Run As Open Run Dialog，弹出如下窗口：双击Java Application 新建一个启动配置：Project 选择Openfire的项目，Main class选择启动类，这里我们选择ServerStarter点击Search 文本框输入ServerStarter 找到类org.jivesoftware.openfire.starter.ServerStarter 点OK完成。勾选上Stop in main，点击Apply。切换到Arguments选项，在VM arugments 里加入：-DopenfireHome=$workspace_loc:openfire_3_5_1/target/openfire ，点击Apply。切换到Classpath下 选择 User Entries 单击Advanced OK ，选择Openfire项目 src i18n OK。重复上面操作再添加src resources OK，点击Apply。切换到Common，勾选Run 、Debug ，点击Apply 。配置完成，我们点下面的Run。程序启动，基本配置完成。2、 插件开发：1、 插件结构：testplugin/ |- plugin.xml - 配置文件 |- readme.html - 用户说明 |- changelog.html - 更新日志 |- icon_small.gif - 小图标 |- icon_large.gif - 大图标 |- src/ - 存放编译的类文件夹 |- database/ - 存放数据库改动 |- i18n/ - 国际化 |- lib/ - 插件所需要的类库 |- web - 显式调用插件时需要的Web页面 |- WEB-INF/ |- web.xml - Web配置 |- web-custom.xml - Web配置 |- images/在项目文件夹下手动新建一个插件文件夹，定义名为testpluin，进入文件夹根据需要新建以上文件夹或文件，其中web、i18n、icon、database都不是必须的。在建立的srcjavaorgjivesoftwareopenfireplugin下建立一个类，起名为TestPlugin。建立plugin.xml ： org.jivesoftware.openfire.plugin. TestPlugin Plugin Test Plugin Aaron 1.0.0 12/24/2007 3.4.1gpl !Web界面需要配置，没有界面则保留空标签即可 - 保存退出。退回到项目根目录 用记事本打开CLASSPATH文件 ，找到类似|plugins/packetFilter/src/java/ kind=src path=src/的地方复制|plugins/packetFilter/src/java/ 并更改其为|plugins/testpluin/src/java/粘贴在|plugins/packetFilter/src/java/后面 。复制一条将 path改为你插件的目录 也就是src/plugins/testplugin/src/java ，保存退出。打开Eclipse点击项目按F5刷新，看到新加入的插件：打开TestPlugin，最基础的类结构如下： package org.jivesoftware.openfire.plugin; import java.io.File; import org.jivesoftware.openfire.*; import org.jivesoftware.openfire.container.*; public class TestPlugin implements Plugin public TestPlugin() public void initializePlugin(PluginManager manager, File pluginDirectory) System.out.println(初始化插件); public void destroyPlugin() System.out.println(停止插件); 插件主类必须实现org.jivesoftware.openfire.plugin. Plugin插件接口并实现里面的两个方法：initializePlugin（PluginManager manager, File pluginDirectory）、destroyPlugin（）。initializePlugin方法在插件加载时调用，destroyPlugin在插件卸载或者重启是调用，在initializePlugin书写你的功能代码或者调用其他方法执行。3、 插件编译编译插件需要ANT工具，Jbuilder、Eclipse都内置Ant工具，我们往环境变量里追加path变量 加入ant 的路径 Jubilder的路径就是：Borland JBuilder2005thirdpartyantbin 加入变量后我们就可以在CMD里调用ANT命令了，运行 CMD 打开命令提示行 ，进入到Openfire项目的根目录下的Build的文件夹 ，输入命令ant plugins编译插件，待插件编译完成后生成的Jar在openfire_3_5_1targetopenfireplugins下面。4、 插件装载找到你的插件复制出来，如果保留在该文件下则插件随Openfire一同启动。将复制出来的插件保存，清空文件夹下除admin文件夹下的所有文件 在Eclipse启动Openfire ，浏览器里输入地址：http:/localhost:9090/ 回车打开Openfire控制台，第一次打开的话会需要一些简单的配置，配置完成后转向到登陆页面，输入用户名密码登陆 ，登陆后 点击菜单上 “插件”链接 进入插件管理页面：点击浏览选择刚才保存的插件，点击Upload Plugin上传 ，上传成功后在插