openfire开发环境安装和配置

最新推荐文章于 2016-09-14 08:04:43 发布

luochuan

最新推荐文章于 2016-09-14 08:04:43 发布

阅读量2.4k

点赞数

分类专栏： JAVA

JAVA 专栏收录该内容

5 篇文章 0 订阅

订阅专栏

环境安装

开发环境(IDE)：openfire -3.8.2 + eclipse-jee-juno-SR2-win32 + jdk-1.7

1、获取openfire源码：http://www.igniterealtime.org/downloads/source.jsp

2、创建openfire工程

将SVN检出的openfire源码导出到eclipse的本地工程目录文件夹openfire中
openfire目录下，除READEME.html、LICENSE.html和changelog.html三个网页文件外，有如下四个子目录：
build　　　　　生成安装文件所需要的的一些文件，如JRE等。
resources　　　为实现国际化（i18n）和本地化的一些编码文件。
documentation　关于Openfire安装和配置的信息，Openfire的Javadoc。
src　　　　　　Openfire的源代码目录，这下面又有许多文件夹，其中Java文件夹是实现Openfire核心功能的存放目录，通过它就可以调试Openfire

3. 从现有资源新建项目
(1) 文件->新建->JAVA项目

从现有Ant构建文件创建Java项目

(2) 在弹出的窗口中，点击浏览，找到前面导出的openfire中的build.xml，选中点击完成会创建openfire的项目工程

4. 编译工程
openfire是用ant构建的，所以要先设置使得eclipse中每次编译都使用内置的ant工具，保证编译的正确执行。同时，要在Eclipse中设置为使用JDK作为JVM，如果使用JRE作为JVM，编译就会失败。
因为openfire在Windows下是使用install4j打包成.exe格式的安装文件的，所以需要安装install4j。否则，在使用ant进行编译的时候，在ant视图中可能会出现警告如下信息：taskdef class com.install4j.install4jtask cannot found。这主要是要安装用来打包Java应用程序的install4j.exe程序，而且将要安装到其默认的安装路径C:\Program Files\install4j下。
(1) 在eclipse中点击Window->Show View->Ant，打开Ant窗口
(2) 在Ant 视图中，单击右键，在弹出的快捷菜单中选择Add Buildfiles..
(3) 在弹出的对话框中，展开openfire_src/build文件夹，选择build目录下的build.xml，点击OK
(4) 在Ant视图中, 展开Openfire XMPP Server，双击 openfire_src（default）编译工程
(4) 如果在Console视图中显示“BUILD SUCCESSFUL”就表示编译成功

5. 创建项目Builder
(1) 在eclipse的菜单栏中，选择Run->Open Run Dialog...，在弹出的对话框左侧的树形结构中选择Java Application，单击右键，选择New创建启动配置
(2) 在Run窗口的Main选项卡中, 修改Name文本框中的值，改成包含要启动的类的工程名openfire_src
(3) 在Run窗口的Main选项卡中，点Browse按钮，选择openfire_src
(4) 在Run窗口的Main选项卡中，点Search按钮，选择Main class为org.jivesoftware.openfire.starter.ServerStarter，单击Apply按钮。（这是openfire的启动类）
(5) 点击进入Arguments选项卡，在VM arguments文本框中输入
-DopenfireHome="${workspace_loc:openfire}/target/openfire"
单击Apply按钮。
这个是用于eclipse执行java命令时传递的参数，这样openfire程序可以通过System.getProperty(“openfireHome”)得到openfire的本地位置。
(6) 点击进入Classpath选项卡，选中User Entries，这样Advanced...就处于可用状态；点击Advanced...按钮，在Advanced Options页面，选择Add Folders, 单击OK。（默认情况下，已经将工程openfire添加到了这里，而不需要进行该项操作，如果有多个工程的时候才需要执行该项操作。）选择openfire_src\src\i18n, 点OK按钮将这个文件夹加入到Classpath选项卡中；同样的方式把openfire_src\src\resources\jar目录也加到Classpath选项卡中。
(7) 在Common选项卡中，勾选Run复选框，单击Apply按钮。
设置完毕，这样以后在run这个工程的时候就会按照正确的配置进行了，debug的设置和run的设置类似，不用多说。

6. 运行并测试编译结果（openfire服务器）
(1) 在Eclipse菜单中，单击Run->Run（或快捷方式Ctrl+F11），在Console试图中出现如下所示的信息。
(2) 在Web浏览器中，输入http://127.0.0.1:9090/，如果可以出现配置的openfire的页面，就表示openfire编译、运行成功。

7. 自己定制openfire服务器时，在Eclipse对openfire源代码进行部署
openfire 的起始类为org.jivesoftware.openfire.starter.ServerStarter.java，但是直接运行此类却有问题，因为此类是针对Openfire安装包而设计的，此类的功能是将所用到的JAR文件解压并将class文件加载到虚拟机中，而我们要用的却是源代码中我们自己编译好的class文件。所以，我们需要一个新的启动类。

package org.jivesoftware.openfire.starter;

import org.jivesoftware.openfire.XMPPServer;

