Class: ActiveRecord::Encryption::EncryptedAttributeType
- Inherits:
-
Type::Text
- Object
- ActiveModel::Type::Value
- ActiveModel::Type::ImmutableString
- ActiveModel::Type::String
- Type::Text
- ActiveRecord::Encryption::EncryptedAttributeType
- 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
-
#cast_type ⇒ Object
readonly
Returns the value of attribute cast_type.
-
#scheme ⇒ Object
readonly
Returns the value of attribute scheme.
Attributes inherited from ActiveModel::Type::Value
Instance Method Summary collapse
- #cast(value) ⇒ Object
- #changed_in_place?(raw_old_value, new_value) ⇒ Boolean
- #deserialize(value) ⇒ Object
-
#initialize(scheme:, cast_type: ActiveModel::Type::String.new, previous_type: false, default: nil) ⇒ EncryptedAttributeType
constructor
Options.
-
#previous_types ⇒ Object
:nodoc:.
- #serialize(value) ⇒ Object
Methods included from ActiveModel::Type::Helpers::Mutable
Methods inherited from Type::Text
Methods inherited from ActiveModel::Type::String
Methods inherited from ActiveModel::Type::ImmutableString
Methods inherited from ActiveModel::Type::Value
#==, #as_json, #assert_valid_value, #binary?, #changed?, #force_equality?, #hash, #immutable_value, #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, default: nil) ⇒ EncryptedAttributeType
Options
-
:scheme
- AScheme
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 29 |
# File 'activerecord/lib/active_record/encryption/encrypted_attribute_type.rb', line 23 def initialize(scheme:, cast_type: ActiveModel::Type::String.new, previous_type: false, default: nil) super() @scheme = scheme @cast_type = cast_type @previous_type = previous_type @default = default end |
Instance Attribute Details
#cast_type ⇒ Object (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 |
#scheme ⇒ Object (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
#cast(value) ⇒ Object
31 32 33 |
# File 'activerecord/lib/active_record/encryption/encrypted_attribute_type.rb', line 31 def cast(value) cast_type.cast(value) end |
#changed_in_place?(raw_old_value, new_value) ⇒ Boolean
47 48 49 50 |
# File 'activerecord/lib/active_record/encryption/encrypted_attribute_type.rb', line 47 def changed_in_place?(raw_old_value, new_value) old_value = raw_old_value.nil? ? nil : deserialize(raw_old_value) old_value != new_value end |
#deserialize(value) ⇒ Object
35 36 37 |
# File 'activerecord/lib/active_record/encryption/encrypted_attribute_type.rb', line 35 def deserialize(value) cast_type.deserialize decrypt(value) end |
#previous_types ⇒ Object
:nodoc:
52 53 54 55 |
# File 'activerecord/lib/active_record/encryption/encrypted_attribute_type.rb', line 52 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
39 40 41 42 43 44 45 |
# File 'activerecord/lib/active_record/encryption/encrypted_attribute_type.rb', line 39 def serialize(value) if serialize_with_oldest? serialize_with_oldest(value) else serialize_with_current(value) end end |