Jive
是一個比較豐富的知識寶藏，從中可以學習到很多新的實戰技巧和具體功能實現方式。前面基本介紹了
Jive
中的一些主要架構技術，通過這些技術可以基本上掌握
Jive
論壇系統。
Jive
中還有很多非常實用的組件技術和工具庫，分析學習可重用技術，可以在自己具體的項目重復使用，大大提高了新系統的開發速度和效率。
Jive
的管理功能中提供了將
Jive
數據庫數據導出到
XML
文件的管理工具，在這個工具功能實現中，使用了樹形結構的遍歷技術。
Jive
將
ForumThread
中的第一個
ForumMessage
作為
root ForumMessage
，以這個
ForumMessage
為根節點，每個
ForumThread
中包含了一套樹形結構。
TreeWalker
是樹形結構的一個抽象接口，代碼如下：
public interface TreeWalker {
??? //
根節點
??? public ForumMessage getRoot();
??? //
獲得父節點
??? public ForumMessage getParent(ForumMessage child)
?????????? ?throws ForumMessageNotFoundException;
??? //
獲得子節點
??? public ForumMessage getChild(ForumMessage parent, int index)
??????????? throws ForumMessageNotFoundException;
??? //
獲得所有子節點
??? public Iterator children(ForumMessage parent);
??? //
獲得所有的子節點，包括子節點的子節點
…
??? public Iterator recursiveChildren(ForumMessage parent);
??? //
獲得一個節點的深度，相對根節點而言
??? public int getMessageDepth(ForumMessage message);
???
??? public int getChildCount(ForumMessage parent);
??? public int getRecursiveChildCount(ForumMessage parent);
?
??? /**
???? *
返回相對父節點的子節點索引。例如
???? * <pre>
???? *?? 4
???? *?? |-- 2
???? *?? |-- |-- 1
???? *?? |-- |-- 6
???? *?? |-- |-- 8
???? *?? |-- 5
???? * </pre>
???? * getIndexOfChild(4, 2)
將返回
0
???? * getIndexOfChild(4, 5)
將返回
1
???? * getIndexOfChild(2, 1)
將返回
0
???? * getIndexOfChild(2, 6)
將返回
1
???? * getIndexOfChild(2, 8)
將返回
2
???? */
??? public int getIndexOfChild(ForumMessage parent, ForumMessage child);
??? //
一個節點是否是葉，葉相對枝來說，葉沒有子節點了
??? public boolean isLeaf(ForumMessage node);
}
DbTreeWalker
是
TreeWalker
的一個實現，它是將一個
ForumThread
下所有帖子的
ID
從數據庫中裝入
LongTree
中。一句
LongTree
的樹形結構遍歷核心技術實現
ForumThread
中的帖子結構的遍歷。
LongTree
類似之前的
Cache
類，封裝了樹形結構遍歷的核心算法，在
LongTree
中建立了
3
個數組
long [] keys
、
char [] leftChildren
和
char [] rightSiblings
。
一個節點有兩個特性：它有子節點；它有兄弟節點。
leftChildren
保存的是這個節點的子節點的索引；而
rightSiblings
保存的是這個節點兄弟節點的索引。例如：
??1000
?? |-- 3000
?? |-- |--4000
?? |-- |--6000
?? |-- |--7000
?? |-- 5000
1000
是個根節點，
1000
下有兩個子節點
3000
和
5000
，而
3000
則有
3
個子節點
4000
、
6000
和
7000
，
3000
還有一個兄弟節點
5000
，使用上述
3
個數組是這樣保持信息的：
keys[0] = 1000
keys[1] = 3000
keys[2] = 4000
keys[3] = 5000
keys[4] = 6000
keys[5] = 7000
keys
數組中保存的是各個節點的數值，而
leftChildren
和
rightSiblings
數組保存的是
keys
數組的
index
，即
0
、
1
、
2
、
3
、
4
等數字。
1000
節點有兩個子節點，那么其對應的
leftChildren
和
rightSiblings
分別是：
leftChildren[0] = 1
leftChildren[0]
中的索引
0
表示當前索引，
keus[0]
是
1000
，說明現在節點是
1000
；
1
也表示
keys
數組的索引，
keys[1]
的值是
3000
，所以上一句表示
1000
的子節點是
3000
。
1000
節點沒有兄弟節點：
rightSiblings[0] =
-
1
再看看
3000
節點，其
keys
的索引
Index
是
1
，其子節點是
4000
、
6000
和
7000
，取最近一個
4000
的索引
index
放入數組：
leftChildren[1] = 2
這表示
1000
節點的子節點是
4000
，那么另外一個
6000
節點如何表示？這是以
4000
節點的兄弟節點表現出來的。
4000
節點的
keys
的索引
index
是
2
，通過下列表示：
rightSiblings[2] = 4
其中，
4
表示
6000
在
keys
中的索引
Index
。同樣，第
3
個子節點
7000
表示如下：
rightSiblings[4] = 5
這樣，
3000
節點有
3
個子節點
4000
、
6000
和
7000
（
4000
、
6000
和
7000
是兄弟節點）通過上述簡單兩句就表現出來了。
總結一個父子關系樹的表示方法：在父節點中，使用
leftChildren
保存最靠近父節點的一個子節點（父節點的第一個兒子，叫長子）的索引，其他子節點則是通過
rightSiblings
表明與長子是兄弟關系。
看看
LongTress
的初始化構造方法，
keys
數組的值保存的是
ForumMessage
的
ID
，如下：
public LongTree(long rootKey, int size) {
??? keys = new long[size+1];?? ???????????????????? //
初始化
??? leftChildren = new char[size+1]; ????????????? //
初始化
??? rightSiblings = new char[size+1]; ???????????? //
初始化
?
??? //
在
keys[1]
中保存的是
rootMessage
的
ID
??? keys[1] = rootKey;
??? leftChildren[1] = 0;?? ????????????????????????????? //
無子節點
??? rightSiblings[1] = 0;? ?????????????????????????????? //
無兄弟姐妹
}
當加入一個節點時，其方法如下：
public void addChild(long parentKey, long newKey) {
??? //
根據
parentKey
找出其對應的
keys
索引
index
??? char parentIndex = findKey(parentKey, (char)1);
??? if (parentIndex == 0) {
??????????? throw new IllegalArgumentException("Parent key " + parentKey +
??????????????????? " not found when adding child " + newKey + ".");
??? }
?
??? //
為
newKey
創建節點
??? keys[nextIndex] = newKey;
??? leftChildren[nextIndex] = 0;
??? rightSiblings[nextIndex] = 0;
?
??? //
將新建節點標志為父節點的子節點
??? if (leftChildren[parentIndex] == 0) {
??????? //
如果父節點原來沒有子節點，那就將新建節點作為其子節點
??????? leftChildren[parentIndex] = nextIndex;
??? }else {
???? ???//
如果父節點有子節點，尋找最后一個子節點
??????? long siblingIndex = leftChildren[parentIndex];
?????? //
在
siblingIndex
中循環查找，直至值為
0
??????? while (rightSiblings[new Long(siblingIndex).intValue()] != 0) {
???????????? siblingIndex = rightSiblings[new Long(siblingIndex).intValue()];
??????? }
??????? //
將新建節點作為最后一個字節點加入
??????? rightSiblings[new Long(siblingIndex).intValue()] = nextIndex;
??? }
??? //
最后，自動增加
nextIndex
以便下一個等待插入
??? nextIndex++;
}
Jive
將數據導出到
XML
文件時，就是根據某個
ForumMessage
的
ID
，通過
TreeWalker
找出它的所有子節點
ForumMessage
的
ID
，然后將其內容導出。
XML
稱為可擴充標記語言，是類似
HTML
定義文檔標記語言的一個框架。
XML
以結構嚴謹著稱，因此用來保存數據是非常適合的，這樣在數據庫之外，又多了一個持久化保存數據的方式。
在
Java
中，
XML
更多時是作為配置文件數據存儲體形式出現，在之前一般是使用
properties
來保存系統的配置文件，如下：
cache.maxsize=1024
cache.minsize=2
這兩句分別設置
cache
的最大值和最小值，那么在
Java
中通過下列語句讀?。?/span>
Properties p = new Properties();
InputStream fin = new FileInputStream("Config.properties");
p.load(fin);
String maxSize = p.getProperty("cache.maxsize ");
String minSize = p.getProperty("cache.minsize ");
這樣就可以獲得配置文件中的兩個值。
這種配置文件使用方法簡單直接，但是只適合配置文件不很復雜的情況。在復雜的配置情況下，
properties
就不是很合適，例如設置系統的可選屬性，一個系統安裝在不同應用場合，客戶的要求總有些不一樣，有些功能是可選的，那么需要在配置文件中配置一些可選的功能，以
Tomcat
的
server.xml
為例，如下：
<Context path="/register" docBase="D:/javasource/SimpleRegister/defaultroot" debug="1"
???????????????? reloadable="true" crossContext="true">
…
</Context>
<Context path="/examples" docBase="examples" debug="0"
???? ????????????reloadable="true" crossContext="true">
????????? <Logger className="org.apache.catalina.logger.FileLogger"
???????????????????? prefix="localhost_examples_log." suffix=".txt"
??????? ??? ??timestamp="true"/>
…
</Context>
在一個配置中有很多
Context
，每個
Contexr
都包含
Logger
等具體配置，
XML
格式本身是一種樹形結構的數據格式。在實際應用中，很多復雜的表示都可以使用樹形結構來分解代表。因此，使用
XML
來表示這種樹形結構的數據無疑是非常合適的。
在
Jive
中，
jive_config.xml
是
Jive
系統的配置文件。這個配置文件是在
Jive
系統安裝時，按照用戶的選擇動態生成的，其中包含數據庫連接參數、界面顯示顏色、電子郵件配置以及緩沖配置、搜索配置和文件或圖片上傳配置。
分析讀取
XML
數據有很多工具，如
DOM
（
http://www.worg/DOM/
）和
SAX
（
http://www.saxproject.org/
）。這兩種是標準的
XML
分析器，可以使用任何語言來實現，
DOM
分析
XML
數據時，是將整個文檔一下子讀入內存，如果文檔很大，性能就發生影響，而
SAX
則是動態地對每一行分析，無需全部讀入，因此在分析大文檔時速度比較快。
但是這兩種分析方法都是圍繞
XML
樹形結構展開的，在編制這兩種分析器時，會涉及到大量
XML
概念的
API
，需要一定的
XML
基礎和知識，使用起來有一定難度。
JDOM
（
http://www.jdom.org
）封裝了
DOM/SAX
的具體使用技術，以非常符合
Java
編程方式的形式來分析
XML
，因此使用起來非常方便。
在分析速度方面，
JDOM
比
DOM
要快，比
SAX
慢一點。但用在分析配置文件上，速度不是主要的，因為可以使用
lazy initialization
。這類似緩存機制，在第一次讀取后就保存在內存中，以后每次直接從內存中獲取。
在
Jive
中，
JDOM
操作基本是由
JiveGlobals
完成的。
public class JiveGlobals {
private static final String JIVE_CONFIG_FILENAME = "jive_config.xml";
private static XMLProperties properties = null;
?
...
//
從配置文件獲取配置
public static String getJiveProperty(String name) {
loadProperties();
return properties.getProperty(name);
}
? //
用
JDOM
載入配置文件
private synchronized static void loadProperties() {
if (properties == null) {
properties = new XMLProperties(jiveHome + File.separator +
JIVE_CONFIG_FILENAME);
}
}
?//
將配置保存到配置文件中
?public static void setJiveProperty(String name, String value) {
?? loadProperties();
?? properties.setProperty(name, value);
?}
}
從上面代碼看出，對
XML
文件讀寫非常方便，使用
properties.getProperty(name)
就可以獲得
name
的配置值，而
properties.setProperty(name, value)
一句就可以將
name
和其值
value
保存到
XML
文件中，非常類似
Hashtable
的讀取和存入。
XMLProperties
是
JDOM
的一個屬性文件輔助包，它主要是對屬性名進行分解和合成，例如
XML
如下：
<jive>
<email>
<fromName>Jive_Administrator</fromName>
<fromEmail>webmaster@example.com</fromEmail>
<subject>Your thread was updated!</subject>
<body>Hello {name}! The thread {threadName} was updated!</body>
</email>
<jive>
jive/email/fromName
的值是
Jive_Administrator
，那么如何讀取
Jive_Administrator
？使用
properties.getProperty("email.fromName")
就可以。注意到，這里
Key
的名字組合是
email.fromName
，這種特定的寫法就是
XMLProperties
可以支持的，在對
XML
文件保存細節中，由
XMLProperties
將這種屬性名稱寫法具體轉換成
XML
文檔操作。具體內部代碼如下：
? public String getProperty(String name) {
??????? if (propertyCache.containsKey(name)) {? //
從緩存中獲取
??????????? return (String)propertyCache.get(name);
??????? }
???????? //
將
email.fromName
轉變為
String
數組
???????? //
例如
propName[0] = jive; propName[1] = email …
??????? String[] propName = parsePropertyName(name);
??????? //
通過
propName
數組循環，遍歷
XML
的樹形結構層次，尋找出對應的屬性值
??????? Element element = doc.getRootElement();
??????? for (int i = 0; i < propName.length; i++) {
??????????? element = element.getChild(propName[i]);
??????????? if (element == null) {
??????????????? return null;
?????? ?????}
??????? }
??????? //
尋找到
element
后，獲得其內容
??????? String value = element.getText();
??????? if ("".equals(value)) {??????????? return null;??????? }
??????? else {
??????????? //
保存到緩存中
??????????? value = value.trim();
??????????? propertyCache.put(name, value);
??????????? return value;
??????? }
??? }
以上只是分析了
JDOM
的
XMLProperties
包是如何做屬性配置提取的，正是因為
JDOM
內部做了很多基礎支持性的細節工作，才使得使用
JDOM
變得非常方便。
總結使用
JDOM
對配置文件讀寫操作語法如下：
·?????????
獲得配置（查詢）：
getProperty(name)
。
·?????????
新增和修改：
properties.setProperty(name, value)
。
·?????????
刪除：
properties.deleteProperty(name)
。
name
的格式是
xxx.xxx.xxx
，例如：
<jive>
?? …
<upload>
??????? <dir>/home/jdon/jive/upload/</dir>
??????? <relurl>upload/</relurl>
??? </upload>
??? …
</jive>
要獲得
/home/jdon/jive/upload/
，
name
的格式是
upload.dir
；要獲得
upload/
，
name
的格式是
upload.relurl
。
注意，如果要在系統中支持上述功能，必須下載
JDOM
包，還要有
DataFormatFilter. java
、
DataUnformatFilter.java
、
XMLFilterBase.java
和
XMLProperties.java
支持。這幾個類不包含在
JDOM
標準包中，作為一個應用包含在其
Sample
中。當然也可以直接從
Jive
中復制出來使用。
5.3?
全文檢索和
Lucene
Jive
中支持全文檢索，這個功能主要核心依賴另外一個開放源代碼項目
Lucene
（
http://jakarta.apache.org/lucene/docs/index.html
）。
Jakarta Lucene
是一個高性能全文搜索引擎，可以跨平臺應用于任何搜索應用。
使用
Lucene
作為搜索引擎，應用系統需要做兩件事情：
（
1
）建立索引文件。將
Jive
數據庫中的數據內容建立索引文件，這是通過
SearchManager
來完成。
SearchManager
代碼如下：
public interface SearchManager {
??? public boolean isSearchEnabled();
??? public void setSearchEnabled(boolean searchEnabled);
??? /**
??? //
如果
SearchManage
正在工作，返回真
??? public boolean isBusy();
??? //
返回索引完成率
??? public int getPercentComplete();
??? //
是否自動建立索引
??? //
通過
TaskEngine.scheduleTask
方法實現定期自動索引
??? public boolean isAutoIndexEnabled();
??? public void setAutoIndexEnabled(boolean value);
??? //
自動索引間隔的分鐘數
??? public int getAutoIndexInterval();
??? public void setAutoIndexInterval(int minutes);
??? //
獲得上次建立索引的時間
??? public Date getLastIndexedDate();
//
在實時建立索引時，將當前帖子加入索引
??? public void addToIndex(ForumMessage message);
??? public void removeFromIndex(ForumMessage message);
??? //
手動更新自上次建立索引后的新內容
??? public void updateIndex();
??? //
手動重新建立全部的索引
??? public void rebuildIndex();
??? //
優化
??? public void optimize();
}
·?????????
SearchManager
定義了建立索引的一些屬性，建立索引有兩種方式：當有新帖子加入時，通過調用
indexMessage()
方法實時索引；或者通過
TaskEngine.scheduleTask
方法每隔一定時間建立索引。
·?????????
DbSearchManager
作為
SearchManager
的子類實現，又是一個線程類，它是建立索引的主要功能類。在
DbSearchManager
中主要使用了
Lucene
的
IndexWriter
、
Analyzer
、
Document
和
Field
等功能類來建立索引。
·?????????
IndexWriter
用戶建立新的索引，當然也可以將文檔加入已經存在的索引。
在文本被索引之前，它必須通過一個分析器
Analyzer
。分析器
Analyzer
負責從文本中分離出索引關鍵字。
Lucene
有幾種不同類型的分析器：
·?????????
SimpleAnalyzer
是將英文轉換為小寫字母，按空格和標點符號切分出英文單詞，
如
I am Java
這一句，使用
SimpleAnalyzer
切詞就會切分出下列詞語：
token1=I
token2=am
token3=Java
·?????????
StandardAnalyzer
是對英文進行了較為復雜的處理。除了按詞語建立索引關鍵字（
token
）外，還能夠為特殊名稱、郵件地址、縮寫格式等建立索引單元，而且對“
and
”、“
the
”等詞語做了過濾。
·?????????
ChineseAnalyzer
是專門用來分析中文的索引的。關于中文分析器，有很多嘗試，如車東的
http://sourceforge.net/projects/weblucene/
；
zhoujun
的
http://www. jdon.com/jive/thread.jsp? forum=61&thread=8400
等，該問題將在后面章節繼續討論。
一個索引是由一系列
Document
組成，每個
Document
是由一個或多個
Field
組成，每個
Field
都有一個名字和值，可以把
Document
作為關系數據庫中一條記錄，而
Field
則是記錄中某列字段。一般建立索引如下：
//
指定將在哪個目錄建立索引
String indexDir = "/home/jdon/jive/WEB-INF/jiveHome";?
//
指定將要建立索引的文本
String text = "welcom here, I am Java,";?????
Analyzer analyzer = new StandardAnalyzer();?? //
使用
StandardAnalyzer
//
建立一個
IndexWriter
IndexWriter writer = new IndexWriter(indexDir, analyzer, true);
//
建立
Document
Document document? = new Document();
//
進行切詞、索引
document.add(Field.Text("fieldname", text));
//
加入索引中
writer.addDocument(document);
writer.close();
其中，
Field
根據具體要求有不同用法，
Lucene
提供
4
種類型的
Field: Keyword
、
UnIndexed
、
UnStored
和
Text
。
·?????????
Keyword
不實現切詞，逐字地保存在索引中，這種類型適合一些如
URL
、日期、個人姓名、社會安全號碼、電話號碼等需要原封不動保留的詞語。
·?????????
UnIndexed
既不實現切詞也不索引，但是其值是一個詞一個詞地保存在索引中，這不適合很大很長的詞語，適合于顯示一些不經過直接搜索的結果值。
·?????????
UnStored
與
UnIndexed
正好相反，將被切詞和索引，但是不保存在索引中，這適合巨大文本，如帖子內容、頁面內容等。
·?????????
Text
是實現切詞、索引，并且保存在索引中。
在
Jive
中，索引的建立以
DbSearchManager
中加入帖子索引方法為例：
protected final void addMessageToIndex(long messageID, long userID,
??????????? long threadID, long forumID, String subject, String body,
??????????? java.util.Date creationDate, IndexWriter writer) throws IOException
{
??? //
建立一個
? Document
??? Document doc = new Document();
??? doc.add(Field.Keyword("messageID",Long.toString(messageID)));
??? doc.add(new Field("userID", Long.toString(userID), false, true, false));
?? doc.add(new Field("threadID", Long.toString(threadID), false, true, false));
??? doc.add(new Field("forumID", Long.toString(forumID), false, true, false));
??? doc.add(Field.UnStored("subject", subject));
??? doc.add(Field.UnStored("body", body));
??? doc.add(new Field("creationDate", DateField.dateToString(creationDate),
??????????????? false, true, false));
??? //
將該
Document
加入當前索引中
??? writer.addDocument(doc);
}
在
DbSearchManager
中同時也實現了自動建立索引的過程，通過在構造方法中生成
TimeTask
實例：
timerTask = TaskEngine.scheduleTask(
??????????????????? this,autoIndexInterval*JiveGlobals.MINUTE,
??????????????????? autoIndexInterval*JiveGlobals.MINUTE);
因為
DbSearchManager
是線程類，它在
run
方法中實現索引任務自動運行：
TaskEngine.addTask(new IndexTask(false));
（
2
）建立完成后，就可以直接搜索特定的詞語了。搜索語句一般代碼如下：
Searcher searcher = new IndexSearcher((indexDir);? //
創建一個搜索器
//
使用和索引同樣的語言分析器
Query query = QueryParser.parse(queryString, "body", new StandardAnalyzer());
//
搜索結果使用
Hits
存儲
Hits hits = searcher.search(query);
//
通過
hits
得到相應字段的數據和查詢的匹配度
for (int i=0; i<hits.length(); i++) {
????? System.out.println(hits.doc(i).get("fieldname "));
};
Jive
實現搜索就復雜得多，它為搜索專門建立了一個
Query
接口：
public interface Query {
??? //
需要搜索的字符串
??? public String getQueryString();
??? public void setQueryString(String queryString);
?
??? public Date getBeforeDate();
??? public void setBeforeDate(Date beforeDate);
?
??? public Date getAfterDate();
??? public void setAfterDate(Date afterDate);
?
??? public User getFilteredUser();
??? public void filterOnUser(User user);
?
??? public ForumThread getFilteredThread();
??? public void filterOnThread(ForumThread thread);
?
??? public int resultCount();
??? public Iterator results();
??? public Iterator results(int startIndex, int numResults);
}
Query
接口中主要定義了和搜索相關的一些參數，可以根據具體要求定制，直接使用
Query
就可以達到搜索的目的，如需要搜索
Java is cool
，那么使用下列代碼：
ForumFactory forumFactory = ForumFactory.getInstance();
Query query = forumFactory.createQuery(forums);
query.setQueryString("Jive is cool");
Iterator iter = query.results();
while (iter.hasNext()) {
???? ForumMessage message = (ForumMessage)iter.nextElement();
???? //
輸出結果
}
追查代碼會發現，上面
forumFactory.createQuery(forums)
方法實際內容是
new DbQuery(forums, this)
。
DbQuery
作為
Query
的一個子類，它的搜索語句通過
executeQuery()
方法中下列語句實現：
private void executeQuery() {
??? try {
?????? Searcher searcher = getSearcher();? //
創建一個搜索器
?????? …
?????? //
使用分析器獲得
Query
對象
?????? org.apache.lucene.search.Query bodyQuery =
??????????????? QueryParser.parse(queryString, "body", DbSearchManager.analyzer);
????? org.apache.lucene.search.Query subjectQuery =
??????????????? QueryParser.parse(queryString, "subject", DbSearchManager.analyzer);
??????? //
將兩個
Query
對象加入
BooleanQuery
??????? BooleanQuery comboQuery = new BooleanQuery();
??????? comboQuery.add(subjectQuery,false,false);
??????? comboQuery.add(bodyQuery,false,false);
??????? //Jive
自己的搜索結果過濾器
??????? MultiFilter multiFilter = new MultiFilter(3);
??????? int filterCount = 0;
????
??????? if (factory.getForumCount() != forums.length) {
???????????? //
將其他論壇內容搜索結果過濾掉
??????????? String[] forumIDs = new String[forums.length];
???????????? for (int i=0; i<forumIDs.length; i++) {
??????????????? forumIDs[i] = Long.toString(forums[i].getID());
???????????? }
???????????? multiFilter.add(new FieldFilter("forumID", forumIDs));
???????????? filterCount++;
??????? }
?
???????? //
日期過濾器
?
如只查詢某日期以后的內容
??????? if (beforeDate != null || afterDate != null) {
??????????? if (beforeDate != null && afterDate != null) {
??????????????? multiFilter.add(new DateFilter("creationDate", beforeDate, afterDate));
??????????????? filterCount++;
?? ??????????}else if (beforeDate == null) {
??????????????? multiFilter.add(DateFilter.After("creationDate", afterDate));
???????????????? filterCount++;
???????????? }else {
???????????????? multiFilter.add(DateFilter.Before("creationDate", beforeDate));
? ???????????????filterCount++;
???????????? }
??????? }
??????? //
過濾用戶
??????? if (user != null) {
???????????? String userID = Long.toString(user.getID());
???????????? multiFilter.add(new FieldFilter("userID", userID));
???????????? filterCount++;
??????? }
??????? //
主題過濾
??????? if (thread != null) {
???????????? String threadID = Long.toString(thread.getID());
????????? ???multiFilter.add(new FieldFilter("threadID", threadID));
???????????? filterCount++;
??????? }
??????? if (filterCount > 0) {//
實現搜索
???????????? hits = searcher.search(comboQuery, multiFilter);
??? ????} else {
???????????? hits = searcher.search(comboQuery);
??????? }
??????? //
搜索結果不要超過最大大小
??????? int numResults = hits.length() < MAX_RESULTS_SIZE ?
??????????????????? hits.length() : MAX_RESULTS_SIZE;
??????? long [] messages = new long[numResults];
??????? for (int i=0; i<numResults; i++) {
?????????? messages[i]= Long.parseLong( ((Document)hits.doc(i)).get("messageID") );
?????? }
??????? results = messages;
????? } catch (Exception e) {
??????? e.printStackTrace();
??????? results = new long[0];
????? }
}
Jive
的搜索使用了過濾器，以便過濾掉不想出現的結果，然后還對搜索結果進行了限制轉換，這些在實際使用中都是必需的。
Jive
默認的字符集編碼方式是
ISO8859_1
，即
Latin-1
字符集，這是國際標準化組織用來表示
Latin
等西方語言使用的字符集。
ISO8859_1
字符集非常類似常見的
ASCII
字符集。由于
ISO8859_1
是使用單字節來表示，而漢字是采取雙字節來表示一個漢字，我國制定了一套專門用來表示漢字
GB2312
和
GBK
編碼字符集。
在
Java
內部運算中，涉及到的所有字符串都會被轉化為
UTF-8
編碼來進行運算。那么，在被
Java
轉化之前，字符串是什么樣的字符集？
Java
總是根據操作系統的默認編碼字符集來決定字符串的初始編碼，而且
Java
系統的輸入和輸出的都是采取操作系統的默認編碼。
因此，如果能統一
Java
系統的輸入、輸出和操作系統
3
者的編碼字符集合，將能夠使
Java
系統正確處理和顯示漢字。這是處理
Java
系統漢字的一個原則，但是在實際項目中，能夠正確抓住和控制住
Java
系統的輸入和輸出部分是比較難的。
Jive
是運行在
Web
容器中的一個
Servlet/JSP
系統。在這個系統中，輸入途徑有很多種：一種是通過頁面表單打包成請求（
request
）發往服務器的；第二種是通過數據庫讀入；還有第
3
種輸入比較復雜，
JSP
在第一次運行時總是被編譯成
Servlet
，
JSP
中常常包含中文字符，那么編譯使用
javac
時，
Java
將根據默認的操作系統編碼作為初始編碼。除非特別指定，如在
Jbuilder
中可以指定默認的字符集。
輸出途徑也有幾種：第一種是
JSP
頁面的輸出。由于
JSP
頁面已經被編譯成
Servlet
，那么在輸出時，也將根據操作系統的默認編碼來選擇輸出編碼，除非指定輸出編碼方式；還有輸出途徑是數據庫，將字符串輸出到數據庫。
由此看來，一個
J2EE
系統的輸入輸出是非常復雜，而且是動態變化的，而
Java
是跨平臺運行的，在實際編譯和運行中，都可能涉及到不同的操作系統，如果任由
Java
自由根據操作系統來決定輸入輸出的編碼字符集，這將不可控制地出現亂碼。
正是由于
Java
的跨平臺特性，使得字符集問題必須由具體系統來統一解決，所以在一個
Java
應用系統中，解決中文亂碼的根本辦法是明確指定整個應用系統統一字符集。
在
Jive
中如果指定默認字符集為某個字符集，那么就要在所有的輸入輸出環節都要標識為這個字符集。但是，前面已經提到，要完全在編碼時做到還是有一定難度，必須對
Web
程序有相當地掌握和理解，而且步驟較繁瑣。
有一種相對省事的做法，例如統一指定為
ISO8859_1
，因為目前大多數軟件都是西方人編制的，他們默認的字符集就是
ISO8859_1
，包括操作系統
Linux
和數據庫
MySQL
等。這樣，如果指定
Jive
統一編碼為
ISO8859_1
，那么就有下面
3
個環節必須把握：
·?????????
開發和編譯代碼時指定字符集為
ISO8859_1
。
·?????????
運行操作系統的默認編碼必須是
ISO8859_1
，如
Linux
。
·?????????
在
JSP
頭部聲明：
<%@ page contentType="text/html;charset=ISO8859_1" %>
。
如果統一指定為
GBK
中文字符集，上述
3
個環節同樣需要做到，不同的是只能運行在默認編碼為
GBK
的操作系統，如中文
Windows
。
所以統一編碼為
ISO8859_1
和
GBK
雖然帶來編制代碼的方便，但是也破壞了
Java
跨平臺運行的優越性，只在一定范圍內行得通。
很多情況下，程序員大都是在中文
Windows
下開發調試
Java
系統，然后直接部署到
Linux
等系統上真正運行。而且其中可能涉及到
XML
文件讀寫。
XML
是對編碼方式要求嚴格的數據存儲體，
XML
又可以隨著代碼移動。因此，在進行真正大規模
Java
系統開發運行時，上述臨時簡單的變通方式就沒有效果了。
要從根本上解決
Java
的中文問題，只要將
Java
系統的統一編碼定義為
UTF-8
。
UTF-8
編碼是一種兼容所有語言的編碼方式，惟一比較麻煩的就是要找到應用系統的所有出入口，然后使用
UTF-8
去“結扎”它。
Jive
默認的字符集編碼方式是
ISO8859_1
，如果都統一為
UTF-8
，那么也需要做下列幾步工作：
·?????????
開發和編譯代碼時指定字符集為
UTF-8
。
·?????????
使用過濾器，將所有請求（
request
）轉換為
UTF-8
；針對不同應用過濾器有兩種。
·?????????
如果所有請求都經過一個
Servlet
控制分配器，那么使用
Servlet
的
filter
執行語句。
·?????????
request.setCharacterEncoding("UTF-8")
。
·?????????
如果不經過
Servlet
，而直接是
JSP
，那么每個
JSP
頭部設置上述語句。
·?????????
在
JSP
頭部聲明：
<%@ page contentType="text/html;charset= UTF-8" %>
。
·?????????
設定數據庫連接方式是
UTF-8
。
以上討論了
Jive
以及通用
Java
的中文問題。如果整個應用系統是從開始進行開發，那么統一指定編碼為
UTF-8
就非常容易做到。如果是在英文源代碼基礎上二次開發，那么首先要將原來的源代碼轉換為統一編碼
UTF-8
，那么這種轉換工作會帶來一定的麻煩。