convenience method for using case insensitive matcher

git-svn-id: https://svn.code.sf.net/p/jackcess/code/jackcess/branches/a97_indexes@1305 f203690c-595d-4dc9-a70b-905162fa7fd2

src/main/java/com/healthmarketscience/jackcess/CursorBuilder.java

 import com.healthmarketscience.jackcess.impl.IndexData;
 import com.healthmarketscience.jackcess.impl.IndexImpl;
 import com.healthmarketscience.jackcess.impl.TableImpl;
+import com.healthmarketscience.jackcess.util.CaseInsensitiveColumnMatcher;
 import com.healthmarketscience.jackcess.util.ColumnMatcher;
 
 
     _beforeFirst = true;
     return this;
   }
-  
+
   /**
    * Sets the cursor so that it will start at the end (unless a savepoint is
    * given).
     setEndRow(specificRow);
     return this;
   }
-  
+
   /**
    * Sets the starting and ending row for a range based index cursor to the
    * given entry (where the given values correspond to the index's columns).
     return this;
   }
 
-  
+
   /**
    * Sets the starting row for a range based index cursor.
    * <p>
     _startRow = startRow;
     return this;
   }
-  
+
   /**
    * Sets the starting row for a range based index cursor to the given entry
    * (where the given values correspond to the index's columns).
     _endRow = endRow;
     return this;
   }
-  
+
   /**
    * Sets the ending row for a range based index cursor to the given entry
    * (where the given values correspond to the index's columns).
     return this;
   }
 
+  /**
+   * Sets the ColumnMatcher to an instance of CaseInsensitiveColumnMatcher
+   */
+  public CursorBuilder setCaseInsensitive() {
+    return setColumnMatcher(CaseInsensitiveColumnMatcher.INSTANCE);
+  }
+
   /**
    * Returns a new cursor for the table, constructed to the given
    * specifications.
     }
     return cursor;
   }
-  
+
   /**
    * Returns a new index cursor for the table, constructed to the given
    * specifications.
    * Note, index based table traversal may not include all rows, as certain
    * types of indexes do not include all entries (namely, some indexes ignore
    * null entries, see {@link Index#shouldIgnoreNulls}).
-   * 
+   *
    * @param index index for the table which will define traversal order as
    *              well as enhance certain lookups
    */
   {
     return createCursor(table.getPrimaryKeyIndex());
   }
-  
+
   /**
    * Creates an indexed cursor for the given table, narrowed to the given
    * range.
    * Note, index based table traversal may not include all rows, as certain
    * types of indexes do not include all entries (namely, some indexes ignore
    * null entries, see {@link Index#shouldIgnoreNulls}).
-   * 
+   *
    * @param index index for the table which will define traversal order as
    *              well as enhance certain lookups
    * @param startRow the first row of data for the cursor (inclusive), or
       .setEndRow(endRow)
       .toIndexCursor();
   }
-  
+
   /**
    * Creates an indexed cursor for the given table, narrowed to the given
    * range.
    * Note, index based table traversal may not include all rows, as certain
    * types of indexes do not include all entries (namely, some indexes ignore
    * null entries, see {@link Index#shouldIgnoreNulls}).
-   * 
+   *
    * @param index index for the table which will define traversal order as
    *              well as enhance certain lookups
    * @param startRow the first row of data for the cursor, or {@code null} for
    * <p>
    * Warning, this method <i>always</i> starts searching from the beginning of
    * the Table (you cannot use it to find successive matches).
-   * 
+   *
    * @param table the table to search
    * @param rowPattern pattern to be used to find the row
    * @return the matching row or {@code null} if a match could not be found.
     }
     return null;
   }
-  
+
   /**
    * Convenience method for finding a specific row (as defined by the cursor)
    * where the index entries match the given values.  See {@link
    * IndexCursor#findRowByEntry(Object...)} for details on the entryValues.
-   * 
+   *
    * @param index the index to search
    * @param entryValues the column values for the index's columns.
    * @return the matching row or {@code null} if a match could not be found.
   {
     return createCursor(index).findRowByEntry(entryValues);
   }
-  
+
   /**
    * Convenience method for finding a specific row by the primary key of the
    * table.  See {@link IndexCursor#findRowByEntry(Object...)} for details on
    * the entryValues.
-   * 
+   *
    * @param table the table to search
    * @param entryValues the column values for the table's primary key columns.
    * @return the matching row or {@code null} if a match could not be found.
   {
     return findRowByEntry(table.getPrimaryKeyIndex(), entryValues);
   }
-  
+
   /**
    * Convenience method for finding a specific row in a table which matches a
    * given row "pattern".  See {@link Cursor#findFirstRow(Column,Object)} for
    * match or a matching row with {@code null} for the desired value.  If
    * distinguishing this situation is important, you will need to use a Cursor
    * directly instead of this convenience method.
-   * 
+   *
    * @param table the table to search
    * @param column column whose value should be returned
    * @param columnPattern column being matched by the valuePattern
     }
     return null;
   }
-  
+
   /**
    * Convenience method for finding a specific row in an indexed table which
    * matches a given row "pattern".  See {@link Cursor#findFirstRow(Map)} for
    * <p>
    * Warning, this method <i>always</i> starts searching from the beginning of
    * the Table (you cannot use it to find successive matches).
-   * 
+   *
    * @param index index to assist the search
    * @param rowPattern pattern to be used to find the row
    * @return the matching row or {@code null} if a match could not be found.
     }
     return null;
   }
-  
+
   /**
    * Convenience method for finding a specific row in a table which matches a
    * given row "pattern".  See {@link Cursor#findFirstRow(Column,Object)} for
    * match or a matching row with {@code null} for the desired value.  If
    * distinguishing this situation is important, you will need to use a Cursor
    * directly instead of this convenience method.
-   * 
+   *
    * @param index index to assist the search
    * @param column column whose value should be returned
    * @param columnPattern column being matched by the valuePattern