Class: RightAws::ActiveSdb

Inherits:
Object show all
Extended by:
ActiveSdbConnect
Defined in:
lib/sdb/active_sdb.rb

Overview

RightAws::ActiveSdb -- RightScale SDB interface (alpha release)

The RightAws::ActiveSdb class provides a complete interface to Amazon's Simple Database Service.

ActiveSdb is in alpha and does not load by default with the rest of RightAws. You must use an additional require statement to load the ActiveSdb class. For example:

require 'right_aws'
require 'sdb/active_sdb'

Additionally, the ActiveSdb class requires the 'uuidtools' gem; this gem is not normally required by RightAws and is not installed as a dependency of RightAws.

Simple ActiveSdb usage example:

class Client < RightAws::ActiveSdb::Base end

connect to SDB

RightAws::ActiveSdb.establish_connection

create domain

Client.create_domain

create initial DB

Client.create 'name' => 'Bush', 'country' => 'USA', 'gender' => 'male', 'expiration' => '2009', 'post' => 'president' Client.create 'name' => 'Putin', 'country' => 'Russia', 'gender' => 'male', 'expiration' => '2008', 'post' => 'president' Client.create 'name' => 'Medvedev', 'country' => 'Russia', 'gender' => 'male', 'expiration' => '2012', 'post' => 'president' Client.create 'name' => 'Mary', 'country' => 'USA', 'gender' => 'female', 'hobby' => ['patchwork', 'bundle jumping'] Client.create 'name' => 'Mary', 'country' => 'Russia', 'gender' => 'female', 'hobby' => ['flowers', 'cats', 'cooking'] sandy_id = Client.create('name' => 'Sandy', 'country' => 'Russia', 'gender' => 'female', 'hobby' => ['flowers', 'cats', 'cooking']).id

find all Bushes in USA

Client.find(:all, :conditions => ["['name'=?] intersection ['country'=?]",'Bush','USA']).each do |client| client.reload puts client.attributes.inspect end

find all Maries through the world

Client.find_all_by_name_and_gender('Mary','female').each do |mary| mary.reload puts "#mary[:name], gender: #mary[:gender], hobbies: #mary[:hobby]mary[:hobby].join(',')" end

find new russian president

medvedev = Client.find_by_post_and_country_and_expiration('president','Russia','2012') if medvedev medvedev.reload medvedev.save_attributes('age' => '42', 'hobby' => 'Gazprom') end

retire old president

Client.find_by_name('Putin').delete

Sandy disappointed in 'cooking' and decided to hide her 'gender' and 'country' ()

sandy = Client.find(sandy_id) sandy.reload sandy.delete_values('hobby' => ['cooking'] ) sandy.delete_attributes('country', 'gender')

remove domain

Client.delete_domain

Defined Under Namespace

Modules: ActiveSdbConnect Classes: ActiveSdbError, Base

Class Method Summary collapse

Methods included from ActiveSdbConnect

connection, establish_connection

Class Method Details

.create_domain(domain_name) ⇒ Object

Create new domain. Raises no errors if the domain already exists.

RightAws::ActiveSdb.create_domain('alpha') #=> :box_usage=>"0.0055590278"



136
137
138
# File 'lib/sdb/active_sdb.rb', line 136

def create_domain(domain_name)
  connection.create_domain(domain_name)
end

.delete_domain(domain_name) ⇒ Object

Remove domain from SDB. Raises no errors if the domain does not exist.

RightAws::ActiveSdb.create_domain('alpha') #=> :box_usage=>"0.0055590001"



145
146
147
# File 'lib/sdb/active_sdb.rb', line 145

def delete_domain(domain_name)
  connection.delete_domain(domain_name)
end

.domainsObject

Retreive a list of domains.

put RightAws::ActiveSdb.domains #=> ['co-workers','family','friends','clients']



127
128
129
# File 'lib/sdb/active_sdb.rb', line 127

def domains
  connection.list_domains[:domains]
end