Skip to content

Commit 6d693a0

Browse files
committed
Better IronRuby docs, release 2.3.5.
1 parent 38d8a5f commit 6d693a0

File tree

4 files changed

+12
-5
lines changed

4 files changed

+12
-5
lines changed

CHANGELOG

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,9 @@
11

22
MASTER
33

4+
5+
* 2.3.5
6+
47
* Initial IronRuby ADONET connection mode support baked right in. Removed most &block
58
parameters, no handle/request object yielded anymore. Better abstraction and compliance
69
per the ActiveRecord abstract adapter to not yielding handles for #execute and only for

README.rdoc

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -145,11 +145,15 @@ Here are some external links for libraries and/or tutorials on how to install an
145145

146146
== IronRuby ADONET Mode
147147

148-
A few details on this implementation. All that is needed in your database.yml configuration file is "mode: adonet" vs "odbc" and if you are running IronRuby, the connection will be native. No need for ANY DBI middle layer is needed or special extension to this adapter. The adapter is opinionated in regards to IronRuby on types coming out of the DB. For example strings will be String, not System::String and DateTime vs System::Datetime. This is so that we can pass all the ActiveRecord tests. When using the adapter it is best to stick with default Ruby types coming in and out. Currently IronRuby is passing most of the ActiveRecord tests. Here is a list of the ones remaining.
148+
A few details on this implementation. All that is needed in your database.yml configuration file is "mode: adonet" vs "odbc" and if you are running IronRuby, the connection will be native. You can also specify an "integrated_security: true" option in your configuration, remember to remove the username/password options too. To use this adapter, you will not need need ANY DBI middle layer or special extension gems to the adapter.
149149

150-
http://gist.github.com/381101
150+
This adapter is opinionated in regards to IronRuby on types going in and out of the DB. For example strings will be String, not System::String and DateTime vs System::Datetime. There are many more examples but the rule of thumb is that the types will be simple types that correlate to a standard Ruby implementation. We enforce this basic rule because it is necessary to pass the tests and let the framework do its job. We recommend sticking to native Ruby types in your application code too.
151+
152+
The adapter establishes a System::Data::SqlClient connection that has both MultipleActiveResultSets (MARS) and Pooling turned off. There are good reasons for this one because the connection would not work otherwise for all the code issued by ActiveRecord. Remember too that ActiveRecord has it's own connection pooling and these underlying features like MARS/Pooling work against the adapter code.
151153

152-
Some are in the adapters realm and some are in Marshalling which is IronRuby core to fix. Feel like helping knock these out, submit a patch.
154+
Currently IronRuby is passing most of the ActiveRecord and Adapter tests. Here is a list of the ones remaining. Some are in the adapter's realm and some are in Marshaling area of IronRuby's core to fix. Feel like helping knock these out? Submit a patch to github issues.
155+
156+
http://gist.github.com/381101
153157

154158

155159
== Contributing

activerecord-sqlserver-adapter.gemspec

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
Gem::Specification.new do |s|
22
s.name = "activerecord-sqlserver-adapter"
3-
s.version = "2.3.4"
3+
s.version = "2.3.5"
44
s.date = "2010-02-17"
55
s.summary = "SQL Server 2000, 2005 and 2008 Adapter For Rails."
66
s.email = "ken@metaskills.net"

lib/active_record/connection_adapters/sqlserver_adapter.rb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -163,7 +163,7 @@ def simplified_datetime
163163
class SQLServerAdapter < AbstractAdapter
164164

165165
ADAPTER_NAME = 'SQLServer'.freeze
166-
VERSION = '2.3.4'.freeze
166+
VERSION = '2.3.5'.freeze
167167
DATABASE_VERSION_REGEXP = /Microsoft SQL Server\s+(\d{4})/
168168
SUPPORTED_VERSIONS = [2000,2005,2008].freeze
169169
LIMITABLE_TYPES = ['string','integer','float','char','nchar','varchar','nvarchar'].freeze

0 commit comments

Comments
 (0)