ilBookingReservationDBRepository Class Reference

Repo class for reservations. More...

Collaboration diagram for ilBookingReservationDBRepository:

Public Member Functions
	__construct (ilDBInterface $db, $preload_context_obj_ids=null)
	Constructor. More...
	getForId (int $id)
	Get reservation data for id. More...
	create (int $user_id, int $assigner_id, int $object_id, $context_obj_id, int $from, int $to, $status, $group_id)
	Insert. More...
	update (int $id, int $user_id, int $assigner_id, int $object_id, $context_obj_id, int $from, int $to, $status, $group_id)
	Update. More...
	delete (int $id)
	Delete. More...
	getNewGroupId ()
	Get next group id. More...
	getNumberOfReservations (array $ids, int $from, int $to, $only_not_over_yet=false)
	Get number of uncancelled reservations in time frame. More...
	getListByDate ( $a_has_schedule, array $a_object_ids=null, array $filter=null, array $a_pool_ids=null)
	List all reservations by date. More...
	getCachedContextObjBookingInfo ($context_obj_id)
	Get context object properties info. More...

Protected Member Functions
	preloadByContextIds ($context_obj_ids)
	Preload reservation information for context obj ids. More...

Protected Attributes
	$db
	$preloaded_by_context_list = null

Detailed Description

Repo class for reservations.

Acts on tables booking_reservation (rw), booking_reservation_group (rw) and booking_object (r)

Author

killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 13 of file class.ilBookingReservationDBRepository.php.

Constructor & Destructor Documentation

__construct()

ilBookingReservationDBRepository::__construct	(	ilDBInterface	$db,
			$preload_context_obj_ids = null
	)

Constructor.

Do not call this constructor directly, use ilBookingReservationDBRepositoryFactory instead

Definition at line 31 of file class.ilBookingReservationDBRepository.php.

References $db, and preloadByContextIds().

    {
        if (is_array($preload_context_obj_ids)) {
            $this->preloadByContextIds($preload_context_obj_ids);
        }
        $this->db = $db;
    }

Here is the call graph for this function:

Member Function Documentation

create()

ilBookingReservationDBRepository::create	(	int	$user_id,
		int	$assigner_id,
		int	$object_id,
			$context_obj_id,
		int	$from,
		int	$to,
			$status,
			$group_id
	)

Insert.

Parameters

int	$user_id
int	$assigner_id
int	$object_id
int	$context_obj_id
int	$from
int	$to
int	$status
int	$group_id

Returns

int

Definition at line 68 of file class.ilBookingReservationDBRepository.php.

References $db, and $ilDB.

      {
        $ilDB = $this->db;

        $id = $ilDB->nextId('booking_reservation');
        $ilDB->manipulate('INSERT INTO booking_reservation' .
            ' (booking_reservation_id,user_id,assigner_id,object_id,context_obj_id,date_from,date_to,status,group_id)' .
            ' VALUES (' . $ilDB->quote($id, 'integer') .
            ',' . $ilDB->quote($user_id, 'integer') .
            ',' . $ilDB->quote($assigner_id, 'integer') .
            ',' . $ilDB->quote($object_id, 'integer') .
            ',' . $ilDB->quote($context_obj_id, 'integer') .
            ',' . $ilDB->quote($from, 'integer') .
            ',' . $ilDB->quote($to, 'integer') .
            ',' . $ilDB->quote($status, 'integer') .
            ',' . $ilDB->quote($group_id, 'integer') . ')');
        return $id;
    }

delete()

ilBookingReservationDBRepository::delete

(

int

$id

)

Delete.

Parameters

int

$id

Definition at line 138 of file class.ilBookingReservationDBRepository.php.

References $db, and $ilDB.

    {
        $ilDB = $this->db;

        if ($id) {
            $ilDB->manipulate('DELETE FROM booking_reservation' .
                ' WHERE booking_reservation_id = ' . $ilDB->quote($id, 'integer'));
        }
    }

getCachedContextObjBookingInfo()

ilBookingReservationDBRepository::getCachedContextObjBookingInfo

(

$context_obj_id

)

Get context object properties info.

Parameters

$context_obj_id

Returns

array|null

Exceptions

ilBookingReservationException

Definition at line 362 of file class.ilBookingReservationDBRepository.php.

    {
        if (!is_array($this->preloaded_by_context_list)) {
            throw new ilBookingReservationException("Repo not initilialized.");
        }
        return array_filter($this->preloaded_by_context_list, function ($row) use ($context_obj_id) {
            return ($row["context_obj_id"] == $context_obj_id);
        });
    }

getForId()

ilBookingReservationDBRepository::getForId

(

int

$id

)

Get reservation data for id.

Parameters

int

Returns

array

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

References $db, and $ilDB.

    {
        $ilDB = $this->db;
        $set = $ilDB->query('SELECT *' .
            ' FROM booking_reservation' .
            ' WHERE booking_reservation_id = ' . $ilDB->quote($id, 'integer'));
        $row = $ilDB->fetchAssoc($set);
        return $row;
    }

getListByDate()