public class StandaloneStarter {
    public static void main(String[] args) {
        XMPPServer server = new XMPPServer();
    }
}

这样程序就可以跑起来了，最后的问题就是配置文件路径的问题。
a) 在StandaloneStarter类的启动选项(VM arguments)中加入-DopenfireHome="${workspace_loc:openfire}/target/openfire"，具体方法参见上文。
b) 点击进入Classpath选项卡，选中User Entries，这样Advanced...就处于可用状态；点击Advanced...按钮，在Advanced Options页面，选择Add Folders, 单击OK。（默认情况下，已经将工程openfire添加到了这里，而不需要进行该项操作，如果有多个工程的时候才需要执行该项操作。）选择 openfire_src\src\i18n, 点OK按钮将这个文件夹加入到Classpath选项卡中；同样的方式把openfire_src\src\resources\jar目录也加到 Classpath选项卡中。

********************************************************************************************
另:
使用Eclipse的版本控制插件SVN获取（检出为），具体步骤为：
1. 在eclipse中，选择Windows->Open Perspective->Other
2. 在弹出的窗口中，选择SVN Repository Exploring, 然后点OK
3. 在SVN Repositories 视图中单击右键，选择 New->Repository Location...
4. 在弹出的New Repository Location对话框的输入URL文本框中输入：http://svn.igniterealtime.org/svn/repos/openfire/trunk，然后，单击Finish.。你将会看到页面中出现URL地址。
5. 展开URL地址与openfire树形结构
6. 在trunk上点击右键，选择Check Out（检出为），即可将源代码保存到您所指定的目录下。
7. 用Create project from existing source新建工程，注意工程名要用openfire。

如果您是做二次开发，为了定制自己的服务器端，就可以采用这样方法：
1. 新建工程：File->New->Project->Java Project，单击Next，在Project name文本框中输入工程名：openfire，单击Finish
2. 解压后得到的openfire_src\src目录下所有内容复制到新建的工程目录workspace\openfire下
3. 在Package Explorer视图中，右击openfire工程，选择Properties，在弹出的对话框中选择Libraries->Add JARs..，把openfire_src/build/lib目录下的*.jar类库全部添加进来；选择Source标签页，Add Folder..，选中src/java目录前的复选框，点击OK按钮。（在Eclipse中将此Java文件夹当成源代码文件夹新建工程，建立新工程后观察Openfire所import的包，发现Openfire用了许多开源工具，而这些库都在上文提到的Build目录的lib 目录下，将Openfire用到的库都添加到这个新建工程的Referenced Libraries中。或者如果这样一个一个添加比较麻烦的话还有一个方法就是从你安装好的Openfire服务器目录下的lib目录中（例如："C:\Program Files\Openfire\lib"或"/usr/local/openfire/lib"）找到openfire.jar，打开后将里面的org/jivesoftware删除，重新打包成jar并添加到这个新建工程的Referenced Libraries中，这样就可以省去了很多类似的工作。）但是这样新建的openfire项目没有打包部署，需要开发者自己完成相应的工作。
注意：新建工程之后，可能会出现一些警告信息，下面对此予以说明：对于警告信息，是没有关系的。因为这些警告信息是使用1.5以上版本JDK时候才出现的，使用JDK1.4是不会出现这些警告信息的。因为这些代码中的有些是使用JDK 1.4编写的，而JDK1.4不支持泛型，而JDK 1.5和JDK1.6是支持泛型的。这些警告信息主要是提示将这些非泛型的代码修改为更加高级的方法——泛型，所以这些警告信息是不影响代码结果的。如果需要修改为泛型也是可以，使用泛型来处理相关的集合类。

注意：提示错误如下：

HTTP ERROR: 500

INTERNAL_SERVER_ERROR

RequestURI=/setup/index.jsp

Caused by:

java.lang.NullPointerException

at org.jivesoftware.admin.AdminConsole.getAppName(AdminConsole.java:122)

at org.jivesoftware.openfire.admin.decorators.setup_jsp._jspService(setup_jsp.java:168)

at org.apache.jasper.runtime.HttpJspBase.service(HttpJspBase.java:97)

at javax.servlet.http.HttpServlet.service(HttpServlet.java:820)

at org.mortbay.jetty.servlet.ServletHolder.handle(ServletHolder.java:487)

at org.mortbay.jetty.servlet.ServletHandler.handle(ServletHandler.java:362)

at org.mortbay.jetty.security.SecurityHandler.handle(SecurityHandler.java:216)

at org.mortbay.jetty.servlet.SessionHandler.handle(SessionHandler.java:181)

at org.mortbay.jetty.handler.ContextHandler.handle(ContextHandler.java:726)

at org.mortbay.jetty.webapp.WebAppContext.handle(WebAppContext.java:405)

at org.mortbay.jetty.servlet.Dispatcher.include(Dispatcher.java:192)

at com.opensymphony.module.sitemesh.filter.PageFilter.applyDecorator(PageFilter.java:156)

at com.opensymphony.module.sitemesh.filter.PageFilter.doFilter(PageFilter.java:59)