From e358751fe03e48b2d53fa1c104ee2623bc14c58c Mon Sep 17 00:00:00 2001 From: James Ahlborn Date: Fri, 8 Jan 2021 01:17:20 +0000 Subject: make some useful things public; add auto module name to manifest git-svn-id: https://svn.code.sf.net/p/jackcess/code/jackcess/branches/modules@1348 f203690c-595d-4dc9-a70b-905162fa7fd2 --- pom.xml | 1 + 1 file changed, 1 insertion(+) (limited to 'pom.xml') diff --git a/pom.xml b/pom.xml index e3c9e0c..b6229d6 100644 --- a/pom.xml +++ b/pom.xml @@ -142,6 +142,7 @@ true + com.healthmarketscience.jackcess -- cgit v1.2.3 From d9117987ac5e06228e3efbfa3c9121f9998740a9 Mon Sep 17 00:00:00 2001 From: James Ahlborn Date: Mon, 18 Jan 2021 17:12:49 +0000 Subject: update documentation and version git-svn-id: https://svn.code.sf.net/p/jackcess/code/jackcess/branches/modules@1351 f203690c-595d-4dc9-a70b-905162fa7fd2 --- pom.xml | 2 +- src/site/site.xml | 5 ++- src/site/xdoc/index.xml | 10 +++--- src/site/xdoc/jackcess-4.xml | 64 +++++++++++++++++++++++++++++++++++++ src/site/xdoc/jackcess_upgrades.xml | 19 +++++++++++ 5 files changed, 90 insertions(+), 10 deletions(-) create mode 100644 src/site/xdoc/jackcess-4.xml create mode 100644 src/site/xdoc/jackcess_upgrades.xml (limited to 'pom.xml') diff --git a/pom.xml b/pom.xml index b6229d6..41b81fb 100644 --- a/pom.xml +++ b/pom.xml @@ -9,7 +9,7 @@ jackcess Jackcess A pure Java library for reading from and writing to MS Access databases. - 3.5.2.mods-SNAPSHOT + 4.0.0-SNAPSHOT https://jackcess.sourceforge.io 2005 diff --git a/src/site/site.xml b/src/site/site.xml index c7c64f7..adf806b 100644 --- a/src/site/site.xml +++ b/src/site/site.xml @@ -15,9 +15,8 @@ - - - + + diff --git a/src/site/xdoc/index.xml b/src/site/xdoc/index.xml index 3f9786c..6cef4a6 100644 --- a/src/site/xdoc/index.xml +++ b/src/site/xdoc/index.xml @@ -21,12 +21,10 @@

- While Jackcess still only requires Java 8+, as of the 4.0.0 release - it now includes an Automatic-Module-Name of - com.healthmarketscience.jackcess in its manifest. That - allows it to be used in the module path for Java 9+ projects. Note - that using jackcess as a module requires enabling the - java.sql module. + While Jackcess still only requires Java 8+, as of the 4.0.0 + release it now includes an Automatic-Module-Name of + com.healthmarketscience.jackcess in its manifest. This + allows it to be used in the module path for Java 9+ projects.

This release is binary compatible with the 3.x release series. diff --git a/src/site/xdoc/jackcess-4.xml b/src/site/xdoc/jackcess-4.xml new file mode 100644 index 0000000..581aac4 --- /dev/null +++ b/src/site/xdoc/jackcess-4.xml @@ -0,0 +1,64 @@ + + + + + James Ahlborn + Upgrading from Jackcess 3.x (or 3.5.x) to 4.x + + + +

+ +

+ Jackcess 4.x is largely binary compatible with the previous 3.x (and + 3.5.x) versions. In order to be more "module friendly", the + exceptions thrown from a few infrequently used methods have changed + from SQLException to IOException. Other + than that, code compiled against the 3.x series should work fine + with the 4.x series. +

+ +

+ Even though Jackcess is now Java 9+ module compatible, it still + only requires Java 8+. However, Jackcess can now be safely used + in the module path of a Java 9+ project (with the module name of + com.healthmarketscience.jackcess). There are a few + features which require additional core Java modules to be enabled + (but these modules are not required if the corresponding features + are not utilized). +

    +
  • java.sql
  • +
      +
    • This module is necessary if Jackcess will need to interact + with any of the classes from the java.sql package + (e.g. handling Clob/Blob or using + ImportUtil).
    • +
    +
  • java.scripting
  • +
      +
    • This module is necessary if expression evaluation is + enabled (the default) and the database includes expressions + (e.g. default values, calculated columns, validation + rules, etc.).
    • +
    +
+

+ +

Working with Jackcess Encrypt

+

+ If you are using the Jackcess Encrypt + project, then you will need to use a version compatible with the + relevant Jackess API. Fortunately, the major versions match, so + it's pretty simple: +

+
    +
  • Jackcess 4.x -> Jackcess Encrypt 4.y
  • +
  • Jackcess 3.x -> Jackcess Encrypt 3.y
  • +
  • Jackcess 2.x -> Jackcess Encrypt 2.y
  • +
  • Jackcess 1.x -> Jackcess Encrypt 1.y
  • +
+
+
+ + + diff --git a/src/site/xdoc/jackcess_upgrades.xml b/src/site/xdoc/jackcess_upgrades.xml new file mode 100644 index 0000000..67af114 --- /dev/null +++ b/src/site/xdoc/jackcess_upgrades.xml @@ -0,0 +1,19 @@ + + + + + James Ahlborn + Upgrading to Older Versions + + + +
+ +
+ + +
-- cgit v1.2.3