openfire4.1.5服务器部署及其异常处理

      本文档旨在为在Windows系统下快速构建Openfire开发环境和集成插件环境进行相关说明。期望读者为Openfire开发人员和Openfire服务器测试、维护人员。

         Openfire服务器： 基于XMPP（jabber）协议的开源实时协作（RTC）服务器，采用Java语言开发。可快速构建企业级的高效及时通信服务器。

         Openfire插件：Openfire的可扩展应用服务模块，单个插件可通过Openfire的后台管理功能进行管理、发布、升级。

         运行环境：JDK1.8，版本基于操作系统x86/x64确定。

1.源码下载地址：http://www.igniterealtime.org/downloads/source.jsp ，下载解压出来后不用管README.html、LICENSE.html、changelog.html这三个文件，用到的只有src、resources、documentation、build这四个文件夹。

2.打开eclipse，新建一个Java Project，Project name和解压出来的目录名字一致，将Use default location勾去掉，在Location里面，Browse到解压的目录，然后直接Finish。

3.可能会有几个目录报错，这是由于需要一些jar包。然后在工程根目录下面新建一个libs文件夹，将coherence.jar复制到libs下面。

4.在工程名称上面点右键--Properties--Java Build Path--Libraries--Add JARs...将复制到libs目录下的jar包导入进去。5.点击Window--Show View--Ant，调出Ant窗口。

6.在Ant中选择Add buildfile，将工程目录下build中的build.xml添加进去。

7.选中加载进去的文件，点击工具栏上的Run the Default Target of the Selected Buildfile。

8.项目进行搭建，控制台出现BUILD SUCCESSFUL，即搭建成功。

9.在工程名上面点击右键--Run As--Run Configurations。在左侧选择Java Application，在右边Main选项卡下面的Projet中Browse浏览选择工程。点击Main选项卡下面Main class中的Search，在弹出的搜索框中，选择ServerStarter - org.jivesoftware.openfire.starter。

10.在右边的选项卡中选择Arguments，在VM arguments里面填入：-DopenfireHome="${workspace_loc:openfire}/target/openfire"

11.在选项卡中选择Classpath，选中User Entries，点击右边的Advanced...按钮，在弹出的选择框中，选中Add Filders，然后按OK，在弹出的选择框中，选择工程目录下的i18n，将该文件夹添加到User Entries。安装同样的方法，将工程目录/src下的resources也添加进去。

12.在选项卡中选择Common，将Debug和Run勾选上。然后点击Apply，再点击Run。

13.在http://127.0.0.1:9090上面可以访问后台管理界面。登陆管理页面进行设置，完成后下载Spark进行测试。

异常处理：java.lang.NullPointerException

       atorg.jivesoftware.admin.AdminConsole.getAppName(AdminConsole.java:117)

       ......等等

这个问题因为文件路径所导致的问题，需要将admin-sidebar.xml和openfire_i18n_en.properties这2个文件直接放在openfire\bin目录下即可解决这个问题。如果再次出现，这样的问题，就需要将openfire目录下的你把openfire下的work 和target文件都删除了，然后重新发布一个。因为web的内容不会自动更新的，只有.class会自动更新。

在opnefire4.1.5中我暂时只遇到了这一个异常，其他异常处理建议请在回复补充。