Module: Mongoid::Paranoia

Extended by:
ActiveSupport::Concern
Defined in:
lib/mongoid/paranoia.rb

Overview

Include this module to get soft deletion of root level documents. This will add a deleted_at field to the Document, managed automatically. Potentially incompatible with unique indices. (if collisions with deleted items)

Examples:

Make a document paranoid.

class Person
  include Mongoid::Document
  include Mongoid::Paranoia
end

Defined Under Namespace

Modules: ClassMethods

Instance Method Summary collapse

Instance Method Details

#delete! ⇒ true, false

Delete the paranoid Document from the database completely.

Examples:

Hard delete the document.

document.delete!

Returns:

  • (true, false) —

    If the operation succeeded.

Since:

  • 1.0.0



42
43
44
 
# File 'lib/mongoid/paranoia.rb', line 42

def delete!
  Persistence::Operations.remove(self).persist
end

#destroy! ⇒ true, false

Delete the paranoid Document from the database completely. This will run the destroy callbacks.

Examples:

Hard destroy the document.

document.destroy!

Returns:

  • (true, false) —

    If the operation succeeded.

Since:

  • 1.0.0



30
31
32
 
# File 'lib/mongoid/paranoia.rb', line 30

def destroy!
  run_callbacks(:destroy) { delete! }
end

#destroyed? ⇒ true, false

Determines if this document is destroyed.

Examples:

Is the document destroyed?

person.destroyed?

Returns:

  • (true, false) —

    If the document is destroyed.

Since:

  • 1.0.0



80
81
82
 
# File 'lib/mongoid/paranoia.rb', line 80

def destroyed?
  @destroyed || !!deleted_at
end

#remove(options = {}) ⇒ true Also known as: delete

Delete the Document, will set the deleted_at timestamp and not actually delete it.

Examples:

Soft remove the document.

document.remove

Parameters:

  • options (Hash) (defaults to: {}) —

    The database options.

Returns:

  • (true) —

    True.

Since:

  • 1.0.0



57
58
59
60
61
62
63
64
65
66
67
68
69
 
# File 'lib/mongoid/paranoia.rb', line 57

def remove(options = {})
  time = self.deleted_at = Time.now
  paranoid_collection.update(
    atomic_selector,
    { "$set" => { paranoid_field => time }},
    Safety.merge_safety_options(options)
  )
  cascade!
  @destroyed = true
  IdentityMap.remove(self)
  Threaded.clear_options!
  true
end

#restore ⇒ Time

Restores a previously soft-deleted document. Handles this by removing the deleted_at flag.

Examples:

Restore the document from deleted state.

document.restore

Returns:

  • (Time) —

    The time the document had been deleted.

Since:

  • 1.0.0



93
94
95
96
97
98
99
 
# File 'lib/mongoid/paranoia.rb', line 93

def restore
  paranoid_collection.update(
    atomic_selector,
    { "$unset" => { paranoid_field => true }}
  )
  attributes.delete("deleted_at")
end