ilBookingReservationDBRepository::getListByDate	(		$a_has_schedule,
		array	$a_object_ids = null,
		array	$filter = null,
		array	$a_pool_ids = null
	)

List all reservations by date.

Parameters

bool	$a_has_schedule	has schedule
array	$a_object_ids	object ids
array	$filter	filter
array	$a_pool_ids	pool ids

Returns

array

Definition at line 203 of file class.ilBookingReservationDBRepository.php.

References $db, $ilDB, $res, ilObjUser\_lookupName(), and ilBookingReservation\STATUS_CANCELLED.

      {
        $ilDB = $this->db;

        $res = array();

        $sql = 'SELECT r.*, o.title, o.pool_id' .
            ' FROM booking_reservation r' .
            ' JOIN booking_object o ON (o.booking_object_id = r.object_id)';

        if ($a_pool_ids !== null) {
            $where = array($ilDB->in('pool_id', $a_pool_ids, '', 'integer'));
        }

        if ($a_object_ids !== null) {
            $where = array($ilDB->in('object_id', $a_object_ids, '', 'integer'));
        }

        if (is_array($filter['context_obj_ids']) && count($filter['context_obj_ids']) > 0) {
            $where = array($ilDB->in('context_obj_id', $filter['context_obj_ids'], '', 'integer'));
        }

        if ($filter['status']) {
            if ($filter['status'] > 0) {
                $where[] = 'status = ' . $ilDB->quote($filter['status'], 'integer');
            } else {
                $where[] = '(status != ' . $ilDB->quote(-$filter['status'], 'integer') .
                    ' OR status IS NULL)';
            }
        }
        if ($filter['title']) {
            $where[] = '(' . $ilDB->like('title', 'text', '%' . $filter['title'] . '%') .
                ' OR ' . $ilDB->like('description', 'text', '%' . $filter['title'] . '%') . ')';
        }
        if ($a_has_schedule) {
            if ($filter['from']) {
                $where[] = 'date_from >= ' . $ilDB->quote($filter['from'], 'integer');
            }
            if ($filter['to']) {
                $where[] = 'date_to <= ' . $ilDB->quote($filter['to'], 'integer');
            }
            if (!$filter['past']) {
                $where[] = 'date_to > ' . $ilDB->quote(time(), 'integer');
            }
        }
        if ($filter['user_id']) { // #16584
            $where[] = 'user_id = ' . $ilDB->quote($filter['user_id'], 'integer');
        }
        /*
        if($a_group_id)
        {
            $where[] = 'group_id = '.$ilDB->quote(substr($a_group_id, 1), 'integer');
        }
        */
        if (sizeof($where)) {
            $sql .= ' WHERE ' . implode(' AND ', $where);
        }

        if ($a_has_schedule) {
            $sql .= ' ORDER BY date_from DESC';
        } else {
            // #16155 - could be cancelled and re-booked
            $sql .= ' ORDER BY status';
        }

        $set = $ilDB->query($sql);
        while ($row = $ilDB->fetchAssoc($set)) {
            $obj_id = $row["object_id"];
            $user_id = $row["user_id"];

            if ($a_has_schedule) {
                $slot = $row["date_from"] . "_" . $row["date_to"];
                $idx = $obj_id . "_" . $user_id . "_" . $slot;
            } else {
                $idx = $obj_id . "_" . $user_id;
            }
            $idx .= "_" . $row["context_obj_id"];

            if ($a_has_schedule && $filter["slot"]) {
                $slot_idx = date("w", $row["date_from"]) . "_" . date("H:i", $row["date_from"]) .
                    "-" . date("H:i", $row["date_to"] + 1);
                if ($filter["slot"] != $slot_idx) {
                    continue;
                }
            }

            if (!isset($res[$idx])) {
                $uname = ilObjUser::_lookupName($user_id);

                $res[$idx] = array(
                    "object_id" => $obj_id
                ,"title" => $row["title"]
                ,"pool_id" => $row["pool_id"]
                ,"context_obj_id" => (int) $row["context_obj_id"]
                ,"user_id" => $user_id
                ,"counter" => 1
                ,"user_name" => $uname["lastname"] . ", " . $uname["firstname"] // #17862
                );

                if ($a_has_schedule) {
                    $res[$idx]["booking_reservation_id"] = $idx;
                    $res[$idx]["date"] = date("Y-m-d", $row["date_from"]);
                    $res[$idx]["slot"] = date("H:i", $row["date_from"]) . " - " .
                        date("H:i", $row["date_to"] + 1);
                    $res[$idx]["week"] = date("W", $row["date_from"]);
                    $res[$idx]["weekday"] = date("w", $row["date_from"]);
                    $res[$idx]["can_be_cancelled"] = ($row["status"] != ilBookingReservation::STATUS_CANCELLED &&
                        $row["date_from"] > time());
                    $res[$idx]["_sortdate"] = $row["date_from"];

                    // this currently means: has any cancelled reservations (it is not grouped by this info)
                    $res[$idx]["status"] = $row["status"];
                } else {
                    $res[$idx]["booking_reservation_id"] = $row["booking_reservation_id"];
                    $res[$idx]["status"] = $row["status"];
                    $res[$idx]["can_be_cancelled"] = ($row["status"] != ilBookingReservation::STATUS_CANCELLED);
                }
            } else {
                $res[$idx]["counter"]++;
            }
        }

        return $res;
    }

