From 921960da653fc4dd4983806c47d985ec1d7baa8c Mon Sep 17 00:00:00 2001 From: ryans Date: Tue, 14 May 2019 14:55:11 -0400 Subject: [PATCH] v3.2.0 --- build.xml | 2 +- doc/release-notes.html | 102 ++++++++++++------------- src/org/jlab/elog/Library.java | 132 ++++++++++++++++----------------- 3 files changed, 119 insertions(+), 117 deletions(-) diff --git a/build.xml b/build.xml index b6f1f14..e1790c9 100644 --- a/build.xml +++ b/build.xml @@ -27,7 +27,7 @@ -
eLog Client API Version 3.1.0
+
eLog Client API Version 3.2.0
Electronic Logbook Client API Overview diff --git a/doc/release-notes.html b/doc/release-notes.html index 4a446d9..0fa43a1 100644 --- a/doc/release-notes.html +++ b/doc/release-notes.html @@ -1,50 +1,52 @@ - - - - Java eloglib Release Notes - - - -

Java eloglib Release Notes

-

September 27, 2018 - Version 3.1.0

-

Default properties updated now that server requires SSL for schema. Server certificate checking is now a configurable option.

-

November 28, 2017 - Version 3.0.0

-

Upgraded to Java 7 platform (no longer support Java 6) - this fixed many issues related to Java 6 JVM.

-

September 16, 2014 - Version 2.9

-

Added support for problem reports: a tool for operations to record issues they - encounter in the elog. A log entry now has an optional problem report section.

-

March 15, 2013 - Version 2.8

-

This version fixes a bug in the Java elog Client API. When writing out the - XML either to a file for queuing or to an HTTP server via PUT, the Java IO stream - constructors assume platform character encoding. The character encoding is now - always UTF-8 as intended.

-

March 14, 2013 - Version 2.7

-

This version adds a new "addAttachment" overloaded method which allows - specification of a caption, but with auto-detection of mime-type. This is needed - for the elog command line interface project.

-

March 12, 2013 - Version 2.6

-

Added a new method named submitNow that takes an argument specifying a path - to a certificate file. There was already a method named SubmitNow, but it doesn't - take any arguments and just uses the default certificate path. I've also added - an additional example program named HelloWorldDemo and updated the docs to reflect - this. The reason for these two changes is someone from offsite is about to use - the API and we noticed there were deficiencies with the offsite scenario mostly - due to the fact that there is not going to be a queue directory available. The - example program we had originally is not good for offsite people because if - they don't setup their certificate correctly or invert the arguments to the - LogEntry constructor the exception generated is masked by the queue directory - not found exception until they code some try catches with whyQueued or switch - to the submitNow method. The HelloWorldDemo just uses submitNow and is good - for offsite users.

-

January 15, 2013 - Version 2.5

-

Fixed bug where accessing attachments from an existing XML file would fail - if the existing XML had spaces around the attachment tag. (Added check to DOM - traversal code to ensure node was an instance of Element instead of TextNode).

-

January 2, 2013 - Version 2.4

-

Updated default UNIX queue path configuration parameter in the elog.properties - file from "/u/group/elogbooks/logentryq/new" to "/group/elogbooks/logentryq/new".

-

October 12, 2012 - Version 2.3

-

This is the initial public release of the Java implementation of the Electronic - Logbooks API.

- - + + + + Java eloglib Release Notes + + + +

Java eloglib Release Notes

+

May 14, 2019 - Version 3.2.0

+

Forced schema validation disabled as it is unreliable over network and also unnecessary anyways.

+

September 27, 2018 - Version 3.1.0

+

Default properties updated now that server requires SSL for schema. Server certificate checking is now a configurable option.

+

November 28, 2017 - Version 3.0.0

+

Upgraded to Java 7 platform (no longer support Java 6) - this fixed many issues related to Java 6 JVM.

+

September 16, 2014 - Version 2.9

+

Added support for problem reports: a tool for operations to record issues they + encounter in the elog. A log entry now has an optional problem report section.

+

March 15, 2013 - Version 2.8

+

This version fixes a bug in the Java elog Client API. When writing out the + XML either to a file for queuing or to an HTTP server via PUT, the Java IO stream + constructors assume platform character encoding. The character encoding is now + always UTF-8 as intended.

+

March 14, 2013 - Version 2.7

+

