Class: CouchRest::Document

Inherits:
Response show all
Includes:
Mixins::Attachments
Defined in:
lib/couchrest/core/document.rb

Direct Known Subclasses

Design, ExtendedDocument

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Mixins::Attachments

#delete_attachment, #fetch_attachment, #put_attachment

Methods inherited from Response

#[], #[]=, #initialize

Constructor Details

This class inherits a constructor from CouchRest::Response

Instance Attribute Details

#database ⇒ Object

Returns the document’s database



90
91
92
 
# File 'lib/couchrest/core/document.rb', line 90

def database
  @database
end

Class Method Details

.use_database(db) ⇒ Object

override the CouchRest::Model-wide default_database This is not a thread safe operation, do not change the model database at runtime.



17
18
19
 
# File 'lib/couchrest/core/document.rb', line 17

def self.use_database(db)
  self.database = db
end

Instance Method Details

#copy(dest) ⇒ Object

copies the document to a new id. If the destination id currently exists, a rev must be provided. dest can take one of two forms if overwriting: “id_to_overwrite?rev=revision” or the actual doc hash with a ‘_rev’ key

Raises:

  • (ArgumentError) 


62
63
64
65
66
 
# File 'lib/couchrest/core/document.rb', line 62

def copy(dest)
  raise ArgumentError, "doc.database required to copy" unless database
  result = database.copy_doc(self, dest)
  result['ok']
end

#destroy(bulk = false) ⇒ Object

Deletes the document from the database. Runs the :delete callbacks. Removes the _id and _rev fields, preparing the document to be saved to a new _id. If bulk is true (defaults to false) the document won’t actually be deleted from the db until bulk save.

Raises:

  • (ArgumentError) 


49
50
51
52
53
54
55
56
57
 
# File 'lib/couchrest/core/document.rb', line 49

def destroy(bulk = false)
  raise ArgumentError, "doc.database required to destroy" unless database
  result = database.delete_doc(self, bulk)
  if result['ok']
    self['_rev'] = nil
    self['_id'] = nil
  end
  result['ok']
end

#id ⇒ Object 



21
22
23
 
# File 'lib/couchrest/core/document.rb', line 21

def id
  self['_id']
end

#move(dest) ⇒ Object

moves the document to a new id. If the destination id currently exists, a rev must be provided. dest can take one of two forms if overwriting: “id_to_overwrite?rev=revision” or the actual doc hash with a ‘_rev’ key

Raises:

  • (ArgumentError) 


71
72
73
74
75
 
# File 'lib/couchrest/core/document.rb', line 71

def move(dest)
  raise ArgumentError, "doc.database required to copy" unless database
  result = database.move_doc(self, dest)
  result['ok']
end

#new_document? ⇒ Boolean

returns true if the document has never been saved

Returns:

  • (Boolean) 


30
31
32
 
# File 'lib/couchrest/core/document.rb', line 30

def new_document?
  !rev
end

#rev ⇒ Object 



25
26
27
 
# File 'lib/couchrest/core/document.rb', line 25

def rev
  self['_rev']
end

#save(bulk = false) ⇒ Object

Saves the document to the db using create or update. Also runs the :save callbacks. Sets the _id and _rev fields based on CouchDB’s response. If bulk is true (defaults to false) the document is cached for bulk save.

Raises:

  • (ArgumentError) 


38
39
40
41
42
 
# File 'lib/couchrest/core/document.rb', line 38

def save(bulk = false)
  raise ArgumentError, "doc.database required for saving" unless database
  result = database.save_doc self, bulk
  result['ok']
end

#uri(append_rev = false) ⇒ Object

Returns the CouchDB uri for the document



78
79
80
81
82
83
84
85
86
87
 
# File 'lib/couchrest/core/document.rb', line 78

def uri(append_rev = false)
  return nil if new_document?
  couch_uri = "http://#{database.uri}/#{CGI.escape(id)}"
  if append_rev == true
    couch_uri << "?rev=#{rev}"
  elsif append_rev.kind_of?(Integer)
    couch_uri << "?rev=#{append_rev}"
  end
  couch_uri
end