Reads and parses lucene search results. More...

Collaboration diagram for ilLuceneSearcher:

Public Member Functions
	setType ($a_type)
	Set search type. More...

	getType ()
	Get type. More...

	search ()
	Search More...

	highlight ($a_obj_ids)
	Highlight/Detail query. More...

	nextResultPage ()
	get next result page More...

	getHighlighter ()
	get highlighter More...

	getResult ()
	Get result. More...

	getPageNumber ()
	get current page number More...

Static Public Member Functions
static	getInstance (ilLuceneQueryParser $qp)
	Get singleton instance. More...

Data Fields
const	TYPE_STANDARD = 1

const	TYPE_USER = 2

Protected Member Functions
	performSearch ()
	search lucene More...

Private Member Functions
	__construct ($qp)
	Constructor. More...

Private Attributes
	$query_parser = null

	$result = null

	$highlighter = null

	$page_number = 1

	$type = self::TYPE_STANDARD

Static Private Attributes
static	$instance = null

Detailed Description

Reads and parses lucene search results.

Author: Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Version: $Id$

Definition at line 35 of file class.ilLuceneSearcher.php.

Constructor & Destructor Documentation

◆ __construct()

ilLuceneSearcher::__construct ( $qp )

private

Constructor.

Parameters

object ilLuceneQueryParser

Returns: ilLuceneSearcher

Definition at line 53 of file class.ilLuceneSearcher.php.

        {
                $this->result = new ilLuceneSearchResult();
                $this->result->setCallback(array($this,'nextResultPage'));
                $this->query_parser = $qp;
        }

Member Function Documentation

◆ getHighlighter()

ilLuceneSearcher::getHighlighter ( )

get highlighter

Returns: ilLuceneHighlightResultParser

Definition at line 166 of file class.ilLuceneSearcher.php.

        {
                return $this->highlighter;       
        }

References $highlighter.

◆ getInstance()

static ilLuceneSearcher::getInstance ( ilLuceneQueryParser $qp )

static

Get singleton instance.

Parameters

object ilLuceneQueryParser

Returns: ilLuceneSearcher

Definition at line 67 of file class.ilLuceneSearcher.php.

        {
                if(self::$instance)
                {
                        return self::$instance;
                }
                return self::$instance = new ilLuceneSearcher($qp);
        }

References $instance.

Referenced by ilSearchAutoComplete\getLuceneList(), ilRepositoryObjectDetailSearch\performLuceneSearch(), ilLuceneAdvancedSearchGUI\performSearch(), ilLuceneSearchGUI\performSearch(), ilLuceneUserSearchGUI\performSearch(), ilSoapObjectAdministration\searchObjects(), ilLuceneAdvancedSearchGUI\showSavedResults(), and ilLuceneSearchGUI\showSavedResults().

Here is the caller graph for this function:

◆ getPageNumber()

ilLuceneSearcher::getPageNumber ( )

get current page number

Parameters

return

Definition at line 190 of file class.ilLuceneSearcher.php.

        {
                return $this->page_number;
        }

References $page_number.

◆ getResult()

ilLuceneSearcher::getResult ( )

Get result.

Parameters

return ilLuceneSearchResult

Definition at line 176 of file class.ilLuceneSearcher.php.

        {
                if($this->result instanceof ilLuceneSearchResult)
                {
                        return $this->result;
                }
                // TODO Error handling
        }

References $result.

◆ getType()

ilLuceneSearcher::getType ( )

Get type.

Returns: int

Definition at line 89 of file class.ilLuceneSearcher.php.

        {
                return $this->type;
        }

References $type.

Referenced by performSearch().

Here is the caller graph for this function:

◆ highlight()

ilLuceneSearcher::highlight ( $a_obj_ids )

Highlight/Detail query.

Parameters

array $a_obj_ids Arry of obj_ids

Returns: object ilLuceneHighlightResultParser

Definition at line 109 of file class.ilLuceneSearcher.php.

        {
                global $ilBench,$ilSetting;
 
                include_once './Services/Search/classes/Lucene/class.ilLuceneHighlighterResultParser.php';
                
                // TODO error handling
                if(!$this->query_parser->getQuery())
                {
                        return;
                }
                
                // Search in combined index
                $ilBench->start('Lucene','SearchHighlight');
                try
                {
                        include_once './Services/WebServices/RPC/classes/class.ilRpcClientFactory.php';
                        $res = ilRpcClientFactory::factory('RPCSearchHandler')->highlight(
                                CLIENT_ID.'_'.$ilSetting->get('inst_id',0),
                                $a_obj_ids,
                                $this->query_parser->getQuery()
                                );
                }
                catch(XML_RPC2_FaultException $e)
                {
                        ilLoggerFactory::getLogger('src')->critical('Highlighting failed with message: ' . $e->getMessage());
                        return new ilLuceneHighlighterResultParser();
                }
                catch(Exception $e)
                {
                        ilLoggerFactory::getLogger('src')->error('Highlighting failed with message: ' . $e->getMessage());
                        return new ilLuceneHighlighterResultParser();
                }
 
                include_once './Services/Search/classes/Lucene/class.ilLuceneHighlighterResultParser.php';
                $this->highlighter = new ilLuceneHighlighterResultParser();
                $this->highlighter->setResultString($res);
                $this->highlighter->parse();
 
                return $this->highlighter;
        }

