在Openfire中使用自己的数据表之修改配置文件

　　目前我使用的Openfire版本是3.10.3，以下使用说明也是在这个版本上做的修改。

　　Openfire提供了两种方式使用用户数据表。一种是安装完成之后默认实现的org.jivesoftware.openfire.user.DefaultUserProvider，一种是org.jivesoftware.openfire.user.JDBCUserProvider，同样对于用户验证也提供了默认实现的org.jivesoftware.openfire.auth.DefaultAuthProvider，一种是org.jivesoftware.openfire.auth.JDBCAuthProvider。前者都是基于安装时候填的数据库表上建立用户表的。如果要想使用自己的用户表或者基于现有的用户表，则需要使用后者。

　　使用自定义的用户表方法有两种，一种是修改配置文件，一种是登录系统修改系统属性。

　　修改配置文件

　　打开Openfire的安装目录，找到conf/openfire.xml配置文件，这个是Openfire加载系统属性的文件，加入以下配置即可修改一些系统属性。

• 增加管理员

　　Openfire默认的登录管理员名称是admin，这里可以进行修改。

 <admin>
         <authorizedUsernames>joe, jane</authorizedUsernames>
 </admin>

以上定义有两个用户名为joe和jane的用户可以登录管理控制台。

• 　使用自定义的数据库连接

 <jdbcProvider>
     <driver>com.mysql.jdbc.Driver</driver>
     <connectionString>jdbc:mysql://localhost/dbname?user=username&amp;password=secret</connectionString>
  </jdbcProvider>

• 自定义认证集成，openfire中默认使用的是md5加密密码的。

 <provider>
     <auth>
       <className>org.jivesoftware.openfire.auth.JDBCAuthProvider</className>
     </auth>
   </provider>
   <jdbcAuthProvider>
      <passwordSQL>SELECT password FROM user_account WHERE username=?</passwordSQL>
      <passwordType>plain</passwordType>
 </jdbcAuthProvider>

这里需要说明className是不能更改的字符串，passwordSQL是查询数据表的sql语句，passwordType是密码的加密方式，有plain、md5、sha1、sha256、sha512等几种字符串可填入。

• 用户数据集成，官方说明，如果使用了用户数据集成，那么就必须使用认证集成。示例如下：

 <provider>
     <auth>
       <className>org.jivesoftware.openfire.auth.JDBCAuthProvider</className>
     </auth>
     <user>
       <className>org.jivesoftware.openfire.user.JDBCUserProvider</className>
     </user>
   </provider>
   <jdbcAuthProvider>
      <passwordSQL>SELECT password FROM user_account WHERE username=?</passwordSQL>
      <passwordType>plain</passwordType>
   </jdbcAuthProvider>
   <jdbcUserProvider>
      <loadUserSQL>SELECT name,email FROM myUser WHERE username=?</loadUserSQL>
      <userCountSQL>SELECT COUNT(*) FROM myUser</userCountSQL>
      <allUsersSQL>SELECT username FROM myUser</allUsersSQL>
      <searchSQL>SELECT username FROM myUser WHERE</searchSQL>
      <usernameField>username</usernameField>
      <nameField>name</nameField>
      <emailField>email</emailField>
  </jdbcUserProvider>

　　其中，user和auth里面的className是Openfire内置的类名，不能更改。jdbcUserProvider是Openfire提供的一些获取用户数据的方法。因为用到自己定义的表，所以字段和表名可能不同，所以必须自定义sql。需要定义的方法有

　　a. loadUserSQL ： 根据用户名查询用户信息，包括名称和邮件。语句后有一个“？”，这个问号会被username替换掉。

　　b. userCountSQL: 查询用户总数。

　　c. searchSQL : 查询用户。where后面没有接入任何字符串，jdbcUserProvider会根据填入查询的用户名或者名称邮件等自动加进去查询。如果没有查询条件将不起作用。

　　d. usernameField: 在自定义数据表中username的字段名。用于以上的sql查询。

　　e. nameField: 在自定义数据表中name的字段名。用于以上的sql查询。

　　f. emailField：在自定义数据表中email的字段名。用户以上的sql查询。

　　

• 　分组集成，如果要使用自己的用户分组，那么也需要加入认证集成，这里认证集成就不再写了，仅展示分组集成配置。

 <provider>
     <group>
   <className>org.jivesoftware.openfire.group.JDBCGroupProvider</className>
     </group>
 </provider>

　　其中group中的className是固定的。

 <jdbcGroupProvider>
        <groupCountSQL>SELECT count(*) FROM myGroups</groupCountSQL>
        <allGroupsSQL>SELECT groupName FROM myGroups</allGroupsSQL>
        <userGroupsSQL>SELECT groupName FROM myGroupUsers WHERE username=?</userGroupsSQL>
        <descriptionSQL>SELECT groupDescription FROM myGroups WHERE groupName=?</descriptionSQL>
        <loadMembersSQL>SELECT username FROM myGroupUsers WHERE groupName=? AND isAdmin='N'</loadMembersSQL>
        <loadAdminsSQL>SELECT username FROM myGroupUsers WHERE groupName=? AND isAdmin='Y'</loadAdminsSQL>
 </jdbcGroupProvider>

以上配置简单说明：

　　a. groupCountSQL: 查询组个数，

　　b. allGroupsSQL: 查询所有的分组。

　　c. userGroupsSQL: 根据用户名查询分组。

　　d. descriptionSQL: 根据组名查询分组描述。

　　e. loadMembersSQL: 根据组名加载分组里面所有的成员。

　　f. loadAdminsSQL: 根据组名查询分组里所有的管理员。