CWIS Developer Documentation

- Home
- Main Page
- Namespaces
- Classes
- Files

- Class List
- Class Index
- Class Hierarchy
- Class Members

Public Member Functions | Static Public Member Functions | Protected Member Functions | Static Protected Member Functions | Protected Attributes | Static Protected Attributes | List of all members
Item Class Reference

Common base class for persistent items store in database. More...

Inheritance diagram for Item:
[legend]

## Public Member Functions
| __construct ($Id)
| Constructor, used to load existing items. More...
| Destroy ()
| Destroy item. More...
| Delete ()
| Destroy item. More...
| Id ()
| Get item ID. More...
| Name ($NewValue=DB_NOVALUE)
| Get/set name of item. More...
| DateCreated ($NewValue=DB_NOVALUE)
| Get/set when item was created. More...
| CreatedBy ($NewValue=DB_NOVALUE)
| Get/set ID of user who created the item. More...
| DateLastModified ($NewValue=DB_NOVALUE)
| Get/set when item was last modified. More...
| LastModifiedBy ($NewValue=DB_NOVALUE)
| Get/set ID of user who last modified the item. More...

## Static Public Member Functions
static | GetCanonicalId ($Id)
| Normalize item ID to canonical form. More...
static | ItemExists ($Id)
| Check whether an item exists with the specified ID. More...

## Protected Member Functions
| UpdateValue ($ColumnName, $NewValue=DB_NOVALUE)
| Convenience function to supply parameters to Database::UpdateValue(). More...
| UpdateDateValue ($ColumnName, $NewValue=DB_NOVALUE)
| Convenience function to supply parameters to Database::UpdateValue(), with preprocessing of new values to convert them into an SQL-compatible date format. More...

## Static Protected Member Functions
static | CreateWithValues ($Values)
| Create a new item, using specified initial database values. More...
static | SetDatabaseAccessValues ($ClassName)
| Set the database access values (table name, ID column name, name column name) for specified class. More...

## Protected Attributes
| $DB
| $Id
| $ItemIdColumnName
| $ItemNameColumnName
| $ItemTableName
| $ValueCache = array()

## Static Protected Attributes
static | $ItemIdColumnNames
static | $ItemNameColumnNames
static | $ItemTableNames

## Detailed Description

Common base class for persistent items store in database.

Definition at line 13 of file Item.php.

## Constructor & Destructor Documentation

Item::__construct | ( |  | $Id | ) |

Constructor, used to load existing items.

To create new items, child classes should implement a static Create() method.

Parameters

  mixed | $Id | ID of item to load, in a form resolvable by GetCanonicalId().

See also
  Create()
  GetCanonicalId()

Exceptions

  InvalidArgumentException | If ID is invalid.

Definition at line 27 of file Item.php.

References $Id, and Id().

## Member Function Documentation

Item::CreatedBy | ( |  | $NewValue = `DB_NOVALUE` | ) |

Get/set ID of user who created the item.

(This method assumes there is a "CreatedBy" column in the database of type INT.)

Parameters

  int | $NewValue | New user ID.

Returns
  int ID of user who created item.

Definition at line 121 of file Item.php.

References UpdateValue().

static Item::CreateWithValues | ( |  | $Values | ) |
| staticprotected

Create a new item, using specified initial database values.

Parameters

  array | $Values | Values to set database columns to for new item, with column names for the index.

Returns
  object Newly-created item.

Definition at line 198 of file Item.php.

References $DB.

Item::DateCreated | ( |  | $NewValue = `DB_NOVALUE` | ) |

Get/set when item was created.

(This method assumes there is a "DateCreated" column in the database of type DATETIME.)

Parameters

  string | $NewValue | New creation date.

Returns
  string Creation date in the format "YYYY-MM-DD HH:MM:SS".

Definition at line 110 of file Item.php.

References UpdateDateValue().

Item::DateLastModified | ( |  | $NewValue = `DB_NOVALUE` | ) |

Get/set when item was last modified.

(This method assumes there is a "DateLastModified" column in the database of type DATETIME.)

Parameters

  string | $NewValue | New modification date.

Returns
  string Modification date in the format "YYYY-MM-DD HH:MM:SS".

Definition at line 132 of file Item.php.

References UpdateDateValue().

Item::Delete | ( |  | ) |

Destroy item.

Provided for backward compatibility - Destroy() should be used instead.

Deprecated:

Definition at line 69 of file Item.php.

References Destroy().

Item::Destroy | ( |  | ) |

Destroy item.

Item object should no longer be used after this call.

Definition at line 57 of file Item.php.

References Id().

Referenced by Delete().

Here is the caller graph for this function:

static Item::GetCanonicalId | ( |  | $Id | ) |
| static

Normalize item ID to canonical form.