References $highlighter, $ilBench, $ilSetting, $res, ilRpcClientFactory\factory(), and ilLoggerFactory\getLogger().

Here is the call graph for this function:

◆ nextResultPage()

ilLuceneSearcher::nextResultPage ( )

get next result page

Parameters

return

Definition at line 156 of file class.ilLuceneSearcher.php.

        {
                $this->page_number++;
                $this->performSearch();
        }

References performSearch().

Here is the call graph for this function:

◆ performSearch()

ilLuceneSearcher::performSearch ( )

protected

search lucene

Returns

Definition at line 199 of file class.ilLuceneSearcher.php.

        {
                global $ilBench,$ilSetting;
 
                // TODO error handling
                if(!$this->query_parser->getQuery())
                {
                        return;
                }
                $ilBench->start('Lucene','SearchCombinedIndex');
                try
                {
                        switch($this->getType())
                        {
                                
                                case self::TYPE_USER:
                                        include_once './Services/WebServices/RPC/classes/class.ilRpcClientFactory.php';
                                        $res = ilRpcClientFactory::factory('RPCSearchHandler')->searchUsers(
                                                CLIENT_ID.'_'.$ilSetting->get('inst_id',0),
                                                (string) $this->query_parser->getQuery()
                                        );
                                        break;
                                
                                case self::TYPE_STANDARD:
                                default:
                                        include_once './Services/WebServices/RPC/classes/class.ilRpcClientFactory.php';
                                        $res = ilRpcClientFactory::factory('RPCSearchHandler')->search(
                                                CLIENT_ID.'_'.$ilSetting->get('inst_id',0),
                                                (string) $this->query_parser->getQuery(),
                                                $this->getPageNumber()
                                        );
                                        break;
                                
                        }
                        ilLoggerFactory::getLogger('src')->debug('Searching for: ' . $this->query_parser->getQuery());
                }
                catch(XML_RPC2_FaultException $e)
                {
                        ilLoggerFactory::getLogger('src')->critical($e->getMessage());
                        return;
                }
                catch(Exception $e)
                {
                        ilLoggerFactory::getLogger('src')->error('Searching failed with message: ' . $e->getMessage());
                        return;
                }
                
                // Parse results
                include_once './Services/Search/classes/Lucene/class.ilLuceneSearchResultParser.php';
                $parser = new ilLuceneSearchResultParser($res);
                $parser->parse($this->result);
                return;
        }

References $ilBench, $ilSetting, $res, ilRpcClientFactory\factory(), ilLoggerFactory\getLogger(), getType(), TYPE_STANDARD, and TYPE_USER.

Referenced by nextResultPage(), and search().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ search()

ilLuceneSearcher::search ( )

Search

Returns

Definition at line 99 of file class.ilLuceneSearcher.php.

        {
                $this->performSearch();
        }

References performSearch().

Here is the call graph for this function:

◆ setType()

ilLuceneSearcher::setType ( $a_type )

Set search type.

Parameters

type $a_type

Definition at line 80 of file class.ilLuceneSearcher.php.

        {
                $this->type = $a_type;
        }

Field Documentation

◆ $highlighter

ilLuceneSearcher::$highlighter = null

private

Definition at line 44 of file class.ilLuceneSearcher.php.

Referenced by getHighlighter(), and highlight().

◆ $instance

ilLuceneSearcher::$instance = null

staticprivate

Definition at line 40 of file class.ilLuceneSearcher.php.

Referenced by getInstance().

◆ $page_number

ilLuceneSearcher::$page_number = 1

private

Definition at line 45 of file class.ilLuceneSearcher.php.

Referenced by getPageNumber().

◆ $query_parser

ilLuceneSearcher::$query_parser = null

private

Definition at line 42 of file class.ilLuceneSearcher.php.

◆ $result

ilLuceneSearcher::$result = null

private

Definition at line 43 of file class.ilLuceneSearcher.php.

Referenced by getResult().

◆ $type

ilLuceneSearcher::$type = self::TYPE_STANDARD

private

Definition at line 46 of file class.ilLuceneSearcher.php.

Referenced by getType().

◆ TYPE_STANDARD

const ilLuceneSearcher::TYPE_STANDARD = 1

Definition at line 37 of file class.ilLuceneSearcher.php.

Referenced by ilSearchAutoComplete\getLuceneList(), and performSearch().

◆ TYPE_USER

const ilLuceneSearcher::TYPE_USER = 2

Definition at line 38 of file class.ilLuceneSearcher.php.

Referenced by performSearch(), and ilLuceneUserSearchGUI\performSearch().

The documentation for this class was generated from the following file:

Services/Search/classes/Lucene/class.ilLuceneSearcher.php

Public Member Functions

Static Public Member Functions

Data Fields

Protected Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ getHighlighter()

◆ getInstance()

◆ getPageNumber()

◆ getResult()

◆ getType()

◆ highlight()

◆ nextResultPage()

◆ performSearch()

◆ search()

◆ setType()

Field Documentation

◆ $highlighter

◆ $instance

◆ $page_number

◆ $query_parser

◆ $result

◆ $type

◆ TYPE_STANDARD

◆ TYPE_USER