Release do Ruby on Rails versão 4 =============================== * Ruby 1.9.3 ou verões superiores. * Parâmetros Fortes * Fila API * Melhorias com Caches Estas notas de lançamento cobrem as grandes mudanças, mas não incluem cada correção de bugs e cada mudança. Se você quiser ver tudo, confira a lista de commits no repositório principal do Rails no GitHub. -------------------------------------------------------------------------------- Atualização do Rails 4.0 ---------------------- TODO. Este é um guia WIP. Se você está atualizando uma aplicação que já existe, que é uma ótima idéia ter uma boa cobertura de testes antes de ir afundo. Você também deve primeiro atualizar para o Rails 3.2, caso se você ainda não ter, e tenha certeza que sua aplicação ainda corre como o esperado antes de tentar uma atualização para Rails 4.0. Em seguida, leve em conta os seguintes alterações: ### Rails 4.0 requer pelo menos o Ruby 1.9.3 ou superior Rails 4.0 requer o Ruby 1.9.3 ou superior. O suporte para todas as versões anteriores do Ruby foi descartado oficialmente e você deve atualizar o seu mais cedo possível. ### O que atualizar em seus aplicativos: * Atualize seu Gemfile que depende * `rails = 4.0.0` * `sass-rails ~> 3.2.3` * `coffee-rails ~> 3.2.1` * `uglifier >= 1.0.3` TODO. Atualizar as versões anteriores. * Rails 4.0 remove vendor/plugins completamente. Você tem que substituir esses plugins, extraindo-os como gems e adicioná-los em seu Gemfile. Se você optar por não fazer gems, você pode movê-los para, digamos, `lib/my_plugin/*` e adicione um inicializador apropriado em `config/initializers/my_plugin.rb`. TODO. Alterações de configuração em arquivos de ambiente Criando uma aplicação com Rails 4.0 ---------------------- ``` ruby Você deve ter a gem 'rails' instalada $ rails new myapp $ cd myapp ``` ### Fornecendo Gems Rails agora usa um Gemfile na raiz do aplicativo para determinar as gems que você necessita para o seu aplicativo para iniciar. Este Gemfile é processado pela gem [Bundler](https://github.com/carlhuda/bundler), que em seguida, instala todas as suas dependências. Ele pode até mesmo instalar todas as dependências localmente para o seu aplicativo para que ele não dependa das gems do sistema. Mais informações: [página inicial Bundler](http://gembundler.com/) ### Vivendo no Limite Bundler e Gemfile congelam sua aplicação Rails fácil como a torta com o novo comando dedicado de bundle. Se você quiser agrupar direto do repositório Git, você pode passar o flag --edge: ``` ruby $ rails new myapp --edge ``` Se você tem um check-out local do repositório Rails e quer gere um aplicativo usando isso, você pode passar o flag --dev: ``` ruby $ ruby /path/to/rails/railties/bin/rails new myapp --dev ``` Características Principais ---------------------- Documentação ---------------------- Guias são reescritos usando Markdown do GitHub. Railties ---------------------- * Permitir gerar scaffold/model/migration para aceitar um modificador polimórfico para references / belongs_to, por exemplo ``` ruby rails g model Product supplier:references{polymorphic} ``` logo irá gerar o modelo com belongs_to :supplier, associação polymorphic: true e migração adequada. * Definir config.active_record.migration_error para :page_load para o desenvolvimento. * Adiciona um corredor para Rails::Railtie como um hook chamado apenas após o início do corredor. * Adicionar um caminho /rails/info/routes que mostra a mesma informação como rake routes * Melhoria rake routes de saída para redirecionamentos. * Coloca todos os ambientes disponíveis no config.paths["config/environments"]. * Adiciona config.queue_consumer para permitir que o consumo padrão a seja configurável. * Adicionar Rails.queue como uma interface com uma implementação padrão que consome jobs em um segmento separado. * Remover Rack::SSL em favor de ActionDispatch::SSL. * Permitem definir a classe que será usada para executar no console, além do IRB, com Rails.application.config.console=. É melhor para adicioná-la em bloco para o console. ```ruby # it can be added to config/application.rb console do # this block is called only when running console, # so we can safely require pry here require "pry" config.console = Pry end ``` * Adicionar um método hide! para geradores Rails para esconder o namespace padrão gerado será exibido ao executar rails generate. * Scaffold agora usa content_tag_for em index.html.erb . * Rails::Plugin foi removido. Em vez de adicionar plugins para vendor/plugins, use gems ou Bundler com o caminho ou git dependências. ### Deprecações Action Mailer ---------------------- * Permitem definir as opções padrão do Action Mailer via config.action_mailer.default_options=. * Eleva uma exceção ActionView::MissingTemplate quando nenhum modelo implícito poderia ser encontrado. * De forma assíncrona enviar mensagens através do Rails Queue. * Opções de entrega (como configurações de SMTP) agora pode ser definida dinamicamente pelo mailer action. Opções de entrega são definidas através da chave `:delivery_method_options` chave no correio. ``` ruby def welcome_mailer(user,company) delivery_options = { user_name: company.smtp_user, password: company.smtp_password, address: company.smtp_host } mail(to: user.email, subject: "Welcome!", delivery_method_options: delivery_options) end ``` Action Pack ---------------------- ### Action Controller * Adiciona o método ActionController::Flash.add_flash_types para permitir que as pessoas registrarem seus tipos próprio Flash. por exemplo: ``` ruby class ApplicationController add_flash_types :error, :warning end ``` Se você adicionar o código acima, você pode usar <%= error %> em uma erb, e redirect_to /foo, :error => 'message' em um controller. * Removeido a dependência Active Model de Action Pack. * Suporte a caracteres Unicode em rotas. Rota será automaticamente escada, assim em vez de escapar manualmente: ``` ruby get Rack::Utils.escape('こんにちは') => 'home#index' ``` Você apenas tem que escrever a rota unicode: ``` ruby get 'こんにちは' => 'home#index' ``` * Retornar formato adequado em exceções. * Extraído redirecionar lógica de: ActionController::ForceSSL::ClassMethods.force_ssl em ActionController::ForceSSL#force_ssl_redirect. * Parâmetros de URL path com codificação inválida agora levantar ActionController::BadRequest. * Consulta malformada e parâmetro hashes de solicitação agora levantar ActionController::BadRequest. * respond_to e respond_with agora levantar ActionController::UnknownFormat em vez de diretamente retornando cabeçalho 406. A exceção é resgatada e convertida para 406 no middleware de manipulação de exceção. * JSONP agora usa application/javascript, em vez de application/json como o tipo de MIME. * Argumentos de sessão passados para processar chamadas em testes funcionais estão agora incorporadas a sessão existente, enquanto que anteriormente iriam substituir a sessão existente. Essa mudança pode quebrar alguns testes existentes, se eles estão afirmando o conteúdo exato da sessão, mas não deve quebrar os testes existentes que apenas afirmam chaves individuais. * Formas de persistir registros usa sempre PATCH (através do _method hack). * Para os recursos, tanto PATCH e PUT são encaminhadas para a action update. * Não ignore o force_ssl em desenvolvimento. Esta é uma mudança de comportamento - use uma condição :if para recriar o comportamento antigo. ``` ruby class AccountsController < ApplicationController force_ssl :if => :ssl_configured? def ssl_configured? !Rails.env.development? end end ``` #### Deprecações * Obsoleto ActionController::Integration em favor da ActionDispatch::Integration. * Obsoleto ActionController::IntegrationTest em favor de ActionDispatch::IntegrationTest. * Obsoleta ActionController::PerformanceTest em favor de ActionDispatch::PerformanceTest. * Obsoleta ActionController::AbstractRequest em favor de ActionDispatch::Request. * Obsoleta ActionController::Request em favor de ActionDispatch::Request. * Obsoleta ActionController::AbstractResponse em favor de ActionDispatch::Response. * Obsoleta ActionController::Response em favor de ActionDispatch::Response. * Obsoleta ActionController::Routing em favor de ActionDispatch::Routing. ### Action Dispatch * Adicionado roteamento Concern para declarar rotas comuns que podem ser reutilizadas dentro de outros resources e routes. Codigo Antes: ``` ruby resources :messages do resources :comments end resources :posts do resources :comments resources :images, only: :index end ``` Codigo Depois: ``` ruby concern :commentable do resources :comments end concern :image_attachable do resources :images, only: :index end resources :messages, concerns: :commentable resources :posts, concerns: [:commentable, :image_attachable] ``` * Mostrar rotas na página de exceção durante a depuração de um RoutingError em desenvolvimento. * Incluído mounted_helpers (ajudantes para acessar engines montadas) em ActionDispatch::IntegrationTest por padrão. * Adicionado middleware ActionDispatch::SSL que quando incluídos forçar todos os pedidos de estar sob o protocolo HTTPS * Copía rota de Constantes literais para os padrões de modo que a geração da url sabe sobre elas. As restrições copiadas são :protocol, :subdomain, :domain, :host e :port * Permite assert_redirected_to para o jogo contra uma expressão regular. * Adiciona um backtrace para a página de erro de roteamento em desenvolvimento. * assert_generates , assert_recognizes e assert_routing tudo em Assertion vez de RoutingError. * Permite que a raiz ajude o caminho a tomar um argumento string. Por exemplo, `root 'pages#main'` como um atalho para `root to: 'pages#main'`. * Adiciona suporte para o verbo PATCH: pedido de objetos responde a patch?. Rotas tem agora um novo método patch, e compreende :patch nos lugares existentes onde um verbo está configurado, como :via. Testes funcionais têm um novo método patch e testes de integração têm um novo método patch_via_redirect. Se :patch é o verbo padrão para atualizações, as edições são tuneladas como PATCH e não como PUT e encaminhando de acordo com a conformidade. * Testes de integração suporta o método OPTIONS. * expires_in aceita um flag must_revalidate. Se for verdade, "deve-revalidar" é adicionado ao cabeçalho Cache-Control. * Padrão de resposta agora sempre usa o seu bloco substituído em respond_with para tornar a sua resposta. * Desligado o modo de detalhe de rack-cache, ainda temos X-Rack-Cache para verificar essa informação. #### Deprecações ### Action View * Remove a dependência Active Model de Action Pack. * Permiti a utilização mounted_helpers (ajudantes para acessar engines montadas) em ActionView::TestCase. * Faz o objeto atual e contador (quando se aplica) variáveis acessíveis na renderização de modelos com :object ou :collection. * Permiti a carga lenta do default_form_builder passando uma string em vez de uma constante. * Adicionado método de índice para classe FormBuilder * Adicionado suporte para layouts ao renderizar um parcial com uma coleção. * Remover :disable_with em favor da opção data-disable-with dos ajudantes submit_tag, button_tag e button_to. * Remover opção :mouseover do helper image_tag. * Modelos sem uma extensão de manipulador levanta agora um aviso de reprovação, mas ainda padrões para ERb. Em versões futuras, ele simplesmente irá retornar o conteúdo do modelo. * Adicionado uma opção divider de grouped_options_for_select para gerar um separador optgroup automaticamente, e depreciado prompt como terceiro argumento, em favor do uso de um hash de opções. * Adicionado helpers time_field e time_field_tag que fazem com que uma tag input[type="time"]. * Removido a obsoleta apis text_helper de highlight, excerpt e word_wrap. * Remover o \n principal acrescentado pelo textarea em assert_select. * Valor padrão mudou para config.action_view.embed_authenticity_token_in_remote_forms para falso. Esta alteração quebra formas remotas que precisam trabalhar também sem JavaScript, por isso, se você precisar de tal comportamento, você pode defini-lo como verdadeiro ou explicitamente passar :authenticity_token => true nas opções do formulário. * Possibilita o uso de um bloco em helper button_to se o texto do botão é difícil de encaixar no parâmetro nome: ``` ruby <%= button_to [:make_happy, @user] do %> Make happy <%= @user.name %> <% end %> # => "
#
# #
#
" ``` * Substituido argumento booleano include_seconds com opção :include_seconds => true na assinatura de distance_of_time_in_words e time_ago_in_words. * Removido helpers button_to_function e link_to_function. * truncate agora sempre retorna um string HTML escapada. A opção :escape pode ser utilizado como false a não escapar do resultado. * Adicionado helpers color_field e color_field_tag. * Adicionadi opção include_hidden para selecionar tag. Com :include_hidden => false selecionado com atributos múltiplos não gera entrada hidden com valor em branco. * Removida a opção de tamanho padrão dos helpers text_field, search_field, telephone_field, url_field, email_field. * Removido opções padrões cols e rows do helper text_area. * Adicionado tag's helpers ativa image_url, javascript_url, stylesheet_url, audio_url, video_url, e font_url. Essas URL helpers irá retornar o caminho completo para o seu assets. Isto é útil quando você está precisando referenciar este host externo ativo. * Permitido argumentos value_method e text_method do collection_select e options_from_collection_for_select para receber um objeto que responde :call como um proc, para avaliar a opção no contexto atual do elemento. Isso funciona da mesma forma com collection_radio_buttons e collection_check_boxes. * Adicionado helpers date_field e date_field_tag que renderizam uma tag input[type="date"]. * Adicionado form helpers collection_check_boxes, semelhante a collection_select: ``` ruby collection_check_boxes :post, :author_ids, Author.all, :id, :name # Outputs something like: ``` Os pares de label/check_box pode ser personalizado com um bloco. * Adicionado form helpers collection_radio_buttons, semelhante a collection_select: ``` ruby collection_radio_buttons :post, :author_id, Author.all, :id, :name # Outputs something like: ``` Os pares de label/radio_button pode ser personalizado com um bloco. * check_box com um atributo HTML5 :form agora replica o :form de atributo para o campo oculto também. * helper de label do formulário aceita :for => nil para não gerar o atributo. * Adicionado opção :format de number_to_percentage. * Adicionado config.action_view.logger para configurar logger na Action View. * helper check_box com :disabled => true irá gerar um campo disabled oculto para se conformar com a convenção de HTML onde os campos com deficiência não foram apresentados com o formulário. Esta é uma mudança de comportamento, anteriormente a tag oculta tinha um valor da caixa de seleção deficientes. * helper favicon_link_tag irá agora usar o favicon em app/assets por padrão. * ActionView::Helpers::TextHelper#highlight agora padrões para os elementos HTML5. #### Deprecações ### Sprockets Mudou-se para uma gem separada chamada sprockets-rails. Active Record ---------------------- * Adicionado declarações add_reference e remove_reference do schema. Alias, add_belongs_to e remove_belongs_to são aceitáveis. Referências são reversíveis. ``` ruby # Criar uma coluna user_id add_reference(:products, :user) # Criar um supplier_id, colunas supplier_type e índice apropriado< add_reference(:products, :supplier, polymorphic: true, index: true) # Remove referência polimórfica remove_reference(:products, :supplier, polymorphic: true) ``` * Adicionado opções :default e :null para column_exists?. ``` ruby column_exists?(:testings, :taggable_id, :integer, null: false) column_exists?(:testings, :taggable_type, :string, default: 'Photo') ``` * ActiveRecord::Relation#inspect agora deixa claro que você está lidando com um objeto de Relation, em vez de um array: ``` ruby User.where(:age => 30).inspect # => , #]> User.where(:age => 30).to_a.inspect # => [#, #] ``` Se mais de 10 itens são devolvidos pela relação, `inspect` mostrará apenas os 10 primeiros, seguidos de reticências. * Adicionado suporte :collation e :ctype ao PostgreSQL. Estes estão disponíveis para PostgreSQL 8.4 ou posterior. ``` ruby development: adapter: postgresql host: localhost database: rails_development username: foo password: bar encoding: UTF8 collation: ja_JP.UTF8 ctype: ja_JP.UTF8 ``` * FinderMethods#exists? agora retorna false com o argumento false. * Adicionado suporte para a especificação a precisão de um timestamp, no adaptador postgresql. Assim, em vez de ter de especificar a precisão incorretamente usando a opção :limit, você pode usar :precision, como pretendido. Por exemplo, em uma migração: ``` ruby def change create_table :foobars do |t| t.timestamps :precision => 0 end end ``` * Permiti ActiveRecord::Relation#pluck a aceitação de várias colunas. Retorna uma array de arrays contendo os valores typecasted: ``` ruby Person.pluck(:id, :name) # SELECT people.id, people.name FROM people # => [[1, 'David'], [2, 'Jeremy'], [3, 'Jose']] ``` * Melhorar a derivação do nome da tabela HABTM de junção de ter em conta o assentamento. Ele agora leva os nomes de tabela dos dois modelos, classifica-as lexicalmente e depois se junta a eles, tirando qualquer prefixo comum do nome segunda tabela. Alguns exemplos: ``` ruby Melhores níveis de modelos (Category <=> Product) Antigo: categories_products Novo: categories_products Melhores modelos de nível com um table_name_prefix global (Category <=> Product) Antigo: site_categories_products Novo: site_categories_products Modelos aninhados em um módulo sem um método table_name_prefix (Admin::Category <=> Admin::Product) Antigo: categories_products Novo: categories_products Modelos aninhados em um módulo com um método table_name_prefix (Admin::Category <=> Admin::Product) Antigo: categories_products Novo: admin_categories_products Modelos aninhados em um modelo pai (Catalog::Category <=> Catalog::Product) Antigo: categories_products Novo: catalog_categories_products Modelos aninhados em modelos de ligações diferentes (Catalog::Category <=> Content::Page) Antigo: categories_pages Novo: catalog_categories_content_pages ``` * Movido as verificações de validade HABTM para ActiveRecord::Reflection. Um efeito colateral disso é se mover quando as exceções são levantadas a partir do ponto de declaração quando a associação é construída. Isso é consistente com outras verificações de validade de associação. * Adicionado hash stored_attributes que contém os atributos armazenados usando ActiveRecord::Store. Isso permite que você recupere a lista de atributos que você definiu. ``` ruby class User < ActiveRecord::Base store :settings, accessors: [:color, :homepage] end User.stored_attributes[:settings] # [:color, :homepage] ``` * Nível de registro padrão do PostgreSQL é agora "aviso", para ignora as mensagens `Notice`. Você pode alterar o nível de log usando a opção disponível min_messages no seu config/database.yml. * Adicionado suporte datatype uuid ao adaptador PostgreSQL. * Adicionado ActiveRecord::Migration.check_pending! que gera um erro se as migrações estão pendentes. * Adicionado #destroy! que atua como #destroy, mas irá gerar uma exceção ActiveRecord::RecordNotDestroyed em vez de retornar false. * Permitir blocos para a contagem com ActiveRecord::Relation, que trabalham semelhante ao Array#count:Person.where("age > 26").count{ |person| person.gender == 'female' } * Adicionado suporte para CollectionAssociation#delete para passar valores Fixnum ou String como IDs de registro. Este encontra os registros que respondem aos ids e exclui-los. ``` ruby class Person < ActiveRecord::Base has_many :pets end person.pets.delete("1") # => [#] person.pets.delete(2, 3) # => [#, #] ``` * Não é mais possível para destruir um modelo marcado como somente leitura. * Adicionado a capacidade de ActiveRecord::Relation#from aceitar outro objetos ActiveRecord::Relation. * Adicionado suporte à codificadores personalizado para ActiveRecord::Store. Agora você pode definir o codificador personalizado como este: ``` ruby store :settings, accessors: [ :color, :homepage ], coder: JSON ``` * Conexões mysql e mysql2 irá definir SQL_MODE=STRICT_ALL_TABLES por padrão, para evitar perda de dados. Isto pode ser desabilitado, especificando strict: false em config/database.yml. * Adicionado ordem padrão de ActiveRecord::Base#first para assegurar resultados consistentes entre as engines diferentes de banco de dados. Introduzido ActiveRecord::Base#take como um substituto para o comportamento antigo. * Adicionado uma opção :index para criar automaticamente índices para references e declarações belongs_to em migrações. Este pode ser um booleano ou um hash que é idêntico a opções disponíveis para o método add_index: ``` ruby create_table :messages do |t| t.references :person, :index => true end ``` É o mesmo que: ``` ruby create_table :messages do |t| t.references :person end add_index :messages, :person_id ``` Geradores também foram atualizados para usar a nova sintaxe. * Adicionado métodos bang para mutação de objetos ActiveRecord::Relation. Por exemplo, enquanto foo.where(:bar) irá retornar um novo objeto deixando foo inalterado, foo.where!(:bar) vai transformar o objeto foo. * Adicionado #find_by e #find_by! para espelhar a funcionalidade fornecida por finders dinâmicos de uma forma que permite a entrada dinâmica mais facilmente: ``` ruby Post.find_by name: 'Spartacus', rating: 4 Post.find_by "published_at < ?", 2.weeks.ago Post.find_by! name: 'Spartacus' ``` * Adicionado ActiveRecord::Base#slice para retornar um hash dos métodos indicados com seus nomes como chaves e valores retornados como valores. * Removido IdentityMap - IdentityMap nunca se formou para ser uma caracterísca "ativada-por-padrão", devido a algumas inconsistências com associações, conforme descrito neste [commit](https://github.com/rails/rails/commit/302c912bf6bcd0fa200d964ec2dc4a44abe328a6). Daí a retirada da base de código, até que tais questões são fixas. * Adicionou um recurso para o estado interno dump/load de exemplo de SchemaCache, porque queremos iniciar mais rapidamente quando temos muitos modelos. ``` ruby # executa rake task. RAILS_ENV=production bundle exec rake db:schema:cache:dump => generate db/schema_cache.dump # Adiciona config.use_schema_cache_dump = true em config / production.rb. BTW, true é default. # boot rails. RAILS_ENV=production bundle exec rails server => use db/schema_cache.dump # Se você remover o cache despejado claro, executar a tarefa rake. RAILS_ENV=production bundle exec rake db:schema:cache:clear => remove db/schema_cache.dump ``` * Adicionado suporte para índices parciais para adaptador PostgreSQL. * O método add_index agora suporta uma opção where que recebe uma string com os critérios dos índices parciais. * Adicionado a classe implementar, o ActiveRecord::NullRelation, o padrão de objeto nulo para a classe Relation. * Implementado método ActiveRecord::Relation#none que retorna uma relação em cadeia com zero registros (uma instância da classe NullRelation). Qualquer condição subseqüente acorrentado a retorno de Relation continuará gerando uma relação vazia e não dispara qualquer consulta ao banco de dados. * Adicionado helper create_join_table de migração para criar tabelas juntadas HABTM. ``` ruby create_join_table :products, :categories # => # create_table :categories_products, :id => false do |td| # td.integer :product_id, :null => false # td.integer :category_id, :null => false # end ``` * A primary key sempre é inicializada no hash @attributes para zero (a menos que outro valor tenha sido especificado). * Em versões anteriores, o seguinte seria gerado uma única consulta com um OUTER JOIN comments, em vez de duas consultas distintas: ``` ruby Post.includes(:comments).where("comments.name = 'foo'") ``` Este comportamento se baseia na correspondência de string de SQL, que é uma idéia intrinsecamente errada, a menos que escreva um parser de SQL, que não queremos fazer. Portanto, agora foi substituído. Para evitar avisos de remoção e para compatibilidade futura, você deve declarar explicitamente quais tabelas de referência, ao usar o trechos SQL: ``` ruby Post.includes(:comments).where("comments.name = 'foo'").references(:comments) ``` Note que você não precisa especificar explicitamente as referências nos seguintes casos, como eles podem ser automaticamente inferidos: ``` ruby Post.where(comments: { name: 'foo' }) Post.where('comments.name' => 'foo') Post.order('comments.name') ``` Você também não precisa se preocupar com isso, a menos que você está carregando. Basicamente, não se preocupe se você ver um aviso de reprovação ou (em versões futuras) um erro de SQL devido a uma falta JOIN. * Apoio à tabela schema_info foi descartada. Por favor, mude para schema_migrations. * Conexões devem ser encerradas no final de um segmento. Se não, seu pool de conexão pode preencher e uma exceção será levantada. * Adicionado o módulo ActiveRecord::Model que pode ser incluído em uma classe como uma alternativa a herança de ActiveRecord::Base: ``` ruby class Post include ActiveRecord::Model end ``` * Registros hstore PostgreSQL pode ser criado. * Tipos hstore PostgreSQL são automaticamente desserializado do banco de dados. * Adicionado método #update_columns que atualiza os atributos do hash passado sem salvar a chamada, portanto, ignorando validações e callbacks. ActiveRecordError será levantado quando chamado em objetos novos ou quando pelo menos um dos atributos for marcado como somente leitura. ``` ruby post.attributes # => {"id"=>2, "title"=>"My title", "body"=>"My content", "author"=>"Peter"} post.update_columns({title: 'New title', author: 'Sebastian'}) # => true post.attributes # => {"id"=>2, "title"=>"New title", "body"=>"My content", "author"=>"Sebastian"} ``` ### Deprecações * Obsoleto a maioria dos métodos do "localizador dinâmico". Todos os métodos dinâmicos, exceto para find_by_... e find_by_...! estão obsoletos. Veja como você pode reescrever o código: ``` ruby find_all_by_... pode ser reescrito usando where(...) find_last_by_... pode ser reescrito usando where(...).last scoped_by_... pode ser reescrito usando where(...) find_or_initialize_by_... pode ser reescrito usando where(...).first_or_initialize find_or_create_by_... pode ser reescrito usando where(...).first_or_create find_or_create_by_...! pode ser reescrito usando where(...).first_or_create! ``` A implementação do obsoleto finders dinâmicos foi movido para a gem active_record_deprecated_finders. * Deprecado o velho estilo hash com base localizador API. Isto significa que os métodos que previamente aceita "opções Finder" não fazem. Por exemplo este: ``` ruby Post.find(:all, :conditions => { :comments_count => 10 }, :limit => 5) ``` Deve ser reescrito no novo estilo que existe desde o Rails 3: ``` ruby Post.where(comments_count: 10).limit(5) ``` Note que como um passo intermediário, é possivel reescrever o código acima como: ``` ruby Post.scoped(:where => { :comments_count => 10 }, :limit => 5) ``` Isso poderia poupar-lhe um monte de trabalho, se há um monte de estilo antigo usando #finder em sua aplicação. Chamando Post.scoped(options) é um atalho para Post.scoped.merge(options). Relation#merge agora aceita um hash de opções, mas eles devem ser idênticos aos nomes do método #finder equivalente. Estes são praticamente idênticos aos de estilo antigo de opções de nomes do #finder, exceto nos seguintes casos: ``` ruby :conditions torna-se :where :include torna-se :includes :extend torna-se :extending ``` O código para implementar as funcionalidades depreciadas foi movido para a gem active_record_deprecated_finders. Esta gem é uma dependência de Active Record no Rails 4.0. Ela deixará de ser uma dependência do Rails 4.1, mas se seu aplicativo depende dos recursos preteridos, então você pode adicioná-lo ao seu próprio Gemfile. Ela será mantida pela equipe principal do Rails até o Rails 5.0 for lançado. * Depreciado scopes avaliados. Não use este: ``` ruby scope :red, where(color: 'red') default_scope where(color: 'red') ``` Use este: ``` ruby scope :red, -> { where(color: 'red') } default_scope { where(color: 'red') } ``` O primeiro tem inúmeras questões. É uma pegadinha comum de fazer o seguinte: ``` ruby scope :recent, where(published_at: Time.now - 2.weeks) ``` Ou uma variante mais sutil: ``` ruby scope :recent, -> { where(published_at: Time.now - 2.weeks) } scope :recent_red, recent.where(color: 'red') ``` Scopes também são muito complexo de implementar dentro do Active Record, e ainda existem bugs. Por exemplo, o seguinte não faz o que você espera: ``` ruby scope :remove_conditions, except(:where) where(...).remove_conditions # => ainda tem conditions ``` * Depreciação adicional para a opção de associação :dependent => :restrict. * Até agora has_many e has_one, opção :dependent => :restrict levanta uma DeleteRestrictionError no momento de destruir o objeto. Em vez disso, ele irá adicionar um erro no modelo. * Para corrigir esse aviso, verifique se seu código não está contando com uma DeleteRestrictionError e adicione config.active_record.dependent_restrict_raises = false no seu config/application.rb. * Nova aplicação rails seria gerada com o config.active_record.dependent_restrict_raises = false no config/application.rb. * O gerador de migração agora cria uma tabela de junção com (comentado) índices cada vez que o nome de migração contém a palavra "join_table". * ActiveRecord::SessionStore foi removido do Rails 4.0 e é agora uma [gem](https://github.com/rails/activerecord-session_store) separada. Active Model ---------------------- * Mudou valor padrão AM::Serializers::JSON.include_root_in_json para false. Agora, serializadores AM e objetos AR têm o mesmo comportamento padrão. ``` ruby class User < ActiveRecord::Base; end class Person include ActiveModel::Model include ActiveModel::AttributeMethods include ActiveModel::Serializers::JSON attr_accessor :name, :age def attributes instance_values end end user.as_json => {"id"=>1, "name"=>"Konata Izumi", "age"=>16, "awesome"=>true} # root não é incluido person.as_json => {"name"=>"Francesco", "age"=>22} # root não é incluido ``` * Passando valores de hash falsos para validates não mais permitir que os validadores correspondentes. * Mensagens ConfirmationValidator de erro irá anexar :#{attribute}_confirmation em vez de attribute. * Adicionado ActiveModel::Model, um mixin para fazer objetos Ruby trabalhar com Action Pack fora da caixa. * ActiveModel::Errors#to_json suporta um novo parâmetro :full_messages. * Guarnições abaixo da API, removido valid? e errors.full_messages. ### Deprecações Active Resource ---------------------- * Active Resource é removido do Rails 4.0 e é agora é separado em uma [gem](https://github.com/rails/activeresource). Active Support ---------------------- * Adicionado valores padrões para todos os métodos ActiveSupport::NumberHelper, para evitar erros com locais vazios ou falta de valores. * Time#change agora trabalha com valores de tempo com outros deslocamentos de UTC ou o fuso horário local. * Adicionado Time#prev_quarter e Time#next_quarter curto para months_ago(3) e months_since(3) . * Removido método require_association obsoleta e não de dependências. * Adicionado opção :instance_accessor para config_accessor. ``` ruby class User include ActiveSupport::Configurable config_accessor :allowed_access, instance_accessor: false end User.new.allowed_access = true # => NoMethodError User.new.allowed_access # => NoMethodError ``` * Métodos ActionView::Helpers::NumberHelper foram movidos para ActiveSupport::NumberHelper e agora estão disponíveis através Numeric#to_s. * Numeric#to_s agora aceita as opções de formatação :phone, :currency, :percentage, :delimited, :rounded, :human, e :human_size. * Adicionado Hash#transform_keys, Hash#transform_keys!, Hash#deep_transform_keys e Hash#deep_transform_keys!. * Alterado xml tipo Datetime para dateTime (com letra T maiúscula). * Adicionado opção :instance_accessor para class_attribute. * Agora constantize olha na cadeia ancestral. * Adicionado Hash#deep_stringify_keys e Hash#deep_stringify_keys! para converter todas as chaves de uma instância Hash em strings. * Adicionado Hash#deep_symbolize_keys e Hash#deep_symbolize_keys! para converter todas as chaves de uma instância Hash em symbols. * Object#try não pode chamar métodos privados. * AS::Callbacks#run_callbacks removido argumento chave. * deep_dup trabalha mais agora expectavelmente e duplica também valores em instancias de Hash e elementos em ocorrências de Array. * Inflector não mais se aplica ice -> ouse a palavras como polícia, fatia. * Adicionado ActiveSupport::Deprecations.behavior = :silence para ignorar completamente depreciações Rails tempo de execução. * Torna Module#delegate parar de usar envio - já não pode delegar métodos privados. * AS::Callbacks depreciado opção :rescuable. * Adicionado Integer#ordinal para obter o sufixo ordinal de string de um inteiro. * Opção AS::Callbacks :per_key não é mais suportado. * AS::Callbacks#define_callbacks acrescentado opção :skip_after_callbacks_if_terminated. * Adicionado html_escape_once a ERB::Util, e a tag helper delega escape_once a ele. * Removido método ActiveSupport::TestCase#pending, utilize instancia de skip. * Excluído a compatibilidade método Module#method_names, utilize o Module#methods a partir de agora (que retorna símbolos). * Excluído a compatibilidade método Module#instance_method_names, utilize o Module#instance_methods a partir de agora (que retorna símbolos). * Banco de dados Unicode atualizado para 6.1.0. * Adiciona opção encode_big_decimal_as_string para forçar serialização JSON de BigDecimals como numérico em vez de envolvê-los em strings de segurança. ### Deprecações * ActiveSupport::Callbacks: uso deprecado de objeto de filtro com métodos #before e #after como callback around. * BufferedLogger está obsoleto. Use ActiveSupport::Logger ou o logger de Ruby stdlib. * Despreza a compatibilidade Module#local_constant_names e use Module#local_constants instancia (que retorna símbolos). Créditos ---------------------- Veja a [lista completa de contribuidores do Rails](http://contributors.rubyonrails.org/) para as muitas pessoas que passam muitas horas contribuindo com o Rails, o quadro estável e robusto que é. Parabéns a todos eles. Créditos da tradução para [Rodrigo Martins](http://github.com/rrmartins)