Parameters

  mixed | $Id | ID to normalize.

Returns
  int Canonical ID.

Definition at line 88 of file Item.php.

References $Id.

Item::Id | ( |  | ) |

Get item ID.

Returns
  int Canonical item ID.

Definition at line 78 of file Item.php.

References $Id.

Referenced by __construct(), Destroy(), and UpdateValue().

Here is the caller graph for this function:

static Item::ItemExists | ( |  | $Id | ) |
| static

Check whether an item exists with the specified ID.

This only checks whether there is an entry for an item with the specified ID in the database – it does not check anything else (e.g. the type of the item).

Parameters

  int | $Id | ID to check.

Returns
  bool TRUE if item exists with ID, otherwise FALSE.

Definition at line 155 of file Item.php.

References $DB, and $Id.

Referenced by ResourceFactory\DuplicateResource(), and ResourceFactory\FilterNonViewableResources().

Here is the caller graph for this function:

Item::LastModifiedBy | ( |  | $NewValue = `DB_NOVALUE` | ) |

Get/set ID of user who last modified the item.

(This method assumes there is a "LastModifiedBy" column in the database of type INT.)

Parameters

  int | $NewValue | New user ID.

Returns
  int ID of user who last modified item.

Definition at line 143 of file Item.php.

References UpdateValue().

Item::Name | ( |  | $NewValue = `DB_NOVALUE` | ) |

Get/set name of item.

(This method assumes there is a "Name" column in the database of type TEXT.)

Parameters

  string | $NewValue | New name. (OPTIONAL)

Returns
  string Current name.

Definition at line 99 of file Item.php.

References UpdateValue().

static Item::SetDatabaseAccessValues | ( |  | $ClassName | ) |
| staticprotected

Set the database access values (table name, ID column name, name column name) for specified class.

This may be overridden in a child class, if different values are needed.

Parameters

  string | $ClassName | Class to set values for.

Definition at line 238 of file Item.php.

References StdLib\Pluralize().

Item::UpdateDateValue | ( |  | $ColumnName,
|  |  | $NewValue = `DB_NOVALUE`
| ) |  |
| protected

Convenience function to supply parameters to Database::UpdateValue(), with preprocessing of new values to convert them into an SQL-compatible date format.

Parameters

  string | $ColumnName | Name of database column.
  string | $NewValue | New value for field. (OPTIONAL)

Returns
  string Return value from Database::UpdateValue().

See also
  Database::UpdateValue()

Definition at line 271 of file Item.php.

References DB_NOVALUE, and UpdateValue().

Referenced by DateCreated(), and DateLastModified().

Here is the caller graph for this function:

Item::UpdateValue | ( |  | $ColumnName,
|  |  | $NewValue = `DB_NOVALUE`
| ) |  |
| protected

Convenience function to supply parameters to Database::UpdateValue().

Parameters

  string | $ColumnName | Name of database column.
  string | $NewValue | New value for field. (OPTIONAL)

Returns
  string Return value from Database::UpdateValue().

See also
  Database::UpdateValue()

Definition at line 255 of file Item.php.

References Id().

Referenced by CreatedBy(), Classification\FieldId(), LastModifiedBy(), Classification\LinkString(), Name(), Classification\QualifierId(), Classification\RecalcDepthAndFullName(), Classification\RecalcResourceCount(), Classification\SegmentName(), and UpdateDateValue().

Here is the caller graph for this function:

## Member Data Documentation

Item::$DB
| protected

Definition at line 181 of file Item.php.

Referenced by Resource\Classifications(), Resource\Clear(), Classification\Create(), Resource\Create(), CreateWithValues(), Resource\Delete(), Resource\GetSchemaForResource(), Resource\IsTempResource(), ItemExists(), Resource\Rating(), and Resource\Set().

Item::$Id
| protected

Definition at line 182 of file Item.php.

Referenced by __construct(), Resource\Clear(), Resource\Create(), GetCanonicalId(), Id(), Classification\Id(), Resource\Id(), Resource\IsTempResource(), ItemExists(), Classification\RecalcResourceCount(), and Resource\Set().

Item::$ItemIdColumnName
| protected

Definition at line 183 of file Item.php.

Item::$ItemIdColumnNames
| staticprotected

Definition at line 188 of file Item.php.

Item::$ItemNameColumnName
| protected

Definition at line 184 of file Item.php.

Item::$ItemNameColumnNames
| staticprotected

Definition at line 189 of file Item.php.

Item::$ItemTableName
| protected

Definition at line 185 of file Item.php.

Item::$ItemTableNames
| staticprotected

Definition at line 190 of file Item.php.

Item::$ValueCache = array()
| protected

Definition at line 186 of file Item.php.

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

- lib/ScoutLib/Item.php