build: 1.0.0

ci/run_tests_pipeline.yaml

@@ -11,8 +11,36 @@ variables:
   QUESTDB_ILP_TCP_AUTH_ENABLE: false
 
 stages:
+  - stage: Validate
+    displayName: "Validation"
+    jobs:
+      - job: Javadoc
+        displayName: "Javadoc"
+        pool:
+          name: "Azure Pipelines"
+          vmImage: "ubuntu-latest"
+        steps:
+          - checkout: self
+            fetchDepth: 0
+            lfs: false
+            submodules: false
+          - bash: |
+              git fetch origin $(System.PullRequest.SourceBranch)
+              git checkout FETCH_HEAD
+            displayName: "Checkout PR source branch"
+            condition: eq(variables['Build.Reason'], 'PullRequest')
+          - task: JavaToolInstaller@0
+            displayName: "Install Java 11"
+            inputs:
+              versionSpec: "11"
+              jdkArchitectureOption: "x64"
+              jdkSourceOption: "PreInstalled"
+          - bash: mvn -f core/pom.xml javadoc:javadoc -Pjavadoc --batch-mode
+            displayName: "Verify Javadoc"
+
   - stage: BuildAndTest
     displayName: "Building and testing"
+    dependsOn: Validate
     jobs:
       - job: RunOn
         displayName: "on"

core/pom.xml

@@ -22,8 +22,7 @@
   ~
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~-->
 
-<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <name>QuestDB</name>
     <description>QuestDB is high performance SQL time series database</description>
@@ -39,7 +38,7 @@
         <test.include>%regex[.*[^o].class]</test.include><!-- exclude module-info.class-->
     </properties>
 
-    <version>1.0.0-SNAPSHOT</version>
+    <version>1.0.1-SNAPSHOT</version>
     <groupId>org.questdb</groupId>
     <artifactId>client</artifactId>
     <packaging>jar</packaging>
@@ -63,7 +62,7 @@
     <scm>
         <url>scm:git:https://github.com/questdb/java-questdb-client.git</url>
         <connection>scm:git:https://github.com/questdb/java-questdb-client.git</connection>
-        <tag>1.0.0</tag>
+        <tag>HEAD</tag>
     </scm>
 
 
@@ -166,7 +165,7 @@
                 <artifactId>maven-surefire-plugin</artifactId>
                 <version>3.5.3</version>
                 <configuration>
-                    <forkNode implementation="org.apache.maven.plugin.surefire.extensions.SurefireForkNodeFactory"/>
+                    <forkNode implementation="org.apache.maven.plugin.surefire.extensions.SurefireForkNodeFactory" />
                     <argLine>-Dslf4j.provider=ch.qos.logback.classic.spi.LogbackServiceProvider</argLine>
                     <useModulePath>true</useModulePath>
                     <includes>
@@ -198,12 +197,16 @@
                             </execution>
                         </executions>
                         <configuration>
+                            <doclint>none</doclint>
+                            <source>11</source>
+                            <detectJavaApiLink>false</detectJavaApiLink>
                             <additionalJOptions>
                                 <additionalJOption>${compilerArg1}</additionalJOption>
                                 <additionalJOption>${compilerArg2}</additionalJOption>
                             </additionalJOptions>
                             <sourceFileExcludes>
                                 <sourceFileExclude>${excludePattern1}</sourceFileExclude>
+                                <sourceFileExclude>module-info.java</sourceFileExclude>
                             </sourceFileExcludes>
                         </configuration>
                     </plugin>
@@ -292,12 +295,16 @@
                             </execution>
                         </executions>
                         <configuration>
+                            <doclint>none</doclint>
+                            <source>11</source>
+                            <detectJavaApiLink>false</detectJavaApiLink>
                             <additionalJOptions>
                                 <additionalJOption>${compilerArg1}</additionalJOption>
                                 <additionalJOption>${compilerArg2}</additionalJOption>
                             </additionalJOptions>
                             <sourceFileExcludes>
                                 <sourceFileExclude>${excludePattern1}</sourceFileExclude>
+                                <sourceFileExclude>module-info.java</sourceFileExclude>
                             </sourceFileExcludes>
                         </configuration>
                     </plugin>

core/src/main/java/io/questdb/client/ParanoiaState.java