Here is the call graph for this function:

getNewGroupId()

ilBookingReservationDBRepository::getNewGroupId

(

)

Get next group id.

Returns

int

Definition at line 152 of file class.ilBookingReservationDBRepository.php.

References $db, and $ilDB.

    {
        $ilDB = $this->db;

        return $ilDB->nextId('booking_reservation_group');
    }

getNumberOfReservations()

ilBookingReservationDBRepository::getNumberOfReservations	(	array	$ids,
		int	$from,
		int	$to,
			$only_not_over_yet = false
	)

Get number of uncancelled reservations in time frame.

Parameters

	int[]	$ids
int	$from
int	$to

Returns

array

Definition at line 168 of file class.ilBookingReservationDBRepository.php.

References $db, $ilDB, $res, and ilBookingReservation\STATUS_CANCELLED.

    {
        $ilDB = $this->db;

        $from = $ilDB->quote($from, 'integer');
        $to = $ilDB->quote($to, 'integer');

        $date = $only_not_over_yet
            ? ' AND date_to > ' . $ilDB->quote(time(), "integer")
            : "";

        $set = $ilDB->query('SELECT count(*) cnt, object_id' .
            ' FROM booking_reservation' .
            ' WHERE ' . $ilDB->in('object_id', $ids, '', 'integer') . $date .
            ' AND (status IS NULL OR status <> ' . $ilDB->quote(
                ilBookingReservation::STATUS_CANCELLED,
                'integer'
            ) . ')' .
            ' AND date_from <= ' . $to . ' AND date_to >= ' . $from .
            ' GROUP BY object_id');
        $res = [];
        while ($row = $ilDB->fetchAssoc($set)) {
            $res[$row["object_id"]] = $row;
        }
        return $res;
    }

preloadByContextIds()

ilBookingReservationDBRepository::preloadByContextIds (   $context_obj_ids )

protected

Preload reservation information for context obj ids.

Parameters

int[]

$context_obj_ids

Definition at line 341 of file class.ilBookingReservationDBRepository.php.

References Vendor\Package\$f, ilUtil\sortArray(), ilUtil\stableSortArray(), and ilBookingReservation\STATUS_CANCELLED.

Referenced by __construct().

    {
        $filter = ["context_obj_ids" => ($context_obj_ids)];
        $filter['past'] = true;
        $filter['status'] = -ilBookingReservation::STATUS_CANCELLED;
        $f = new ilBookingReservationDBRepositoryFactory();
        $repo = $f->getRepo();
        $list = $repo->getListByDate(true, null, $filter);
        $list = ilUtil::sortArray($list, "slot", "asc", true);
        $list = ilUtil::stableSortArray($list, "date", "asc", true);
        $list = ilUtil::stableSortArray($list, "object_id", "asc", true);
        $this->preloaded_by_context_list = ilUtil::stableSortArray($list, "pool_id", "asc", true);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

update()

ilBookingReservationDBRepository::update	(	int	$id,
		int	$user_id,
		int	$assigner_id,
		int	$object_id,
			$context_obj_id,
		int	$from,
		int	$to,
			$status,
			$group_id
	)

Update.

Parameters

int	$id
int	$user_id
int	$assigner_id
int	$object_id
int	$context_obj_id
int	$from
int	$to
int	$status
int	$group_id

Returns

int

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

References $db, and $ilDB.

      {
        $ilDB = $this->db;
        return $ilDB->manipulate('UPDATE booking_reservation' .
            ' SET object_id = ' . $ilDB->quote($object_id, 'text') .
            ', user_id = ' . $ilDB->quote($user_id, 'integer') .
            ', assigner_id = ' . $ilDB->quote($assigner_id, 'integer') .
            ', date_from = ' . $ilDB->quote($from, 'integer') .
            ', date_to = ' . $ilDB->quote($to, 'integer') .
            ', status = ' . $ilDB->quote($status, 'integer') .
            ', group_id = ' . $ilDB->quote($group_id, 'integer') .
            ', context_obj_id = ' . $ilDB->quote($context_obj_id, 'integer') .
            ' WHERE booking_reservation_id = ' . $ilDB->quote($id, 'integer'));
    }

Field Documentation

$db

ilBookingReservationDBRepository::$db

protected

Definition at line 18 of file class.ilBookingReservationDBRepository.php.

Referenced by __construct(), create(), delete(), getForId(), getListByDate(), getNewGroupId(), getNumberOfReservations(), and update().

$preloaded_by_context_list

ilBookingReservationDBRepository::$preloaded_by_context_list = null

protected

Definition at line 23 of file class.ilBookingReservationDBRepository.php.

---

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

• Modules/BookingManager/Reservations/classes/class.ilBookingReservationDBRepository.php