Public Member Functions
	__construct ()
	set_add_limitations ($theAddLimitation)
	unsafe_select ($Condition)
	select ($Start=false, $Limit=false, $Field=false, $Order=false, $Condition= '1=1')
	delete ($id, $Options= '1=1')
	create ($Record)
	update ($id, $Record)
	select_list ($id)

Data Fields
	$NativeTable = '`umx_comment`'
	$Database = false
	$DatabaseAlgorithms = false
	$Security = false
	$SecurityParser = false
	$UserAccess = false
	$UserAlgorithms = false
	$AddLimitations = '1 = 1'

Detailed Description

Class provides records access routine.

Author: Dodonov A.A.

Definition at line 26 of file comment_access.php.

Constructor & Destructor Documentation

__construct ( )

Constructor.

Author: Dodonov A.A.

Definition at line 67 of file comment_access.php.

            {
                  try
                  {
                        $this->Database = get_package( 'database' , 'last' , __FILE__ );
                        $this->DatabaseAlgorithms = get_package( 'database::database_algorithms' , 'last' , __FILE__ );
                        $this->Security = get_package( 'security' , 'last' , __FILE__ );
                        $this->SecurityParser = get_package( 'security::security_parser' , 'last' , __FILE__ );
                        $this->UserAccess = get_package( 'user::user_access' , 'last' , __FILE__ );
                        $this->UserAlgorithms = get_package( 'user::user_algorithms' , 'last' , __FILE__ );
                  }
                  catch( Exception $e )
                  {
                        $a = func_get_args();_throw_exception_object( __METHOD__ , $a , $e );
                  }
            }

Member Function Documentation

create ( $Record )

Creating record.

Parameters

$Record Example for creation.

Returns: id of the created record.

Exceptions

Exception An exception of this type is thrown.

Author: Dodonov A.A.

Definition at line 334 of file comment_access.php.

            {
                  try
                  {
                        $Record = $this->compile_record( $Record );
                        list( $Fields , $Values ) = $this->DatabaseAlgorithms->compile_fields_values( $Record , CREATION_DATE );
                        $id = $this->DatabaseAlgorithms->create( $this->NativeTable , $Fields , $Values );
                        $Link = get_package( 'link' , 'last' , __FILE__ );
                        $Link->create_link( 
                              get_field( $MasterLink , 'master_id' ) , $id , 
                              get_field( $MasterLink , 'master_type' ) , 'comment'
                        );
                        $EventManager = get_package( 'event_manager' , 'last' , __FILE__ );
                        $EventManager->trigger_event( 'on_after_create_comment' , array( 'id' => $id ) );
                        return( $id );
                  }
                  catch( Exception $e )
                  {
                        $a = func_get_args();_throw_exception_object( __METHOD__ , $a , $e );
                  }
            }

delete	(	$id,
		$Options = `' 1 = 1'`
	)

Deleting records.

Parameters

$id	- Record's identificator.
$Options	- Additional options.

Exceptions

Exception An exception of this type is thrown.

Author: Dodonov A.A.

Definition at line 253 of file comment_access.php.

            {
                  try
                  {
                        $Link = get_package( 'link' , 'last' , __FILE__ );
                        $Link->delete_link( false , $id , false , 'comment' );
                        $id = $this->Security->get( $id , 'integer_list' );
                        $this->Database->delete( $this->NativeTable , "( $this->AddLimitations ) AND id IN ( $id )" );
                        $this->Database->commit();
                  }
                  catch( Exception $e )
                  {
                        $a = func_get_args();_throw_exception_object( __METHOD__ , $a , $e );
                  }
            }

select	(	$Start = `false`,
		$Limit = `false`,
		$Field = `false`,
		$Order = `false`,
		$Condition = `'1 = 1'`
	)

Function returns list of records.

Parameters

$Start	- Number of the first record.
$Limit	- Count of records limitation.
$Field	- Field to sort by.
$Order	- Sorting order.
$Condition	- Additional conditions.

Returns: List of records.

Exceptions

Exception An exception of this type is thrown.

Author: Dodonov A.A.

