CHANGELOG.md 9.1 KB
Newer Older
1 2
*   `time` columns can now affected by `time_zone_aware_attributes`. If you have
    set `config.time_zone` to a value other than `'UTC'`, they will be treated
3
    as in that time zone by default in Rails 5.1. If this is not the desired
4 5 6 7 8 9 10 11 12 13 14
    behavior, you can set

        ActiveRecord::Base.time_zone_aware_types = [:datetime]

    A deprecation warning will be emitted if you have a `:time` column, and have
    not explicitly opted out.

    Fixes #3145

    *Sean Griffin*

15 16 17 18 19
*   `nil` as a value for a binary column in a query no longer logs as
    "<NULL binary data>", and instead logs as just "nil".

    *Sean Griffin*

20 21 22 23 24 25 26
*   `attribute_will_change!` will no longer cause non-persistable attributes to
    be sent to the database.

    Fixes #18407.

    *Sean Griffin*

27 28
*   Remove support for the `protected_attributes` gem.

29
    *Carlos Antonio da Silva*, *Roberto Miranda*
30

31
*   Fix accessing of fixtures having non-string labels like Fixnum.
32 33 34

    *Prathamesh Sonpatki*

35
*   Remove deprecated support to preload instance-dependent associations.
36 37 38

    *Yves Senn*

39 40 41 42
*   Remove deprecated support for PostgreSQL ranges with exclusive lower bounds.

    *Yves Senn*

43 44 45 46 47
*   Remove deprecation when modifying a relation with cached arel.
    This raises an `ImmutableRelation` error instead.

    *Yves Senn*

Y
Yves Senn 已提交
48 49
*   Added `ActiveRecord::SecureToken` in order to encapsulate generation of
    unique tokens for attributes in a model using `SecureRandom`.
50 51 52

    *Roberto Miranda*

53 54 55 56 57 58 59 60 61
*   Change the behavior of boolean columns to be closer to Ruby's semantics.

    Before this change we had a small set of "truthy", and all others are "falsy".

    Now, we have a small set of "falsy" values and all others are "truthy" matching
    Ruby's semantics.

    *Rafael Mendonça França*

62 63 64 65
*   Deprecate `ActiveRecord::Base.errors_in_transactional_callbacks=`.

    *Rafael Mendonça França*

66
*   Change transaction callbacks to not swallow errors.
67

68 69
    Before this change any errors raised inside a transaction callback
    were getting rescued and printed in the logs.
70

71
    Now these errors are not rescued anymore and just bubble up, as the other callbacks.
72 73 74

    *Rafael Mendonça França*

75 76 77 78
*   Remove deprecated `sanitize_sql_hash_for_conditions`.

    *Rafael Mendonça França*

79 80 81 82
*   Remove deprecated `Reflection#source_macro`.

    *Rafael Mendonça França*

83 84 85 86
*   Remove deprecated `symbolized_base_class` and `symbolized_sti_name`.

    *Rafael Mendonça França*

87 88 89 90
*   Remove deprecated `ActiveRecord::Base.disable_implicit_join_references=`.

    *Rafael Mendonça França*

91
*   Remove deprecated access to connection specification using a string accessor.
92 93 94 95 96

    Now all strings will be handled as a URL.

    *Rafael Mendonça França*

97 98 99 100
*   Change the default `null` value for `timestamps` to `false`.

    *Rafael Mendonça França*

101 102 103 104
*   Return an array of pools from `connection_pools`.

    *Rafael Mendonça França*

105 106 107 108
*   Return a null column from `column_for_attribute` when no column exists.

    *Rafael Mendonça França*

109 110 111 112
*   Remove deprecated `serialized_attributes`.

    *Rafael Mendonça França*

113 114 115 116
*   Remove deprecated automatic counter caches on `has_many :through`.

    *Rafael Mendonça França*

117 118 119 120 121 122 123 124 125
*   Change the way in which callback chains can be halted.

    The preferred method to halt a callback chain from now on is to explicitly
    `throw(:abort)`.
    In the past, returning `false` in an ActiveRecord `before_` callback had the
    side effect of halting the callback chain.
    This is not recommended anymore and, depending on the value of the
    `config.active_support.halt_callback_chains_on_return_false` option, will
    either not work at all or display a deprecation warning.
126 127 128

    *claudiob*

129
*   Clear query cache on rollback.
Y
Yves Senn 已提交
130

131
    *Florian Weingarten*
Y
Yves Senn 已提交
132

133 134 135 136 137 138
*   Fixed setting of foreign_key for through associations while building of new record.

    Fixes #12698.

    *Ivan Antropov*

139 140 141 142 143 144 145
*   Improve a dump of the primary key support. If it is not a default primary key,
    correctly dump the type and options.

    Fixes #14169, #16599.

    *Ryuta Kamizono*

146 147 148 149 150 151 152 153 154 155 156
*   Format the datetime string according to the precision of the datetime field.

    Incompatible to rounding behavior between MySQL 5.6 and earlier.

    In 5.5, when you insert `2014-08-17 12:30:00.999999` the fractional part
    is ignored. In 5.6, it's rounded to `2014-08-17 12:30:01`:

    http://bugs.mysql.com/bug.php?id=68760

    *Ryuta Kamizono*

157 158 159 160
*   Allow precision option for MySQL datetimes.

    *Ryuta Kamizono*

161 162 163 164
*   Fixed automatic inverse_of for models nested in module.

    *Andrew McCloud*

