基礎(chǔ)對(duì)象概述

Xunsearch PHP-SDK 全面采用面向?qū)ο螅?code style="box-sizing: border-box; border-bottom-width: 1px; border-bottom-style: dashed; border-bottom-color: rgb(204, 204, 204);">OOP）的開發(fā)方式。 本章節(jié)將簡(jiǎn)單介紹開發(fā)過程中要接觸到的幾個(gè)重要對(duì)象（類）。

• XS 搜索項(xiàng)目的總對(duì)象，所有操作均基于此對(duì)象或其屬性。

• XSException 所有操作中出現(xiàn)的異常、錯(cuò)誤均拋出此類型的異常，搜索代碼中應(yīng)該嘗試捕捉該異常以確定操作是否成功。

• XSDocument 文檔用于描述檢索/索引的基礎(chǔ)對(duì)象，包含一組字段及其值，相當(dāng)于常規(guī)SQL數(shù)據(jù)表中的一行記錄。

• XSIndex 提供索引添加/刪除/修改功能，通常以 XS 對(duì)象的屬性方式出現(xiàn)，參見 XS::index。

• XSSearch 提供各種搜索功能，通常以 XS 對(duì)象的屬性方式出現(xiàn)，參見 XS::search。

• XSTokenizer 自定義字段詞法分析器接口。

類對(duì)象中的魔術(shù)屬性

通過 PHP 對(duì)象中的 __get 和 __set 技巧，我們針對(duì)所有 XSComponent 的子類實(shí)現(xiàn)了對(duì)象的模擬屬性。 這類讀取或?qū)懭雽傩灾禃r(shí)實(shí)際上是隱含調(diào)用了相應(yīng)的 getter/setter 方法，這類屬性不區(qū)分大小寫。

$a = $obj->text; // $a 值等于 $obj->getText() 的返回值$obj->text = $a; // 等同事調(diào)用 $obj->setText($a)

支持這類屬性的對(duì)象主要包括以下幾個(gè)（不全，僅挑重要的列出）：

• XS::index 項(xiàng)目索引對(duì)象：$xs->index

• XS::search 項(xiàng)目搜索對(duì)象：$xs->search

• XS::defaultCharset 項(xiàng)目默認(rèn)字符集：$xs->defaultCharset

• XSSearch::dbTotal 搜索數(shù)據(jù)庫(kù)內(nèi)的數(shù)據(jù)總量：$xs->search->dbTotal

• XSSearch::lastCount 最近一次搜索的結(jié)果匹配總數(shù)估算值：$xs->search->lastCount

• XSSearch::query 搜索語句：$xs->search->query