SDRValue Class Reference
[SDR Model Objects]

Model class for SDRValue entity. More...

Inheritance diagram for SDRValue:

List of all members.

Public Member Functions

__construct ($constraints=null)

Constructs new SDRValue object.

addSDRDateValue ($entry= '')

Add new SDRDateValue object connected to this object.

addSDRFieldValue ($field)

Add new SDRFieldValue object connected to this object.

addSDRIntValue ($entry)

Add new SDRIntValue object connected to this object.

addSDRTextValue ($entry)

Add new SDRTextValue object connected to this object.

addSDRVersionFieldValue ($version, $field)

Add new SDRVersionFieldValue object connected to this object.

listSDRDateValues ($constraints=array(), $limit=array(), $order=array(), $count=false)

Retrieves list of children SDRDateValue objects.

listSDRDateValuesMulti ($constraints=array(), $limit=array(), $order=array(), $count=false, $depth=1)

Retrieves list of children SDRDateValue objects using joins.

listSDRFieldValues ($constraints=array(), $limit=array(), $order=array(), $count=false)

Retrieves list of children SDRFieldValue objects.

listSDRFieldValuesMulti ($constraints=array(), $limit=array(), $order=array(), $count=false, $depth=1)

Retrieves list of children SDRFieldValue objects using joins.

listSDRIntValues ($constraints=array(), $limit=array(), $order=array(), $count=false)

Retrieves list of children SDRIntValue objects.

listSDRIntValuesMulti ($constraints=array(), $limit=array(), $order=array(), $count=false, $depth=1)

Retrieves list of children SDRIntValue objects using joins.

listSDRTextValues ($constraints=array(), $limit=array(), $order=array(), $count=false)

Retrieves list of children SDRTextValue objects.

listSDRTextValuesMulti ($constraints=array(), $limit=array(), $order=array(), $count=false, $depth=1)

Retrieves list of children SDRTextValue objects using joins.

listSDRVersionFieldValues ($constraints=array(), $limit=array(), $order=array(), $count=false)

Retrieves list of children SDRVersionFieldValue objects.

listSDRVersionFieldValuesMulti ($constraints=array(), $limit=array(), $order=array(), $count=false, $depth=1)

Retrieves list of children SDRVersionFieldValue objects using joins.

Static Public Member Functions

static exists ($constraints=array())

Checks to see if object exists according to constraints.

static findOrAddValue ($entry, $field)

Find a value if it exists, or add it if it does not exist.

static getAttributesStatic ()

Retrieves attributes and information about them.

static getList ($constraints=array(), $limit=array(), $order=array(), $count=false)

Retrieves list of SDRValue objects.

static getTableNameStatic ()

Retrieves name of table represented by this class.

static retrieve ($constraints=array(), $checkOnly=false)

Retrieves a single object of this type, given the constraints.

Static Public Attributes

static $ATTRIBUTES

Attributes for this entity and information about them.

Private Member Functions

valueTableForType ($type)

Get the name of a value table (for storing the data of a value) based on value type.

Detailed Description

Model class for SDRValue entity.

INSERT DESCRIPTION HERE

Definition at line 12 of file SDRValue.php5.

Constructor & Destructor Documentation

SDRValue::__construct ( $ constraints = null )

Constructs new SDRValue object.

This method will only populate the object if a constraints array is passed in, to use for selecting the information for the object from the database (see Guide to Database Constraints).

Parameters:

$constraints

[array]: constraints array for populating

Definition at line 33 of file SDRValue.php5.

References SDatabaseModel::populate(), SModel2::registerAttributes(), SDatabaseModel::registerPrimaryKey(), and SDatabaseModel::registerTableName().

Member Function Documentation

SDRValue::addSDRDateValue ( $ entry = '' )

Add new SDRDateValue object connected to this object.

