Class: ActiveRecord::Encryption::EncryptedAttributeType

Inherits:
Type::Text show all
Includes:
ActiveModel::Type::Helpers::Mutable
Defined in:
activerecord/lib/active_record/encryption/encrypted_attribute_type.rb

Overview

An ActiveModel::Type::Value that encrypts/decrypts strings of text.

This is the central piece that connects the encryption system with encrypts declarations in the model classes. Whenever you declare an attribute as encrypted, it configures an EncryptedAttributeType for that attribute.

Instance Attribute Summary collapse

Attributes inherited from ActiveModel::Type::Value

#limit, #precision, #scale

Instance Method Summary collapse

Methods included from ActiveModel::Type::Helpers::Mutable

#cast

Methods inherited from Type::Text

#type

Methods inherited from ActiveModel::Type::String

#to_immutable_string

Methods inherited from ActiveModel::Type::ImmutableString

#type

Methods inherited from ActiveModel::Type::Value

#==, #assert_valid_value, #binary?, #cast, #changed?, #force_equality?, #hash, #map, #serializable?, #type, #type_cast_for_schema, #value_constructed_by_mass_assignment?

Constructor Details

#initialize(scheme:, cast_type: ActiveModel::Type::String.new, previous_type: false) ⇒ EncryptedAttributeType

Options

  • :scheme - A Scheme with the encryption properties for this attribute.

  • :cast_type - A type that will be used to serialize (before encrypting) and deserialize (after decrypting). ActiveModel::Type::String by default.


23
24
25
26
27
28
# File 'activerecord/lib/active_record/encryption/encrypted_attribute_type.rb', line 23

def initialize(scheme:, cast_type: ActiveModel::Type::String.new, previous_type: false)
  super()
  @scheme = scheme
  @cast_type = cast_type
  @previous_type = previous_type
end

Instance Attribute Details

#cast_typeObject (readonly)

Returns the value of attribute cast_type.


13
14
15
# File 'activerecord/lib/active_record/encryption/encrypted_attribute_type.rb', line 13

def cast_type
  @cast_type
end

#schemeObject (readonly)

Returns the value of attribute scheme.


13
14
15
# File 'activerecord/lib/active_record/encryption/encrypted_attribute_type.rb', line 13

def scheme
  @scheme
end

Instance Method Details

#changed_in_place?(raw_old_value, new_value) ⇒ Boolean

Returns:

  • (Boolean)

42
43
44
45
# File 'activerecord/lib/active_record/encryption/encrypted_attribute_type.rb', line 42

def changed_in_place?(raw_old_value, new_value)
  old_value = raw_old_value.nil? ? nil : deserialize_previous_value_to_determine_change(raw_old_value)
  old_value != new_value
end

#deserialize(value) ⇒ Object


30
31
32
# File 'activerecord/lib/active_record/encryption/encrypted_attribute_type.rb', line 30

def deserialize(value)
  cast_type.deserialize decrypt(value)
end

#previous_typesObject

:nodoc:


47
48
49
50
# File 'activerecord/lib/active_record/encryption/encrypted_attribute_type.rb', line 47

def previous_types # :nodoc:
  @previous_types ||= {} # Memoizing on support_unencrypted_data so that we can tweak it during tests
  @previous_types[support_unencrypted_data?] ||= build_previous_types_for(previous_schemes_including_clean_text)
end

#serialize(value) ⇒ Object


34
35
36
37
38
39
40
# File 'activerecord/lib/active_record/encryption/encrypted_attribute_type.rb', line 34

def serialize(value)
  if serialize_with_oldest?
    serialize_with_oldest(value)
  else
    serialize_with_current(value)
  end
end