ilLoggingActivity Class Reference

PhpIncludeInspection More...

Inheritance diagram for ilLoggingActivity:

Collaboration diagram for ilLoggingActivity:

Public Member Functions
	__construct (ilNode $a_context)
	Default constructor. More...
	setLogFile ($a_log_file)
	Sets the log file name and path. More...
	getLogFile ()
	Returns the log file name and path. More...
	setLogMessage ($a_log_message)
	Sets the message to be logged. More...
	getLogMessage ()
	Returns the currently set log message. More...
	setLogLevel ($a_log_level)
	Sets the log level of the message to be logged. More...
	getLogLevel ()
	Returns the currently set log level. More...
	getContext ()
	Returns the parent object. More...
	execute ()
	Executes this action according to its settings. More...
	setName ($name)
	getName ()

Protected Attributes
	$name

Private Member Functions
	checkFileWriteability ($a_log_file)
	Checks if the file is "really really" writeable. More...
	checkExtensionValidity ($extension)
	Checks if the given extension is a listed one. More...
	checkForExistingLogMessageContent ($a_log_message)
	Checks if an actual log message is set for the instance. More...
	determineValidityOfLogLevel ($a_log_level)
	Determines, if the given log level is a valid one. More...
	closeFilePointer ($file_pointer)
	Closes the file pointer. More...
	writeLogMessage ($file_pointer)
	Writes the instances log message to the logfile. More...
	acquireFilePointer ()
	Acquires and returns a file pointer to the instances log file. More...

Private Attributes
	$context
	$log_file = 'none.log'
	$log_message = 'no message set'
	$log_level = 'MESSAGE'

Detailed Description

PhpIncludeInspection

PhpIncludeInspection PhpIncludeInspection Class ilLoggingActivity

This activity writes a given message with loglevel to the given logfile. Design consideration is to configure the activity at the workflows creation time, since it is triggered on known conditions.

Author

Maximilian Becker mbeck.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Version

$Id$

/

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

Constructor & Destructor Documentation

__construct()

ilLoggingActivity::__construct

(

ilNode

$a_context

)

Default constructor.

Parameters

ilNode

$a_context

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

    {
        $this->context = $a_context;
    }

Member Function Documentation

acquireFilePointer()

ilLoggingActivity::acquireFilePointer ( )

private

Acquires and returns a file pointer to the instances log file.

Returns

resource File pointer

Exceptions

ilWorkflowFilesystemException

PhpIncludeInspection

Definition at line 282 of file class.ilLoggingActivity.php.

Referenced by execute().

    {
        $file_pointer = fopen($this->log_file, 'a');
        if ($file_pointer == null) {
            require_once './Services/WorkflowEngine/exceptions/ilWorkflowFilesystemException.php';
            throw new ilWorkflowFilesystemException('Cannot write to filesystem - no pointer returned.', 1000);
        }
        return $file_pointer;
    }

Here is the caller graph for this function:

checkExtensionValidity()

ilLoggingActivity::checkExtensionValidity (   $extension )

private

Checks if the given extension is a listed one.

(One of .log or .txt)

Parameters

$extension

Returns

void

Exceptions

ilWorkflowObjectStateException

PhpIncludeInspection

Definition at line 100 of file class.ilLoggingActivity.php.

Referenced by setLogFile().

    {
        if ($extension != '.log' && $extension != '.txt') {
            require_once './Services/WorkflowEngine/exceptions/ilWorkflowObjectStateException.php';
            throw new ilWorkflowObjectStateException('Illegal extension. Log file must be either .txt or .log.', 1002);
        }
    }

Here is the caller graph for this function:

checkFileWriteability()

ilLoggingActivity::checkFileWriteability (   $a_log_file )

private

Checks if the file is "really really" writeable.

Parameters

$a_log_file

Returns

void

Exceptions

ilWorkflowFilesystemException

PhpUsageOfSilenceOperatorInspection

PhpIncludeInspection

