jdbc-helper 0.2.0 → 0.2.1

data/README.rdoc

@@ -29,21 +29,25 @@ Add JDBC driver of the DBMS you're willing to use to your CLASSPATH
               :user     => 'mysql',
               :password => '')
  conn.close
- 
- 
+
+
  # MySQL shortcut connector
  conn = JDBCHelper::MySQLConnector.connect('localhost', 'mysql', '', 'test')
  conn.close
-  
+
 == Querying database table
 
  conn.query("SELECT a, b, c FROM T") do | row |
-     p row.labels
-     p row.rownum
+     row.labels
+     row.rownum
+
+     row.a, row.b, row.c          # Dot-notation
+     row[0], row[1], row[2]       # Numeric index
+     row['a'], row['b'], row['c'] # String index. Case-insensitive.
+     row[:a], row[:b], row[:c]    # Symbol index. Case-insensitive.
 
-     puts row.a, row.b, row.c
-     puts row[0], row[1], row[2]
-     puts row['a'], row['b'], row['c']
+     row[0..-1]                   # Range index. Returns an array of values.
+     row[0, 3]                    # Offset and length. Returns an array of values.
  end
 
  # Returns an array of rows when block is not given
@@ -62,9 +66,9 @@ Add JDBC driver of the DBMS you're willing to use to your CLASSPATH
  # chain enumerators, `enumerate' is much preferred over `query'. (which returns the
  # array of the entire rows)
  conn.enumerate("SELECT * FROM LARGE_T").each_slice(1000) do | slice |
-	slice.each do | row |
-		# ...
-	end
+    slice.each do | row |
+        # ...
+    end
  end
 
 == Updating database table
@@ -75,7 +79,7 @@ Add JDBC driver of the DBMS you're willing to use to your CLASSPATH
      # ...
      # Transaction logic here
      # ...
- 
+
      if success
          tx.commit
      else
@@ -88,7 +92,7 @@ Add JDBC driver of the DBMS you're willing to use to your CLASSPATH
  conn.execute_batch
  conn.add_batch("DELETE FROM T");
  conn.clear_batch
-  
+
 == Using prepared statements
  p_sel = conn.prepare("SELECT * FROM T WHERE b = ? and c = ?")
  p_sel.query(100, 200) do | row |
@@ -110,7 +114,7 @@ Add JDBC driver of the DBMS you're willing to use to your CLASSPATH
 
 == Using table wrappers (since 0.2.0)
   # For more complex examples, refer to test/test_object_wrapper.rb
-  
+
   conn.table('test.data').count
   conn.table('test.data').empty?
   conn.table('test.data').select(:c => 3) do |row|
@@ -125,7 +129,7 @@ Add JDBC driver of the DBMS you're willing to use to your CLASSPATH
   conn.table('test.data').drop_table!
 
 == Contributing to jdbc-helper
- 
+
 * Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
 * Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
 * Fork the project

data/lib/jdbc-helper/connection/row.rb

@@ -12,6 +12,7 @@ class Connection
 #       puts row.a
 #       puts row[1]
 #       puts row['c']
+#       puts row[:a]
 #
 #       row.each do | value |
 #           # ...
@@ -33,16 +34,24 @@ class Row
 
 	include Enumerable
 
-	# @param [Fixnum/String] idx
-	# @return [Object]
-	def [](idx)
+	# @overload [](idx)
+	#   @param [Fixnum/String/Symbol/Range] idx Access index
+	#   @return [Object]
+	# @overload [](offset, len)
+	#   @param [Fixnum] offset Start offset
+	#   @param [Fixnum] len Length of Array
+	#   @return [Array]
+	def [](*idx)
+		return @values[*idx] if idx.length > 1
+
+		idx = idx.first
 		case idx
 		when Fixnum
 			raise RangeError.new("Index out of bound") if idx >= @values.length
 			@values[idx]
-		when String
+		when String, Symbol
 			# case-insensitive, assuming no duplicate labels
-			vidx = @labels_d.index(idx.downcase) or
+			vidx = @labels_d.index(idx.to_s.downcase) or
 				raise NameError.new("Unknown column label: #{idx}")
 			@values[vidx]
 		else

data/test/test_connection.rb

@@ -25,10 +25,19 @@ class TestConnection < Test::Unit::TestCase
 		assert_equal 1, rec.one
 		assert_equal 1, rec[0]
 		assert_equal 1, rec['one']
+		assert_equal 1, rec[:one]
+		assert_equal [1], rec[0...1]
+		assert_equal [1], rec[0, 1]
 
 		assert_equal 'two', rec.two
 		assert_equal 'two', rec[1]
 		assert_equal 'two', rec['two']
+		assert_equal ['two'], rec[1..-1]
+		assert_equal ['two'], rec[1, 1]
+
+		assert_equal [1, 'two'], rec[0..1]
+		assert_equal [1, 'two'], rec[0..-1]
+		assert_equal [1, 'two'], rec[0, 2]
 
 		assert_raise(NoMethodError) { rec.three }
 		assert_raise(NameError) { rec['three'] }

metadata

