class.ilBuddySystemRelation.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2015 ILIAS open source, Extended GPL, see docs/LICENSE */
 
require_once 'Services/Contact/BuddySystem/interfaces/interface.ilBuddySystemRelationState.php';
 
class ilBuddySystemRelation
{
        protected $is_owned_by_request = false;
 
        protected $user_id;
 
        protected $buddy_user_id;
 
        protected $timestamp;
 
        protected $state;
 
        protected $prior_state;
 
        public function __construct(ilBuddySystemRelationState $state)
        {
                $this->setState($state, false);
        }
 
        public function setState(ilBuddySystemRelationState $state, $remember_prior_state = true)
        {
                if($remember_prior_state)
                {
                        $this->setPriorState($this->getState());
                }
 
                $this->state = $state;
                return $this;
        }
 
        public function getState()
        {
                return $this->state;
        }
 
        public function getPriorState()
        {
                return $this->prior_state;
        }
 
        private function setPriorState($prior_state)
        {
                $this->prior_state = $prior_state;
        }
 
        public function isOwnedByRequest()
        {
                return $this->is_owned_by_request;
        }
 
        public function setIsOwnedByRequest($is_owned_by_request)
        {
                $this->is_owned_by_request = $is_owned_by_request;
        }
 
        public function getBuddyUserId()
        {
                return $this->buddy_user_id;
        }
 
        public function setBuddyUserId($buddy_user_id)
        {
                $this->buddy_user_id = $buddy_user_id;
                return $this;
        }
 
        public function getUserId()
        {
                return $this->user_id;
        }
 
        public function setUserId($user_id)
        {
                $this->user_id = $user_id;
                return $this;
        }
 
        public function getTimestamp()
        {
                return $this->timestamp;
        }
 
        public function setTimestamp($timestamp)
        {
                $this->timestamp = $timestamp;
                return $this;
        }
 
        public function getCurrentPossibleTargetStates()
        {
                require_once 'Services/Contact/BuddySystem/classes/states/class.ilBuddySystemRelationStateFilterRuleFactory.php';
                $state_filter = ilBuddySystemRelationStateFilterRuleFactory::getInstance()->getFilterRuleByRelation($this);
                return $state_filter->getStates();
        }
 
        public function link()
        {
                if($this->getUserId() == $this->getBuddyUserId())
                {
                        throw new ilBuddySystemRelationStateException("Can't change a state when the requester equals the requestee.");
                }
 
                $this->getState()->link($this);
                return $this;
        }
 
        public function unlink()
        {
                if($this->getUserId() == $this->getBuddyUserId())
                {
                        throw new ilBuddySystemRelationStateException("Can't change a state when the requester equals the requestee.");
                }
 
                $this->getState()->unlink($this);
                return $this;
        }
 
        public function request()
        {
                if($this->getUserId() == $this->getBuddyUserId())
                {
                        throw new ilBuddySystemRelationStateException("Can't change a state when the requester equals the requestee.");
                }
 
                $this->getState()->request($this);
                return $this;
        }
 
        public function ignore()
        {
                if($this->getUserId() == $this->getBuddyUserId())
                {
                        throw new ilBuddySystemRelationStateException("Can't change a state when the requester equals the requestee.");
                }
 
                $this->getState()->ignore($this);
                return $this;
        }
 
        public function isLinked()
        {
                return $this->getState() instanceof ilBuddySystemLinkedRelationState;
        }
 
        public function isUnlinked()
        {
                return $this->getState() instanceof ilBuddySystemUnlinkedRelationState;
        }
 
        public function isRequested()
        {
                return $this->getState() instanceof ilBuddySystemRequestedRelationState;
        }
 
        public function isIgnored()
        {
                return $this->getState() instanceof ilBuddySystemIgnoredRequestRelationState;
        }
 
        public function wasLinked()
        {
                return $this->getPriorState() instanceof ilBuddySystemLinkedRelationState;
        }
 
        public function wasUnlinked()
        {
                return $this->getPriorState() instanceof ilBuddySystemUnlinkedRelationState;
        }
 
        public function wasRequested()
        {
                return $this->getPriorState() instanceof ilBuddySystemRequestedRelationState;
        }
 
        public function wasIgnored()
        {
                return $this->getPriorState() instanceof ilBuddySystemIgnoredRequestRelationState;
        }
}