|
|
一 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，其他情況自己改一下編碼應該沒問題。 |
|
關注公眾號
有償服務微信
有償服務QQ
皖公網安備34010302002376號 )|網站地圖|
發表于 2019-7-9 16:43:03