<author email="javajedi@users.sf.net">Tim McCune</author>
</properties>
<body>
+ <release version="4.0.2" date="TBD">
+ <action dev="jahlborn" type="update">
+ Add Table methods to access the creation and last modified dates.
+ </action>
+ </release>
<release version="4.0.1" date="2021-06-21">
<action dev="jahlborn" type="fix">
Ignore trailing spaces when creating text index entries.
package com.healthmarketscience.jackcess;
import java.io.IOException;
+import java.time.LocalDateTime;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
*/
public PropertyMap getProperties() throws IOException;
+ /**
+ * @return the created date for this table if available
+ * @usage _general_method_
+ */
+ public LocalDateTime getCreatedDate() throws IOException;
+
+ /**
+ * Note: jackcess <i>does not automatically update the modified date of a
+ * Table</i>.
+ *
+ * @return the last updated date for this table if available
+ * @usage _general_method_
+ */
+ public LocalDateTime getUpdatedDate() throws IOException;
+
/**
* @return All of the Indexes on this table (unmodifiable List)
* @usage _intermediate_method_
return dtc.getDateTimeFactory().toDateDouble(value, dtc);
}
- private static LocalDateTime toLocalDateTime(
+ static LocalDateTime toLocalDateTime(
Object value, DateTimeContext dtc) {
if(value instanceof TemporalAccessor) {
return temporalToLocalDateTime((TemporalAccessor)value, dtc);
import java.nio.file.Path;
import java.nio.file.StandardOpenOption;
import java.text.SimpleDateFormat;
+import java.time.LocalDateTime;
import java.time.ZoneId;
import java.util.ArrayList;
import java.util.Arrays;
/** the columns to read when getting object propertyes */
private static Collection<String> SYSTEM_CATALOG_PROPS_COLUMNS =
new HashSet<String>(Arrays.asList(CAT_COL_ID, CAT_COL_PROPS));
+ /** the columns to read when grabbing dates */
+ private static Collection<String> SYSTEM_CATALOG_DATE_COLUMNS =
+ new HashSet<String>(Arrays.asList(CAT_COL_ID,
+ CAT_COL_DATE_CREATE, CAT_COL_DATE_UPDATE));
/** regex matching characters which are invalid in identifier names */
private static final Pattern INVALID_IDENTIFIER_CHARS =
objectId, SYSTEM_CATALOG_PROPS_COLUMNS), owner);
}
+ LocalDateTime getCreateDateForObject(int objectId) throws IOException {
+ return getDateForObject(objectId, CAT_COL_DATE_CREATE);
+ }
+
+ LocalDateTime getUpdateDateForObject(int objectId) throws IOException {
+ return getDateForObject(objectId, CAT_COL_DATE_UPDATE);
+ }
+
+ private LocalDateTime getDateForObject(int objectId, String dateCol)
+ throws IOException {
+ Row row = _tableFinder.getObjectRow(objectId, SYSTEM_CATALOG_DATE_COLUMNS);
+ if(row == null) {
+ return null;
+ }
+ Object date = row.get(dateCol);
+ return ((date != null) ? ColumnImpl.toLocalDateTime(date, this) : null);
+ }
+
private Integer getDbParentId() throws IOException {
if(_dbParentId == null) {
// need the parent id of the databases objects
import java.nio.BufferOverflowException;
import java.nio.ByteBuffer;
import java.nio.charset.Charset;
+import java.time.LocalDateTime;
import java.util.AbstractMap;
import java.util.ArrayList;
import java.util.Arrays;
return _props;
}
+ @Override
+ public LocalDateTime getCreatedDate() throws IOException {
+ return getDatabase().getCreateDateForObject(_tableDefPageNumber);
+ }
+
+ @Override
+ public LocalDateTime getUpdatedDate() throws IOException {
+ return getDatabase().getUpdateDateForObject(_tableDefPageNumber);
+ }
+
/**
* @return all PropertyMaps for this table (and columns)
* @usage _advanced_method_
}
}
+ public void testTableDates() throws Exception {
+ for (final TestDB testDB : SUPPORTED_DBS_TEST_FOR_READ) {
+ Table table = open(testDB).getTable("Table1");
+ String expectedCreateDate = null;
+ String expectedUpdateDate = null;
+ if(testDB.getExpectedFileFormat() == FileFormat.V1997) {
+ expectedCreateDate = "2010-03-05T14:48:26.420";
+ expectedUpdateDate = "2010-03-05T14:48:26.607";
+ } else {
+ expectedCreateDate = "2004-05-28T17:51:48.701";
+ expectedUpdateDate = "2006-07-24T09:56:19.701";
+ }
+ System.out.println("FOO " + testDB.getExpectedFileFormat() + " " +
+ table.getCreatedDate() + " " +
+ table.getUpdatedDate());
+ assertEquals(expectedCreateDate, table.getCreatedDate().toString());
+ assertEquals(expectedUpdateDate, table.getUpdatedDate().toString());
+ }
+ }
private static void checkRawValue(String expected, Object val)
{
if(expected != null) {