java和Discuz論壇實現單點登錄，通過Ucenter（用戶管理中心）

樂虎國際

一 Discuz論壇搭建步驟
  1：服務器環境配置
         服務器要支持php語言+支持mysql 5.0以上的數據庫 + Apache服務器（支持網站的一個服務器，通過域名的能訪問就可以了）

         Msql5.0以上的數據庫一個。

  2：安裝Discuz
         （1）下載Discuz源碼包http://www.discuz.net/thread-3570835-1-1.html

         （2）解壓源碼包Discuz_X3.2_SC_GBK.zip（這里以Discuz X3/2為例）有三個文件，把           其中的upload文件夾里面的內容放在網站的根目錄下。

                   注意：

是upload文件夾下面的所有內容放入網站根目錄下，如果把upload整個文件夾放在網站根目錄訪問的地址就是http://localhost/upload）

         （3）訪問域名地址就開始安裝如圖：參考地址：

http://jingyan.baidu.com/article/ac6a9a5ea76e022b653eacca.html

                  

                    

配置數據庫信息：

提前創建好mysql數據庫，用戶/密碼，這里進行配置。同時給設置一個管理員賬號和密碼：點擊下一步

                   注意：一定是mysql 5.0以上的數據庫版本

                  

                   如果沒有問題的話就安裝成功了。它會自動創建對應的數據庫表等相關信息。

                   然后訪問域名就直接可以訪問論壇了。

　 3：Discuz的簡單配置介紹
       （1）前臺登錄及管理員功能
                  

                   如果是管理員的話會有一些管理信息



如果是管理員瀏覽帖子的話，會有“置頂”，“精華”，“明亮”等操作，如圖：



具體還有很多，這里不一一介紹。



       （2）后臺管理心中
管理中心，就是進入后臺管理的入口。主要是網站的風格，和布局

                   管理中心后臺有很多功能，首先需要設置的是論壇大致板塊，如下圖：

                  

                   對應的前臺如下圖：



我理解的時間也有限，具體設置還需要多進行操作，這里不進行逐個說明。

二 Discuz論壇與java無縫對接（單點登錄）
  1： Discuz和java對接的原理
        Discuz和java對接需要一個中間件，它就是Ucenter。Comsenz（康盛）的UCenter當前在國內的單點登錄領域占據絕對份額，其完整的產品線令UCenter成為了賬號集成方面事實上的標準。基于UCenter，可以將Comsenz旗下的Discuz!（社區論壇系統）、SupeSite（門戶CMS系統）、X-Space（博客系統）從用戶資源層面進行無縫整合，使得賬號實現統一管理，在任何一個系統中進行注冊、登錄、注銷等操作時，該賬號在其他系統中的會話狀態也將同步更新，最終實現一號通的單點登錄模式。



使用ucenter進行同步操作，主要依托于ucenter  server 和ucenter client之間的api接口進行通訊。要使得通訊成為可能，首先要通過ucenter管理所用應用（通過配置使得當前應用和ucenter產生聯系，也就是通訊成功）。其他應用通過掛接到ucenter的接口上，從而使得某些數據可以進行同步操作。

                  

  2 ： Discuz和Ucenter通道的配置
（1）Ucenter用戶管理中心的簡單介紹

         Discuz和Ucenter都屬于Comsenz（康盛）公司的產品，所以Discuz和Ucenter之間的通信通道非常容易建立。

    Discuz中附帶的有Ucenter應用程序例如：

    之前Discuz論壇安裝之后訪問地址是http://localhost/ upload，那么Ucenter的訪問地址是http://localhost/ upload/uc_server，登錄界面如下：



輸入之前的管理員密碼即可登錄成功！

后臺管理頁面如下



（2）Ucenter于Discuz通道建立。

         我們如果用的是Discuz自帶的Ucenter，他與Discuz就已經默認是互通的，我可以直接來用也可以重新配置。建立成功如下：



         注釋：這里有系統默認的我們就直接用，下面Ucenter于java建立通道的時候會詳細說明怎么建立通道，建立通信通道的方式都是一樣的。

3 ： Java和Ucenter通道的配置
（1）Ucenter端添java web網站通道
登錄成功之后

應用管理》添加應用

        

         標紅的為主要填寫的。其他的可以不填寫。



安裝方式：自定義

應用類型：其他

應用名稱：JAVA項目名稱，可隨意

應用主URL：JAVA項目的訪問地址，例如：http://localhost:8080/javaTest

通信密鑰：任意字符，例如：123456

應用接口文件名稱：uc.php，這個不要改，前面也不要加/api/，UCenter在與其通信時會自動轉換為：http://localhost:8080/javaTest/api/uc.php

是否開啟同步登錄：是

是否接受通知：是

以上的配置項必填，其他保持為空即可。

點擊“提交”，保存成功后，記下該JAVA應用的APPID，下面的配置中會需要。

此時返回應用列表，UCenter會自動進行通信驗證，不出意外肯定會出現“通信失敗”的字樣，先不必管它

因為java端也需要一些配置

