java(jsp)整合discuz同步登录功能详解

三叶草

最近做了一个资源库系统的项目，老师说可以搭建开源论坛替代自己开发社交模块，正好在开源中国上看到了一个利用discuz的UCenter功能实现同步登录的开源项目（https://code.google.com/p/discuz-ucenter-api-for-java/），不禁大喜，于是花了几个小时照着教程操作了一遍，居然很轻松的成功了，特写此文以做纪念。。
Uenter是Comsenz旗下各个产品之间信息直接传递的一个桥梁，通过UCenter站长可以无缝整合Comsenz系列产品，实现用户的一站式注册、登录、退出。UCenter可以让Comsenz旗下所有产品联系地更加紧密，实现用户的统一注册登录，让社区真正运转起来。 UCenter拥有机制完善的接口，经过简单修改便可以挂接其它任何平台的第三方的网络应用程序。UCenter作为信息传统桥梁，拥有统一的短信息、好友机制，最终用户可以通过它轻松通行在各个应用之中，无需重复登录、注册、退出。统一的标签(TAG)机制，将社区中各个应用紧密连接，用户可以在社区里面进行自由穿梭，快速找到所需的应用，获得最佳的使用体验。
首先，第一步，安装好apache和ph
我的版本为php-5.4.23-Win32-VC9-x86和httpd-2.2.25-win32-x86-openssl-0.9.8y

基本上没有遇到什么特别的问题，除了因为php和apache的版本不配套耽误了点时间，其余基本顺利。

如果php里面是2_4，则需要下载一个低版本的php，否则会导致apache服务器无法正常解析php文件。
第二步，安装discuz，我安装的版本是Discuz_X3.1_SC_UTF8.zip。安装的时候勾选全新安装会顺便安装UCenter，如果没有安装的话就需要自己下载安装了，版本为UCenter1.5+
第三步，开始配置UCenter服务器端(就是UCenter安装的那个程序)

如图:

第三步，配置我们自己的程序，也就是客户端。
1.拷贝开源项目里的jar包https://code.google.com/p/discuz-ucenter-api-for-java/downloads/list
2.配置一个用于与UCenter对接的servlet

<servlet>
    <servlet-name>connect_discuz</servlet-name>
    <servlet-class>com.fivestars.interfaces.bbs.api.UC</servlet-class>
    <load-on-startup>2</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>connect_discuz</servlet-name>
    <url-pattern>/api/uc.php</url-pattern>
</servlet-mapping>

3.把配置文件（config.properties）复制到src目录下

#
# ================================================
# * Discuz! Ucenter API for JAVA
# ================================================
# UC comunication settings
#  
# 
#uc server url如果是全新安装的模式，ucenter可以随discuz一起安装，路径是
UC_API = https://{discuz根目录}/uc_server
#uc ip address
UC_IP = 127.0.0.1
#key
UC_KEY = yunstudio
#appid
UC_APPID = 2
#connect mode: default value is ""
UC_CONNECT =

4.把开源项目中的demo（Jsp_demo.jsp）复制到应用的根目录中。原来作者的jsp文件编码和文件头都有点小问题，所以我稍微的修改了一下。

<%
/**
 * ================================================
 * Discuz! Ucenter API for JAVA
 * ================================================
 * JSP 调用示例
 * 
 * 更多信息：https://code.google.com/p/discuz-ucenter-api-for-java/
 * 作者：梁平 (no_ten@163.com) 
 * 创建时间：2009-2-20
 */
%>
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ page import="com.fivestars.interfaces.bbs.util.XMLHelper"%>
<%@ page import="com.fivestars.interfaces.bbs.client.Client"%>
<%
Client uc = new Client();
String result = uc.uc_user_login("admin", "yun");
LinkedList<String> rs = XMLHelper.uc_unserialize(result);
if(rs.size()>0){
  int $uid = Integer.parseInt(rs.get(0));
  String $username = rs.get(1);
  String $password = rs.get(2);
  String $email = rs.get(3);
  if($uid > 0) {
    response.addHeader("P3P"," CP="CURa ADMa DEVa PSAo PSDo OUR BUS UNI PUR INT DEM STA PRE COM NAV OTC NOI DSP COR"");
    out.println("登录成功");
    out.println($username);
    out.println($password);
    out.println($email);
    String $ucsynlogin = uc.uc_user_synlogin($uid);
    out.println("登录成功"+$ucsynlogin);
    //本地登陆代码
    //TODO ... ....
    Cookie auth = new Cookie("auth", uc.uc_authcode($password+"\t"+$uid, "ENCODE"));
    auth.setMaxAge(31536000);
    //auth.setDomain("localhost");
    response.addCookie(auth);
    Cookie user = new Cookie("uchome_loginuser", $username);
    response.addCookie(user);
  } else if($uid == -1) {
    out.println("用户不存在,或者被删除");
  } else if($uid == -2) {
    out.println("密码错");
  } else {
    out.println("未定义");
  }
}else{
  out.println("Login failed");
  System.out.println(result);
}
%>

如果例子能运行起来，那么注册登出什么的就可以直接看官网上的代码看懂了，很简单的。