Added @SInCE annotations for new stats methods and updated CHANGELOG

Author: gmfeinberg

CHANGELOG.md

@@ -11,7 +11,16 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/).
 ### Added
 - Added client statistics. Users can enable internal driver statistics by
 using system property -Dcom.oracle.nosql.sdk.nosqldriver.stats.profile=
-[none|regular|more|all] or by using the NoSQLConfig.setStatsProfile() api.
+[none|regular|more|all] or by using the NoSQLHandleConfig.setStatsProfile() api.
+- Added StatsControl interface as well as methods to control stats in
+NoSQLHandleConfig and NoSQLHandle.
+- Added to NoSQLHandleConfig:
+ - get/setStatsInterval
+ - get/setStatsProfile
+ - get/setStatsPrettyPrint
+ - getStatsHandler
+- Added to NoSQLHandle:
+ - getStatsControl
 
 ## [5.2.29] 2021-11-18
 

driver/src/main/java/oracle/nosql/driver/NoSQLHandle.java

@@ -575,6 +575,8 @@ public SystemResult doSystemRequest(String statement,
      * Returns an object that allows control over how statistics are collected.
      *
      * @return the StatsControl object
+     *
+     * @since 5.2.30
      */
     public StatsControl getStatsControl();
 

driver/src/main/java/oracle/nosql/driver/NoSQLHandleConfig.java

@@ -1211,6 +1211,8 @@ public SslContext getSslContext() {
      *
      * @param statsInterval stats logging interval in seconds
      * @return this
+     *
+     * @since 5.2.30
      */
     public NoSQLHandleConfig setStatsInterval(int statsInterval) {
         if (statsInterval < 1) {
@@ -1226,6 +1228,8 @@ public NoSQLHandleConfig setStatsInterval(int statsInterval) {
      * Default interval is 600 seconds, i.e. 10 min.
      *
      * @return the current interval in seconds
+     *
+     * @since 5.2.30
      */
     public int getStatsInterval() {
         return this.statsInterval;
@@ -1237,6 +1241,8 @@ public int getStatsInterval() {
      *
      * @param statsProfile profile to use
      * @return this
+     *
+     * @since 5.2.30
      */
     public NoSQLHandleConfig setStatsProfile(StatsControl.Profile statsProfile)
     {
@@ -1249,6 +1255,8 @@ public NoSQLHandleConfig setStatsProfile(StatsControl.Profile statsProfile)
      * Default profile is NONE.
      *
      * @return the current profile
+     *
+     * @since 5.2.30
      */
     public StatsControl.Profile getStatsProfile() {
         return this.statsProfile;
@@ -1261,6 +1269,8 @@ public StatsControl.Profile getStatsProfile() {
      *
      * @param statsPrettyPrint flag to enable JSON pretty print
      * @return this
+     *
+     * @since 5.2.30
      */
     public NoSQLHandleConfig setStatsPrettyPrint(boolean statsPrettyPrint) {
         this.statsPrettyPrint = statsPrettyPrint;
@@ -1272,6 +1282,8 @@ public NoSQLHandleConfig setStatsPrettyPrint(boolean statsPrettyPrint) {
      * Default is disabled.
      *
      * @return the current JSON pretty print flag
+     *
+     * @since 5.2.30
      */
     public boolean getStatsPrettyPrint() {
         return this.statsPrettyPrint;
@@ -1283,6 +1295,8 @@ public boolean getStatsPrettyPrint() {
      * @param statsHandler User defined StatsHandler.
      *
      * @return this
+     *
+     * @since 5.2.30
      */
     public NoSQLHandleConfig setStatsHandler(
         StatsControl.StatsHandler statsHandler) {
@@ -1294,6 +1308,8 @@ public NoSQLHandleConfig setStatsHandler(
      * Returns the registered statistics handler, otherwise null.
      *
      * @return this
+     *
+     * @since 5.2.30
      */
     public StatsControl.StatsHandler getStatsHandler() {
         return this.statsHandler;

driver/src/main/java/oracle/nosql/driver/StatsControl.java

@@ -82,6 +82,8 @@
  *
  * For a detailed statistics log entries structure and values see
  * {@link oracle.nosql.driver}</p>
+ *
+ * @since 5.2.30
  */
 public interface StatsControl {