Browse Source
add details about 3.5 upgrade
git-svn-id: https://svn.code.sf.net/p/jackcess/code/jackcess/trunk@1331 f203690c-595d-4dc9-a70b-905162fa7fd2tags/jackcess-3.5.0
James Ahlborn
3 years ago
3 changed files with 66 additions and 5 deletions
+ 4
- 3
src/main/java/com/healthmarketscience/jackcess/DateTimeType.java
View File
| @@ -25,9 +25,10 @@ package com.healthmarketscience.jackcess; | |||
| */ | |||
| public enum DateTimeType | |||
| { | |||
| /** use legacy {@link java.util.Date} objects. To maintain backwards | |||
| compatibility, this is the default type. */ | |||
| /** Use legacy {@link java.util.Date} objects. This was the default for | |||
| Jackcess before version 3.5. */ | |||
| DATE, | |||
| /** use jdk8+ {@link java.time.LocalDateTime} objects */ | |||
| /** Use jdk8+ {@link java.time.LocalDateTime} objects. This is the default | |||
| for Jackcess from version 3.5 onwards. */ | |||
| LOCAL_DATE_TIME; | |||
| } | |||
+ 3
- 2
src/site/site.xml
View File
| @@ -15,6 +15,7 @@ | |||
| <item name="Downloads" href="https://sourceforge.net/project/showfiles.php?group_id=134943"/> | |||
| <item name="SourceForge Project" href="https://sourceforge.net/projects/jackcess/"/> | |||
| <item name="Cookbook" href="cookbook.html"/> | |||
| <item name="Upgrading to Jackcess 3.5.x" href="jackcess-3_5.html"/> | |||
| <item name="Upgrading to Jackcess 3.x" href="jackcess-3.html"/> | |||
| <item name="Upgrading to Jackcess 2.x" href="jackcess-2.html"/> | |||
| <item name="FAQ" href="faq.html"/> | |||
| @@ -34,9 +35,9 @@ | |||
| <gitHub> | |||
| <projectId>jahlborn/jackcess</projectId> | |||
| <ribbonOrientation>right</ribbonOrientation> | |||
| <ribbonColor>gray</ribbonColor> | |||
| <ribbonColor>gray</ribbonColor> | |||
| </gitHub> | |||
| </fluidoSkin> | |||
| </custom> | |||
| </project> | |||
+ 59
- 0
src/site/xdoc/jackcess-3_5.xml
View File
| @@ -0,0 +1,59 @@ | |||
| <?xml version="1.0"?> | |||
| <document> | |||
| <properties> | |||
| <author email="jahlborn@users.sf.net">James Ahlborn</author> | |||
| <title>Upgrading from Jackcess 2.x to 3.x</title> | |||
| </properties> | |||
| <body> | |||
| <section name="Jackcess 3.5"> | |||
| <subsection name="So what changed, now?"> | |||
| <p> | |||
| Jackcess 3.5 is binary compatible with previous 3.x versions. | |||
| However, a few default settings have changed which will change the | |||
| behavior of Jackcess out of the box. The old behavior is still | |||
| available, but you must now configure it explicitly. | |||
| <ul> | |||
| <li><b>DateTypeType default has been changed to | |||
| LOCAL_DATE_TIME.</b></li> | |||
| <ul> | |||
| <li>The Jackcess API was originally built using the Date type | |||
| for representing date/time values. However, Access databases | |||
| are inherently "local" time (they contain no timezone info). | |||
| The LocalDateTime type in jdk8+ is a more accurate value for | |||
| relaying Access date/time values. As of the 3.0 release, the | |||
| Jackcess API supported using <i>either</i> date/time type, | |||
| depending on the configured DateTimeType for the Database. | |||
| However, in order to maintain backwards compatibility, the | |||
| default was kept as DATE. As of the 3.5 release, the default is | |||
| now LOCAL_DATE_TIME. The legacy behavior is still available, | |||
| and can be enabled by configuring the DateTimeType appropriately | |||
| (either per Database or via system property).</li> | |||
| </ul> | |||
| <li><b>Expression evaluation is enabled by default.</b></li> | |||
| <ul> | |||
| <li>Optional expression evaluation was added back in the 2.2 | |||
| release, but left disabled as the implementation matured. The | |||
| support is mature enough now to enable this behavior by default. | |||
| Expression evaluation can still be disabled by configuring the | |||
| Database appropriately (either per Database or via system | |||
| property).</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. | |||
| The version 3.5 release maintains compatibility with the Jackcess | |||
| Encrypt 3.x releases. | |||
| </p> | |||
| </subsection> | |||
| </section> | |||
| </body> | |||
| </document> | |||
Loading…