This method creates a new SDRDateValue and makes sure that relevant foreign keys in that object point to this object and any other necessary objects as passed in as parameters to this method. For parameters that request another model object, you may either pass in the model object itself, or the id value for that object, as would be used in the foreign key of the new SDRDateValue object. For example, if the new object needs to point to both this object and, say, a user object, then you can either pass in a user object, or a user ID.

Parameters:

$entry

[time]: INSERT DESCRIPTION HERE

Returns:: [SDRDateValue]: new object (already committed) or null on failure

Definition at line 257 of file SDRValue.php5.

References SDatabaseModel::commit().

SDRValue::addSDRFieldValue ( $ field )

Add new SDRFieldValue object connected to this object.

This method creates a new SDRFieldValue and makes sure that relevant foreign keys in that object point to this object and any other necessary objects as passed in as parameters to this method. For parameters that request another model object, you may either pass in the model object itself, or the id value for that object, as would be used in the foreign key of the new SDRFieldValue object. For example, if the new object needs to point to both this object and, say, a user object, then you can either pass in a user object, or a user ID.

Parameters:

$field

[SDRField]: Can also be foreign key value. INSERT DESCRIPTION HERE

Returns:: [SDRFieldValue]: new object (already committed) or null on failure

Definition at line 329 of file SDRValue.php5.

References SDatabaseModel::commit().

SDRValue::addSDRIntValue ( $ entry )

Add new SDRIntValue object connected to this object.

This method creates a new SDRIntValue and makes sure that relevant foreign keys in that object point to this object and any other necessary objects as passed in as parameters to this method. For parameters that request another model object, you may either pass in the model object itself, or the id value for that object, as would be used in the foreign key of the new SDRIntValue object. For example, if the new object needs to point to both this object and, say, a user object, then you can either pass in a user object, or a user ID.

Parameters:

$entry

[int]: INSERT DESCRIPTION HERE

Returns:: [SDRIntValue]: new object (already committed) or null on failure

Definition at line 476 of file SDRValue.php5.

References SDatabaseModel::commit().

SDRValue::addSDRTextValue ( $ entry )

Add new SDRTextValue object connected to this object.

This method creates a new SDRTextValue and makes sure that relevant foreign keys in that object point to this object and any other necessary objects as passed in as parameters to this method. For parameters that request another model object, you may either pass in the model object itself, or the id value for that object, as would be used in the foreign key of the new SDRTextValue object. For example, if the new object needs to point to both this object and, say, a user object, then you can either pass in a user object, or a user ID.

Parameters:

$entry

[string]: INSERT DESCRIPTION HERE

Returns:: [SDRTextValue]: new object (already committed) or null on failure

Definition at line 404 of file SDRValue.php5.

References SDatabaseModel::commit().

SDRValue::addSDRVersionFieldValue	(	$	version,
		$	field
	)

Add new SDRVersionFieldValue object connected to this object.

This method creates a new SDRVersionFieldValue and makes sure that relevant foreign keys in that object point to this object and any other necessary objects as passed in as parameters to this method. For parameters that request another model object, you may either pass in the model object itself, or the id value for that object, as would be used in the foreign key of the new SDRVersionFieldValue object. For example, if the new object needs to point to both this object and, say, a user object, then you can either pass in a user object, or a user ID.

Parameters:

	$version	[SDRVersion]: Can also be foreign key value. INSERT DESCRIPTION HERE
	$field	[SDRField]: Can also be foreign key value. INSERT DESCRIPTION HERE

Returns:: [SDRVersionFieldValue]: new object (already committed) or null on failure

Definition at line 178 of file SDRValue.php5.

References SDatabaseModel::commit().

static SDRValue::exists ( $ constraints = array() ) [static]

Checks to see if object exists according to constraints.

This is simply an alias for retrieve($constraints, true);

Parameters:

$constraints

[array]: constraints used to check for existence of object

Returns:: [boolean]: whether object exists in DB

Definition at line 73 of file SDRValue.php5.

static SDRValue::findOrAddValue	(	$	entry,
		$	field
	)			`[static]`

