Class: CouchRest::Validation::GenericValidator

Inherits:
Object
  • Object
show all
Defined in:
lib/couchrest/validation/validators/generic_validator.rb

Overview

All validators extend this base class. Validators must:

  • Implement the initialize method to capture its parameters, also calling super to have this parent class capture the optional, general :if and :unless parameters.

  • Implement the call method, returning true or false. The call method provides the validation logic.

Author:

  • Guy van den Berg

Instance Attribute Summary (collapse)

Instance Method Summary (collapse)

Constructor Details

- (GenericValidator) initialize(field, opts = {})

Construct a validator. Capture the :if and :unless clauses when present.

All additional key/value pairs are passed through to the validator that is sub-classing this GenericValidator



54
55
56
57
# File 'lib/couchrest/validation/validators/generic_validator.rb', line 54

def initialize(field, opts = {})
  @if_clause     = opts.delete(:if)
  @unless_clause = opts.delete(:unless)
end

Instance Attribute Details

- (Object) field_name (readonly)

Returns the value of attribute field_name



41
42
43
# File 'lib/couchrest/validation/validators/generic_validator.rb', line 41

def field_name
  @field_name
end

- (Object) if_clause

Returns the value of attribute if_clause



40
41
42
# File 'lib/couchrest/validation/validators/generic_validator.rb', line 40

def if_clause
  @if_clause
end

- (Object) unless_clause

Returns the value of attribute unless_clause



40
41
42
# File 'lib/couchrest/validation/validators/generic_validator.rb', line 40

def unless_clause
  @unless_clause
end

Instance Method Details

- (Object) ==(other)



109
110
111
112
113
114
115
116
# File 'lib/couchrest/validation/validators/generic_validator.rb', line 109

def ==(other)
  self.class == other.class &&
  self.field_name == other.field_name &&
  self.class == other.class &&
  self.if_clause == other.if_clause &&
  self.unless_clause == other.unless_clause &&
  self.instance_variable_get(:@options) == other.instance_variable_get(:@options)
end

- (Object) add_error(target, message, field_name = :general)

Add an error message to a target resource. If the error corresponds to a specific field of the resource, add it to that field, otherwise add it as a :general message.

TODO - should the field_name for a general message be :default???



69
70
71
# File 'lib/couchrest/validation/validators/generic_validator.rb', line 69

def add_error(target, message, field_name = :general)
  target.errors.add(field_name, message)
end

- (Boolean) call(target)

Call the validator. "call" is used so the operation is BoundMethod and Block compatible. This must be implemented in all concrete classes.

Raises:

  • (NotImplementedError)


79
80
81
# File 'lib/couchrest/validation/validators/generic_validator.rb', line 79

def call(target)
  raise NotImplementedError, "CouchRest::Validation::GenericValidator::call must be overriden in a subclass"
end

- (Boolean) execute?(target)

Determines if this validator should be run against the target by evaluating the :if and :unless clauses optionally passed while specifying any validator.



89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
# File 'lib/couchrest/validation/validators/generic_validator.rb', line 89

def execute?(target)
  if unless_clause = self.unless_clause
    if unless_clause.is_a?(Symbol)
      return false if target.send(unless_clause)
    elsif unless_clause.respond_to?(:call)
      return false if unless_clause.call(target)
    end
  end

  if if_clause = self.if_clause
    if if_clause.is_a?(Symbol)
      return target.send(if_clause)
    elsif if_clause.respond_to?(:call)
      return if_clause.call(target)
    end
  end

  true
end