SimpleDB::Class::Domain - A schematic representation of a SimpleDB domain.
version 1.0503
A subclass of this class is created for each domain in SimpleDB with it's name, attributes, and relationships.
The following methods are available from this class.
Constructor. Normally you should never call this method yourself, instead use the domain() method in SimpleDB::Class.
A hash containing the parameters needed to construct this object.
Required. A reference to a SimpleDB::Class object.
Required. The SimpleDB domain name associated with this class.
Returns the SimpleDB::Class::Item subclass name passed into the constructor.
Returns the name determined automatically by the item_class passed into the constructor.
Returns the SimpleDB::Class object set in the constructor.
Creates this domain in the SimpleDB.
Deletes this domain from the SimpleDB.
Retrieves an item from the SimpleDB by ID and then returns a SimpleDB::Class::Item object.
The unique identifier (called ItemName in AWS documentation) of the item to retrieve.
A hash which allows options to modify the retrieval.
A boolean that if set true will get around Eventual Consistency, but at a reduced performance. Note that since SimpleDB::Class fetches requests by id (like this one) directly from memcached, this option should never be needed. It is provided only for completeness.
A hash reference of attribute names paired with values that should be set as soon as the item is instantiated. This is useful for prefilling cache attributes, and is used by the belongs_to method for that purpose. Doing so prevents stale object references.
belongs_to
Adds a new item to this domain.
A hash reference of name value pairs to insert as attributes into this item.
A hash of extra options to modify the put.
Optionally specify a unqiue id for this item.
A hash reference of attribute names paired with values that should be set as soon as the item is instantiated. This is useful for prefilling cache attributes to prevent stale object references.
Returns an integer indicating how many items are in this domain.
WARNING: With this method you need to be aware that SimpleDB is eventually consistent. See "Eventual Consistency" in SimpleDB::Class for details.
A hash containing options to modify the count.
A where clause as defined in SimpleDB::Class::SQL if you want to count only a certain number of items in the domain.
A boolean that if set true will get around Eventual Consistency, but at a reduced performance.
Returns an array reference of ids (itemName()s) in the domain.
A hash containing options to modify the array reference.
A where clause as defined in SimpleDB::Class::SQL if you want to fetch only a certain number of items in the domain.
Defaults to 0. A boolean that if set true will get around Eventual Consistency, but at a reduced performance.
Returns the maximum value of an attribute.
The name of the attribute to find the maximum value of.
A hash of options to modify the search.
A where clause as defined by SimpleDB::Class::SQL. An optional clause to limit the range of the maximum value.
Returns the minimum value of an attribute.
The name of the attribute to find the minimum value of.
A hash of extra options to modify the search.
A where clause as defined by SimpleDB::Class::SQL. An optional clause to limit the range of the minimum value.
Returns a SimpleDB::Class::ResultSet object.
A hash of options to set up the search.
A where clause as defined by SimpleDB::Class::SQL.
An order by clause as defined by SimpleDB::Class::SQL.
A limit clause as defined by SimpleDB::Class::SQL.
A hash reference of attribute names paired with values that should be set as soon as the item is instantiated. This is useful for prefilling cache attributes as items come off the result set, and is used by the has_many method for that purpose. Doing so prevents stale object references.
has_many
SimpleDB::Class is Copyright 2009-2010 Plain Black Corporation (http://www.plainblack.com/) and is licensed under the same terms as Perl itself.
To install SimpleDB::Class, copy and paste the appropriate command in to your terminal.
cpanm
cpanm SimpleDB::Class
CPAN shell
perl -MCPAN -e shell install SimpleDB::Class
For more information on module installation, please visit the detailed CPAN module installation guide.