openfire处理消息流程,及openfire详细信息

XMPP介绍ExtensibleMessagingandPresenceProtocol，简单的来讲，它就是一个发送接收处理消息的 协议 离婚协议模板下载合伙人协议 下载渠道分销协议免费下载敬业协议下载授课协议下载 ，但是这个协议发送的消息，既不是二进制的东东也不是字符串，而是XML。正是因为使用了XML作为消息传递的中介，Extensible才谈的上，不是么？IMInstantMessenger，及时通信软件，就是大家使用的QQ、MSNMessenger和Gtalk等等。其中Gtalk就是基于XMPP协议的一个实现，其他的则不是。当前IM几乎作为每个上网者必然使用的工具，在国外的大型企业中有一些企业级的IM应用，但是其商业价值还没完全发挥出来。设想既然XMPP协议是一个公开的协议，那么每个企业都可以利用它来开发适合本身企业工作，提高自身生产效率的IM；甚至，你还可以在网络游戏中集成这种通信软件，不但让你可以边游戏边聊天，也可以开发出适合游戏本身的IM应用，比如说一些游戏关键场景提醒功能，团队语音交流等等都可以基于IM来实现。SparkSmack和Openfire开源界总是有许多有趣的东东，这三个合起来就是一个完整的XMPPIM实现。包括服务器端——Openfire，客户端——Spark，XMPP传输协议的实现——Smack（记住，XMPP是一个协议，协议是需要实现的，Smack起到的就是这样的一个作用）。三者都是基于Java语言的实现。Spark提供了客户端一个基本的实现，并提出了一个很好的插件架构，这对于开发者来说不能不说是一个福音。我强烈建议基于插件方式来实现你新增加的功能，而不是去改它的源代码，这样有利于你项目架构，把原始项目的影响降到最低。Openfire是基于XMPP协议的IM的服务器端的一个实现，虽然当两个用户连接后，可以通过点对点的方式来发送消息，但是用户还是需要连接到服务器来获取一些连接信息和通信信息的，所以服务器端是必须要实现的。Openfire也提供了一些基本功能，但真的很基本的！庆幸的是，它也提供插件的扩展，像Spark一样，同样强烈建议使用插件扩展的方式来增加新的功能，而不是修改人家的源代码。Smack是一个XMPP协议的Java实现，提供一套可扩展的API，不过有些时候，你还是不得不使用自己定制发送的XML文件内容的方式来实现自己的功能下图展示了三者之间的关系：从图上可以了解到，client端和server端都可以通过插件的方式来进行扩展，smack是二者传递数据的媒介。ApacheMINAOpenfire的通信处理基于ApacheMINA框架实现。ApacheMINA是一个网络应用程序框架，用来帮助用户简单地开发高性能和高可靠性的网络应用程序。它提供了一个通过JavaNIO在不同的传输例如TCP/IP和UDP/IP上抽象的事件驱动的异步API。　　ApacheMINA也称为:　　●NIO框架库　　●客户端服务器框架库　　●一个网络套接字库　　MINA虽然简单但是仍然提供了全功能的网络应用程序框架：　　●为不同的传输类型提供了统一的API:　　○通过JavaNIO提供TCP/IP和UDP/IP支持　　○通过RXTX提供串口通讯(RS232)　　○In-VM管道通讯　　○你能实现你自己的API!　　●过滤器作为一个扩展特性;类似Servlet过滤器　　●低级和高级的API:　　○低级:使用字节缓存(ByteBuffers)　　○高级:使用用户定义的消息对象(objects)和编码(codecs)　　●高度定制化线程模型:　　○单线程　　○一个线程池　　○一个以上的线程池(也就是SEDA)　　●使用Java5SSL引擎提供沙盒(Out-of-the-box)SSL•TLS•StartTLS支持　　●超载保护和传输流量控制　　●利用模拟对象进行单元测试　　●JMX管理能力　　●通过StreamIoHandler提供基于流的I/O支持　　●和知名的容器(例如PicoContainer、Spring)集成　　●从Netty平滑的迁移到MINA，Netty是MINA的前辈。命名规则Openfire中常见的类名后缀命名包括Starter、Plugin、Listener、Dispatcher、Handler、Manager、Provider，通常情况下，这些命名类包括如下意义：XXStarter系统启动类，如org.jivesoftware.openfire.starter.ServerStarter，调用其start()方法可启动系统应用。XXListener业务的最终处理类。XXDispatcher调度类，其中有很多关键方法，如addListener()，以组合的方式，为类内定义的静态Set<XXListener>实例添加XXListener对象。以便调用dispatchEvent(Stringproperty,EventTypeeventType,Map<String,Object>params)方法遍历处理Set集中的XXListener对象（通过调用XXListener对象的各实际方法完成实际业务）。XXPlugin实现Plugin接口的插件类,需实现initializePlugin(PluginManagermanager,FilepluginDirectory)方法和destroyPlugin()方法。在其初始化方法中调用Dispatcher实现类的addListener()方法如PropertyEventDispatcher.addListener(this)。XXProvider实现面向接口编程方式的接口类，通过反射机制创建具体实现类的对象，反射类名配置在ofproperty表对应的记录propvalue属性中。若没有相关配置，则调用默认实现类，默认实现类类名命名规则为DefaultXXProvider。XXHandler实际处理类，以ConnectionHandler为例，在org.jivesoftware.openfire.spi.ConnectionManagerImpl类的startClientSSLListeners(StringlocalIPAddress)方法中，有这样一段代码：sslSocketAcceptor.bind(newInetSocketAddress(bindInterface,port),newClientConnectionHandler(serverName));其中bind方法的第二个参数是新创建的一个ClientConnectionHandler的实例，而它就是ConnectionHandler的一个子类。系统配置项Openfire的系统配置项采用文件结合数据库表的方式配置，也有部分默认配置项通过Java硬编码方式配置（如org.jivesoftware.openfire.ConnectionManager接口类中定义的DEFAULT_PORT、DEFAULT_SSL_PORT、DEFAULT_COMPONENT_PORT等），Openfire中比较重要的配置位置包括：1、src/conf目录下的openfire.xml配置文件。该配置文件为系统核心配置文件。在第一次启动Openfire并通过管理控制台完成安装配置后会往该配置文件中填入相应的配置信息。2、plugin.xml配置文件。该配置文件为各插件包下的核心配置文件，由它确定插件核心处理类和相应页面插件的展现等。配置项及含义详见官方插件开发说明部分。3、web.xml和web-custom.xml配置文件。用于配置servlet和用户自定义servlet(插件页面用，放在插件对应目录下)。4、ofproperty中的各条记录，该表中包括两个字段name和propvalue，分别代表配置项名和配置项值。系统启动流程系统启动时调用ServerStarter类中的start()方法，通过反射加载org.jivesoftware.openfire.XMPPServer类文件，创建实例时调用其构造函数，在其构造函数中调用其start()方法实际启动服务应用程序。Start()方法中首先调用verifyDataSource()方法验证并确保数据库可以访问，然后会调用loadModules();initModules();startModules();方法来对Module接口的实现类的各子类进行操作，依次完成模块的加载、初始化和启动操作。loadModules()方法中会调用loadModule(Stringmodule)方法通过反射加载各模块类，参数字符串module为对应的模块核心处理类的类名,如AdHocCommandHandler。现以AdHocCommandHandler为例对接下来的处理流程进行说明。通过loadModule创建AdHocCommandHandler类实例时调用其构造函数，在构造函数中初始化了其私有AdHocCommandManager对象。在initModules()时调用AdHocCommandHandler实例的initialize(XMPPServerserver)方法对其私有属性对象进行初始化。然后调用start()方法，调用addDefaultCommands方法添加命令并启动命令（通过调用startCommand(AdHocCommandcommand)方法实现）。网络处理消息监听服务SSL等监听服务的调度在ConnectionManagerImpl类中实现。ConnectionManagerImpl.createClientSSLListeners()方法启动SSL监听消息封装信息处理采用XML节的方式传递信息，消息封装通常采用IQ、Message、Presence。Openfire消息包接受处理流程数据库处理Openfire的数据库处理采用直接调用JDBC的方式。核心类为org.jivesoftware.database.DbConnectionManager。数据库的处理与业务处理耦合，没有划分出专门的业务逻辑层。ConnectionProvider此类为数据库提供者接口，如需连接mysql、hsqldb等数据库，需首先实现些接口，处理方式通常直接调用XXManager中的实例方法，XXManager中又调用的是对应的接口XXProvider的方法，实际操作在该接口的实现类中实现。实现类是动态绑定的（默认的实现类通常命名规则为DefaultXXProvider），在运行时根据ofproperty表中对应配置项值选择。下面以添加用户组为例进行说明。首先获得GroupManager的一个实例，在调用其构造函数时调用initProvider()方法，在该方法中获取数据库中配置项的值，若不为空则根据该值通过反射机制获取GroupProvider接口的实现类实例对象；若为空则以DefaultGroupProvider作为GroupProvider接口的实现类并创建实例对象，然后调用GroupProvider.createGroup(Stringname)方法完成业务操作。常用类org.jivesoftware.database.DbConnectionManager连接管理类org.jivesoftware.util.JiveGlobals通常用于操作ofproperty表中记录openfire数据结构数据库表以下是一个说明每个表格的Openfire数据库架构。黄色行表示主键。        ofGroup        ofGroupProp        ofGroupUser        ofID        ofOffline        ofPresence        ofPrivate        ofUser        ofUserProp        ofUserFlag        ofRoster        ofRosterGroups        ofPrivacyList        ofVCard        ofVersion        ofProperty        ofExtComponentConf        ofRemoteServerConf        ofSecurityAuditLog        ofMucService        ofMucServiceProp        ofMucRoom        ofMucRoomProp        ofMucAffiliation        ofMucMember        ofMucConversationLog        ofPubsubNode        ofPubsubNodeJIDs        ofPubsubNodeGroups        ofPubsubAffiliation        ofPubsubItem        ofPubsubSubscription        ofPubsubDefaultConf ofGroup（用户组的数据） 列名 类型 长度 描述 groupName VARCHAR 50 组名称（主键） description VARCHAR 255 组描述 ofGroupProp（名称值协会为一组） 列名 类型 长度 描述 groupName VARCHAR 50 组名称（主键） name VARCHAR 100 组属性名称（主键） propValue VARCHAR 4000 组属性值 ofGroupUser（组成员） 列名 类型 长度 描述 groupName VARCHAR 50 组名称（主键） username VARCHAR 100 用户名（主键） administrator NUMBER n/a 是否为管理员（布尔）（主键） ofID（用于唯一ID序列生成） 列名 类型 长度 描述 idType NUMBER n/a 证件类型（例如，组，用户名册）（主键） id NUMBER n/a 下一个可用块编号的（用于数据库独立编号） ofOffline（离线邮件存储） 列名 类型 长度 更改 username VARCHAR 32 用户名（主键） messageID NUMBER n/a 存储信息的编号（主键） creationDate VARCHAR 15 日期信息存储 messageSize NUMBER n/a 邮件的大小以字节为单位 stanza TEXT n/a 消息文本 ofPresence（离线的存在） 列名 类型 长度 更改 username VARCHAR 64 用户名（主键） offlinePresence TEXT n/a 存在的信息设置为用户注销 offlineDate CHAR 15 信息存储日期 ofPrivate（私人数据存储） 列名 类型 长度 描述 username VARCHAR 32 用户名（主键） name VARCHAR 100 姓名私营项（主键） namespace VARCHAR 200 名字空间私营项（主键） privateData TEXT n/a 价值的私人数据 ofUser（用户数据） 列名 类型 长度 描述 username VARCHAR 32 用户名（主键） plainPassword VARCHAR 32 纯文字密码数据 encryptedPassword VARCHAR 255 加密的密码数据（默认） name VARCHAR 100 名字 email VARCHAR 100 电邮地址 creationDate VARCHAR 15 创建日期 modificationDate VARCHAR 15 最后更新日期 ofUserProp（名称值协会针对用户） 列名 类型 长度 描述 username VARCHAR 32 用户名（主键） name VARCHAR 100 用户属性名称（主键） propValue VARCHAR 4000 用户属性值 ofUserFlag（用户类型标识（如残疾人）） 列名 类型 长度 描述 username VARCHAR 64 用户名（主键） name VARCHAR 100 用户属性名称（主键） startTime CHAR 15 国旗的时候，开始被有效（无效的'现在'） endTime CHAR 15 当时国旗是结束有效（无效的'永远'） ofRoster（好友列表） 列名 类型 长度 描述 rosterID NUMBER n/a 编号名册（主键） username VARCHAR 32 用户名 jid TEXT n/a 地址名册入境 sub NUMBER n/a 认购地位入境 ask NUMBER n/a 卖出地位入境 recv NUMBER n/a 检举表明进入名册收到请求 nick VARCHAR 255 昵称分配给这个名册入境 ofRosterGroups（组的好友名单中的条目） 列名 类型 长度 描述 rosterID NUMBER n/a 名册编号（主键） rank NUMBER n/a 立场项（主键） groupName VARCHAR 255 用户定义的名称，这个名册组 ofPrivacyList（用户隐私清单） 列名 类型 长度 描述 username VARCHAR 32 用户名（主键） name VARCHAR 100 姓名保密清单（主键） isDefault NUMBER n/a 检举指出，如果这是默认隐私的用户名单 list TEXT n/a XML表示的隐私清单 ofVCard（电子名片的联系信息） 列名 类型 长度 描述 username VARCHAR 32 用户名（主键） vcard TEXT n/a 价值的vCard入境 ofVersion（包含产品版本信息） 列名 类型 长度 描述 name VARCHAR 50 名称的项目，版本信息正在跟踪的（主键） version INTEGER n/a 版本号 ofProperty（服务器属性） 列名 类型 长度 描述 name VARCHAR 100 属性名称（主键） propValue TEXT n/a 进入值 ofExtComponentConf（外部元件配置） 列名 类型 长度 描述 subdomain VARCHAR 255 子的外部元件（主键） secret VARCHAR 255 共享密钥的外部元件 permission VARCHAR 10 许可，表明如果组件是可以连接到服务器 ofRemoteServerConf（远程服务器配置） 列名 类型 长度 描述 xmppDomain VARCHAR 255 域的外部元件（主键） remotePort NUMBER n/a 港口的远程服务器连接到 permission VARCHAR 10 许可，表明如果远程服务器可以连接到服务器 ofSecurityAuditLog（伐木安全事件） 列名 类型 长度 描述 msgID NUMBER n/a 编号审计信息（主键） username VARCHAR 64 使用者谁执行的行动 entryStamp NUMBER n/a 时间戳当事件发生 summary VARCHAR 255 总结了发生在事件 node VARCHAR 255 节点事件发生 details TEXT n/a 详细的细节，所发生的 ofMucService（甲Groupchat服务） 列名 类型 长度 描述 serviceID NUMBER n/a 编号的服务（收录） subdomain VARCHAR 255 子服务（主键） description VARCHAR 255 服务说明 isHidden NUMBER n/a 1，如果隐藏的管理界面名单，0正常 ofMucServiceProp（名称值协会的Groupchat服务） 列名 类型 长度 描述 serviceID NUMBER n/a 编号的服务（主键） name VARCHAR 100 属性名称（主键） propValue TEXT n/a 属性值 ofMucRoom（Groupchat室内资料） 列名 类型 长度 描述 roomID NUMBER n/a 编号的房间（主键） creationDate VARCHAR 15 创建日期 modificationDate VARCHAR 15 最后更新日期 name VARCHAR 50 姓名房间用作公共编号 naturalName VARCHAR 255 天然名称室 description VARCHAR 255 客房描述 canChangeSubject NUMBER n/a 检举指出是否可以改变参与者的主题 maxUsers NUMBER n/a 马克斯一些房间居住者 canChangeSubject NUMBER n/a 检举指出是否与会者可以改变的主题或不 publicRoom NUMBER n/a 检举指示是否室将在目录中列出或不 moderated NUMBER n/a 检举指示是否室主持或不 membersOnly NUMBER n/a 检举指出是否房间是会员制或不 canInvite NUMBER n/a 检举指出是否占用可以邀请其他用户 roomPassword VARCHAR 50 密码数据加入室 canDiscoverJID NUMBER n/a 检举指出是否真正JID的居住者是公共或不 logEnabled NUMBER n/a 检举指出是否房间谈话记录或不 subject VARCHAR 100 最后为人所知的主题房间 rolesToBroadcast NUMBER n/a 二元代表的作用，以广播 useReservedNick NUMBER n/a 检举指出是否用户只能加入室使用其保留昵称 canChangeNick NUMBER n/a 检举指出是否可以改变其占用的空间昵称 canRegister NUMBER n/a 检举显示用户是否被允许登记室 ofMucRoomProp（名称值协会的Groupchat房间） 列名 类型 长度 描述 roomID NUMBER n/a 编号的房间（主键） name VARCHAR 100 属性名称（主键） propValue VARCHAR 4000 属性值 ofMucAffiliation（归属的空间用户） 列名 类型 长度 描述 roomID NUMBER n/a jid TEXT n/a 用户JID（主键） affiliation NUMBER n/a 一些代表所属一级 ofMucMember（室成员资料） 列名 类型 长度 描述 roomID NUMBER n/a 编号的房间（主键） jid TEXT n/a 用户JID（主键） nickname VARCHAR 255 保留昵称的会员 ofMucConversationLog（室会话日志） 列名 类型 长度 描述 roomID NUMBER n/a 编号的空间 sender TEXT n/a JID的用户发送邮件的房间 nickname VARCHAR 255 昵称使用时由用户发出的信息 logTime VARCHAR 15 日期的消息时，被送到房间 subject VARCHAR 50 新的主题改变的信息 body TEXT n/a 消息正文 ofPubsubNode（节点pubsub服务） 列名 类型 长度 描述 serviceID VARCHAR 100 编号托管服务节点（主键） nodeID VARCHAR 100 编号的节点（主键） leaf NUMBER n/a 检举表明节点是否是叶或收集节点 creationDate VARCHAR 15 创建日期 modificationDate VARCHAR 15 最后更新日期 parent VARCHAR 100 编号的父节点（如果有的话） deliverPayloads NUMBER n/a 检举指出是否有效载荷中包含的通知 maxPayloadSize NUMBER n/a 最大规模的有效载荷的字节 persistItems NUMBER n/a 检举表明节点是否将持续出版项目 maxItems NUMBER n/a 最大的项目数量将持续 notifyConfigChanges NUMBER n/a 检举指出是否发送通知时，该节点的配置发生了变化 notifyDelete NUMBER n/a 检举指出是否发送通知时，该节点将被删除 notifyRetract NUMBER n/a 检举指出是否发送通知时，发布的项目将被删除 presenceBased NUMBER n/a 检举指出是否发送通知只有用户才 sendItemSubscribe NUMBER n/a 检举指出是否向去年出版项目，以新用户 publisherModel VARCHAR 15 Publisher中使用的模式的节点 subscriptionEnabled NUMBER n/a 检举指出是否允许订阅 configSubscription NUMBER n/a 检举指出是否新的订户必须设定为活跃 accessModel VARCHAR 10 访问模型所使用的节点 payloadType VARCHAR 100 类型的有效载荷数据将提供在节点 bodyXSLT VARCHAR 100 网址的一个XSLT转换有效载荷的格式为一个邮件正文 dataformXSLT VARCHAR 100 网址的一个XSLT转化的有效载荷格式的数据形式结果 creator VARCHAR 1024 JID的实体建立了节点 description VARCHAR 255 说明节点 language VARCHAR 255 默认语言的节点 name VARCHAR 50 名称节点 replyPolicy VARCHAR 15 政策界定业主或出版商是否应得到答复项目 associationPolicy VARCHAR 15 政策规定谁可以联系叶节点的集合 maxLeafNodes NUMBER n/a 马克斯一些叶节点，一个节点可能会收集 ofPubsubNodeJIDs（JIDs与节点） 列名 类型 长度 描述 serviceID VARCHAR 100 编号托管服务节点（主键） nodeID VARCHAR 100 编号的节点（主键） jid VARCHAR 1024 JID实体（主键） associationType VARCHAR 20 协会类型的节点 ofPubsubNodeGroups（名册集团与节点） 列名 类型 长度 内容 serviceID VARCHAR 100 编号托管服务节点 nodeID VARCHAR 100 编号的节点 rosterGroup VARCHAR 100 名册组节点所有者可以签署和检索项目 ofPubsubAffiliation（节点分支机构） 列名 类型 长度 描述 serviceID VARCHAR 100 编号托管服务节点（主键） nodeID VARCHAR 100 编号的节点（主键） jid VARCHAR 1024 JID的子公司（主键） affiliation VARCHAR 10 所属类别 ofPubsubItem（项目发布到节点） 列名 类型 长度 描述 serviceID VARCHAR 100 编号托管服务节点（主键） nodeID VARCHAR 100 编号的节点（主键） id VARCHAR 100 编号的出版项目（独特的每个节点）（主键） jid VARCHAR 1024 JID出版商 creationDate VARCHAR 15 创建日期 payload TEXT n/a XML的有效载荷包括在出版项目 ofPubsubSubscription（订阅节点） 列名 类型 长度 描述 serviceID VARCHAR 100 编号托管服务节点（主键） nodeID VARCHAR 100 编号的节点（主键） id VARCHAR 100 编号认购（主键） jid VARCHAR 1024 地址接收通知 owner VARCHAR 1024 JID的子公司，拥有认购 state VARCHAR 15 国家认购（工作流程中的） deliver NUMBER n/a 检举指出是否通知或未启用 digest NUMBER n/a 检举表明一个实体是否希望收到通知摘要 digest_frequency NUMBER n/a 最低数目的毫秒之间发出任何两个通知消化 expire VARCHAR 15 日期在租赁认购将结束或已经结束 includeBody NUMBER n/a 检举表明一个实体是否希望收到邮件正文除了有效载荷格式 showValues VARCHAR 30 存在这些国家的实体希望收到通知 subscriptionType VARCHAR 10 无论是用户订阅的项目或节点（收集节点只） subscriptionDepth NUMBER n/a 收到通知的儿童一定深度（收集节点只） keyword VARCHAR 200 关键字活动必须符合 ofPubsubDefaultConf（默认配置节点） 列名 类型 长度 描述 serviceID VARCHAR 100 编号托管服务节点（主键） leaf NUMBER n/a 检举指出是否配置属于叶或收集节点（主键） deliverPayloads NUMBER n/a 检举指出是否有效载荷中包含的通知 maxPayloadSize NUMBER n/a 最大规模的有效载荷的字节 persistItems NUMBER n/a 检举表明节点是否将持续出版项目 maxItems NUMBER n/a 最大的项目数量将持续 notifyConfigChanges NUMBER n/a 检举指出是否发送通知时，该节点的配置发生了变化 notifyDelete NUMBER n/a 检举指出是否发送通知时，该节点将被删除 notifyRetract NUMBER n/a 检举指出是否发送通知时，发布的项目将被删除 presenceBased NUMBER n/a 检举指出是否发送通知只有用户才 sendItemSubscribe NUMBER n/a 检举指出是否向去年出版项目，以新用户 publisherModel VARCHAR 15 Publisher中使用的模式的节点 subscriptionEnabled NUMBER n/a 检举指出是否允许订阅 accessModel VARCHAR 10 访问模型所使用的节点 language VARCHAR 255 默认语言的节点 replyPolicy VARCHAR 15 政策界定业主或出版商是否应得到答复项目 associationPolicy VARCHAR 15 政策规定谁可以联系叶节点的集合 maxLeafNodes NUMBER n/a 马克斯一些叶节点，一个节点可能会收集WEB服务器Openfire采用内置的jetty作web服务器，在启动AdminConsolePlugin插件时调用startup()方法启动jetty服务器，9090为其明文端口，9091为其加密端口。页面处理Openfire没有采用现在很流行的技术架构（SSH），只使用JSP+JavaBean，但是它有自己的系统设计，就连日志都是自己做的，没有使用我们熟悉的log4j。现有的Openfire管理控制台可采用插件方式进行扩展（详见插件开发说明部分介绍），页面采用Jsp方式实现，页面直接调用业务处理逻辑类（通常命名为XXManager）的实例方法，通常通过request对象封装的方式传递页面展现判定变量，常出现本页跳转。每个插件可定义自己的Servlet类和web.xml及web-custom.xml配置文件。采用装饰框架方式展现页面，decorator页面有两个，即src/web/decorators目录下的两个页面main.jsp和setup.jsp。采用自定义的admin标签实现，标签库admin.tld放置在src/web/WEB-INF目录下，标签解析类放置在org.jivesoftware.admin包下，有SidebarTag、SubnavTag、SubSidebarTag、TabsTag四个解析类。在调用loadPlugin()方法进行插件加载时，解析插件的plugin.xml配置文件，将获取的相关信息封装在AdminConsole类的generatedModel对象中，后期通过插件解析类提取该对象中的数据并配合sitemesh装饰器进行页面展现。详见“使用dom4j设计Openfire式导航菜单”部分相关介绍。插件开发OpenfirePlugins加载流程官方插件开发说明所有插件都存放在openfire根下的plugins目录下。当一个插件被以JAR或WAR文件发布时，他自动扩展为一个文件夹。插件目录结构如下所示：PluginStructuremyplugin/|-plugin.xml<-插件定义文件|-readme.html<-可选的插件自己述文件，它将被显示给最终用户。|-changelog.html<-可选的插件版本日志文件，它将被展现给最终用户。|-logo_small.gif<-可选的与插件关联的小图标（16x16）文件（也能为png文件）|-logo_large.gif<-可选的与插件关联的大图标（32x32）文件（也能为png文件）|-classes/<-你的插件需要的资源文件（如properties文件）|-database/<-可选的你的插件需要的数据库schema文件|-i18n/<-可选的i18n文件，它们为插件提供国际化支持|-lib/<-你的插件需要的库(JAR文件)|-web<-需要集成到管理控制台中的各类资源（如果有的话）|-WEB-INF/|-web.xml<-配置jsp调度的web.xml配置文件|-web-custom.xml<-可选的用户定义的web.xml文件，用于调度自定义servlets|-images/若插件需要为Openfire的管理控制台添加内容，则web文件夹必须存在。具体内容详述如下。Plugin.xml文件指定了主插件类，下面是一个例子。Itviplugin.xml<?xmlversion="1.0"encoding="UTF-8"?><plugin><!--Mainpluginclass--><class>plugin.Itvi</class><!--Pluginmeta-data--><name>TestPlugin</name><description>Thisisanexampleplugin.</description><author>JiveSoftware</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><!--Adminconsoleentries--><adminconsole><!--Moreonthisbelow--><tabid="mytab"name="Example"url="sample.html"description="Clicktomanage..."><sidebarid="mysidebar"name="MyPlugin"><itemid="my-plugin"name="MyPluginAdmin"url="sample.html"description="Clicktoadministersettingsformyplugin"/></sidebar></tab></adminconsole></plugin>各元数据域能在plugin.xml文件中进行设置：·name–插件名.·description–插件描述.·author–插件作者.·version–插件版本.·date–插件版本生成日期。该日期必须为MM/dd/yyyy格式,如07/01/2006.·url–关于该插件的更多详细信息可以从该地址获取.·minServerVersion–为运行该插件所需的最低的Openfire软件版本（Openfire2.1.2及后续版本支持该选项）.如果服务器版本低于需要的最低版本，插件将不会启动.·databaseKey–如果插件需要它自己的数据库表，必须将databaseKey元素设置为一个schemakeyname（通常与插件同名）.然后需将所有需支持数据库类型的数据库schema文件放到插件的database文件夹下.例如，给一个关键字“foo”，那么schema文件需命名为"foo_mysql.sql","foo_oracle.sql"等.我们建议你在命名你的表时加上前缀"of"(openfire),以避免与其他可能使用同一数据库的其他应用系统需要的表产生冲突.关于版本的描述信息需添加到ofVersion表中，以对应的key做标识，这样可以跟踪schema版本信息，如:INSERTINTOofVersion(name,version)VALUES('foo',0);·databaseVersion–数据库schema版本（如果定义了数据库schema）。有数据库schema的新插件的版本从0开始编号。如果以后的插件版本需要更新schema，这些更新能通过在database/upgrade目录下为各版本创建子目录的方式来定义。例如目录database/upgrade/1和database/upgrade/2将包括如"foo_mysql.sql"和"foo_oracle.sql"这样的包含各版本相应的数据库改变信息的脚本.这些脚本中均需要更新ofVersion表的信息，如:UPDATEofVersionsetversion=1wherename='foo';·parentPlugin–父插件名("foo.jar"插件相应的为"foo").当一个插件有一个父插件，将不会创建一个新的classloader，相应地替换为使用父插件的classloader。这使得插件间能更紧密地联合工作。子插件不能脱离父插件独立工作。·licenseType–指定许可类型信息。有效值包括:·"commercial":插件被发布为商业性插件。·"gpl":插件被发布为遵循GNUPublicLicense(GPL)协议。·"apache":插件被发布为Apachelicense系列·"internal":插件仅供内部使用，且不能被重新发布。·"other":插件被发布为与其他目录下的版本限制不同。License许可信息需在插件自述文件中进行详细描述。如果许可类型未设置，默认为other。为了给最终用户提供插件的额外信息，可以为插件添加一些额外文件（全放置在插件的主目录下）:·readme.html–可选的插件自述文件，它的信息将展现给最终用户。·changelog.html--可选的插件版本日子文件，它将被展现给最终用户。·logo_small.png--可选的与插件关联的小图标（16x16）文件（也能为gif文件）。·logo_large.png--可选的与插件关联的大图标（32x32）文件（也能为gif文件）。插件必须实现Plugin接口，且有一个默认构造函数。Plugin接口包含了初始化和销毁插件的方法。Samplepluginimplementationpackageorg.example;importorg.jivesoftware.openfire.container.Plugin;importorg.jivesoftware.openfire.container.PluginManager;importjava.io.File;/***AsamplepluginforOpenfire.*/publicclassExamplePluginimplementsPlugin{publicvoidinitializePlugin(PluginManagermanager,FilepluginDirectory){//Yourcodegoeshere}publicvoiddestroyPlugin(){//Yourcodegoeshere}}Openfire插件开发人员指南导言插件是增强Openfire功能。这份文件是一个开发人员创建插件指南。结构的一个插件插件存放在插件openfireHome目录。当部署一个jar或war插件文件，它会自动解压安装。该文件在插件目录结构如下：插件结构  myplugin/                  | -plugin.xml                           插件定义文件                  |-readme.html                          任择自述文件的插件，它会显示给最终用户                  |-changelog.html