Docs For Class PNObject

PNObject PNObject(
[init
$init = null], [key
$key = null], [field
$field = null])

Constructur, init everything to sane defaults and handle parameters

Parameters:

init	$init	Initialization value (see _init() for details)
key	$key	The DB key to use to retrieve the object (optional) (default=null)
field	$field	The field containing the key value (optional) (default=null)

[ Top ]

void clearFailedValidationData(
)

Clear the failed validation object data for this object

[ Top ]

void clearSessionCache(
)

Clear the session cache for this object

[ Top ]

void clearValidationErrors(
)

Clear the failed validation errors for this object

[ Top ]

The delete(
)

Generic delete handler for an object

Tags:

return:

Object Data

Overridden in child classes as:

PNObjectArray::delete(): Generic delete handler for an object

PNCategoryArray::delete()

PNCategory::delete()

[ Top ]

void deletePostProcess(
[
$data = null])

Post-Process the data after a delete. Subclasses can define appropriate implementations.

Overridden in child classes as:

PNCategoryRegistry::deletePostProcess()

Parameters:

$data

[ Top ]

void deletePreProcess(
[
$data = null])

Pre-Process the data prior a delete. Subclasses can define appropriate implementations.

Parameters:

$data

[ Top ]

void generateEmptyObject(
)

Generate an empty object with the fields initialized to null

[ Top ]

The &get(
[key
$key = 0], [field
$field = 'id'], [force
$force = false])

Return the current object data. If $key and $field are supplied, the object is fetched again from the database.

Tags:

return:

object's data value

Overridden in child classes as:

PNObjectArray::get(): Return the current object data. Maps to $this->getWhere().

Parameters:

key	$key	The record's key value
field	$field	The field we wish to get (optional) (default='id')
force	$force	If false, the system attempts to return the object from the session cache (optional) (default=false) (currently not used)

[ Top ]

The getData(
)

Return the currently set object data

Tags:

return:

object's data array

Overridden in child classes as:

PNObjectArray::getData(): Return the currently set object data

[ Top ]

The getDataField(
key
$key, [default
$default = null])

Generic function to retrieve

Tags:

return:

Object Data

Overridden in child classes as:

PNObjectArray::getDataField(): Generic function to retrieve

Parameters:

key	$key	The access key of the object field
default	$default	The default value to return (optional) (default=null)

[ Top ]

The &getDataFromInput(
[key
$key = null], [default
$default = null], [source
$source = 'REQUEST'])

Get the data from the various input streams provided.

Tags:

return:

requested object/value

Parameters:

key	$key	The access key of the object (optional) (default=null, reverts to $this->_objPath)
default	$default	The default value to return (optional) (default=null)
source	$source	Where to get the variable from (optional) (default='REQUEST')

[ Top ]

void getDataFromInputPostProcess(
[
$data = null])

Post-Process the data after getting it from Input. Subclasses can define appropriate implementations.

Overridden in child classes as:

PNCategoryArray::getDataFromInputPostProcess()

PNCategory::getDataFromInputPostProcess()

Parameters:

$data

[ Top ]

The &getDataFromSession(
[key
$key = null], [default
$default = null], [source
$path = ''], [
$autocreate = true], [
$overwriteExistingVar = false])

Get the data from the various input streams provided.

Tags:

return:

requested object/value

Parameters:

key	$key	The access key of the object (optional) (default=null, reverts to $this->_objPath)
default	$default	The default value to return (optional) (default=null)
source	$path	Where to get the variable from (optional) (default=null)
	$autocreate
	$overwriteExistingVar

[ Top ]

void getDataFromSessionPostProcess(
[
$data = null])

Post-Process the data after getting it from Session. Subclasses can define appropriate implementations.

Parameters:

$data

[ Top ]

The getDataFromSource(
source
$source, [key
$key = null], [default
$default = null], [clean
$clean = true])

Generic access function to retrieve data from the specified source

Tags:

return:

requested object/value

Parameters:

source	$source	The source data
key	$key	The access key of the object (optional) (default=null)
default	$default	The default value to return (optional) (default=null)
clean	$clean	Whether or not to clean the acquired data (optional) (default=true)