Definition at line 214 of file comment_access.php.

            {
                  try
                  {
                        $Condition = $this->DatabaseAlgorithms->select_condition( 
                              $Start , $Limit , $Field , $Order , $Condition , $this->NativeTable
                        );
                        return( $this->unsafe_select( $Condition ) );
                  }
                  catch( Exception $e )
                  {
                        $a = func_get_args();_throw_exception_object( __METHOD__ , $a , $e );
                  }
            }

select_list ( $id )

Function selects list of objects.

Parameters

$id	- Comma separated list of record's id.

Returns: Array of records.

Exceptions

Exception An exception of this type is thrown.

Author: Dodonov A.A.

Definition at line 428 of file comment_access.php.

            {
                  try
                  {
                        $id = $this->Security->get( $id , 'integer_list' );
                        return( $this->unsafe_select( $this->NativeTable.".id IN ( $id ) ORDER BY creation_date ASC" ) );
                  }
                  catch( Exception $e )
                  {
                        $a = func_get_args();_throw_exception_object( __METHOD__ , $a , $e );
                  }
            }

set_add_limitations ( $theAddLimitation )

Function sets additional limitations.

Parameters

$theAddLimitation - Additional limitations.

Exceptions

Exception An exception of this type is thrown.

Author: Dodonov A.A.

Definition at line 114 of file comment_access.php.

            {
                  try
                  {
                        if( $this->AddLimitations === '1 = 1' )
                        {
                              $this->AddLimitations = $theAddLimitation;
                        }
                        else
                        {
                              throw( new Exception( '"AddLimitations" was already set' ) );
                        }
                  }
                  catch( Exception $e )
                  {
                        $a = func_get_args();_throw_exception_object( __METHOD__ , $a , $e );
                  }
            }

unsafe_select ( $Condition )

Selecting records.

Parameters

$Condition - Records selection condition.

Returns: Array of objects.

Exceptions

Exception An exception of this type is thrown.

Author: Dodonov A.A.

Definition at line 155 of file comment_access.php.

            {
                  try
                  {
                        $this->Database->query_as( DB_OBJECT );
                        return( 
                              $this->Database->select( 
                                    $this->UserAccess->NativeTable.'.* , '.$this->NativeTable.'.*' , 
                                    $this->NativeTable.' , '.$this->UserAccess->NativeTable , 
                                    $this->NativeTable.'.author = '.$this->UserAccess->NativeTable.".id 
                                          AND ( $this->AddLimitations ) AND $Condition"
                              )
                        );
                  }
                  catch( Exception $e )
                  {
                        $a = func_get_args();_throw_exception_object( __METHOD__ , $a , $e );
                  }
            }

update	(	$id,
		$Record
	)

Updating record.

Parameters

$id	- Comma separated list of record's id.
$Record	- Example for update.

Exceptions

Exception An exception of this type is thrown.

Author: Dodonov A.A.

Definition at line 383 of file comment_access.php.

            {
                  try
                  {
                        $id = $this->Security->get( $id , 'integer_list' );
                        $Record = $this->SecurityParser->parse_parameters( $Record , 'comment:string' , 'allow_not_set' );
                        list( $Fields , $Values ) = $this->DatabaseAlgorithms->compile_fields_values( $Record );
                        if( isset( $Fields[ 0 ] ) )
                        {
                              $this->Database->update( 
                                    $this->NativeTable , $Fields , $Values , "( $this->AddLimitations ) AND id IN ( $id )"
                              );
                              $this->Database->commit();
                        }
                  }
                  catch( Exception $e )
                  {
                        $a = func_get_args();_throw_exception_object( __METHOD__ , $a , $e );
                  }
            }

Field Documentation

$AddLimitations = '1 = 1'

Definition at line 94 of file comment_access.php.

$Database = false

Cached objects.

Author: Dodonov A.A.

Definition at line 50 of file comment_access.php.

$DatabaseAlgorithms = false

Definition at line 51 of file comment_access.php.

$NativeTable = '`umx_comment`'

Table name in wich objects of this entity are stored.

Author: Dodonov A.A.

Definition at line 38 of file comment_access.php.

$Security = false

Definition at line 52 of file comment_access.php.

$SecurityParser = false

Definition at line 53 of file comment_access.php.

$UserAccess = false

Definition at line 54 of file comment_access.php.

$UserAlgorithms = false

Definition at line 55 of file comment_access.php.

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

packages/comment/packages/comment_access/comment_access.php

Public Member Functions

Data Fields

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Field Documentation