（2）java web網站端的配置
1、從“discuz-ucenter-api-for-java”的開源項目網站中下載相關的API文件，也可以從這里下載：JAVA_UCenter.zip

這里給一個比較好的下載地址，包括源碼，及jar包文件：

http://code.google.com/p/discuz-ucenter-api-for-java

2、將JAVA_UCenter.zip解壓、覆蓋到你的JAVA項目中，其中的新文件有：

src/config.properties：本地的JAVA項目與UCenter的接口配置文件（需要根據實際環境進行配置）

src/api/ucenter/Base64.java

src/api/ucenter/Client.java：將常用的UCenter操作封裝成的客戶端對象，我們在項目中主要用它來與UCenter打交道

src/api/ucenter/PHPFunctions.java

src/api/ucenter/UC.java：本地的JAVA項目用來接收UCenter同步命令的Servlet接口，其訪問地址必須為：/api/uc.php

src/api/ucenter/XMLHelper.java

WebRoot/WEB-INF/web.xml：主要就是將src/api/ucenter/UC.java定義為Servlet



注意：

(1) src/config.properties中的代碼如下：

# ================================================
# Ucenter API for JAVA
# ================================================
UC_API = http://localhost:9201
UC_IP =
UC_KEY = 123456
UC_APPID = 2
UC_CONNECT =

其中，UC_API表示UCenter的訪問地址，UC_KEY就是在UCenter中添加新應用時定義的通信密鑰，UC_APPID表示新應用的APPID，就是剛才記下的那個。

除這三項外，其他的配置保持為空即可。

(2) WebRoot/WEB-INF/web.xml中的代碼如下：

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4"
    xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
    http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
   
  <servlet>
    <display-name>同步UC Server發出的操作指令</display-name>
    <servlet-name>UC</servlet-name>
    <servlet-class>api.ucenter.UC</servlet-class>
    <load-on-startup>2</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>UC</servlet-name>
    <url-pattern>/api/uc.php</url-pattern>
  </servlet-mapping>
  
</web-app>

別的無所謂，只需注意這一行：<url-pattern>/api/uc.php</url-pattern>

3、JAVA端配置完成，在eclipse中啟動調試模式

4、再次返回到UCenter的控制臺，點擊應用管理，此時應該會看到綠色的“通信成功”字樣





         到這里Discuz和Ucenter之間的通信通道與java和Ucenter之間的通信通道都已經建立成功，下面就可以在2.3.4看具體如何開發



2.3.4  Java端具體代碼實現
（1）java網站web 網站注冊同步Discuz論壇注冊
1> 步驟說明：

注冊java網站web網站 > 調用Client里面的UC注冊Discuz論壇的接口（uc_user_register） > 判斷注冊結果

         2>具體代碼實現（僅供參考）

         //java網站網站的注冊

      boolean falg = tempUserService.insert(tempUserVO);

      //同步論壇的注冊

      if(falg){

         Client uc = new Client();

         String $returns = uc.uc_user_register(tempUserVO.getUsername(), tempUserVO.getPass(), tempUserVO.getEamil());

         int $uid = Integer.parseInt($returns);

           if ($uid <= 0) {

               if ($uid == -1) {

                   System.out.print("用戶名不合法");

               } else if ($uid == -2) {

                   System.out.print("包含要允許注冊的詞語");

               } else if ($uid == -3) {

                   System.out.print("用戶名已經存在");

               } else if ($uid == -4) {

                   System.out.print("Email 格式有誤");

               } else if ($uid == -5) {

                   System.out.print("Email 不允許注冊");

               } else if ($uid == -6) {

                   System.out.print("該 Email 已經被注冊");

               } else {

                   System.out.print("未定義");

               }

           }

           System.out.println("id:"+$uid);

         System.out.println("添加成功！");

        

      }else{

         System.out.println("添加失敗！");

      }

（2）java網站web 網站登錄，同步Discuz論壇登錄
1> 步驟說明：

登錄民信web網站 > 調用Client里面的UC登錄接口獲取用戶信息 > 接受返回的用戶XML信息并解析 > 調用Client登錄DIscuz論壇的登錄接口 > 接受返回過來的js代碼 > 輸出到java網站web網站 > 跳轉到論壇地址（此時已經你會發現用戶已經登錄）

         2>具體代碼實現（僅供參考）