Find a value if it exists, or add it if it does not exist.

Parameters:

	$entry	[mixed]: A number, text, or date value
	$type	[string]: The name of the value's type (TYPE_INT, TYPE_TEXT, TYPE_DATE)

Returns:: [SDRValue]: A value object representing that value, either existing or newly committed

For internal use only.

Definition at line 521 of file SDRValue.php5.

References SDatabaseModel::commit(), SDRFieldValue::retrieve(), and SDRTextValue::retrieve().

Referenced by SDRService::submit().

static SDRValue::getAttributesStatic ( ) [static]

Retrieves attributes and information about them.

This method is needed because there is no generic way to get at the $ATTRIBUTES static member variable without this kind of method. If you do not need to generically grab the attributes of a model class, just use ModelClass::$ATTRIBUTES or $obj->getAttributes().

Returns:: [array]: contents of static $ATTRIBUTES array

Definition at line 103 of file SDRValue.php5.

static SDRValue::getList	(	$	constraints = `array()`,
		$	limit = `array()`,
		$	order = `array()`,
		$	count = `false`
	)			`[static]`

Retrieves list of SDRValue objects.

See Guide to Database Constraints for more on how to construct constraint and other arrays for this method.

Parameters:

	$constraints	[array]: limit results by criteria
	$limit	[array]: limit results by count
	$order	[array]: change ordering of results
	$count	[boolean]: if true, return the number of objects that would have been returned, rather than the objects themselves

Returns:: [array of SDRValue]: list of objects matching the criteria, if any, or null on error

Definition at line 90 of file SDRValue.php5.

static SDRValue::getTableNameStatic ( ) [static]

Retrieves name of table represented by this class.

Returns:: [string]: table name

Definition at line 112 of file SDRValue.php5.

SDRValue::listSDRDateValues	(	$	constraints = `array()`,
		$	limit = `array()`,
		$	order = `array()`,
		$	count = `false`
	)

Retrieves list of children SDRDateValue objects.

This method retrieves objects of type SDRDateValue which have their valueId field equal to the value of this object's id field. The constraints, limit and order parameters can be used to trim down and order the results. See Guide to Database Constraints for more on using database constraints with DBI2/SModel2.

Parameters:

	$constraints	[array]: constraints array to further limit results
	$limit	[array]: limit array to control how many and which results are returned
	$order	[array]: order array to control the ordering of the returned results
	$count	[boolean]: if true, only return the count of how many objects would be returned, rather than the objects themselves

Returns:: [SDRDateValue]: array of child objects, or an integer if $count is true, or null on error

Definition at line 213 of file SDRValue.php5.

SDRValue::listSDRDateValuesMulti	(	$	constraints = `array()`,
		$	limit = `array()`,
		$	order = `array()`,
		$	count = `false`,
		$	depth = `1`
	)

Retrieves list of children SDRDateValue objects using joins.

This method retrieves objects of type SDRDateValue which have their valueId field equal to the value of this object's id field. The constraints, limit and order parameters can be used to trim down and order the results. See Guide to Database Constraints for more on using database constraints with DBI2/SModel2. Unlike listSDRDateValues(), this method joins the child objects with their parent objects.

Parameters:

	$constraints	[array]: constraints array to further limit results
	$limit	[array]: limit array to control how many and which results are returned
	$order	[array]: order array to control the ordering of the returned results
	$count	[boolean]: if true, only return the count of how many objects would be returned, rather than the objects themselves
	$depth	[int]: how deep to traverse dependencies when doing joins

Returns:: [SDRDateValue]: array of child objects, or an integer if $count is true, or null on error

Definition at line 237 of file SDRValue.php5.

SDRValue::listSDRFieldValues	(	$	constraints = `array()`,
		$	limit = `array()`,
		$	order = `array()`,
		$	count = `false`
	)

Retrieves list of children SDRFieldValue objects.