This version adds a new "addAttachment" overloaded method which allows + specification of a caption, but with auto-detection of mime-type. This is needed + for the elog command line interface project.

+

March 12, 2013 - Version 2.6

+

Added a new method named submitNow that takes an argument specifying a path + to a certificate file. There was already a method named SubmitNow, but it doesn't + take any arguments and just uses the default certificate path. I've also added + an additional example program named HelloWorldDemo and updated the docs to reflect + this. The reason for these two changes is someone from offsite is about to use + the API and we noticed there were deficiencies with the offsite scenario mostly + due to the fact that there is not going to be a queue directory available. The + example program we had originally is not good for offsite people because if + they don't setup their certificate correctly or invert the arguments to the + LogEntry constructor the exception generated is masked by the queue directory + not found exception until they code some try catches with whyQueued or switch + to the submitNow method. The HelloWorldDemo just uses submitNow and is good + for offsite users.

+

January 15, 2013 - Version 2.5

+

Fixed bug where accessing attachments from an existing XML file would fail + if the existing XML had spaces around the attachment tag. (Added check to DOM + traversal code to ensure node was an instance of Element instead of TextNode).

+

January 2, 2013 - Version 2.4

+

Updated default UNIX queue path configuration parameter in the elog.properties + file from "/u/group/elogbooks/logentryq/new" to "/group/elogbooks/logentryq/new".

+

October 12, 2012 - Version 2.3

+

This is the initial public release of the Java implementation of the Electronic + Logbooks API.

+ + diff --git a/src/org/jlab/elog/Library.java b/src/org/jlab/elog/Library.java index 16f5400..720b724 100644 --- a/src/org/jlab/elog/Library.java +++ b/src/org/jlab/elog/Library.java @@ -1,66 +1,66 @@ -package org.jlab.elog; - -import java.io.IOException; -import java.io.InputStream; -import java.util.Properties; -import org.jlab.elog.exception.LogRuntimeException; - -/** - * Captures the jlog library global version and configuration information. - * The Overview page contains a list of all available configuration properties. - * - * @author ryans - */ -public final class Library { - - private static final String VERSION = "3.1.0"; - private static Properties configuration; - - static { - InputStream in = Library.class.getClassLoader().getResourceAsStream( - "org/jlab/elog/elog.properties"); - - configuration = new Properties(); - - try { - configuration.load(in); - } catch (IOException e) { - throw new LogRuntimeException("Unable to load properties.", e); - } - } - - private Library() { - // Can't instantiate publicly - } - - /** - * Get the configuration properties. - * - * @return The configuration - */ - public static Properties getConfiguration() { - return configuration; - } - - /** - * Set the configuration properties. - * - * @param configuration The configuration - */ - public static void setConfiguration(Properties configuration) { - Library.configuration = configuration; - } - - /** - * Returns the library version String. A programmaticaly accessible version - * String is a requirement of JLab accelerator software certification. - * - * The major version number corresponds to the API version. The minor - * version number corresponds to the implementation version. - * - * @return The version String - */ - public static String getVersion() { - return VERSION; - } -} +package org.jlab.elog; + +import java.io.IOException; +import java.io.InputStream; +import java.util.Properties; +import org.jlab.elog.exception.LogRuntimeException; + +/** + * Captures the jlog library global version and configuration information. + * The Overview page contains a list of all available configuration properties. + * + * @author ryans + */ +public final class Library { + + private static final String VERSION = "3.2.0"; + private static Properties configuration; + + static { + InputStream in = Library.class.getClassLoader().getResourceAsStream( + "org/jlab/elog/elog.properties"); + + configuration = new Properties(); + + try { + configuration.load(in); + } catch (IOException e) { + throw new LogRuntimeException("Unable to load properties.", e); + } + } + + private Library() { + // Can't instantiate publicly + } + + /** + * Get the configuration properties. + * + * @return The configuration + */ + public static Properties getConfiguration() { + return configuration; + } + + /** + * Set the configuration properties. + * + * @param configuration The configuration + */ + public static void setConfiguration(Properties configuration) { + Library.configuration = configuration; + } + + /** + * Returns the library version String. A programmaticaly accessible version + * String is a requirement of JLab accelerator software certification. + * + * The major version number corresponds to the API version. The minor + * version number corresponds to the implementation version. + * + * @return The version String + */ + public static String getVersion() { + return VERSION; + } +}