XSException 异常

所有操作中出现的异常、错误均抛出此类型的异常，搜索代码中应该尝试捕捉该异常以确定操作是否成功。

已通过重载魔术方法 XSException::__toString 对出错信息作了简要的美化和修饰，您可以直接输出该对象，如需要查看堆栈追踪，通过继承来的 XSException::getTraceAsString 即可。

Note: 在系统内部将所有的错误处理也转换成为抛出 XSErrorException 对象，而 XSErrorException 继承自 XSException，所以实际代码中只要统一捕捉 XSException 即可。

一段典型的处理代码应类似下面的方式：

  1. require '$prefix/sdk/php/lib/XS.php';
  2. try
  3. {
  4.     $xs = new XS('demo');
  5.     $docs = $xs->search->setQuery('hightman')->setLimit(5)->search();
  6.     foreach ($docs as $doc)
  7.     {
  8.        echo $doc->rank() . ". " . $doc->subject . " [" . $doc->percent() . "%]\n";
  9.        echo $doc->message . "\n";
  10.     }
  11. }
  12. catch (XSException $e)
  13. {
  14.     echo $e;               // 直接输出异常描述
  15.     if (defined('DEBUG'))  // 如果是 DEBUG 模式，则输出堆栈情况
  16.         echo "\n" . $e->getTraceAsString() . "\n";
  17. }