165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180
*   Change `ActiveRecord::Relation#update` behavior so that it can
    be called without passing ids of the records to be updated.

    This change allows to update multiple records returned by
    `ActiveRecord::Relation` with callbacks and validations.

        # Before
        # ArgumentError: wrong number of arguments (1 for 2)
        Comment.where(group: 'expert').update(body: "Group of Rails Experts")

        # After
        # Comments with group expert updated with body "Group of Rails Experts"
        Comment.where(group: 'expert').update(body: "Group of Rails Experts")

    *Prathamesh Sonpatki*

181 182 183 184 185 186
*   Fix `reaping_frequency` option when the value is a string.

    This usually happens when it is configured using `DATABASE_URL`.

    *korbin*

187 188 189 190 191 192 193 194 195 196 197 198 199
*   Fix error message when trying to create an associated record and the foreign
    key is missing.

    Before this fix the following exception was being raised:

        NoMethodError: undefined method `val' for #<Arel::Nodes::BindParam:0x007fc64d19c218>

    Now the message is:

        ActiveRecord::UnknownAttributeError: unknown attribute 'foreign_key' for Model.

    *Rafael Mendonça França*

200 201 202 203
*   When a table has a composite primary key, the `primary_key` method for
    SQLite3 and PostgreSQL adapters was only returning the first field of the key.
    Ensures that it will return nil instead, as Active Record doesn't support
    composite primary keys.
204 205 206 207 208

    Fixes #18070.

    *arthurnn*

209 210 211 212 213 214 215
*   `validates_size_of` / `validates_length_of` do not count records,
    which are `marked_for_destruction?`.

    Fixes #7247.

    *Yves Senn*

216 217 218 219 220 221
*   Ensure `first!` and friends work on loaded associations.

    Fixes #18237.

    *Sean Griffin*

222 223 224 225 226 227
*   `eager_load` preserves readonly flag for associations.

    Closes #15853.

    *Takashi Kokubun*

228
*   Provide `:touch` option to `save()` to accommodate saving without updating
229 230
    timestamps.

231
    Fixes #18202.
232 233 234

    *Dan Olson*

235
*   Provide a more helpful error message when an unsupported class is passed to
236
    `serialize`.
237

238
    Fixes #18224.
239 240 241

    *Sean Griffin*

242 243 244 245 246 247 248 249 250
*   Add bigint primary key support for MySQL.

    Example:

        create_table :foos, id: :bigint do |t|
        end

    *Ryuta Kamizono*

R
Ryuta Kamizono 已提交
251 252 253 254 255 256
*   Support for any type primary key.

    Fixes #14194.

    *Ryuta Kamizono*

257 258 259 260
*   Dump the default `nil` for PostgreSQL UUID primary key.

    *Ryuta Kamizono*

261 262 263 264 265 266
*   Add a `:foreign_key` option to `references` and associated migration
    methods. The model and migration generators now use this option, rather than
    the `add_foreign_key` form.

    *Sean Griffin*

267 268 269 270 271
*   Don't raise when writing an attribute with an out-of-range datetime passed
    by the user.

    *Grey Baker*

272 273 274 275 276
*   Replace deprecated `ActiveRecord::Tasks::DatabaseTasks#load_schema` with
    `ActiveRecord::Tasks::DatabaseTasks#load_schema_for`.

    *Yves Senn*

277 278 279
*   Fixes bug with 'ActiveRecord::Type::Numeric' that causes negative values to
    be marked as having changed when set to the same negative value.

Y
Yves Senn 已提交
280
    Closes #18161.
281 282 283

    *Daniel Fox*

284 285 286 287 288 289 290
*   Introduce `force: :cascade` option for `create_table`. Using this option
    will recreate tables even if they have dependent objects (like foreign keys).
    `db/schema.rb` now uses `force: :cascade`. This makes it possible to
    reload the schema when foreign keys are in place.

    *Matthew Draper*, *Yves Senn*

291 292 293 294 295 296 297 298
*   `db:schema:load` and `db:structure:load` no longer purge the database
    before loading the schema. This is left for the user to do.
    `db:test:prepare` will still purge the database.

    Closes #17945.

    *Yves Senn*

Y
Yves Senn 已提交
299
*   Fix undesirable RangeError by `Type::Integer`. Add `Type::UnsignedInteger`.
300 301 302

    *Ryuta Kamizono*

303 304 305 306
*   Add `foreign_type` option to `has_one` and `has_many` association macros.

    This option enables to define the column name of associated object's type for polymorphic associations.

307
    *Ulisses Almeida*, *Kassio Borges*
308

309 310 311 312 313
*   Remove deprecated behavior allowing nested arrays to be passed as query
    values.

    *Melanie Gilman*

314 315 316 317 318
*   Deprecate passing a class as a value in a query. Users should pass strings
    instead.

    *Melanie Gilman*

319 320 321 322 323
*   `add_timestamps` and `remove_timestamps` now properly reversible with
    options.

    *Noam Gagliardi-Rabinovich*

324 325 326 327 328 329 330
*   `ActiveRecord::ConnectionAdapters::ColumnDumper#column_spec` and
    `ActiveRecord::ConnectionAdapters::ColumnDumper#prepare_column_options` no
    longer have a `types` argument. They should access
    `connection#native_database_types` directly.

    *Yves Senn*

331
Please check [4-2-stable](https://github.com/rails/rails/blob/4-2-stable/activerecord/CHANGELOG.md) for previous changes.