Class: Globalize::ActiveRecord::Migration::Migrator

Inherits:
Object
  • Object
show all
Includes:
Exceptions
Defined in:
lib/globalize/active_record/migration.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(model) ⇒ Migrator

Returns a new instance of Migrator.



21
22
23
 
# File 'lib/globalize/active_record/migration.rb', line 21

def initialize(model)
  @model = model
end

Instance Attribute Details

#model ⇒ Object (readonly)

Returns the value of attribute model.



17
18
19
 
# File 'lib/globalize/active_record/migration.rb', line 17

def model
  @model
end

Instance Method Details

#add_translation_fields ⇒ Object 



79
80
81
82
83
84
85
86
87
88
89
 
# File 'lib/globalize/active_record/migration.rb', line 79

def add_translation_fields
  connection.change_table(translations_table_name) do |t|
    fields.each do |name, options|
      if options.is_a? Hash
        t.column name, options.delete(:type), options
      else
        t.column name, options
      end
    end
  end
end

#add_translation_fields!(fields, options = {}) ⇒ Object 



41
42
43
44
45
46
47
48
49
50
 
# File 'lib/globalize/active_record/migration.rb', line 41

def add_translation_fields!(fields, options = {})
  @fields = fields
  validate_translated_fields

  add_translation_fields
  clear_schema_cache!
  move_data_to_translation_table if options[:migrate_data]
  remove_source_columns if options[:remove_source_columns]
  clear_schema_cache!
end

#clear_schema_cache! ⇒ Object 



173
174
175
176
177
 
# File 'lib/globalize/active_record/migration.rb', line 173

def clear_schema_cache!
  connection.schema_cache.clear! if connection.respond_to? :schema_cache
  model::Translation.reset_column_information
  model.reset_column_information
end

#column_type(name) ⇒ Object 



149
150
151
 
# File 'lib/globalize/active_record/migration.rb', line 149

def column_type(name)
  columns.detect { |c| c.name == name.to_s }.try(:type)
end

#complete_translated_fields ⇒ Object

This adds all the current translated attributes of the model It’s a problem because in early migrations would add all the translated attributes



65
66
67
68
69
 
# File 'lib/globalize/active_record/migration.rb', line 65

def complete_translated_fields
  translated_attribute_names.each do |name|
    @fields[name] ||= column_type(name)
  end
end

#create_translation_table ⇒ Object 



71
72
73
74
75
76
77
 
# File 'lib/globalize/active_record/migration.rb', line 71