Definition at line 79 of file class.ilLoggingActivity.php.

Referenced by setLogFile().

    {
        @$file_handle = fopen($a_log_file, 'a+');
        if ($file_handle == null) {
            require_once './Services/WorkflowEngine/exceptions/ilWorkflowFilesystemException.php';
            throw new ilWorkflowFilesystemException('Could not write to filesystem - no pointer returned.', 1002);
        }
        fclose($file_handle);
    }

Here is the caller graph for this function:

checkForExistingLogMessageContent()

ilLoggingActivity::checkForExistingLogMessageContent (   $a_log_message )

private

Checks if an actual log message is set for the instance.

Parameters

$a_log_message

Returns

void

Exceptions

ilWorkflowObjectStateException

PhpIncludeInspection

Definition at line 141 of file class.ilLoggingActivity.php.

Referenced by setLogMessage().

    {
        if ($a_log_message == null || $a_log_message == '') {
            require_once './Services/WorkflowEngine/exceptions/ilWorkflowObjectStateException.php';
            throw new ilWorkflowObjectStateException('Log message must not be null or empty.', 1002);
        }
    }

Here is the caller graph for this function:

closeFilePointer()

ilLoggingActivity::closeFilePointer (   $file_pointer )

private

Closes the file pointer.

Parameters

$file_pointer

Returns

void

Exceptions

ilWorkflowFilesystemException

PhpIncludeInspection

Definition at line 250 of file class.ilLoggingActivity.php.

Referenced by execute().

    {
        if (!fclose($file_pointer)) {
            require_once './Services/WorkflowEngine/exceptions/ilWorkflowFilesystemException.php';
            throw new ilWorkflowFilesystemException('Cannot write to filesystem - pointer returned did not close.', 1001);
        }
    }

Here is the caller graph for this function:

determineValidityOfLogLevel()

ilLoggingActivity::determineValidityOfLogLevel (   $a_log_level )

private

Determines, if the given log level is a valid one.

Log levels are similar to Apache log4j levels.

Parameters

$a_log_level

Returns

bool

Definition at line 190 of file class.ilLoggingActivity.php.

References $valid.

Referenced by setLogLevel().

    {
        switch (strtolower($a_log_level)) {
            case 'trace':
            case 'message':
            case 'warning':
            case 'debug':
            case 'info':
            case 'fatal':
                $valid = true;
                break;
            default:
                $valid = false;
                return $valid;
        }
        return $valid;
    }

Here is the caller graph for this function:

execute()

ilLoggingActivity::execute

(

)

Executes this action according to its settings.

Returns

void

Implements ilActivity.

Definition at line 233 of file class.ilLoggingActivity.php.

References acquireFilePointer(), closeFilePointer(), and writeLogMessage().

    {
        $file_pointer = null;
        $file_pointer = $this->acquireFilePointer();
        $this->writeLogMessage($file_pointer);
        $this->closeFilePointer($file_pointer);
    }

Here is the call graph for this function:

getContext()

ilLoggingActivity::getContext

(

)

Returns the parent object.

Type is ilNode, implements ilWorkflowEngineElement

Returns

ilNode Parent node of this element.

Implements ilWorkflowEngineElement.

Definition at line 223 of file class.ilLoggingActivity.php.

References $context.

    {
        return $this->context;
    }

getLogFile()

ilLoggingActivity::getLogFile

(

)

Returns the log file name and path.

Returns

string File name and path of the log file.

Definition at line 114 of file class.ilLoggingActivity.php.

References $log_file.

    {
        return $this->log_file;
    }

getLogLevel()

ilLoggingActivity::getLogLevel

(

)

Returns the currently set log level.

Returns

string

Definition at line 213 of file class.ilLoggingActivity.php.

References $log_level.

    {
        return $this->log_level;
    }

getLogMessage()

ilLoggingActivity::getLogMessage

(

)

Returns the currently set log message.

Returns

string

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

