JUgrSystem.class.php

Go to the documentation of this file.

<?php
include_once("core/system/JBaseObject.class.php");
include_once("core/system/User.class.php");
include_once("core/system/Group.class.php");
include_once("core/system/Role.class.php");
include_once("core/utils/JSession.class.php");

/* Constants */
define(JUGRSYSTEM_SESSION_VAR, "james-jugrsystem");


class JUgrSystem extends JBaseObject
{
        var $users;                     
        var $userslogin;        
        var $groups;            
        var $roles;                     

        
        function JUgrSystem()
        {
                // And refresh information about groups and roles
                $this->RefreshAll();
        }
        
        function RefreshAll()
        {
                $this->_RefreshUsers();
                $this->_RefreshGroups();
                $this->_RefreshRoles();
        }
        
        function &GetInstance()
        {
                static $obj;
                
                if (!isset($obj))
                {
                        // We look if it is in session
                        if (JSession::ExistsVar(JUGRSYSTEM_SESSION_VAR))
                        {
                                $obj = JSession::GetVar(JUGRSYSTEM_SESSION_VAR);
                        }
                        else
                        {
                                $obj = new JUgrSystem();
                                JSession::SetVar(JUGRSYSTEM_SESSION_VAR, $obj);
                        }
                        
                        // Doing that thing, we make sure that 
                        // $ob->_UpdateSession will be called just before the
                        // scripts ends its execution, and the changes made in
                        // the object will be stored in session.
                        register_shutdown_function(array(&$obj, _UpdateSession));
                        
                }
                
                return $obj;
        }
                

        function _UpdateSession()
        {
                JSession::SetVar(JUGRSYSTEM_SESSION_VAR, $this);
        }

        function _RefreshUsers()
        {
                $this->users = array();
                $this->userslogin = array();
                
                $this->_UpdateSession();
        }
        
        function &GetUser($id, $refresh=false, $cached=false)
        {
                // We don't care if it is an idU nor a login name. In both
                // cases will be cached in the array in the same way.
                if (isset($this->users[$id]))
                {
                        if (!$refresh)
                                return $this->users[$id];
                        else
                        {
                                $user =& new User($id);
                                if (JSystem::IsError($user))
                                        return JSystem::RaiseError(JSystem::GetLastError());
                                else
                                {
                                        $this->users[$user->GetId()] = $user;
                                        $this->userslogin[$user->GetLogin()] = $user->GetId();
                                        return $this->users[$user->GetId()];
                                }
                        }
                }
                else if (isset($this->userslogin[$id]))
                {
                        if (!$refresh)
                                return $this->users[$this->userslogin[$id]];
                        else
                        {
                                $user =& new User($id);
                                if (JSystem::IsError($user))
                                        return JSystem::RaiseError(JSystem::GetLastError());
                                else
                                {
                                        $this->users[$user->GetId()] = $user;
                                        $this->userslogin[$user->GetLogin()] = $user->GetId();
                                        return $this->users[$user->GetId()];
                                }
                        }
                }
                else
                {
                        $user =& new User($id);
                        if (JSystem::IsError($user))
                                return JSystem::RaiseError(JSystem::GetLastError());
                                
                        if ($cached)
                        {
                                        $this->users[$user->GetId()] = $user;
                                        $this->userslogin[$user->GetLogin()] = $user->GetId();
                                        return $this->users[$user->GetId()];
                        }
                        else
                        {
                                return $user;
                        } 
                }
        }
                        
        function &GetAllUsers()
        {
                return User::GetAllUsersId();
        }
        
        function &AddUser($login, $pass, $globalgroup, $globalrole)
        {
                $user =& User::Create($login, $pass, $globalgroup, $globalrole);
                $this->RefreshAll();
                
                return $user;
        }
        
        function RemoveUser($idU)
        {
                User::Remove($idU);
                $this->RefreshAll();
        }
        
        function _RefreshGroups()
        {
                $groupsid = Group::GetAllGroupsId();
                
                while (! $groupsid->EOF)
                {
                        $idG = $groupsid->row["idG"];
                        $this->groups[$idG] =& new Group($idG);
                        $groupsid->Next();
                }
                
                $this->_UpdateSession();
        }
        
