ilLuceneSearcher Class Reference

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 156 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 179 of file class.ilLuceneSearcher.php.

    {
        return $this->page_number;
    }

References $page_number.

getResult()

ilLuceneSearcher::getResult

(

)

Get result.

Parameters

return ilLuceneSearchResult

Definition at line 166 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 88 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 108 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 (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 146 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 188 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 (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, $parser, $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 98 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 79 of file class.ilLuceneSearcher.php.

    {
        $this->type = $a_type;
    }

References $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