This method retrieves objects of type SDRFieldValue which have their valueId field equal to the value of this object's id field. The constraints, limit and order parameters can be used to trim down and order the results. See Guide to Database Constraints for more on using database constraints with DBI2/SModel2.

Parameters:

	$constraints	[array]: constraints array to further limit results
	$limit	[array]: limit array to control how many and which results are returned
	$order	[array]: order array to control the ordering of the returned results
	$count	[boolean]: if true, only return the count of how many objects would be returned, rather than the objects themselves

Returns:: [SDRFieldValue]: array of child objects, or an integer if $count is true, or null on error

Definition at line 285 of file SDRValue.php5.

SDRValue::listSDRFieldValuesMulti	(	$	constraints = `array()`,
		$	limit = `array()`,
		$	order = `array()`,
		$	count = `false`,
		$	depth = `1`
	)

Retrieves list of children SDRFieldValue objects using joins.

This method retrieves objects of type SDRFieldValue which have their valueId field equal to the value of this object's id field. The constraints, limit and order parameters can be used to trim down and order the results. See Guide to Database Constraints for more on using database constraints with DBI2/SModel2. Unlike listSDRFieldValues(), this method joins the child objects with their parent objects.

Parameters:

	$constraints	[array]: constraints array to further limit results
	$limit	[array]: limit array to control how many and which results are returned
	$order	[array]: order array to control the ordering of the returned results
	$count	[boolean]: if true, only return the count of how many objects would be returned, rather than the objects themselves
	$depth	[int]: how deep to traverse dependencies when doing joins

Returns:: [SDRFieldValue]: array of child objects, or an integer if $count is true, or null on error

Definition at line 309 of file SDRValue.php5.

SDRValue::listSDRIntValues	(	$	constraints = `array()`,
		$	limit = `array()`,
		$	order = `array()`,
		$	count = `false`
	)

Retrieves list of children SDRIntValue objects.

This method retrieves objects of type SDRIntValue which have their valueId field equal to the value of this object's id field. The constraints, limit and order parameters can be used to trim down and order the results. See Guide to Database Constraints for more on using database constraints with DBI2/SModel2.

Parameters:

	$constraints	[array]: constraints array to further limit results
	$limit	[array]: limit array to control how many and which results are returned
	$order	[array]: order array to control the ordering of the returned results
	$count	[boolean]: if true, only return the count of how many objects would be returned, rather than the objects themselves

Returns:: [SDRIntValue]: array of child objects, or an integer if $count is true, or null on error

Definition at line 432 of file SDRValue.php5.

SDRValue::listSDRIntValuesMulti	(	$	constraints = `array()`,
		$	limit = `array()`,
		$	order = `array()`,
		$	count = `false`,
		$	depth = `1`
	)

Retrieves list of children SDRIntValue objects using joins.

This method retrieves objects of type SDRIntValue which have their valueId field equal to the value of this object's id field. The constraints, limit and order parameters can be used to trim down and order the results. See Guide to Database Constraints for more on using database constraints with DBI2/SModel2. Unlike listSDRIntValues(), this method joins the child objects with their parent objects.

Parameters:

	$constraints	[array]: constraints array to further limit results
	$limit	[array]: limit array to control how many and which results are returned
	$order	[array]: order array to control the ordering of the returned results
	$count	[boolean]: if true, only return the count of how many objects would be returned, rather than the objects themselves
	$depth	[int]: how deep to traverse dependencies when doing joins

Returns:: [SDRIntValue]: array of child objects, or an integer if $count is true, or null on error

Definition at line 456 of file SDRValue.php5.

SDRValue::listSDRTextValues	(	$	constraints = `array()`,
		$	limit = `array()`,
		$	order = `array()`,
		$	count = `false`
	)

Retrieves list of children SDRTextValue objects.

This method retrieves objects of type SDRTextValue which have their valueId field equal to the value of this object's id field. The constraints, limit and order parameters can be used to trim down and order the results. See Guide to Database Constraints for more on using database constraints with DBI2/SModel2.

