Relato Sobre a Migração de uma Aplicação Legada para Rails

Reescrevendo em Rails
uma grande aplicação
legada
Um relato sobre as diﬁculdades encontradas

Cássio Marques

cassiomarques.wordpress.com

@cassiomarques

cassiommc@gmail.com

http://www.ﬂickr.com/photos/venteco

http://www.ﬂickr.com/photos/epleitez/

Migração de uma
grande aplicação
desktop para Rails

Aplicação para
Controle de Serviços
de Hemoterapia

• Desktop
• C++ (Qt 3)
• PostgreSQL
• +150k loc em C++
• +60k loc em PL/PGSQL

Porque migrar?
• Complexidade da linguagem
• Dificuldade de integração com outras
aplicações.
• Dificuldade para acessar remotamente
• Dificuldade para manutenção: nada de
testes, +5 min para compilar, SPs, etc...

Rails? Ruby? WTF?

• Quem programa com isso?
• Não haverá quem dê manutenção
• Não há uma empresa “por trás” do Ruby

O que eles não sabiam...

• Já existiam 4 outras aplicações menores em
produção escritas em Ruby
• A diﬁculdade de encontrar um proﬁssional
bom em Java/C#/Whatever é a mesma de
encontrar um bom em Ruby
• Produtividade!
• Comunidade open-source

O maior vilão de toda
essa história...

Ótimo se você seguir
as convenções...

... mas ainda
interessante mesmo
que você não as siga.

1 class Product < ActiveRecord::Base
2 set_table_name 'produto'
3 set_primary_key 'codigo'
4 end

Bancos legados podem
usar nomes de colunas
estranhos...

estoquequantidade
fornecedorcnpj
requisicaoﬁcha
cobrancacodigo

PRD_CDG
STT_USR
codigoproduto
codigoproduto_novo
codigoproduto_novo2

1 class Product < ActiveRecord::Base
2 alias_attribute 'description', 'produtodescricao'
3 end

Não funciona para
queries...

2 alias_attribute 'expiration_date', 'validade'
3 named_scope :expired,
4 :conditions => ['expiration_date <= ?', Time.now]
5 # PGError: ERROR: column "expiration_date" does not exist
6
7
8 class Hemocomponent < ActiveRecord::Base
9 alias_attribute 'acronym', 'sigla'
10 end
11 Hemocomponent.find_by_acronym 'CHE'
12 # undefined method `find_by_acronym' for #<Class:0x1033f2380>

1 has_many :donations,
2          :class_name => 'Donation',
3          :foreign_key => 'doador_codigo'
4
5 belongs_to :donor,
6            :class_name => 'Donor',
7            :foreign_key => 'doador_codigo'

+200 tabelas c/ média
de 15 campos cada

Criar um novo banco e
migrar os dados depois

Alterar o nome das
tabelas e colunas

RAILS_ENV=production rake db:schema:dump

rake db:schema:load

Duas bases para
desenvolvimento

1) development “normal”

2) dump da base de produção (com dados)

1 class RenameDonationTableAndColumns < ActiveRecord::Migration
2   def self.up
3     rename_table :doacao, :donations
4     change_table :donations do |t|
5       t.rename :codigo, :id
6       t.rename :doador, :donor_id
7       t.rename :data, :date
8       t.rename :tipo_sanguineo, :blood_type
9       # ...
10     end
11   end
12
13   def self.down
14     raise IrreversibleMigration
15   end
16 end

Redeﬁnir tipos dos
campos

1 class ChangeDonorsColumns < ActiveRecord::Migration
2   def self.up
3     change_table :donors do |t|
4       t.change :document_type, :string, :size => 15
5       t.change :document_number, :string, :size => 15
6     end
7   end
8
9   def self.down
10     raise ActiveRecord::IrreversibleMigration
11   end
12 end

Crie seus próprios
métodos para migrations

1 module ActiveRecord
2   module ConnectionAdapters
3     class PostgreSQLAdapter < AbstractAdapter
4       def change_sn_to_boolean(table_name, column_name)
5         execute %Q{
6           ALTER TABLE #{quote_table_name(table_name)}
7           ALTER COLUMN #{quote_column_name(column_name)}
8           type boolean
9           using (case when #{quote_column_name(column_name)} = 'S'
10           then true else false end)
11         }
12       end
13     end
14   end
15 end

58 change_sn_to_boolean :donors, :send_sms

foreign_key_migrations
composite_primary_keys

Alterar dados com
migrations

1 class PopulateAddressPrefixes < ActiveRecord::Migration
2   def self.up
3     Address.all.each do |address|
4       if address.prefix.blank?
5         address.update_attributes(
6           :prefix => AddressPrefix.find_by_code('R')
7         )
8       end
9     end
10   end
11 end

1 class PopulateAddressPrefixes < ActiveRecord::Migration
2   def self.up
3     prefix = AddressPrefix.find_by_code 'R'
4     execute <<-SQL
5       update addresses set prefix_id = E'#{prefix.id}'
6       where prefix_id is null
7     SQL
8   end
9 end

1 donor.education_level.description # => join no banco!

ok, vamos tirar as
enumerações do
banco...

problema com FK’s (tabelas
com enumerações ainda
referenciadas)

1 donor.education_level = 5 # WTF?

enumerate_it
github.com/cassiomarques/enumerate_it

(jabá mode on)

1 class EducationLevel < EnumerateIt::Base
2   associate_values(
3     :none                 => ['1', 'Não Cursou']   ,
4     :incomplete_1st_grade => ['2', '1º Grau Incompleto'],
5     :complete_1st_grade   => ['3', '1º Grau Completo'],
6     :incomplete_2nd_grade => ['4', '2º Incompleto'],
7     :complete_2nd_grade   => ['5', '2º Completo'],
8     :incomplete_3rd_grade => ['6', '3º Grau Incompleto'],
9     :complete_3rd_grade   => ['7', '3º Grau Completo']
10   )
11 end

1 class Donor < ActiveRecord::Base
2 has_enumeration_for :education_level, :with => EducationLevel
3 end

1 donor.education_level = EducationLevel::COMPLETE_3RD_GRADE
2 donor.education_level_humanize # 3º Grau Completo (sem join)

1 <% form_for @donor do |f| %>
2 <%= f.select :education_level, EducationLevel.to_a %>
3 <% end -%>

schema.rb => banco de
testes

... mas se a sua PK for
varchar...

1 create_table "donors", :id => false, :force => true do |t|
3 t.string "id", :limit => 6, :null => false
4 # ...
5 end

1 class CreateAndAssignDonorsIdSequence < ActiveRecord::Migration
2   def self.up
3     suppress_messages do
4       execute 'create sequence donor_id_seq' rescue nil
5       execute "alter table donors alter column id set default nextval('donors_id_seq')"
6     end
7   end
8 end

1 # spec/spec_helper.rb e/ou features/support/schema_fixes.rb
2 require 'migrations/schema_fixes'
3
4 [FirstMigration, SecondMigration].each { |m| m.migrate :up }

Stored Procedures,
functions, etc...

• Diﬁceis de testar
• Side effects
• Código procedural
• Lógica separada da app

Relato Sobre a Migração de uma Aplicação Legada para Rails

Mais conteúdo relacionado

Semelhante a Relato Sobre a Migração de uma Aplicação Legada para Rails (20)

Último (8)

Relato Sobre a Migração de uma Aplicação Legada para Rails