References $log_message.

    {
        return $this->log_message;
    }

getName()

ilLoggingActivity::getName

(

)

Returns

mixed

Implements ilWorkflowEngineElement.

Definition at line 298 of file class.ilLoggingActivity.php.

References $name.

    {
        return $this->name;
    }

setLogFile()

ilLoggingActivity::setLogFile

(

$a_log_file

)

Sets the log file name and path.

Parameters

string

$a_log_file

Path, name and extension of the log file.

Returns

void

Definition at line 62 of file class.ilLoggingActivity.php.

References checkExtensionValidity(), and checkFileWriteability().

    {
        $extension = substr($a_log_file, strlen($a_log_file)-4, 4);
        $this->checkExtensionValidity($extension);
        $this->checkFileWriteability($a_log_file);
        $this->log_file = $a_log_file;
    }

Here is the call graph for this function:

setLogLevel()

ilLoggingActivity::setLogLevel

(

$a_log_level

)

Sets the log level of the message to be logged.

See also

$log_level

Parameters

string

$a_log_level

A valid log level.

Returns

void

Exceptions

ilWorkflowObjectStateException

on illegal log level.

PhpIncludeInspection

Definition at line 171 of file class.ilLoggingActivity.php.

References $valid, and determineValidityOfLogLevel().

    {
        $valid = $this->determineValidityOfLogLevel($a_log_level);
        if ($valid == false) {
            require_once './Services/WorkflowEngine/exceptions/ilWorkflowObjectStateException.php';
            throw new ilWorkflowObjectStateException('Log level must be one of: message, warning, debug, info, fatal.', 1002);
        }
        $this->log_level = strtoupper($a_log_level);
    }

Here is the call graph for this function:

setLogMessage()

ilLoggingActivity::setLogMessage

(

$a_log_message

)

Sets the message to be logged.

Parameters

string

$a_log_message

Text of the log message

Returns

void

Definition at line 126 of file class.ilLoggingActivity.php.

References checkForExistingLogMessageContent().

    {
        $this->checkForExistingLogMessageContent($a_log_message);
        $this->log_message = $a_log_message;
    }

Here is the call graph for this function:

setName()

ilLoggingActivity::setName

(

$name

)

Parameters

string

$name

Returns

mixed

Implements ilWorkflowEngineElement.

Definition at line 293 of file class.ilLoggingActivity.php.

References $name.

    {
        $this->name = $name;
    }

writeLogMessage()

ilLoggingActivity::writeLogMessage (   $file_pointer )

private

Writes the instances log message to the logfile.

Parameters

$file_pointer

Returns

void

PhpIncludeInspection

Definition at line 266 of file class.ilLoggingActivity.php.

References date.

Referenced by execute().

    {
        require_once './Services/WorkflowEngine/classes/utils/class.ilWorkflowUtils.php';
        fwrite($file_pointer, date('Y/m/d H:i:s') . substr((string) ilWorkflowUtils::microtime(), 1, 6) . ' :: ');
        fwrite($file_pointer, $this->log_level . ' :: ');
        fwrite($file_pointer, $this->log_message . "\r\n");
    }

Here is the caller graph for this function:

Field Documentation

$context

ilLoggingActivity::$context

private

Definition at line 26 of file class.ilLoggingActivity.php.

Referenced by getContext().

$log_file

ilLoggingActivity::$log_file = 'none.log'

private

Definition at line 29 of file class.ilLoggingActivity.php.

Referenced by getLogFile().

$log_level

ilLoggingActivity::$log_level = 'MESSAGE'

private

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

Referenced by getLogLevel().

$log_message

ilLoggingActivity::$log_message = 'no message set'

private

Definition at line 32 of file class.ilLoggingActivity.php.

Referenced by getLogMessage().

$name

ilLoggingActivity::$name

protected

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

Referenced by getName(), and setName().

---

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

• Services/WorkflowEngine/classes/activities/class.ilLoggingActivity.php