1基础简介
XMPP
Extensible Messaging and Presence Protocol,简单的来讲,它就是一个发送接收处理消息的协议,但是这个协议发送的消息,既不是二进制的东东也不是字符串,而是XML。正是因为使用了XML作为消息传递的中介,Extensible 才谈的上,不是么?
Spark Smack 和 Openfire
开源界总是有许多有趣的东东,这三个合起来就是一个完整的XMPP IM 实现。包括服务器端——Openfire,客户端——Spark,XMPP 传输协议的实现——Smack(记住,XMPP是一个协议,协议是需要实现的,Smack起到的就是这样的一个作用)。三者都是基于Java 语言的实现。
Spark 提供了客户端一个基本的实现,并提出了一个很好的插件架构,这对于开发者来说不能不说是一个福音。我强烈建议基于插件方式来实现你新增加的功能,而不是去改它的源代码,这样有利于你项目架构,把原始项目的影响降到最低。
Openfire 是基于XMPP 协议的IM 的服务器端的一个实现,虽然当两个用户连接后,可以通过点对点的方式来发送消息,但是用户还是需要连接到服务器来获取一些连接信息和通信信息的,所以服务器端是必须要实现的。Openfire 也提供了一些基本功能,但真的很基本的!庆幸的是,它也提供插件的扩展,像Spark 一样,同样强烈建议使用插件扩展的方式来增加新的功能,而不是修改人家的源代码。
Smack 是一个XMPP 协议的Java 实现,提供一套可扩展的API,不过有些时候,你还是不得不使用自己定制发送的XML 文件内容的方式来实现自己的功能
企业案例-聚友中国即时通讯-PC端+WEB端+android端+ios端+平板端+云端多平台互通、方便集成各类应用
下图展示了三者之间的关系:
从图上可以了解到,client 端和server端都可以通过插件的方式来进行扩展,smack是二者传递数据的媒介。
Apache MINA
Openfire的通信处理基于Apache MINA框架实现。Apache MINA是一个网络应用程序框架,用来帮助用户简单地开发高性能和高可靠性的网络应用程序。它提供了一个通过Java NIO在不同的传输例如TCP/IP和UDP/IP上抽象的事件驱动的异步API。
Apache MINA 也称为:
● NIO 框架库
● 客户端服务器框架库
● 一个网络套接字库
MINA虽然简单但是仍然提供了全功能的网络应用程序框架:
● 为不同的传输类型提供了统一的API:
○ 通过Java NIO提供TCP/IP 和 UDP/IP支持
○ 通过RXTX提供串口通讯(RS232)
○ In-VM管道通讯
○ 你能实现你自己的API!
● 过滤器作为一个扩展特性; 类似Servlet过滤器
● 低级和高级的API:
○ 低级: 使用字节缓存(ByteBuffers)
○ 高级: 使用用户定义的消息对象(objects)和编码(codecs)
● 高度定制化线程模型:
○ 单线程
○ 一个线程池
○ 一个以上的线程池(也就是SEDA)
● 使用Java 5 SSL引擎提供沙盒(Out-of-the-box) SSL • TLS • StartTLS支持
● 超载保护和传输流量控制
● 利用模拟对象进行单元测试
● JMX管理能力
● 通过StreamIoHandler提供基于流的I/O支持
● 和知名的容器(例如PicoContainer、Spring)集成
● 从Netty平滑的迁移到MINA, Netty是MINA的前辈。
2命名规则
Openfire中常见的类名后缀命名包括Starter、Plugin、Listener、Dispatcher、Handler、Manager、Provider,通常情况下,这些命名类包括如下意义:
XXHandler
实际处理类,以ConnectionHandler为例,在org.jivesoftware.openfire.spi. ConnectionManagerImpl类的startClientSSLListeners(String localIPAddress)方法中,有这样一段代码:
sslSocketAcceptor.bind(new InetSocketAddress(bindInterface, port), new ClientConnectionHandler(serverName));其中bind方法的第二个参数是新创建的一个ClientConnectionHandler的实例,而它就是ConnectionHandler的一个子类。
Openfire的系统配置项采用文件结合数据库表的方式配置,也有部分默认配置项通过Java硬编码方式配置(如org.jivesoftware.openfire. ConnectionManager接口类中定义的DEFAULT_PORT、DEFAULT_SSL_PORT、DEFAULT_COMPONENT_PORT等),Openfire中比较重要的配置位置包括:
一、 src/conf目录下的openfire.xml配置文件。该配置文件为系统核心配置文件。在第一次启动Openfire并通过管理控制台完成安装配置后会往该配置文件中填入相应的配置信息。
二、 plugin.xml配置文件。该配置文件为各插件包下的核心配置文件,由它确定插件核心处理类和相应页面插件的展现等。配置项及含义详见官方插件开发说明部分。
三、 web.xml和web-custom.xml配置文件。用于配置servlet和用户自定义servlet(插件页面用,放在插件对应目录下)。
四、 ofproperty中的各条记录,该表中包括两个字段name和propvalue,分别代表配置项名和配置项值。
系统启动时调用ServerStarter类中的start()方法,通过反射加载org.jivesoftware.openfire.XMPPServer类文件,创建实例时调用其构造函数,在其构造函数中调用其start()方法实际启动服务应用程序。Start()方法中首先调用verifyDataSource()方法验证并确保数据库可以访问,然后会调用 loadModules();initModules();startModules();方法来对Module接口的实现类的各子类进行操作,依次完成模块的加载、初始化和启动操作。loadModules()方法中会调用loadModule(String module)方法通过反射加载各模块类,参数字符串module为对应的模块核心处理类的类名,如AdHocCommandHandler。现以AdHocCommandHandler为例对接下来的处理流程进行说明。通过loadModule创建AdHocCommandHandler类实例时调用其构造函数,在构造函数中初始化了其私有AdHocCommandManager对象。在initModules()时调用AdHocCommandHandler实例的initialize(XMPPServer server)方法对其私有属性对象进行初始化。然后调用start()方法,调用addDefaultCommands方法添加命令并启动命令(通过调用startCommand(AdHocCommand command)方法实现)。
5网络处理
Openfire的数据库处理采用直接调用JDBC 的方式。核心类为org.jivesoftware.database.DbConnectionManager。数据库的处理与业务处理耦合,没有划分出专门的业务逻辑层。
处理方式
通常直接调用XXManager中的实例方法,XXManager中又调用的是对应的接口XXProvider的方法,实际操作在该接口的实现类中实现。实现类是动态绑定的(默认的实现类通常命名规则为DefaultXXProvider),在运行时根据ofproperty表中对应配置项值选择。下面以添加用户组为例进行说明。
首先获得GroupManager的一个实例,在调用其构造函数时调用initProvider()方法,在该方法中获取数据库中配置项的值,若不为空则根据该值通过反射机制获取GroupProvider接口的实现类实例对象;若为空则以DefaultGroupProvider作为GroupProvider接口的实现类并创建实例对象,然后调用GroupProvider. createGroup(String name)方法完成业务操作。
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 | 名字 |
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 | 马克斯一些叶节点,一个节点可能会收集 |
Openfire采用内置的jetty作web服务器,在启动AdminConsolePlugin插件时调用startup()方法启动jetty服务器,9090为其明文端口,9091为其加密端口。
8页面处理
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式导航菜单”部分相关介绍。
9插件开发
官方插件开发说明
所有插件都存放在openfire根下的plugins目录下。当一个插件被以JAR或WAR文件发布时,他自动扩展为一个文件夹。插件目录结构如下所示:
Plugin Structure
myplugin/
|- 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文件指定了主插件类,下面是一个例子。
Itvi plugin.xml
<?xml version="1.0" encoding="UTF-8"?>
<plugin>
<!-- Main plugin class -->
<class>plugin.Itvi</class>
<!-- Plugin meta-data -->
<name>TestPlugin</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>
<!-- Admin console entries -->
<adminconsole>
<!-- More on this below -->
<tab id="mytab" name="Example" url="sample.html" description="Click to manage...">
<sidebar id="mysidebar" name="My Plugin">
<item id="my-plugin" name="My Plugin Admin"
url="sample.html"
description="Click to administer settings for my plugin" />
</sidebar>
</tab>
</adminconsole>
</plugin>
各元数据域能在plugin.xml文件中进行设置:
· name – 插件名.
· description – 插件描述.
· author – 插件作者.
· version – 插件版本.
· date – 插件版本生成日期。该日期必须为MM/dd/yyyy格式, 如07/01/2006.
· url – 关于该插件的更多详细信息可以从该地址获取.
· minServerVersion – 为运行该插件所需的最低的Openfire软件版本(Openfire 2.1.2及后续版本支持该选项).如果服务器版本低于需要的最低版本,插件将不会启动.
· databaseKey – 如果插件需要它自己的数据库表,必须将databaseKey元素设置为一个schema key name(通常与插件同名). 然后需将所有需支持数据库类型的数据库schema 文件放到插件的database文件夹下. 例如,给一个关键字“foo”,那么schema文件需命名为"foo_mysql.sql", "foo_oracle.sql"等.我们建议你在命名你的表时加上前缀"of" (openfire),以避免与其他可能使用同一数据库的其他应用系统需要的表产生冲突.关于版本的描述信息需添加到ofVersion表中,以对应的key做标识,这样可以跟踪schema版本信息,如:
INSERT INTO ofVersion (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表的信息,如:
UPDATE ofVersion set version=1 where name='foo';
· parentPlugin – 父插件名 ("foo.jar"插件相应的为"foo").当一个插件有一个父插件,将不会创建一个新的class loader,相应地替换为使用父插件的class loader。这使得插件间能更紧密地联合工作。子插件不能脱离父插件独立工作。
· licenseType – 指定许可类型信息。 有效值包括:
o "commercial": 插件被发布为商业性插件。
o "gpl": 插件被发布为遵循GNU Public License (GPL)协议。
o "apache": 插件被发布为Apache license系列
o "internal": 插件仅供内部使用,且不能被重新发布。
o "other": 插件被发布为与其他目录下的版本限制不同。License许可信息需在插件自述文件中进行详细描述。
如果许可类型未设置,默认为other。
为了给最终用户提供插件的额外信息,可以为插件添加一些额外文件(全放置在插件的主目录下):
· readme.html – 可选的插件自述文件,它的信息将展现给最终用户。
· changelog.html --可选的插件版本日子文件,它将被展现给最终用户。
· logo_small.png --可选的与插件关联的小图标(16x16)文件(也能为gif文件)。
· logo_large.png --可选的与插件关联的大图标(32x32)文件(也能为gif文件)。
插件必须实现Plugin接口,且有一个默认构造函数。Plugin接口包含了初始化和销毁插件的方法。
Sample plugin implementation
package org.example;
import org.jivesoftware.openfire.container.Plugin;
import org.jivesoftware.openfire.container.PluginManager;
import java.io.File;
/**
* A sample plugin for Openfire.
*/
public class ExamplePlugin implements Plugin {
public void initializePlugin(PluginManager manager, File pluginDirectory) {
// Your code goes here
}
public void destroyPlugin() {
// Your code goes here
}
}