Validate Lucene search results Do access checks, create ref_ids from obj_ids... More...

Collaboration diagram for ilLuceneSearchResultFilter:

Public Member Functions
	addFilter (ilLuceneResultFilter $filter)

	setCandidates (ilLuceneSearchResult $a_ids)
	Set result ids. More...

	getCandidates ()
	get result ids More...

	getUserId ()
	Get user id. More...

	getRequiredPermission ()
	Get required permission. More...

	isLimitReached ()
	Check if search max hits is reached. More...

	getResultIds ()
	get filtered ids More...

	getResultObjIds ()
	get filtered ids More...

	getResults ()
	get results More...

	getMaxHits ()
	get max hits More...

	loadFromDb ()
	Load results from db. More...

	filter ()
	Filter search results. More...

Static Public Member Functions
static	getInstance (int $a_user_id)

Protected Member Functions
	__construct (int $a_user_id)
	Singleton constructor. More...

	checkFilter (int $a_ref_id)
	check appended filter More...

	append (int $a_ref_id, int $a_obj_id)
	Append to filtered results. More...

	isOffsetReached (int $a_current_nr)
	Check if offset is reached. More...

Protected Attributes
int	$user_id

ilLuceneSearchResult	$result = null

array	$checked = []

ilSearchSettings	$settings

ilUserSearchCache	$cache

string	$required_permission = 'visible'

bool	$limit_reached = false

int	$offset = 0

array	$filters = array()

ilAccess	$access

Static Protected Attributes
static ilLuceneSearchResultFilter	$instance = null

Detailed Description

Validate Lucene search results Do access checks, create ref_ids from obj_ids...

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

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

Constructor & Destructor Documentation

◆ __construct()

ilLuceneSearchResultFilter::__construct ( int $a_user_id )

protected

Singleton constructor.

Definition at line 56 of file class.ilLuceneSearchResultFilter.php.

    {
        global $DIC;
 
        $this->access = $DIC->access();
        $this->user_id = $a_user_id;
        $this->settings = ilSearchSettings::getInstance();
        $this->cache = ilUserSearchCache::_getInstance($this->getUserId());
        $this->offset = $this->settings->getMaxHits() * ($this->cache->getResultPageNumber() - 1);
    }

References $DIC, ilUserSearchCache\_getInstance(), ILIAS\Repository\access(), ilSearchSettings\getInstance(), getUserId(), and ILIAS\Repository\settings().

Here is the call graph for this function:

Member Function Documentation

◆ addFilter()

ilLuceneSearchResultFilter::addFilter ( ilLuceneResultFilter $filter )

Definition at line 75 of file class.ilLuceneSearchResultFilter.php.

                                                           : void
    {
        $this->filters[] = $filter;
    }

◆ append()

ilLuceneSearchResultFilter::append	(	int	$a_ref_id,
		int	$a_obj_id
	)

protected

Append to filtered results.

Definition at line 244 of file class.ilLuceneSearchResultFilter.php.

                                                           : void
    {
        $this->checked[$a_ref_id] = $a_obj_id;
    }

Referenced by filter().

Here is the caller graph for this function:

◆ checkFilter()

ilLuceneSearchResultFilter::checkFilter ( int $a_ref_id )

protected

check appended filter

Definition at line 231 of file class.ilLuceneSearchResultFilter.php.

                                                 : bool
    {
        foreach ($this->filters as $filter) {
            if (!$filter->filter($a_ref_id)) {
                return false;
            }
        }
        return true;
    }

Referenced by filter().

Here is the caller graph for this function:

◆ filter()

ilLuceneSearchResultFilter::filter ( )

Filter search results.

Do RBAC checks.