@@ -28,11 +28,11 @@
 public class ParanoiaState {
     /**
      * <pre>
-     * BASIC -> validates UTF-8 in log records (throws a LogError if invalid),
+     * BASIC -&gt; validates UTF-8 in log records (throws a LogError if invalid),
      *          throws a LogError on abandoned log records (missing .$() at the end of log statement),
      *          detects closed stdout in LogConsoleWriter.
      *          This introduces a low overhead to logging.
-     * AGGRESSIVE -> BASIC + holds recent history of log lines to help diagnose closed stdout,
+     * AGGRESSIVE -&gt; BASIC + holds recent history of log lines to help diagnose closed stdout,
      *               holds the stack trace of abandoned log record.
      *               This introduces a significant overhead to logging.
      *

core/src/main/java/io/questdb/client/std/Decimal128.java

@@ -333,7 +333,7 @@ public static int compareTo(long aHigh, long aLow, int aScale, long bHigh, long
     }
 
     /**
-     * Divide two Decimal128 numbers and store the result in sink (a / b -> sink)
+     * Divide two Decimal128 numbers and store the result in sink (a / b {@code ->} sink)
      * Uses optimal precision calculation up to MAX_SCALE
      *
      * @param a            First operand (dividend)
@@ -477,7 +477,7 @@ public static boolean isNull(long hi, long lo) {
     }
 
     /**
-     * Calculate modulo of two Decimal128 numbers and store the result in sink (a % b -> sink)
+     * Calculate modulo of two Decimal128 numbers and store the result in sink (a % b {@code ->} sink)
      *
      * @param a    First operand (dividend)
      * @param b    Second operand (divisor)
@@ -526,7 +526,7 @@ public static void putNull(long addr) {
     }
 
     /**
-     * Subtract two Decimal128 numbers and store the result in sink (a - b -> sink)
+     * Subtract two Decimal128 numbers and store the result in sink (a - b {@code ->} sink)
      *
      * @param a    First operand (minuend)
      * @param b    Second operand (subtrahend)
@@ -1043,7 +1043,7 @@ public void ofZero() {
     /**
      * Rescale this Decimal128 in place
      *
-     * @param newScale The new scale (must be >= current scale)
+     * @param newScale The new scale (must be {@code >=} current scale)
      */
     public void rescale(int newScale) {
         validateScale(newScale);

core/src/main/java/io/questdb/client/std/Decimal256.java

@@ -1089,7 +1089,7 @@ public boolean equals(Object obj) {
      * Checks if this Decimal256 value fits within the specified storage size (pow 2).
      * The value fits if its absolute magnitude can be represented with the given number of digits.
      *
-     * @param size the target size (number of bytes available pow 2, e.g., 4 bytes -> 2)
+     * @param size the target size (number of bytes available pow 2, e.g., 4 bytes {@code ->} 2)
      * @return true if the value fits within the storage size, false otherwise
      */
     public boolean fitsInStorageSizePow2(int size) {
@@ -1615,7 +1615,7 @@ public void ofZero() {
     /**
      * Rescale this Decimal256 in place
      *
-     * @param newScale The new scale (must be >= current scale)
+     * @param newScale The new scale (must be {@code >=} current scale)
      */
     public void rescale(int newScale) {
         if (isNull()) {
@@ -2869,7 +2869,7 @@ private void multiplyByPowerOf10InPlace(int n) {
     /**
      * Rescale this Decimal256 in place without checks
      *
-     * @param newScale The new scale (must be >= current scale)
+     * @param newScale The new scale (must be {@code >=} current scale)
      */
     private void rescale0(int newScale) {
         int scaleDiff = newScale - this.scale;

core/src/main/java/io/questdb/client/std/Decimal64.java

@@ -112,7 +112,7 @@ public static void add(Decimal64 a, Decimal64 b, Decimal64 sink) {
     }
 
     /**
-     * Divide two Decimal64 numbers and store the result in sink (a / b -> sink)
+     * Divide two Decimal64 numbers and store the result in sink (a / b {@code ->} sink)
      */
     public static void divide(Decimal64 a, Decimal64 b, Decimal64 sink, int resultScale, RoundingMode roundingMode) {
         sink.copyFrom(a);
@@ -218,7 +218,7 @@ public static boolean isNull(long value) {
     }
 
     /**
-     * Calculate modulo of two Decimal64 numbers and store the result in sink (a % b -> sink)
+     * Calculate modulo of two Decimal64 numbers and store the result in sink (a % b {@code ->} sink)
      */
     public static void modulo(Decimal64 a, Decimal64 b, Decimal64 sink) {
         sink.copyFrom(a);
@@ -242,7 +242,7 @@ public static void negate(Decimal64 a, Decimal64 sink) {
     }
 
     /**
-     * Subtract two Decimal64 numbers and store the result in sink (a - b -> sink)
+     * Subtract two Decimal64 numbers and store the result in sink (a - b {@code ->} sink)
      */
     public static void subtract(Decimal64 a, Decimal64 b, Decimal64 sink) {
         sink.copyFrom(a);
@@ -704,7 +704,7 @@ public void ofZero() {
     /**
      * Rescale this Decimal64 in place
      *
-     * @param newScale The new scale (must be >= current scale)
+     * @param newScale The new scale (must be {@code >=} current scale)
      */
     public void rescale(int newScale) {
         validateScale(newScale);

examples/pom.xml

@@ -22,13 +22,12 @@
   ~
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~-->
 
-<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
 
     <groupId>org.questdb</groupId>
     <artifactId>client-examples</artifactId>
-    <version>1.0.0-SNAPSHOT</version>
+    <version>1.0.1-SNAPSHOT</version>
     <name>Examples for QuestDB</name>
 
     <dependencies>

pom.xml

@@ -22,11 +22,10 @@
   ~
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~-->
 
-<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
     <modelVersion>4.0.0</modelVersion>
 
-    <version>1.0.0-SNAPSHOT</version>
+    <version>1.0.1-SNAPSHOT</version>
     <groupId>org.questdb</groupId>
     <artifactId>client-parent</artifactId>
     <packaging>pom</packaging>
@@ -36,7 +35,7 @@
         <connection>scm:git:https://github.com/questdb/java-questdb-client.git</connection>
         <developerConnection>scm:git:https://github.com/questdb/java-questdb-client.git</developerConnection>
         <url>https://github.com/questdb/java-questdb-client</url>
-        <tag>1.0.0</tag>
+        <tag>HEAD</tag>
     </scm>
 
     <build>