Parameters:

	$constraints	[array]: constraints array to further limit results
	$limit	[array]: limit array to control how many and which results are returned
	$order	[array]: order array to control the ordering of the returned results
	$count	[boolean]: if true, only return the count of how many objects would be returned, rather than the objects themselves

Returns:: [SDRTextValue]: array of child objects, or an integer if $count is true, or null on error

Definition at line 360 of file SDRValue.php5.

SDRValue::listSDRTextValuesMulti	(	$	constraints = `array()`,
		$	limit = `array()`,
		$	order = `array()`,
		$	count = `false`,
		$	depth = `1`
	)

Retrieves list of children SDRTextValue objects using joins.

This method retrieves objects of type SDRTextValue which have their valueId field equal to the value of this object's id field. The constraints, limit and order parameters can be used to trim down and order the results. See Guide to Database Constraints for more on using database constraints with DBI2/SModel2. Unlike listSDRTextValues(), this method joins the child objects with their parent objects.

Parameters:

	$constraints	[array]: constraints array to further limit results
	$limit	[array]: limit array to control how many and which results are returned
	$order	[array]: order array to control the ordering of the returned results
	$count	[boolean]: if true, only return the count of how many objects would be returned, rather than the objects themselves
	$depth	[int]: how deep to traverse dependencies when doing joins

Returns:: [SDRTextValue]: array of child objects, or an integer if $count is true, or null on error

Definition at line 384 of file SDRValue.php5.

SDRValue::listSDRVersionFieldValues	(	$	constraints = `array()`,
		$	limit = `array()`,
		$	order = `array()`,
		$	count = `false`
	)

Retrieves list of children SDRVersionFieldValue objects.

This method retrieves objects of type SDRVersionFieldValue which have their valueId field equal to the value of this object's id field. The constraints, limit and order parameters can be used to trim down and order the results. See Guide to Database Constraints for more on using database constraints with DBI2/SModel2.

Parameters:

	$constraints	[array]: constraints array to further limit results
	$limit	[array]: limit array to control how many and which results are returned
	$order	[array]: order array to control the ordering of the returned results
	$count	[boolean]: if true, only return the count of how many objects would be returned, rather than the objects themselves

Returns:: [SDRVersionFieldValue]: array of child objects, or an integer if $count is true, or null on error

Definition at line 133 of file SDRValue.php5.

SDRValue::listSDRVersionFieldValuesMulti	(	$	constraints = `array()`,
		$	limit = `array()`,
		$	order = `array()`,
		$	count = `false`,
		$	depth = `1`
	)

Retrieves list of children SDRVersionFieldValue objects using joins.

This method retrieves objects of type SDRVersionFieldValue which have their valueId field equal to the value of this object's id field. The constraints, limit and order parameters can be used to trim down and order the results. See Guide to Database Constraints for more on using database constraints with DBI2/SModel2. Unlike listSDRVersionFieldValues(), this method joins the child objects with their parent objects.

Parameters:

	$constraints	[array]: constraints array to further limit results
	$limit	[array]: limit array to control how many and which results are returned
	$order	[array]: order array to control the ordering of the returned results
	$count	[boolean]: if true, only return the count of how many objects would be returned, rather than the objects themselves
	$depth	[int]: how deep to traverse dependencies when doing joins

Returns:: [SDRVersionFieldValue]: array of child objects, or an integer if $count is true, or null on error

Definition at line 157 of file SDRValue.php5.

static SDRValue::retrieve	(	$	constraints = `array()`,
		$	checkOnly = `false`
	)			`[static]`

Retrieves a single object of this type, given the constraints.

Use this method instead of the constructor since the constructor cannot return error conditions properly.

Parameters:

	$constraints	[array]: constraints to use when retrieving object
	$checkOnly	[boolean]: if true, just return whether the row exists in the DB

