ilClientNodeDAV Class Reference

Class ilClientNodeDAV. More...

Inheritance diagram for ilClientNodeDAV:

Collaboration diagram for ilClientNodeDAV:

Public Member Functions
	__construct (string $client_name, ilWebDAVRepositoryHelper $repo_helper, ilWebDAVObjDAVHelper $dav_helper)
	setName ($name)
	Overwrite parent function to throw an exception if called. More...
	getChildren ()
	Returns Repository Root Object. More...
	getName ()
	Return name of client. More...
	getLastModified ()
	Returns some date as return for last modified. More...
	getChild ($name)
	If the "ILIAS" is given as parameter, the repository root will be returned. More...
	childExists ($name)
	Either the given name is the name of the repository root of ILIAS or it is a reference to a node in the ILIAS-repo. More...
	getRefIdFromName ($name)
	Gets ref_id from name. More...
	createDirectory ($name)
	It is not allowed to create a directory here. More...
	delete ()
	It is not allowed to delete anything here. More...
	createFile ($name, $data=null)
	It is not allowed (and not even possible) to create a file here. More...

Protected Member Functions
	getMountPointByReference ($name)
	Create DAV-Object from ref_id. More...
	getRepositoryRootPoint ()
	Creates and returns Repository Root Object. More...
	checkIfRefIdIsValid ($ref_id)
	Check if object with ref_id exists and if is DAVable object. More...

Protected Attributes
	$repo_helper
	$name_of_repository_root

Detailed Description

Class ilClientNodeDAV.

This class represents the used ilias client. For example if your clients name is "my_ilias" and you are currently in the directory with the ref_id=123, the path would look like this: ilias.mysite.com/webdav.php/my_ilias/ref_123/

The call would look like this: -> webdav.php <- creates the request handler and initialize ilias -> ilWebDAVRequestHandler <- setup the webdav server -> ilObjMountPointDAV <- This represents the "root" node and is needed for sabreDAV -> ilMountPointDAV <- This class represents the used client (for example here it is my_ilias) -> child of ilContainerDAV

Author

Raphael Heer rapha.nosp@m.el.h.nosp@m.eer@h.nosp@m.slu..nosp@m.ch $Id$

Definition at line 27 of file class.ilClientNodeDAV.php.

Constructor & Destructor Documentation

__construct()

ilClientNodeDAV::__construct	(	string	$client_name,
		ilWebDAVRepositoryHelper	$repo_helper,
		ilWebDAVObjDAVHelper	$dav_helper
	)

Parameters

string

$client_name

Definition at line 38 of file class.ilClientNodeDAV.php.

References $DIC, and $repo_helper.

    {
        global $DIC;
        
        $this->repo_helper = $repo_helper;
        $this->dav_helper = $dav_helper;
        $this->client_name = $client_name;
        $this->name_of_repository_root = 'ILIAS';
    }

Member Function Documentation

checkIfRefIdIsValid()

ilClientNodeDAV::checkIfRefIdIsValid (   $ref_id )

protected

Check if object with ref_id exists and if is DAVable object.

Parameters

$ref_id

Returns

mixed

Definition at line 192 of file class.ilClientNodeDAV.php.

Referenced by getRefIdFromName().

    {
        if ($ref_id > 0 && $this->repo_helper->objectWithRefIdExists($ref_id) && $this->dav_helper->isDAVableObject($ref_id, true, false)) {
            return $ref_id;
        }
    }

Here is the caller graph for this function:

childExists()

ilClientNodeDAV::childExists

(

$name

)

Either the given name is the name of the repository root of ILIAS or it is a reference to a node in the ILIAS-repo.

Returns true if name=name of repository root or if given reference exists and user has read permissions to this reference

Implements Sabre\DAV\ICollection.

Definition at line 156 of file class.ilClientNodeDAV.php.

References $name, and getRefIdFromName().

    {
        if ($name == $this->name_of_repository_root) {
            return true;
        }
        
        $ref_id = $this->getRefIdFromName($name);
        if ($ref_id > 0) {
            return $this->repo_helper->objectWithRefIdExists($ref_id) && $this->repo_helper->checkAccess('read', $ref_id);
        }
        return false;
    }

Here is the call graph for this function:

createDirectory()

ilClientNodeDAV::createDirectory

(

$name

)

It is not allowed to create a directory here.

Parameters

string

$name

Exceptions

Forbidden

Implements Sabre\DAV\ICollection.

Definition at line 205 of file class.ilClientNodeDAV.php.

    {
        throw new Forbidden();
    }

createFile()

ilClientNodeDAV::createFile	(		$name,
			$data = null
	)

It is not allowed (and not even possible) to create a file here.

Parameters

string	$name
null	$data

Returns

null|string|void

Exceptions

Forbidden

Implements Sabre\DAV\ICollection.

Definition at line 228 of file class.ilClientNodeDAV.php.

    {
        throw new Forbidden();
    }

delete()

ilClientNodeDAV::delete

(

)

It is not allowed to delete anything here.

Exceptions

Forbidden

