0.15.1

Author: greenrobot

CHANGELOG.md

@@ -1,6 +1,16 @@
 ObjectBox C and C++ API Changelog
 =================================
 
+0.15.1 (2022-01-25)
+-------------------
+* Fix non-unique indexes triggering unique constraint violations in corner cases (introduced in 0.15.0)
+* Minor performance improvements with hashed indexes
+* Admin UI now supports multiple sessions to the same host using different ports (session ID via HTTP request)
+
+### Sync
+
+* Performance improvements for compression and decompression
+
 0.15.0 (2021-12-09)
 -------------------
 * New "Flex" data type that can contain data of various types like integers, floating points, strings, lists and maps 

CMakeLists.txt

@@ -31,7 +31,7 @@ else ()
 
     function(defineObjectBoxLib VARIANT)
         # Configuration updated for each release
-        set(DL_VERSION 0.15.0)
+        set(DL_VERSION 0.15.1)
 
         # Platform detection and other setup
         set(DL_URL https://github.com/objectbox/objectbox-c/releases/download)

README.md

@@ -14,7 +14,7 @@ box.put({.text = "Buy milk"});
 
 See [ObjectBox C and C++ docs](https://cpp.objectbox.io/) for API details.  
 
-**Latest version: 0.15.0** (2021-12-09).
+**Latest version: 0.15.1** (2022-01-26).
 See [changelog](CHANGELOG.md) for more details.
 
 Feature Highlights

download.sh

@@ -44,7 +44,7 @@ tty -s || quiet=true
 
 # Note: optional arguments like "--quiet" shifts argument positions in the case block above
 
-version=${1:-0.15.0}
+version=${1:-0.15.1}
 os=${2:-$(uname)}
 arch=${3:-$(uname -m)}
 echo "Base config: OS ${os} and architecture ${arch}"

doxygen/Changelog.md

@@ -3,6 +3,16 @@
 ObjectBox C and C++ API Changelog
 =================================
 
+0.15.1 (2022-01-25)
+-------------------
+* Fix non-unique indexes triggering unique constraint violations in corner cases (introduced in 0.15.0)
+* Minor performance improvements with hashed indexes
+* Admin UI now supports multiple sessions to the same host using different ports (session ID via HTTP request)
+
+### Sync
+
+* Performance improvements for compression and decompression
+
 0.15.0 (2021-12-09)
 -------------------
 * New "Flex" data type that can contain data of various types like integers, floating points, strings, lists and maps 

doxygen/Doxyfile

@@ -38,7 +38,7 @@ PROJECT_NAME           = "ObjectBox C and C++ API"
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         = "0.15.0"
+PROJECT_NUMBER         = "0.15.1"
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer a

include/objectbox-sync.h

@@ -34,7 +34,7 @@
 #include "objectbox.h"
 
 #if defined(static_assert) || defined(__cplusplus)
-static_assert(OBX_VERSION_MAJOR == 0 && OBX_VERSION_MINOR == 15 && OBX_VERSION_PATCH == 0,
+static_assert(OBX_VERSION_MAJOR == 0 && OBX_VERSION_MINOR == 15 && OBX_VERSION_PATCH == 1,
               "Versions of objectbox.h and objectbox-sync.h files do not match, please update");
 #endif
 
@@ -318,7 +318,7 @@ typedef struct OBX_sync_server OBX_sync_server;
 ///       E.g. a client with an incompatible model will be rejected during login.
 /// @param store_options Options for the server's store.
 ///        It is freed automatically (same as with obx_store_open()) - don't use or free it afterwards.
-/// @param uri The URI (following the pattern protocol:://IP:port) the server should listen on.
+/// @param uri The URI (following the pattern "protocol://IP:port") the server should listen on.
 ///        Supported \b protocols are "ws" (WebSockets) and "wss" (secure WebSockets).
 ///        To use the latter ("wss"), you must also call obx_sync_server_certificate_path().
 ///        To bind to all available \b interfaces, including those that are available from the "outside", use 0.0.0.0 as
@@ -383,7 +383,12 @@ OBX_C_API uint64_t obx_sync_server_connections(OBX_sync_server* server);
 /// The returned char* is valid until another call to obx_sync_server_stats_string() or the server is closed.
 OBX_C_API const char* obx_sync_server_stats_string(OBX_sync_server* server, bool include_zero_values);
 
-// TODO admin UI ("browser")
+/// Configure admin with a sync server, attaching the store and enabling custom sync-server functionality in the UI.
+/// This is a replacement for obx_admin_opt_store() and obx_admin_opt_store_path() - don't set them for the server.
+/// After configuring, this acts as obx_admin() - see for more details.
+/// You must use obx_admin_close() to stop & free resources after you're done; obx_sync_server_stop() doesn't do that.
+/// @param options configuration set up with obx_admin_opt_*. You can pass NULL to use the default options.
+OBX_C_API OBX_admin* obx_sync_server_admin(OBX_sync_server* server, OBX_admin_options* options);
 
 #ifdef __cplusplus
 }

include/objectbox-sync.hpp

@@ -19,7 +19,7 @@
 #include "objectbox-sync.h"
 #include "objectbox.hpp"
 
-static_assert(OBX_VERSION_MAJOR == 0 && OBX_VERSION_MINOR == 15 && OBX_VERSION_PATCH == 0,
+static_assert(OBX_VERSION_MAJOR == 0 && OBX_VERSION_MINOR == 15 && OBX_VERSION_PATCH == 1,
               "Versions of objectbox.h and objectbox-sync.hpp files do not match, please update");
 
 static_assert(sizeof(obx_id) == sizeof(OBX_id_array::ids[0]),
@@ -153,7 +153,7 @@ class SyncClientListener : public SyncClientLoginListener,
 
 class SyncObjectsMessageListener {
 public:
-    /// TODO do we want to transform to a more c++ friendly representation, like in other listeners?
+    // TODO do we want to transform to a more c++ friendly representation, like in other listeners?
     virtual void received(const OBX_sync_msg_objects* cObjects) noexcept = 0;
 };
 

include/objectbox.h

@@ -1,5 +1,5 @@
 /*
- * Copyright 2018-2021 ObjectBox Ltd. All rights reserved.
+ * Copyright 2018-2022 ObjectBox Ltd. All rights reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -51,7 +51,7 @@ extern "C" {
 /// obx_version() or obx_version_is_at_least().
 #define OBX_VERSION_MAJOR 0
 #define OBX_VERSION_MINOR 15
-#define OBX_VERSION_PATCH 0  // values >= 100 are reserved for dev releases leading to the next minor/major increase
+#define OBX_VERSION_PATCH 1  // values >= 100 are reserved for dev releases leading to the next minor/major increase
 
 //----------------------------------------------
 // Common types
@@ -692,7 +692,9 @@ OBX_C_API OBX_store* obx_store_open(OBX_store_options* opt);
 /// Check if an open store was found for the given path (i.e. opened before and not yet closed).
 OBX_C_API bool obx_store_is_open(const char* path);
 
-/// Get a store previously opened with createShared() matching the given path of the DB directory.
+/// Attach to a previously opened store matching the path of the DB directory, which was used for opening the store.
+/// The returned store is a new instance (e.g. different pointer value) with its own lifetime and must also be closed.
+/// The actual underlying store is only closed when the last store OBX_store instance is closed.
 /// @returns nullptr if no open store was found (i.e. not opened before or already closed)
 OBX_C_API OBX_store* obx_store_attach(const char* path);
 
@@ -1829,7 +1831,7 @@ typedef struct OBX_admin OBX_admin;
 
 /// Initialize the http-server with the given options.
 /// Note: the given options are always freed by this function, including when an error occurs.
-/// @param opt required parameter holding the options (see obx_admin_opt_*())
+/// @param options required parameter holding the options (see obx_admin_opt_*())
 /// @returns NULL if the operation failed, see functions like obx_last_error_code() to get error details
 OBX_C_API OBX_admin* obx_admin(OBX_admin_options* options);
 

include/objectbox.hpp

@@ -25,7 +25,7 @@
 #include <optional>
 #endif
 
-static_assert(OBX_VERSION_MAJOR == 0 && OBX_VERSION_MINOR == 15 && OBX_VERSION_PATCH == 0,
+static_assert(OBX_VERSION_MAJOR == 0 && OBX_VERSION_MINOR == 15 && OBX_VERSION_PATCH == 1,
               "Versions of objectbox.h and objectbox.hpp files do not match, please update");
 
 static_assert(sizeof(obx_id) == sizeof(OBX_id_array::ids[0]),