[ Top ]

The &getFailedValidationData(
)

Get the object which failed validation

Tags:

return:

object's data value

[ Top ]

void getHash(
[
$includeStandardFields = true], [
$objData = null])

Get the hashcode for this object data

Overridden in child classes as:

PNObjectArray::getHash(): Get the hashcode for this object data array

Parameters:

	$includeStandardFields
	$objData

[ Top ]

The getID(
)

Return the object-ID or false

Tags:

return:

object-ID or false

[ Top ]

The getIDField(
)

Return the object ID field name

Tags:

return:

object's ID field name

[ Top ]

void getValidation(
)

[ Top ]

The &getWhere(
where
$where)

Return/Select the object using the given where clause.

Tags:

return:

object's data value

Overridden in child classes as:

PNObjectArray::getWhere(): Return/Select the object using the given where clause.

Parameters:

where

$where

The where-clause to use

[ Top ]

Boolean hasID(
)

Return whether or not this object has a set id field

[ Top ]

The insert(
)

Generic insert handler for an object (ID is inserted into the object data)

Tags:

return:

Object Data

Overridden in child classes as:

PNObjectArray::insert(): Generic insert handler for an object (ID is inserted into the object data)

[ Top ]

void insertPostProcess(
[
$data = null])

Post-Process the data after an insert. Subclasses can define appropriate implementations.

Overridden in child classes as:

PNCategoryArray::insertPostProcess()

PNCategory::insertPostProcess()

Parameters:

$data

[ Top ]

void insertPreProcess(
[
$data = null])

Pre-Process the data prior to an insert. Subclasses can define appropriate implementations.

Overridden in child classes as:

PNCategoryArray::insertPreProcess()

PNCategory::insertPreProcess()

Parameters:

$data

[ Top ]

void prayer(
)

Print HTML-formatted debug output for the object

[ Top ]

void prayerData(
)

Print HTML-formatted debug output for the object data

[ Top ]

The save(
)

Generic insert handler for an object (ID is inserted into the object data). If the object contains a valid ID, it is updated, otherwise it it inserted

Tags:

return:

result set

Overridden in child classes as:

PNObjectArray::save(): Save an object - if it has an ID update it, otherwise insert it

[ Top ]

The &select(
key
$key, [field
$field = 'id'], [where
$where = ''])

Select the object from the database using the specified key (and field)

Tags:

return:

object's data value

Overridden in child classes as:

PNObjectArray::select(): Generic select handler for an object. Select (and set) the specified object array

Parameters:

key	$key	The record's key value (if init is a string directive)
field	$field	The key-field we wish to select by (optional) (default='id')
where	$where	The key-field we wish to select by (optional) (default='id')

[ Top ]

The selectPostProcess(
[obj
$obj = null])

Post-Process the newly selected object. Subclasses can define appropriate implementations.

Tags:

return:

object's data value

Overridden in child classes as:

PNObjectArray::selectPostProcess(): Iterate over the object data and post-process it

PNCategoryArray::selectPostProcess()

PNCategory::selectPostProcess()

Parameters:

obj

$obj

Override object (needed for selectObjectArray processing) (optional) (default=null)

[ Top ]

void setData(
data
$data, [cache
$cache = true])

Set (and return) the object data.

Overridden in child classes as:

PNObjectArray::setData(): Set (and return) the object data. Since we dont' have a definitive key, we don't cache

Parameters:

data	$data	The data to assign
cache	$cache	Whether or not to cache the data in session (optional) (default=true)

[ Top ]

The setDataField(
key
$key, value
$value)

Generic function to retrieve

Tags:

return:

value which was set into the specified object field

Parameters:

key	$key	The access key of the object field
value	$value	The value to assign to the specified object field

[ Top ]

The &setDataToSession(
[autocreate
$data = null], [overwriteExistingVar
$key = null], [
$path = ''], [
$autocreate = true], [
$overwriteExistingVar = false])

Set the current object data into session

Tags:

return:

session data

Parameters:

autocreate	$data	The autocreate passed to SessionUtil::setVar
overwriteExistingVar	$key	The overwriteExistingVar variable passed to SessionUtil::setVar
	$path
	$autocreate
	$overwriteExistingVar

[ Top ]

void setDataToSessionPreProcess(
[
$data = null])

Pre-Process the data before writing it to Session. Subclasses can define appropriate implementations.

Parameters:

$data

[ Top ]

The update(
)

Generic upate handler for an object

Tags:

return:

Object Data

Overridden in child classes as:

PNObjectArray::update(): Generic upate handler for an object

[ Top ]

void updatePostProcess(
[
$data = null])

Post-Process the data after an update. Subclasses can define appropriate implementations.

Overridden in child classes as:

PNCategoryArray::updatePostProcess()

PNCategory::updatePostProcess()

Parameters:

$data

[ Top ]

void updatePreProcess(
[
$data = null])

Pre-Process the data prior to an update. Subclasses can define appropriate implementations.

Overridden in child classes as:

PNCategoryArray::updatePreProcess()

PNCategory::updatePreProcess()

Parameters:

$data

[ Top ]

Boolean validate(
)

Generic function to validate an object

Tags:

return:

indicating whether validation has passed or failed

Overridden in child classes as:

PNObjectArray::validate(): Constructur, init everything to sane defaults and handle parameters

[ Top ]

void validatePostProcess(
[
$type = 'user'])

Post-Process the basic object validation with class specific logic.

Subclasses can define appropriate implementations.

Overridden in child classes as:

PNCategory::validatePostProcess()

PNCategoryRegistry::validatePostProcess()

Parameters:

$type

[ Top ]

void _init(
[init
$init = null], [key
$key = null], [field
$field = null])

Internal intialization routine

Overridden in child classes as:

PNObjectArray::_init(): Internal intialization routine

Parameters:

init

$init

Initialization value (can be an object or a string directive)

key

$key

The DB key to use to retrieve the object (optional) (default=null)

field

$field

The field containing the key value (optional) (default=null)

If $_init is an arrary it is set(), otherwise it is interpreted as a string specifying the source from where the data should be retrieved from.

[ Top ]

Class: PNObject

Class Overview

Variables

Methods

Child classes:

Class Details

Class Variables

$_columns =

$_GET_FROM_DB = 'D'

$_GET_FROM_GET = 'G'

$_GET_FROM_POST = 'P'

$_GET_FROM_REQUEST = 'R'

$_GET_FROM_SESSION = 'S'

$_GET_FROM_VALIDATION_FAILED = 'V'

$_objColumnArray =

$_objData =

$_objField =

$_objJoin =

$_objKey =

$_objPath =

$_objPermissionFilter =

$_objSessionPath =

$_objType =

$_objValidation =

$_table =

Class Methods

constructor PNObject [line 57]

Parameters:

method clearFailedValidationData [line 700]

method clearSessionCache [line 709]

method clearValidationErrors [line 691]

method delete [line 597]

Tags:

method deletePostProcess [line 624]

Parameters:

method deletePreProcess [line 615]

Parameters:

method generateEmptyObject [line 137]

method get [line 186]

Tags:

Parameters:

method getData [line 201]

Tags:

method getDataField [line 476]

Tags:

Parameters:

method getDataFromInput [line 346]

Tags:

Parameters:

method getDataFromInputPostProcess [line 423]

Parameters:

method getDataFromSession [line 373]

Tags:

Parameters:

method getDataFromSessionPostProcess [line 431]

Parameters:

method getDataFromSource [line 454]

Tags:

Parameters:

method getFailedValidationData [line 251]

Tags:

method getHash [line 673]

Parameters:

method getID [line 223]

Tags:

method getIDField [line 212]

Tags:

method getValidation [line 630]

method getWhere [line 240]

Tags:

Parameters:

method hasID [line 264]

method insert [line 527]

Tags:

method insertPostProcess [line 551]

Parameters:

method insertPreProcess [line 543]

Parameters:

method prayer [line 718]

method prayerData [line 727]