//網站的登錄

      TempUser tempUser =  tempUserService.queryByName(tempUserVO.getUsername());

      System.out.println("結果："+tempUser.getAddress()+"  =="+tempUser.getEamil());

      request.getSession().setAttribute("tempUser", tempUser);

     

      //Discuz論壇的登錄

      Client uc = new Client();

      String $result = uc.uc_user_login(tempUser.getUsername(), tempUser.getPass());

      String $ucsynlogin = "";

       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) {

                   $ucsynlogin = uc.uc_user_synlogin($uid);

               } else if($uid == -1) {

                   System.out.println("用戶不存在,或者被刪除");

               } else if($uid == -2) {

                   System.out.println("密碼錯");

               } else {

                   System.out.println("未定義");

               }

               //設置本地Discuz登錄的cookie信息，cookie存活時間

               //直接訪問論壇就有用戶信息了

               try {

                  response.setCharacterEncoding("UTF-8");

                  //同步Cookie信息

//                response.addHeader("P3P"," CP=\"CURa ADMa DEVa PSAo PSDo OUR BUS UNI PUR INT DEM STA PRE COM NAV OTC NOI DSP COR\"");

//              Cookie auth = new Cookie("auth", uc.uc_authcode($password+"\t"+$uid, "ENCODE"));

//              auth.setMaxAge(31536000);

//              //auth.setDomain("localhost");//設置本地cookie

//              response.addCookie(auth);

//              Cookie user = new Cookie("Discuz_loginuser", $username);

//              response.addCookie(user);

                 

                  //把返回過來的js文件直接輸出在頁面上，然后跳轉到論壇網站首頁就已經是登錄之后的

                  PrintWriter out = response.getWriter();

                out.write($ucsynlogin);

                out.flush();           } catch (Exception e) {

                // TODO Auto-generated catch block

                e.printStackTrace();

             }

           }else{

               System.out.println("Login failed");

           }

//    System.out.println("登錄的結果:"+$result);

（3）java網站退出，論壇同步退出
1> 步驟說明：

java網站網站注銷 > 調用Client里面的uc_user_synlogout同時注銷論壇用戶

         2>具體代碼實現（僅供參考）

          Client uc = new Client();

      String $ucsynlogout = uc.uc_user_synlogout();

      System.out.println("退出成功"+$ucsynlogout);

      return $ucsynlogout;

（4）java網站修改用戶信息同步論壇資料信息
1> 步驟說明：

修改用戶保存 > 獲取之前論壇用戶信息 > 調用接口進行修改uc_user_edit

         2>具體代碼實現（僅供參考）

                   Client uc = new Client();

      uc.uc_user_edit($username, $oldpw, $newpw, $email, $ignoreoldpw, $questionid, $answer)



主要代碼片段

   

（5）論壇登錄同步登錄java網站web
    我們來看看discuz那邊登錄了，java這邊怎么實現同步登錄。在uc.java里有一個doanswer的方法。所有同步操作都在這個方法里完成。其邏輯是這樣的，uc這個類繼承了HttpServlet。當ucenter發出通知時，會訪問這個servlet.并執行他的doGet()方法。doGet()調用doAnswer().

  String $code = request.getParameter("code");會傳一個code進來(加密了的)。然后調用$code = new Client().uc_authcode($code, "DECODE");進行解密操作。新建一個Map,Map<String,String> $get = new HashMap<String, String>();然后根據解密出來的code的內容封裝這個Map.調用這個方法，parse_str($code, $get); 經過以上操作后，所有同步操作需要的信息都在map里，如action。action代表的是什么操作，如同步登錄，同步退出，修改密碼等。還有其他信息,如username.登錄的用戶名。改密碼時還會傳新密碼過來。所有的這些都包含在這個叫$get的Map里。然后我們就可以進行我們自己的邏輯操作了。(以上邏輯不想理解沒關系，你只要知道當你在discuz登錄之后，uc.java的doAnswer()方法就會被調用，你所需要的一切信息都包含在$get這個Map里)

   操作到這里，你一定想吐槽筆者！不行啊，discuz那邊登錄了，java這邊完全沒反應啊！！doAnswer方法沒有被調用啊！是的，你還需要到discuz后臺做一些設置。管理中心->站長->ucenter設置。把ucenter連接方式改為接口方式。然后，你登錄discuz時，doAnswer()方法就會被調用了。（其他操作如退出也一樣）



注意亂碼問題：   

Discuz登錄同步java網站web網站登錄，中文亂碼問題

     到這里，我們又遇到了中文的問題了，discuz用中文登錄的時候不行啊！是的,這確實是個比較麻煩的問題。筆者也弄了好久。原因是這樣的，上面提到過，傳進來的$code是需要uc_authcode()方法進行解密的，當中文的時候解密出來的$code是"".解決方法如下：在Client.java的uc_authcode()方法里找到這句String $result = $result1.substring(0, $result1.length());并把它改成：        

?

1

2

3

4

5

6

7

String $result= $result1.toString();

   try{

      $result=new String($result.getBytes("iso-8859-1"),"GBK");

    }catch (Exception e) {

       $result = $result1.substring(0, $result1.length());

       // TODO: handle exception

    }

這樣還不行，解密出來的code中文部分仍是亂碼。所以在uc.java的$code = new Client().uc_authcode($code, "DECODE");這句下面還要加上$code = new String($code.getBytes("GBK"),"UTF-8");可能有人會說直接轉成utf-8不行嗎？為什么要先轉成gbk呢？如果直接轉成utf-8的話，解密出來的$code是""。到此中文的問題就得到解決了。筆者下載的是GBK版本的discuz，其他情況自己改一下編碼應該沒問題。

樂虎國際

以上內容轉載https://www.cnblogs.com/puqiuxiaomao/p/4037092.html

shajian

為什么我返回的那個script的鏈接執行一直返回-1