12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364 |
- <?xml version="1.0"?>
-
- <document>
- <properties>
- <author email="jahlborn@users.sf.net">James Ahlborn</author>
- <title>Upgrading from Jackcess 3.x (or 3.5.x) to 4.x</title>
- </properties>
- <body>
-
- <section name="Jackcess 4.0">
- <subsection name="Just give it to me straight">
- <p>
- 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 <code>SQLException</code> to <code>IOException</code>. Other
- than that, code compiled against the 3.x series should work fine
- with the 4.x series.
- </p>
-
- <p>
- Even though Jackcess is now Java 9+ module compatible, <i>it still
- only requires Java 8+</i>. However, Jackcess can now be safely used
- in the module path of a Java 9+ project (with the module name of
- <code>com.healthmarketscience.jackcess</code>). 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).
- <ul>
- <li><b>java.sql</b></li>
- <ul>
- <li>This module is necessary if Jackcess will need to interact
- with any of the classes from the <code>java.sql</code> package
- (e.g. handling <code>Clob</code>/<code>Blob</code> or using
- <code>ImportUtil</code>).</li>
- </ul>
- <li><b>java.scripting</b></li>
- <ul>
- <li>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.).</li>
- </ul>
- </ul>
- </p>
-
- <h4>Working with Jackcess Encrypt</h4>
- <p>
- If you are using the <a href="https://jackcessencrypt.sourceforge.io/">Jackcess Encrypt</a>
- 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:
- </p>
- <ul>
- <li>Jackcess 4.x -> Jackcess Encrypt 4.y</li>
- <li>Jackcess 3.x -> Jackcess Encrypt 3.y</li>
- <li>Jackcess 2.x -> Jackcess Encrypt 2.y</li>
- <li>Jackcess 1.x -> Jackcess Encrypt 1.y</li>
- </ul>
- </subsection>
- </section>
-
- </body>
- </document>
|