Returns:: [SDRValue]: retrieved object, or null on error or object does not exist (or true/false if $checkOnly is true, to indicate whether the row exists in the DB)

Definition at line 55 of file SDRValue.php5.

Referenced by SDRVersionFieldValue::getParentValue(), SDRTextValue::getParentValue(), SDRIntValue::getParentValue(), SDRFieldValue::getParentValue(), and SDRDateValue::getParentValue().

SDRValue::valueTableForType ( $ type ) [private]

Get the name of a value table (for storing the data of a value) based on value type.

Parameters:

$type

[string]: The name of the value's type (TYPE_INT, TYPE_TEXT, TYPE_DATE)

Returns:: [string]: The name of the table for the given value type

Definition at line 496 of file SDRValue.php5.

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

sdr/update/model/SDRValue.php5


Public Member Functions
	__construct ($constraints=null)
	Constructs new SDRValue object.
	addSDRDateValue ($entry= '')
	Add new SDRDateValue object connected to this object.
	addSDRFieldValue ($field)
	Add new SDRFieldValue object connected to this object.
	addSDRIntValue ($entry)
	Add new SDRIntValue object connected to this object.
	addSDRTextValue ($entry)
	Add new SDRTextValue object connected to this object.
	addSDRVersionFieldValue ($version, $field)
	Add new SDRVersionFieldValue object connected to this object.
	listSDRDateValues ($constraints=array(), $limit=array(), $order=array(), $count=false)
	Retrieves list of children SDRDateValue objects.
	listSDRDateValuesMulti ($constraints=array(), $limit=array(), $order=array(), $count=false, $depth=1)
	Retrieves list of children SDRDateValue objects using joins.
	listSDRFieldValues ($constraints=array(), $limit=array(), $order=array(), $count=false)
	Retrieves list of children SDRFieldValue objects.
	listSDRFieldValuesMulti ($constraints=array(), $limit=array(), $order=array(), $count=false, $depth=1)
	Retrieves list of children SDRFieldValue objects using joins.
	listSDRIntValues ($constraints=array(), $limit=array(), $order=array(), $count=false)
	Retrieves list of children SDRIntValue objects.
	listSDRIntValuesMulti ($constraints=array(), $limit=array(), $order=array(), $count=false, $depth=1)
	Retrieves list of children SDRIntValue objects using joins.
	listSDRTextValues ($constraints=array(), $limit=array(), $order=array(), $count=false)
	Retrieves list of children SDRTextValue objects.
	listSDRTextValuesMulti ($constraints=array(), $limit=array(), $order=array(), $count=false, $depth=1)
	Retrieves list of children SDRTextValue objects using joins.
	listSDRVersionFieldValues ($constraints=array(), $limit=array(), $order=array(), $count=false)
	Retrieves list of children SDRVersionFieldValue objects.
	listSDRVersionFieldValuesMulti ($constraints=array(), $limit=array(), $order=array(), $count=false, $depth=1)
	Retrieves list of children SDRVersionFieldValue objects using joins.
Static Public Member Functions
static	exists ($constraints=array())
	Checks to see if object exists according to constraints.
static	findOrAddValue ($entry, $field)
	Find a value if it exists, or add it if it does not exist.
static	getAttributesStatic ()
	Retrieves attributes and information about them.
static	getList ($constraints=array(), $limit=array(), $order=array(), $count=false)
	Retrieves list of SDRValue objects.
static	getTableNameStatic ()
	Retrieves name of table represented by this class.
static	retrieve ($constraints=array(), $checkOnly=false)
	Retrieves a single object of this type, given the constraints.
Static Public Attributes
static	$ATTRIBUTES
	Attributes for this entity and information about them.
Private Member Functions
	valueTableForType ($type)
	Get the name of a value table (for storing the data of a value) based on value type.

SDRValue Class Reference [SDR Model Objects]

Public Member Functions

Static Public Member Functions

Static Public Attributes

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

SDRValue Class Reference
[SDR Model Objects]