@@ -1,113 +1,118 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: jdbc-helper
-version: !ruby/object:Gem::Version
-  version: 0.2.0
+version: !ruby/object:Gem::Version 
   prerelease: 
+  version: 0.2.1
 platform: ruby
-authors:
-- Junegunn Choi
+authors: 
+  - Junegunn Choi
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-05-19 00:00:00.000000000Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: &2156345260 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 1.0.0
-  type: :development
-  prerelease: false
-  version_requirements: *2156345260
-- !ruby/object:Gem::Dependency
-  name: jeweler
-  requirement: &2156344780 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 1.5.2
-  type: :development
-  prerelease: false
-  version_requirements: *2156344780
-- !ruby/object:Gem::Dependency
-  name: rcov
-  requirement: &2156344300 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: *2156344300
-description: JDBCHelper::Connection object wraps around a JDBC connection and provides
-  much nicer interface to crucial database operations from primitive selects and updates
-  to more complex ones involving batch updates, prepared statements and transactions.
+
+date: 2011-05-19 00:00:00 +09:00
+default_executable: 
+dependencies: 
+  - !ruby/object:Gem::Dependency 
+    name: bundler
+    version_requirements: &id001 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ~>
+          - !ruby/object:Gem::Version 
+            version: 1.0.0
+    requirement: *id001
+    prerelease: false
+    type: :development
+  - !ruby/object:Gem::Dependency 
+    name: jeweler
+    version_requirements: &id002 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ~>
+          - !ruby/object:Gem::Version 
+            version: 1.5.2
+    requirement: *id002
+    prerelease: false
+    type: :development
+  - !ruby/object:Gem::Dependency 
+    name: rcov
+    version_requirements: &id003 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: "0"
+    requirement: *id003
+    prerelease: false
+    type: :development
+description: A JDBC helper for JRuby/Database developers.
 email: junegunn.c@gmail.com
 executables: []
+
 extensions: []
-extra_rdoc_files:
-- LICENSE.txt
-- README.rdoc
-files:
-- lib/jdbc-helper.rb
-- lib/jdbc-helper/connection.rb
-- lib/jdbc-helper/connection/prepared_statement.rb
-- lib/jdbc-helper/connection/result_set_enumerator.rb
-- lib/jdbc-helper/connection/row.rb
-- lib/jdbc-helper/connection/statement_pool.rb
-- lib/jdbc-helper/connector.rb
-- lib/jdbc-helper/connector/mysql_connector.rb
-- lib/jdbc-helper/connector/oracle_connector.rb
-- lib/jdbc-helper/constants.rb
-- lib/jdbc-helper/object_wrapper.rb
-- lib/jdbc-helper/sql.rb
-- LICENSE.txt
-- README.rdoc
-- test/database.yml
-- test/helper.rb
-- test/test_connection.rb
-- test/test_connectors.rb
-- test/test_object_wrapper.rb
-- test/test_performance.rb
-- test/test_sql.rb
+
+extra_rdoc_files: 
+  - LICENSE.txt
+  - README.rdoc
+files: 
+  - lib/jdbc-helper.rb
+  - lib/jdbc-helper/connection.rb
+  - lib/jdbc-helper/connection/prepared_statement.rb
+  - lib/jdbc-helper/connection/result_set_enumerator.rb
+  - lib/jdbc-helper/connection/row.rb
+  - lib/jdbc-helper/connection/statement_pool.rb
+  - lib/jdbc-helper/connector.rb
+  - lib/jdbc-helper/connector/mysql_connector.rb
+  - lib/jdbc-helper/connector/oracle_connector.rb
+  - lib/jdbc-helper/constants.rb
+  - lib/jdbc-helper/object_wrapper.rb
+  - lib/jdbc-helper/sql.rb
+  - LICENSE.txt
+  - README.rdoc
+  - test/database.yml
+  - test/helper.rb
+  - test/test_connection.rb
+  - test/test_connectors.rb
+  - test/test_object_wrapper.rb
+  - test/test_performance.rb
+  - test/test_sql.rb
+has_rdoc: true
 homepage: http://github.com/junegunn/jdbc-helper
-licenses:
-- MIT
+licenses: 
+  - MIT
 post_install_message: 
 rdoc_options: []
-require_paths:
-- lib
-required_ruby_version: !ruby/object:Gem::Requirement
+
+require_paths: 
+  - lib
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-      segments:
-      - 0
-      hash: -1455612613663735519
-required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 2
+        segments: 
+          - 0
+        version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
 requirements: []
+
 rubyforge_project: 
-rubygems_version: 1.7.2
+rubygems_version: 1.5.1
 signing_key: 
 specification_version: 3
-summary: A JDBC helper for Ruby/Database developers
-test_files:
-- test/database.yml
-- test/helper.rb
-- test/test_connection.rb
-- test/test_connectors.rb
-- test/test_object_wrapper.rb
-- test/test_performance.rb
-- test/test_sql.rb
+summary: A JDBC helper for JRuby/Database developers.
+test_files: 
+  - test/database.yml
+  - test/helper.rb
+  - test/test_connection.rb
+  - test/test_connectors.rb
+  - test/test_object_wrapper.rb
+  - test/test_performance.rb
+  - test/test_sql.rb