Implements Sabre\DAV\INode.

Definition at line 215 of file class.ilClientNodeDAV.php.

    {
        throw new Forbidden();
    }

getChild()

ilClientNodeDAV::getChild

(

$name

)

If the "ILIAS" is given as parameter, the repository root will be returned.

Such an URL would look like this: https://ilias.de/webdav.php/client/ILIAS/

Otherwise, the given name will be inspected if it is a reference ID of a collection/container. If call is valid and permissions are granted, the collection/container will be returned. Such an URL would look like this: https://ilias.de/webdav.php/client/ref_12345/

Parameters

string

$name

Returns

ilObjCategoryDAV|ilObjCourseDAV|ilObjFileDAV|ilObjFolderDAV|ilObjGroupDAV|ilObjRepositoryRootDAV|

Exceptions

BadRequest
Forbidden

Implements Sabre\DAV\ICollection.

Definition at line 103 of file class.ilClientNodeDAV.php.

References $name, getMountPointByReference(), and getRepositoryRootPoint().

    {
        if ($name == $this->name_of_repository_root) {
            return $this->getRepositoryRootPoint();
        } else {
            return $this->getMountPointByReference($name);
        }
    }

Here is the call graph for this function:

getChildren()

ilClientNodeDAV::getChildren

(

)

Returns Repository Root Object.

Array is needed since a list of all children is expected.

Returns

array|[]

Exceptions

Forbidden

Implements Sabre\DAV\ICollection.

Definition at line 65 of file class.ilClientNodeDAV.php.

References getRepositoryRootPoint().

    {
        return array($this->getRepositoryRootPoint());
    }

Here is the call graph for this function:

getLastModified()

ilClientNodeDAV::getLastModified

(

)

Returns some date as return for last modified.

Returns

false|int|null

Implements Sabre\DAV\INode.

Definition at line 85 of file class.ilClientNodeDAV.php.

    {
        return strtotime('2000-01-01');
    }

getMountPointByReference()

ilClientNodeDAV::getMountPointByReference (   $name )

protected

Create DAV-Object from ref_id.

Parameters

string

$name

Exceptions

Forbidden
BadRequest

Returns

ilObjCategoryDAV|ilObjCourseDAV|ilObjGroupDAV|ilObjFolderDAV|ilObjFileDAV

Definition at line 120 of file class.ilClientNodeDAV.php.

References $name, and getRefIdFromName().

Referenced by getChild().

    {
        $ref_id = $this->getRefIdFromName($name);
        
        if ($ref_id > 0) {
            if ($this->repo_helper->checkAccess('read', $ref_id)) {
                return $this->dav_helper->createDAVObjectForRefId($ref_id);
            }

            throw new Forbidden("No read permission for object with reference ID $ref_id ");
        }
        
        throw new BadRequest("Invalid parameter $name");
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getName()

ilClientNodeDAV::getName

(

)

Return name of client.

Returns

string

Implements Sabre\DAV\INode.

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

    {
        return $this->client_name;
    }

getRefIdFromName()

ilClientNodeDAV::getRefIdFromName

(

$name

)

Gets ref_id from name.

Name should look like this: ref_<ref_id>

Parameters

string

$name

Returns

int

Definition at line 175 of file class.ilClientNodeDAV.php.

References $name, and checkIfRefIdIsValid().

Referenced by childExists(), and getMountPointByReference().

    {
        $ref_parts = explode('_', $name);
        if (count($ref_parts) == 2) {
            $ref_id = (int) $ref_parts[1];
            return $this->checkIfRefIdIsValid($ref_id);
        }
        
        return 0;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getRepositoryRootPoint()

ilClientNodeDAV::getRepositoryRootPoint ( )

protected

Creates and returns Repository Root Object.

Returns

ilObjRepositoryRootDAV

Exceptions

Forbidden

Definition at line 140 of file class.ilClientNodeDAV.php.

Referenced by getChild(), and getChildren().

    {
        if ($this->repo_helper->checkAccess('read', ROOT_FOLDER_ID)) {
            return new ilObjRepositoryRootDAV($this->name_of_repository_root, $this->repo_helper, $this->dav_helper);
        }
        throw new Forbidden("No read permission for ilias repository root");
    }

Here is the caller graph for this function:

setName()

ilClientNodeDAV::setName

(

$name

)

Overwrite parent function to throw an exception if called.

It is not forbidden to rename the client over WebDAV

Parameters

string

$name

Exceptions

Forbidden

Implements Sabre\DAV\INode.

Definition at line 54 of file class.ilClientNodeDAV.php.

    {
        throw new Forbidden("You cant change the client name");
    }

Field Documentation

$name_of_repository_root

ilClientNodeDAV::$name_of_repository_root

protected

Definition at line 33 of file class.ilClientNodeDAV.php.

$repo_helper

ilClientNodeDAV::$repo_helper

protected

Definition at line 30 of file class.ilClientNodeDAV.php.

Referenced by __construct().

---

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

• Services/WebDAV/classes/dav/class.ilClientNodeDAV.php