diff options
Diffstat (limited to 'guides/source/pt_br/4_0_release_notes.md')
| -rw-r--r-- | guides/source/pt_br/4_0_release_notes.md | 883 |
1 files changed, 0 insertions, 883 deletions
diff --git a/guides/source/pt_br/4_0_release_notes.md b/guides/source/pt_br/4_0_release_notes.md deleted file mode 100644 index 5adf86412a..0000000000 --- a/guides/source/pt_br/4_0_release_notes.md +++ /dev/null @@ -1,883 +0,0 @@ -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 <a href="https://github.com/rails/rails/commits/master">lista de commits</a> no repositório principal do <a href="https://github.com/rails/rails/">Rails</a> 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 <strong><%= @user.name %></strong> - <% end %> - # => "<form method="post" action="/users/1/make_happy" class="button_to"> - # <div> - # <button type="submit"> - # Make happy <strong>Name</strong> - # </button> - # </div> - # </form>" - ``` - -* 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: - <input id="post_author_ids_1" name="post[author_ids][]" type="checkbox" value="1" /> - <label for="post_author_ids_1">D. Heinemeier Hansson</label> - <input id="post_author_ids_2" name="post[author_ids][]" type="checkbox" value="2" /> - <label for="post_author_ids_2">D. Thomas</label> - <input name="post[author_ids][]" type="hidden" value="" /> - ``` - - 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: - <input id="post_author_id_1" name="post[author_id]" type="radio" value="1" /> - <label for="post_author_id_1">D. Heinemeier Hansson</label> - <input id="post_author_id_2" name="post[author_id]" type="radio" value="2" /> - <label for="post_author_id_2">D. Thomas</label> - ``` - - 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 - # => <ActiveRecord::Relation [#<User ...>, #<User ...>]> - - User.where(:age => 30).to_a.inspect - # => [#<User ...>, #<User ...>] - ``` - - 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") # => [#<Pet id: 1>] - person.pets.delete(2, 3) # => [#<Pet id: 2>, #<Pet id: 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)
\ No newline at end of file |