Definition at line 172 of file class.ilLuceneSearchResultFilter.php.

                            : bool
    {
        // get ref_ids and check access
        $counter = 0;
        $offset_counter = 0;
 
        foreach ($this->getCandidates() as $obj_id) {
            // Check referenced objects
            foreach (ilObject::_getAllReferences($obj_id) as $ref_id) {
                // Check filter
                if (!$this->checkFilter($ref_id)) {
                    $this->cache->appendToFailed($ref_id);
                    continue;
                }
 
                // Access failed by prior check
                if ($this->cache->isFailed($ref_id)) {
                    continue;
                }
                // Offset check
                if ($this->cache->isChecked($ref_id) and !$this->isOffsetReached($offset_counter)) {
                    ilLoggerFactory::getLogger('src')->debug('Result was checked');
                    $offset_counter++;
                    break;
                }
 
                // RBAC check
                if ($this->access->checkAccessOfUser(
                    $this->getUserId(),
                    $this->getRequiredPermission(),
                    '',
                    $ref_id,
                    '',
                    $obj_id
                )) {
                    ++$counter;
                    $offset_counter++;
                    $this->append($ref_id, $obj_id);
                    $this->cache->appendToChecked($ref_id, $obj_id);
                    break;
                } else {
                    $this->cache->appendToFailed($ref_id);
                }
            }
            if ($counter >= $this->settings->getMaxHits()) {
                $this->limit_reached = true;
                $this->cache->setResults($this->getResultIds());
                $this->cache->save();
                return false;
            }
        }
        $this->cache->setResults($this->getResultIds());
        $this->cache->save();
        return true;
    }

References $ref_id, ilObject\_getAllReferences(), ILIAS\Repository\access(), append(), checkFilter(), getCandidates(), ilLoggerFactory\getLogger(), getResultIds(), and ILIAS\Repository\settings().

Here is the call graph for this function:

◆ getCandidates()

ilLuceneSearchResultFilter::getCandidates ( )

get result ids

Definition at line 91 of file class.ilLuceneSearchResultFilter.php.

                                   : ?ilLuceneSearchResult
    {
        return $this->result;
    }

References $result.

Referenced by filter().

Here is the caller graph for this function:

◆ getInstance()

static ilLuceneSearchResultFilter::getInstance ( int $a_user_id )

static

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

                                                      : ilLuceneSearchResultFilter
    {
        if (self::$instance == null) {
            return self::$instance = new ilLuceneSearchResultFilter($a_user_id);
        }
        return self::$instance;
    }

References $instance.

Referenced by ilLuceneAdvancedSearchGUI\performSearch(), ilLuceneSearchGUI\performSearch(), ilSoapObjectAdministration\searchObjects(), ilLuceneAdvancedSearchGUI\showSavedResults(), and ilLuceneSearchGUI\showSavedResults().

Here is the caller graph for this function:

◆ getMaxHits()

ilLuceneSearchResultFilter::getMaxHits ( )

get max hits

Definition at line 155 of file class.ilLuceneSearchResultFilter.php.

                                : int
    {
        return $this->settings->getMaxHits();
    }

References ILIAS\Repository\settings().

Here is the call graph for this function:

◆ getRequiredPermission()

ilLuceneSearchResultFilter::getRequiredPermission ( )

Get required permission.

Definition at line 107 of file class.ilLuceneSearchResultFilter.php.

                                           : string
    {
        return $this->required_permission;
    }

References $required_permission.

◆ getResultIds()

ilLuceneSearchResultFilter::getResultIds ( )

get filtered ids

Returns: int[] array of filtered ref_ids

Definition at line 125 of file class.ilLuceneSearchResultFilter.php.

                                  : array
    {
        return $this->checked;
    }

References $checked.

Referenced by filter().

Here is the caller graph for this function:

◆ getResultObjIds()

ilLuceneSearchResultFilter::getResultObjIds ( )

get filtered ids

Returns: int[] array of filtered obj_ids

Definition at line 134 of file class.ilLuceneSearchResultFilter.php.

                                     : array
    {
        $obj_ids = [];
        foreach ($this->checked as $obj_id) {
            $obj_ids[] = $obj_id;
        }
        return $obj_ids;
    }

