sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From desruisse...@apache.org
Subject svn commit: r1552055 - /sis/site/trunk/content/branches.mdtext
Date Wed, 18 Dec 2013 18:42:38 GMT
Author: desruisseaux
Date: Wed Dec 18 18:42:37 2013
New Revision: 1552055

URL: http://svn.apache.org/r1552055
Log:
Reworded the sentence in order to put behavioral difference in the first sentence, and added
a point about aliases lost at (un)marshalling on the JDK6 branch.

Modified:
    sis/site/trunk/content/branches.mdtext

Modified: sis/site/trunk/content/branches.mdtext
URL: http://svn.apache.org/viewvc/sis/site/trunk/content/branches.mdtext?rev=1552055&r1=1552054&r2=1552055&view=diff
==============================================================================
--- sis/site/trunk/content/branches.mdtext [UTF-8] (original)
+++ sis/site/trunk/content/branches.mdtext [UTF-8] Wed Dec 18 18:42:37 2013
@@ -64,6 +64,7 @@ for building and running on a JDK6 platf
   * _Multi-catches_ replaced by an explicit sequences of _catch_ statements.
   * _Diamond operators_ replaced by explicit generic types.
   * _Suppressed exceptions_ removed.
+  * Exception types introduced after JDK6 (e.g. `java.util.IllformedLocaleException`) replaced
by their nearest parent (may be `RuntimeException`).
   * Imports of `java.util.Objects` replaced by imports of `org.apache.sis.internal.util.Objects`.
   * Other JDK7-specific features resolved on a case-by-case basis.
 
@@ -86,22 +87,25 @@ Behavioral differences between the branc
 ==========================================================
 
 Some JDK7-specific features are reproduced on the JDK6 branch in an approximative way,
-which may cause some differences in the behavior:
-
-  * JDK7 branch creates `java.util.Locale` instances using `Locale.Builder` inner class while
the JDK6 branch
-    uses the `Locale` constructor. Since the former performs more rigorous syntax checks
than the later,
-    some language strings accepted by the JDK6 branch may be rejected by the JDK7 branch.
For example the
-    "`en_US_WIN`" string will be rejected on the JDK7 branch because "`WIN`" is not a valid
locale variant.
-
-  * Some exception types do not exist on the JDK6 branch, for instance `java.util.IllformedLocaleException`.
-    The JDK6 branch replaces those types by their nearest parent, which may be `java.lang.RuntimeException`.
-
-  * Some verbose _multi-catches_ are replaced by a single catch of a broad type like `Exception`.
-    Consequently some exceptions that would be propagated on the JDK7 branch are caught on
the JDK6 branch.
-    Since such propagated exceptions are expected to be bugs, the broad exception handling
on JDK6 branch
+which may cause some differences in application behavior (ignoring differences in performance).
+Most differences are about the JDK7 branch being slightly stricter than the JDK6 branch is,
+or being able to handle information that are unsupported on the JDK6 branch.
+
+  * Invalid language strings accepted by the JDK6 branch may be rejected by the JDK7 branch,
for example "`en_US_WIN`".
+    Conversely the JDK7 branch accepts IETF BCP 47 language tag strings (for example "`en-US-x-lvariant-POSIX`")
while
+    the JDK6 branch does not. This is because the JDK7 branch creates `java.util.Locale`
instances using `Locale.Builder`
+    while the JDK6 branch uses `Locale` constructor, and the former performs more rigorous
syntax checks than the later.
+    In the above example, "`WIN`" is not a valid locale variant.
+
+  * Some exceptions that would be propagated on the JDK7 branch are caught on the JDK6 branch.
+    This is because some verbose _multi-catches_ are replaced by a single catch of a broad
type like `Exception`.
+    Since uncaught exceptions on JDK7 branch were expected to be bugs, the broad exception
handling on JDK6 branch
     may make some potential SIS bugs slightly more difficult to identify.
 
-Generally speaking, the JDK7 branch is slightly stricter than the JDK6 branch is.
+  * When (un)marshalling instances of `org.apache.sis.referencing.AbstractIdentifiedObject`,
+    aliases are lost on the JDK6 branch while they are property (un)marshalled on the JDK7
branch.
+    This is because of an issue with the JAXB implementation bundled in JDK6.
+
 Regarding all above points, the trunk is identical to the JDK6 branch.
 
 



Mime
View raw message