diff options
author | Sean Griffin <sean@thoughtbot.com> | 2015-01-30 10:13:42 -0700 |
---|---|---|
committer | Sean Griffin <sean@thoughtbot.com> | 2015-01-30 10:38:44 -0700 |
commit | 155b1b7fe3a1d231fb98a6fb04a21f6eb190b98f (patch) | |
tree | ed85201a699e27d4196ffef4dda37d28424c3d44 /guides/CHANGELOG.md | |
parent | dedb946bfb940ece65064175f09ed55815768ec6 (diff) | |
download | rails-155b1b7fe3a1d231fb98a6fb04a21f6eb190b98f.tar.gz rails-155b1b7fe3a1d231fb98a6fb04a21f6eb190b98f.tar.bz2 rails-155b1b7fe3a1d231fb98a6fb04a21f6eb190b98f.zip |
Remove most uses of `Column#cast_type`
The goal is to remove the type object from the column, and remove
columns from the type casting process entirely. The primary motivation
for this is clarity. The connection adapter does not have sufficient
type information, since the type we want to work with might have been
overriden at the class level. By taking this object from the column,
it is easy to mistakenly think that the column object which exists on
the connection adapter is sufficient. It isn't.
A concrete example of this is `serialize`. In 4.2 and earlier, `where`
worked in a very inconsistent and confusing manner. If you passed a
single value to `where`, it would serialize it before querying, and do
the right thing. However, passing it as part of an array, hash, or range
would cause it to not work. This is because it would stop using prepared
statements, so the type casting would come from arel. Arel would have no
choice but to get the column from the connection adapter, which would
treat it as any other string column, and query for the wrong value.
There are a handful of cases where using the column object to find the
cast type is appropriate. These are cases where there is not actually a
class involved, such as the migration DSL, or fixtures. For all other
cases, the API should be designed as such that the type is provided
before we get to the connection adapter. (For an example of this, see
the work done to decorate the arel table object with a type caster, or
the introduction of `QueryAttribute` to `Relation`).
There are times that it is appropriate to use information from the
column to change behavior in the connection adapter. These cases are
when the primitive used to represent that type before it goes to the
database does not sufficiently express what needs to happen. An example
of this that affects every adapter is binary vs varchar, where the
primitive used for both is a string. In this case it is appropriate to
look at the column object to determine which quoting method to use, as
this is something schema dependent.
An example of something which would not be appropriate is to look at the
type and see that it is a datetime, and performing string parsing when
given a string instead of a date. This is the type of logic that should
live entirely on the type. The value which comes out of the type should
be a sufficiently generic primitive that the adapter can be expected to
know how to work with it.
The one place that is still using the column for type information which
should not be necessary is the connection adapter type caster which is
sometimes given to the arel table when we can't find the associated
table. This will hopefully go away in the near future.
Diffstat (limited to 'guides/CHANGELOG.md')
0 files changed, 0 insertions, 0 deletions