def create_translation_table
  connection.create_table(translations_table_name) do |t|
    t.references table_name.sub(/^#{table_name_prefix}/, '').singularize, :null => false, :index => false, :type => column_type(model.primary_key).to_sym
    t.string :locale, :null => false
    t.timestamps :null => false
  end
end

#create_translation_table!(fields = {}, options = {}) ⇒ Object 



29
30
31
32
33
34
35
36
37
38
39
 
# File 'lib/globalize/active_record/migration.rb', line 29

def create_translation_table!(fields = {}, options = {})
  @fields = fields
  # If we have fields we only want to create the translation table with those fields
  complete_translated_fields if fields.blank?
  validate_translated_fields

  create_translation_table
  add_translation_fields!(fields, options)
  create_translations_index
  clear_schema_cache!
end

#create_translations_index ⇒ Object 



91
92
93
94
95
96
97
98
99
100
101
102
103
 
# File 'lib/globalize/active_record/migration.rb', line 91

def create_translations_index
  connection.add_index(
    translations_table_name,
    "#{table_name.sub(/^#{table_name_prefix}/, "").singularize}_id",
    :name => translation_index_name
  )
  # index for select('DISTINCT locale') call in translation.rb
  connection.add_index(
    translations_table_name,
    :locale,
    :name => translation_locale_index_name
  )
end

#drop_translation_table ⇒ Object 



105
106
107
 
# File 'lib/globalize/active_record/migration.rb', line 105

def drop_translation_table
  connection.drop_table(translations_table_name)
end

#drop_translation_table!(options = {}) ⇒ Object 



56
57
58
59
60
61
 
# File 'lib/globalize/active_record/migration.rb', line 56

def drop_translation_table!(options = {})
  move_data_to_model_table if options[:migrate_data]
  drop_translations_index
  drop_translation_table
  clear_schema_cache!
end

#drop_translations_index ⇒ Object 



109
110
111
112
113
 
# File 'lib/globalize/active_record/migration.rb', line 109

def drop_translations_index
  if connection.indexes(translations_table_name).map(&:name).include?(translation_index_name)
    connection.remove_index(translations_table_name, :name => translation_index_name)
  end
end

#fields ⇒ Object 



25
26
27
 
# File 'lib/globalize/active_record/migration.rb', line 25

def fields
  @fields ||= complete_translated_fields
end

#move_data_to_model_table ⇒ Object 



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
 
# File 'lib/globalize/active_record/migration.rb', line 125

def move_data_to_model_table
  add_missing_columns

  # Find all of the translated attributes for all records in the model.
  all_translated_attributes = model.all.collect{|m| m.attributes}
  all_translated_attributes.each do |translated_record|
    # Create a hash containing the translated column names and their values.
    translated_attribute_names.inject(fields_to_update={}) do |f, name|
      f.update({name.to_sym => translated_record[name.to_s]})
    end

    # Now, update the actual model's record with the hash.
    model.where(model.primary_key.to_sym => translated_record[model.primary_key]).update_all(fields_to_update)
  end
end

#move_data_to_translation_table ⇒ Object 



115
116
117
118
119
120
121
122
123
 
# File 'lib/globalize/active_record/migration.rb', line 115

def move_data_to_translation_table
  model.find_each do |record|
    translation = record.translation_for(I18n.locale) || record.translations.build(:locale => I18n.locale)
    fields.each do |attribute_name, attribute_type|
      translation[attribute_name] = record.read_attribute(attribute_name, {:translated => false})
    end
    translation.save!
  end
end

#remove_source_columns ⇒ Object 



52
53
54
 
# File 'lib/globalize/active_record/migration.rb', line 52

def remove_source_columns
  connection.remove_columns(table_name, *fields.keys)
end

#translation_index_name ⇒ Object 



161
162
163
164
165
 
# File 'lib/globalize/active_record/migration.rb', line 161

def translation_index_name
  index_name = "index_#{translations_table_name}_on_#{table_name.singularize}_id"
  index_name.size < connection.index_name_length ? index_name :
    "index_#{Digest::SHA1.hexdigest(index_name)}"[0, connection.index_name_length]
end

#translation_locale_index_name ⇒ Object 



167
168
169
170
171
 
# File 'lib/globalize/active_record/migration.rb', line 167

def translation_locale_index_name
  index_name = "index_#{translations_table_name}_on_locale"
  index_name.size < connection.index_name_length ? index_name :
    "index_#{Digest::SHA1.hexdigest(index_name)}"[0, connection.index_name_length]
end

#valid_field_name?(name) ⇒ Boolean

Returns:

  • (Boolean) 


153
154
155
 
# File 'lib/globalize/active_record/migration.rb', line 153

def valid_field_name?(name)
  translated_attribute_names.include?(name)
end

#valid_field_type?(name, type) ⇒ Boolean

Returns:

  • (Boolean) 


157
158
159
 
# File 'lib/globalize/active_record/migration.rb', line 157

def valid_field_type?(name, type)
  !translated_attribute_names.include?(name) || [:string, :text, :citext].include?(type)
end

#validate_translated_fields ⇒ Object 



141
142
143
144
145
146
147
 
# File 'lib/globalize/active_record/migration.rb', line 141

def validate_translated_fields
  fields.each do |name, options|
    raise BadFieldName.new(name) unless valid_field_name?(name)
    type = (options.is_a? Hash) ? options[:type] : options
    raise BadFieldType.new(name, type) unless valid_field_type?(name, type)
  end
end