This is an automated email from the ASF dual-hosted git repository. struberg pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/openjpa.git
commit 14263ca52d858e9fd29c1e508f2cd0a2ec50e8ca Author: Mark Struberg <[email protected]> AuthorDate: Tue Apr 2 22:53:17 2019 +0200 OPENJPA-2775 improve JavaDoc for sub-second fractions --- .../main/java/org/apache/openjpa/jdbc/sql/DBDictionary.java | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/openjpa-jdbc/src/main/java/org/apache/openjpa/jdbc/sql/DBDictionary.java b/openjpa-jdbc/src/main/java/org/apache/openjpa/jdbc/sql/DBDictionary.java index 0767fd6..ff72cd5 100644 --- a/openjpa-jdbc/src/main/java/org/apache/openjpa/jdbc/sql/DBDictionary.java +++ b/openjpa-jdbc/src/main/java/org/apache/openjpa/jdbc/sql/DBDictionary.java @@ -438,7 +438,9 @@ public class DBDictionary protected final Set<String> fixedSizeTypeNameSet = new HashSet<>(); /** - * set of types that only accept a single precision... + * set of types that might have an optional fraction (sub-second) part. + * @{code @Column(scale=-1)} sets the fraction to zero. + * @{code @Column(scale=0)} will use the default behaviour (no fraction information generated) */ public final Set<String> fractionalTypeNameSet = new HashSet<>(); @@ -446,8 +448,8 @@ public class DBDictionary * Default amount of digits for fractional Types. * This is not supported/required by every database. * - * This value is only being used if no explicit {@code @Column(scale=n)} is set. - * Use {@code @Column(scale=-1)} to disable the scale + * This value is only being used if no explicit {@code @Column(scale=n)} is set or n is zero. + * Use {@code @Column(scale=-1)} to disable the explicit fraction part in the SQL generator. * @see #fractionalTypeNameSet * @see #getFractionLength(Column, String) */ @@ -2023,7 +2025,7 @@ public class DBDictionary } /** - * Only get's used if no explicit scale is used. + * Only get's used if no explicit scale is used (@{code @Column(scale=0)} which is the default). * Attention! @{code @Column(scale=-1)} disables the scale of a column * @return the fraction length of types which have a fraction * @see #fractionalTypeNameSet