◆ getResults()

ilLuceneSearchResultFilter::getResults ( )

get results

Returns: int[] array of ids

Definition at line 147 of file class.ilLuceneSearchResultFilter.php.

    {
        return $this->checked;
    }

References $checked.

◆ getUserId()

ilLuceneSearchResultFilter::getUserId ( )

Get user id.

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

                               : int
    {
        return $this->user_id;
    }

References $user_id.

Referenced by __construct().

Here is the caller graph for this function:

◆ isLimitReached()

ilLuceneSearchResultFilter::isLimitReached ( )

Check if search max hits is reached.

Returns: bool max hits reached

Definition at line 116 of file class.ilLuceneSearchResultFilter.php.

                                    : bool
    {
        return $this->limit_reached;
    }

References $limit_reached.

◆ isOffsetReached()

ilLuceneSearchResultFilter::isOffsetReached ( int $a_current_nr )

protected

Check if offset is reached.

Parameters

int $a_current_nr Current result number

Returns: bool

Definition at line 254 of file class.ilLuceneSearchResultFilter.php.

                                                         : bool
    {
        return !($a_current_nr < $this->offset);
    }

References $offset.

◆ loadFromDb()

ilLuceneSearchResultFilter::loadFromDb ( )

Load results from db.

Definition at line 163 of file class.ilLuceneSearchResultFilter.php.

                                : void
    {
        $this->checked = $this->cache->getResults();
    }

◆ setCandidates()

ilLuceneSearchResultFilter::setCandidates ( ilLuceneSearchResult $a_ids )

Set result ids.

Definition at line 83 of file class.ilLuceneSearchResultFilter.php.

                                                              : void
    {
        $this->result = $a_ids;
    }

Field Documentation

◆ $access

ilAccess ilLuceneSearchResultFilter::$access

protected

Definition at line 50 of file class.ilLuceneSearchResultFilter.php.

◆ $cache

ilUserSearchCache ilLuceneSearchResultFilter::$cache

protected

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

◆ $checked

array ilLuceneSearchResultFilter::$checked = []

protected

Definition at line 41 of file class.ilLuceneSearchResultFilter.php.

Referenced by getResultIds(), and getResults().

◆ $filters

array ilLuceneSearchResultFilter::$filters = array()

protected

Definition at line 48 of file class.ilLuceneSearchResultFilter.php.

◆ $instance

ilLuceneSearchResultFilter ilLuceneSearchResultFilter::$instance = null

staticprotected

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

Referenced by getInstance().

◆ $limit_reached

bool ilLuceneSearchResultFilter::$limit_reached = false

protected

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

Referenced by isLimitReached().

◆ $offset

int ilLuceneSearchResultFilter::$offset = 0

protected

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

Referenced by isOffsetReached().

◆ $required_permission

string ilLuceneSearchResultFilter::$required_permission = 'visible'

protected

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

Referenced by getRequiredPermission().

◆ $result

ilLuceneSearchResult ilLuceneSearchResultFilter::$result = null

protected

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

Referenced by getCandidates().

◆ $settings

ilSearchSettings ilLuceneSearchResultFilter::$settings

protected

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

◆ $user_id

int ilLuceneSearchResultFilter::$user_id

protected

Definition at line 39 of file class.ilLuceneSearchResultFilter.php.

Referenced by getUserId().

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

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

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addFilter()

◆ append()

◆ checkFilter()

◆ filter()

◆ getCandidates()

◆ getInstance()

◆ getMaxHits()

◆ getRequiredPermission()

◆ getResultIds()

◆ getResultObjIds()

◆ getResults()

◆ getUserId()

◆ isLimitReached()

◆ isOffsetReached()

◆ loadFromDb()

◆ setCandidates()

Field Documentation

◆ $access

◆ $cache

◆ $checked

◆ $filters

◆ $instance

◆ $limit_reached

◆ $offset

◆ $required_permission

◆ $result

◆ $settings

◆ $user_id