openfire build

1. build path：

a) source folder：包括openfire和各插件的代码。

b) libraries：build/lib下jar包和插件下jar包，jdk/lib/tools.jar（编译jsp需要）。

2. ant build：build/build.xml

a) openfire(default)：构建openfire。

b) plugins：构建所有插件。

c) plugin –Dplugin=search：构建插件search。

3. start server：org.jivesoftware.openfire.starter.ServerStarter

a) VM arguments：根、库、插件目录和调试模式 -DopenfireHome=target/openfire -Dopenfire.lib.dir=target/openfire/lib -DpluginDirs=target/openfire/plugins -DdevelopmentMode=true

b) classpath： src/i18n：国际化文本。 src/resources/jar：MIME类型和Console配置文件。

4. running：

a) ServerStarter：更新ClassLoader，将lib加进来，实例化唯一的XMPPServer。

b) XMPPServer：

i. 初始化：定位openfireHome，JiveGlobals读取conf/openfire.xml，JiveProperties读取数据库表ofproperty，获取host，设置version，初始化PluginManager，检查数据库。

ii. 加载、初始化、启动模块：Model：initialize，start，stop，destroy，getName；其他接口：ServerFeaturesProvider，特性支持；

iii. BasicModule：私有域name，停止时stop和destroy。

1. boot modules：

a) RoutingTableImpl：所有消息路由。

b) AuditManagerImpl：实现AuditManager。

c) RosterManager：所有花名册管理。

d) PrivateStorage：所有隐私管理。

2. core modules：

a) PresenceManagerImpl：所有状态管理。

b) SessionManager：所有会话管理。

c) PacketRouterImpl：转给IQRouter、MessageRouter、PresenceRouter。

d) MulticastRouter：广播特性，路由带多个地址（addresses）的包。

e) PacketTransporterImpl：传送包：PacketDelivererImpl：实现PacketDeliver，转移处理；TransportHandler：网关处理。

f) OfflineMessageStrategy：离线留言策略。OfflineMessageStore：存储离线留言。

g) VCardManager：用户名片管理。

3. standard modules：

a) IQHandler：全部被交给。

IQBindHandler：处理绑定资源请求；

IQSessionEstablishmentHandler：绑定资源后激活会话；

IQAuthHandler：处理登录请求；

IQPingHandler：处理ping请求；

IQPrivateHandler：处理隐私请求；

IQTimeHandler：处理时间请求。

IQvCardHandler：处理名片请求；

IQVersionHandler：处理版本请求；

IQLastActivityHandler：处理最近活动请求；

IQOfflineMessagesHandler：处理获取离线留言请求；

IQPEPHandler：处理公共订阅请求；

IQPEPOwnerHandler；IQSharedGroupHandler：处理共享组请求；

AdHocCommandHandler：处理命令请求；

IQDiscoInfoHandler；

IQDiscoItemsHandler。

b) PresenceSubscrieHandler：处理状态订阅请求。

PresenceUpdateHandler：处理状态请求。

c) MulticastDNSService：发布服务器信息。

d) DefaultFileTransferManager：实现FileTransferManager，管理文件传输；FileTransferProxy：

e) MediaProxyService：多媒体传输协议供jingle使用。

f) STUNService：点对点支持。

g) PubSubModule：

h) UpdateManager：检查服务器和插件升级版本。

i) FlashCrossDomainHandler：

j) InternalComponentManager：管理组件。

k) MultiUserChatManager：管理多人聊天。

l) ClearspaceManager：

m) ConnectionManagerImpl：实现ConnectionManager，处理连接请求。

n) WorkGroupSupport：工作组支持 iv. StatisticsManager，PubSubEngine监听服务启动。 v. PluginManager：监视并加载插件目录下的插件。

5. serving：