        function &GetGroup($idG, $refresh=false)
        {
                $group =& $this->_AccessGroup($idG, $refresh);
                if (JSystem::IsError($group))
                {
                        // Try refreshing the info
                        $this->_RefreshGroups();
                        $group =& $this->_AccessGroup($idG, $refresh);
                        
                        if (JSystem::IsError($group))
                        {
                                return JSystem::RaiseError(
                                                                new JSystemError(ERROR_GROUP_NOT_FOUND));
                        }
                        else
                                return $group;
                }
                else
                        return $group;
        }
        
        function &_AccessGroup($idG, $refresh=false)
        {
                if (isset($this->groups[$idG]))
                {
                        if ($refresh)
                        {
                                $this->groups[$idG] =& new Group($idG);
                                $this->_UpdateSession();
                        }
                        
                        return $this->groups[$idG];
                }
                else
                        return JSystem::RaiseError(
                                                        new JSystemError(ERROR_GROUP_NOT_FOUND));
        }
        
        function &GetAllGroups($refresh = false)
        {
                if ($refresh)           
                        $this->_RefreshGroups();
                return $this->groups;
        }
        
        function &GetGroups($parent=0, $global=null)
        {
                $result = array();

                $groupsid = Group::GetAllGroupsId($parent, $global);
                while (! $groupsid->EOF)
                {
                        $idG = $groupsid->row["idG"];
                        $result[$idG] =& $this->GetGroup($idG);
                        $groupsid->Next();
                }
                
                return $result;
        }
                
        
        function &AddGroup($name, $global, $parent)
        {
                $group =& Group::Create($name, $global, $parent);       
                if (JSystem::IsError($group))
                        return JSystem::RaiseError(JSystem::GetLastError());
                                
                $this->groups[$group->GetId()] =& $group;
                $this->RefreshAll();
                
                return $group;
        }
        
        function RemoveGroup($idG)
        {
                $error = Group::Remove($idG);
                
                if (JSystem::IsError($error))
                        return $error;
                else
                {
                        unset($this->groups[$idG]);
                        $this->RefreshAll();
                }
        }
        
        function _RefreshRoles()
        {
                $rolesid = Role::GetAllRolesId();
                
                while (! $rolesid->EOF)
                {
                        $idR = $rolesid->row["idR"];
                        $this->roles[$idR] =& new Role($idR);
                        $rolesid->Next();
                }
                
                $this->_UpdateSession();
        }
        
        function &GetRole($idR, $refresh=false)         
        {
                $role =& $this->_AccessRole($idR, $refresh);
                if (JSystem::IsError($role))
                {
                        // Try refreshing the info
                        $this->_RefreshRoles();
                        $role =& $this->_AccessRole($idR, $refresh);
                        
                        if (JSystem::IsError($role))
                        {
                                return JSystem::RaiseError(
                                                                new JSystemError(ERROR_ROLE_NOT_FOUND));
                        }
                        else
                                return $role;
                }
                else
                        return $role;
        }
        
        function &_AccessRole($idR, $refresh=false)     
        {
                if (isset($this->roles[$idR]))
                {
                        if ($refresh)
                        {
                                $this->roles[$idR] =& new Role($idR);
                                $this->_UpdateSession();
                        }
                                
                        return $this->roles[$idR];
                }
                else
                        return JSystem::RaiseError(
                                                        new JSystemError(ERROR_ROLE_NOT_FOUND));
        }
        
        function &GetAllRoles($refresh=false)
        {
                if ($refresh)
                        $this->_RefreshRoles();
                return $this->roles;
        }
        
        function &AddRole($name)
        {
                $role =& Role::Create($name);
                $this->roles[$role->GetId()] =& $role;
                $this->RefreshAll();
                
                return $role;
        }
        
        function RemoveRole($idR)
        {
                $error = Role::Remove($idR);
                if (JSystem::IsError($error))
                        return $error;
                else
                {
                        unset($this->roles[$idR]);
                        $this->RefreshAll();
                }
        }
        
}
?>

---