基础对象概述

Xunsearch PHP-SDK 全面采用面向对象（OOP）的开发方式。本章节将简单介绍开发过程中要接触到的几个重要对象（类）。

  • XS 搜索项目的总对象，所有操作均基于此对象或其属性。
  • XSException 所有操作中出现的异常、错误均抛出此类型的异常，搜索代码中应该尝试捕捉该异常以确定操作是否成功。
  • XSDocument 文档用于描述检索/索引的基础对象，包含一组字段及其值，相当于常规SQL数据表中的一行记录。
  • XSIndex 提供索引添加/删除/修改功能，通常以 XS 对象的属性方式出现，参见 XS::index。
  • XSSearch 提供各种搜索功能，通常以 XS 对象的属性方式出现，参见 XS::search。
  • XSTokenizer 自定义字段词法分析器接口。

类对象中的魔术属性

通过 PHP 对象中的 get 和 set 技巧，我们针对所有 XSComponent 的子类实现了对象的模拟属性。这类读取或写入属性值时实际上是隐含调用了相应的 getter/setter 方法，这类属性不区分大小写。

  1. $a = $obj->text; // $a 值等于 $obj->getText() 的返回值
  2. $obj->text = $a; // 等同事调用 $obj->setText($a)

支持这类属性的对象主要包括以下几个（不全，仅挑重要的列出）：