Java Library for MS Access

This cookbook will attempt to familiarize the reader with the various - nooks and crannies of the Jackcess API. The API is large due to the - large feature-set that an Access Database provides, so this cookbook - will by no means be exhaustive. However, this will hopefully give the - reader enough useful building blocks such that the rest of the API can - be discovered and utilized as necessary. + nooks and crannies of the Jackcess 2.x API. The API is large due to + the large feature-set that an Access Database provides, so this + cookbook will by no means be exhaustive. However, this will hopefully + give the reader enough useful building blocks such that the rest of + the API can be discovered and utilized as necessary.

This cookbook is a cross between a tutorial and a reference, so the @@ -48,7 +48,7 @@ Database class.

- Database db = Database.open(new File("mydb.mdb")); + Database db = DatabaseBuilder.open(new File("mydb.mdb"));

That's it, now you have a Database instance (maybe this isn't that @@ -76,11 +76,12 @@ is the best way to interact with the data in a Table, for the sake of simplicity when just getting started, we will use the simplified iteration provided by the Table class itself. When reading row - data, it is generally provided as a Map<String,Object> where the keys are the column + data, it is generally provided as a Row where the keys are the column names and the values are the strongly typed column values.

- for(Map<String,Object> row : table) { + for(Row row : table) { System.out.prinln("Look ma, a row: " + row); } @@ -112,7 +113,7 @@ their values like so:

- Map<String,Object> row = ...; + Row row = ...; for(Column column : table.getColumns()) { String columnName = column.getName(); Object value = row.get(columnName); @@ -191,7 +192,7 @@ is possible may be out of date).

- As of version 1.2.10, Jackcess supports: + As of version 2.0.0, Jackcess supports:

Creating databases for Access all versions 2000-2010

Java Library for MS Access

Jackcess is a pure Java library for reading from and writing to MS - Access databases (currently supporting versions 2000-2007). It is part of the OpenHMS project from Health Market Science, Inc.. It is not an application. There is no GUI. It's a + Access databases (currently supporting versions 2000-2010). It is part of the OpenHMS project from Health Market Science, Inc.. It is not an application. There is no GUI. It's a library, intended for other developers to use to build Java applications. Jackcess is licensed under the @@ -19,6 +20,7 @@ for more info.

Here are a few snippets of code to whet your appetite. For more @@ -26,19 +28,15 @@ unit tested, you can find even more example code in the unit tests.

Displaying the contents of a table: - System.out.println(Database.open(new File("my.mdb")).getTable("MyTable").display()); - -
Iterating through the rows of a table: - Table table = Database.open(new File("my.mdb")).getTable("MyTable"); -for(Map<String, Object> row : table) { + Table table = DatabaseBuilder.open(new File("my.mdb")).getTable("MyTable"); +for(Row row : table) { System.out.println("Column 'a' has value: " + row.get("a")); }
Searching for a row with a specific column value: - Map<String, Object> row = Cursor.findRow(table, Collections.singletonMap("a", "foo")); + Row row = CursorBuilder.findRow(table, Collections.singletonMap("a", "foo")); if(row != null) { System.out.println("Found row where 'a' == 'foo': " + row); } else { @@ -47,14 +45,12 @@ if(row != null) {
Creating a new table and writing data into it: - Database db = Database.create(new File("new.mdb")); + Database db = DatabaseBuilder.create(Database.FileFormat.V2000, new File("new.mdb")); Table newTable = new TableBuilder("NewTable") .addColumn(new ColumnBuilder("a") - .setSQLType(Types.INTEGER) - .toColumn()) + .setSQLType(Types.INTEGER)) .addColumn(new ColumnBuilder("b") - .setSQLType(Types.VARCHAR) - .toColumn()) + .setSQLType(Types.VARCHAR)) .toTable(db); newTable.addRow(1, "foo"); @@ -62,13 +58,18 @@ newTable.addRow(1, "foo");
Copying the contents of a JDBC ResultSet (e.g. from an external database) into a new table: - Database.open(new File("my.mdb")).copyTable("Imported", resultSet); + Database db = DatabaseBuilder.open(new File("my.mdb")); +new ImportUtil.Builder(db, "Imported").importResultSet(resultSet); +db.close();
Copying the contents of a CSV file into a new table: - Database.open(new File("my.mdb")).importFile("Imported2", new File("my.csv"), ","); + Database db = DatabaseBuilder.open(new File("my.mdb")); +new ImportUtil.Builder(db, "Imported2").setDelimiter(",").importFile(new File("my.csv")); +db.close();

Some other jackcess related projects: