aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSteve Klabnik <steve@steveklabnik.com>2013-08-26 11:49:10 -0700
committerSteve Klabnik <steve@steveklabnik.com>2013-08-26 11:49:10 -0700
commitc9f834bdfbfa38091dbeff97682085df280ea802 (patch)
tree13392e3aaf87aab67e60a4bb285dabfbaed1dfa3
parentc21fd2353a11380f065d56fa24c59c4c43c01ce0 (diff)
parent186a9a17b035391eade2b4e0465f719fddadd5cc (diff)
downloadrails-c9f834bdfbfa38091dbeff97682085df280ea802.tar.gz
rails-c9f834bdfbfa38091dbeff97682085df280ea802.tar.bz2
rails-c9f834bdfbfa38091dbeff97682085df280ea802.zip
Merge pull request #12015 from vipulnsward/add_dynamic_finders_to_upgrade
Add Finder API changes to upgrading guide [ci skip]
-rw-r--r--guides/source/upgrading_ruby_on_rails.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/guides/source/upgrading_ruby_on_rails.md b/guides/source/upgrading_ruby_on_rails.md
index 391551938a..79e0c6bf09 100644
--- a/guides/source/upgrading_ruby_on_rails.md
+++ b/guides/source/upgrading_ruby_on_rails.md
@@ -172,6 +172,18 @@ this gem such as `whitelist_attributes` or `mass_assignment_sanitizer` options.
* Rails 4.0 has deprecated `ActiveRecord::Fixtures` in favor of `ActiveRecord::FixtureSet`.
* Rails 4.0 has deprecated `ActiveRecord::TestCase` in favor of `ActiveSupport::TestCase`.
+* Rails 4.0 has deprecated the old-style hash based finder API. This means that
+ methods which previously accepted "finder options" no longer do.
+
+* All dynamic methods except for `find_by_...` and `find_by_...!` are deprecated.
+ Here's how you can handle the changes:
+
+ * `find_all_by_...` becomes `where(...)`.
+ * `find_last_by_...` becomes `where(...).last`.
+ * `scoped_by_...` becomes `where(...)`.
+ * `find_or_initialize_by_...` becomes `find_or_initialize_by(...)`.
+ * `find_or_create_by_...` becomes `find_or_create_by(...)`.
+
### Active Resource
Rails 4.0 extracted Active Resource to its own gem. If you still need the feature you can add the [Active Resource gem](https://github.com/rails/activeresource) in your Gemfile.