a) 登录：ConnectionManager声明了五种连接：client、client ssl、external component、other server、connection manager，它们有各自的端口并且可禁用。ConnectionManagerImpl创建多个SocketAcceptor监听各个端口，并绑定不同的ConnectionHandler：管理会话，创建各自的NIOConnection和StanzaHandler并将消息交给后者处理，它创建不同的LocalSession。 client client ssl external component connection manager SocketAccepter SocketAccepter SocketAccepter SocketAccepter ClientCH ClientCH ComponentCH MultiplexerCH ClientSH ClientSH ComponentSH MultiplexerSH LClientS LClientS LComponentS LConnectionMultiplexerS L*S 消息路径：(SocketAccepter)IoSession = > ConnectionHandler => NIOConnection、StanzaHandler => PacketRouter(LocalSession)，然后分IQ、Presence、Message分别路由。

b) IQRouter：RoutingTable、MulticastRouter、SessionManager、UserManager、IQHandler。错误的包交给从SessionManager获得的Session，广播交给MulticastRouter，给其他人的包交给RoutingTable(错误也路由给自己)，剩下的交给IQHandler(根据包里的namespace找到唯一的处理者)。

c) PresenceRouter：RoutingTable（路由）、MulticastRouter（广播）、SessionManager（出错）、PresenceManager（探测）、PresenceUpdateHandler（更新）、PresenceSubscribeHandler（订阅）。

d) MessageRouter：RoutingTable、MulticastRouter、SessionManager、UserManager（判断注册）、OfflineMessageStrategy（保存留言）。

e) 关键类的理解：

i. ClientConnectionHandler：负责监听IoSession的建立、收发消息和关闭，并且构建Conection和StanzaHandler，收到的消息交给后者，通过前者发送消息。

ii. NIOConnection：保存了表示与用户之间连接的IoSession，通过它发送消息给用户，或者使用PacketDeliver转发消息作为离线留言存储；它通常被Session使用。

iii. ClientStanzaHandler：先建立Session（最终是SessionManager创建并注入Connection），收到的消息交给PacketRouter处理。 iv. LocalClientSession：保存用户信息(IQAuthHandler处理登录)，设置用户状态，给用户发送消息，由SessionManager统一管理。

f) 路由功能类：

i. MulticastRouter：广播发送给服务器且有addresses元素的包。

ii. RoutingTableImpl：routePacket转发消息给user、component、server。

iii. IQHandler：处理IQ包。IQAuthHandler处理用户登录，IQBindHandler处理资源绑定，

iv. PresenceUpdateHandler：通过Session设置用户状态。 v. PresenceSubscribeHandler：处理状态订阅包。

g) 管理者类：

i. RosterManager：管理Roster，每个花名册可以广播用户状态给好友。

ii. PrivacyListManager：管理PrivacyList，如果不阻止联系人就发给他状态，使用PrivacyListProvider从数据库加载隐私列表。

iii. UserManager：管理或创建User，更改密码，使用UserProvider从数据库加载用户信息。

iv. PresenceManager：管理用户最后活动状态，用户上下线状态信息。

v. GroupManager：使用GroupProvider管理用户组。

vi. VCardManager：使用VCardProvider管理用户名片。

h) 工厂类：

i. AuthFactory：可配AuthProvider，验证用户登录、获得并加解密用户密码，登录后会告诉UserManager通过UserProvider加载User。

i) 其他类：

i. AdminConsole：获得程序名称和版本，添加删除模块。 逻辑简要： ConnectionManagerImpl作为最后一个模块被加载、初始化和启动，它使用mina-core.jar中的SocketAcceptor、IoSession、IoHandler等处理底层通讯。ClientConnectionHandler是个IoHandler，它监听用户连接请求并用打开的IoSession建立NIOConnection（它调用IoSession发消息给用户）和ClientStanzaHandler，后者通过SessionManager为用户建立LocalClientSession并注入NIOConnection，而从用户收到的Packet则让PacketRouter转发给IQRouter、PresenceRouter和MessageRouter，出错信息可能由Sesssion处理后交给Connection返回给用户，处理成功则让RoutingTableImpl路由给接受者，IQAuthHandler处理用户登录认证的包Authentication然后设置Session的状态为已认证，广播包由MulticastRouter处理，查询包由相应名称空间的IQHandler处理，状态包由PresenceUpdateHandler和PresenceSubscribeHandler处理，消息包一般由RoutingTable的routePacket路由给接收者的Session，如果接收者没有登录则返回给MessageRouter的routingFailed，它调用OfflineMessageStrategy保存为离线消息。