CASL-1358: Extensions local testing #522

Marcin-Here · 2025-10-13T13:19:08Z

No description provided.

Signed-off-by: Marcin-Here <[email protected]>

rlakde · 2025-10-13T18:28:44Z

docs/drafts/EXTENSIONS_TESTING.md

+The Naksha Hub (REST Service) receives requests through API endpoints, processes them via internal synchronous pipeline by invoking pre-configured inbuilt / custom Event Handlers.
+When pipeline encounters custom handler, the respective EventHandler implementation is loaded from the cached copy of Extension. The Extensions are (un)cached dynamically (via background job) from the external Extension Registry (S3 bucket or local folder). The setup thus, allows flexibility in injecting the custom business logic as part of pipeline execution.
+
+![extensions_loading.png](../diagrams/extensions_loading.png))


Remove additional bracket ")"

rlakde · 2025-10-13T18:32:40Z

docs/latest/EXTENSIONS_TESTING.md

+1. **Prepare the config directory** as per the configuration instructions: [Naksha Service Configuration](../../README.md#configuration).
+2. **Start Naksha Service using the custom config**. For example, you can run:  
+```bash
+java -jar here-naksha-app-service/build/libs/naksha-app-service-*.jar extension-config


If you are not specifying the version of the jar then try to use same convention everywhere like Section#9 Intellij Debugging to avoid confusion

docs/latest/EXTENSIONS_TESTING.md

rlakde · 2025-10-13T18:34:58Z

docs/latest/EXTENSIONS_TESTING.md

+2025-09-24 15:30:48.455 -0500 [INFO ]  [NakshaWorker#2] - ext.test.handlers.TestHandler (processEvent:45) {streamId=3Yr6hZRsTSS9} - Handler received request WriteXyzFeatures 
+2025-09-24 15:30:48.465 -0500 [INFO ]  [NakshaWorker#2] - app.service.util.logging.AccessLogUtil (writeAccessLog:219) {streamId=3Yr6hZRsTSS9} - {"time":"2025-09-24T20:30:48,464","clientInfo":{"appId":"naksha","ip":"0:0:0:0:0:0:0:1","realm":null,"remoteAddress":"0:0:0:0:0:0:0:1:60076","userAgent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36","userId":"master-test-user"},"ms":37,"ns":37950490,"reqInfo":{"accept":"application/geo+json","contentType":"application/geo+json","method":"POST","origin":"http://localhost:8080","referer":"http://localhost:8080/hub/swagger/index.html","size":540,"uri":"/hub/spaces/test_space/features"},"respInfo":{"contentType":"application/geo+json","size":68,"statusCode":200,"statusMsg":"OK"},"src":null,"streamId":"3Yr6hZRsTSS9","streamInfo":{"spaceId":"test_space","timeInStorageMs":0},"t":"STREAM","timeWithoutStorageMs":37,"unixtime":1758745848464} 
+2025-09-24 15:30:48.465 -0500 [INFO ]  [NakshaWorker#2] - app.service.util.logging.AccessLogUtil (writeAccessLog:225) {streamId=3Yr6hZRsTSS9} - [REST API stats => spaceId,storageId,method,uri,status,timeTakenMs,resSize,timeWithoutStorageMs] - RESTAPIStats test_space - POST /hub/spaces/test_space/features 200 37 68 37 
+```


Can we have V3 specific logs here? Instead of copying it from V2 file.

rlakde · 2025-10-13T18:36:06Z

docs/drafts/EXTENSIONS_TESTING.md

+Use the following command to start the Naksha service with remote debugging enabled:
+
+```bash
+java -Xdebug -Xrunjdwp:server=y,transport=dt_socket,address=8888,suspend=y -jar naksha-2.2.12-all.jar extension-config


See my above comment related to jar version, Make sure to use same convention everywhere.

rlakde · 2025-10-13T18:36:43Z

docs/drafts/EXTENSIONS_TESTING.md

+
+- `-Xdebug` → Enables debugging.
+- `-Xrunjdwp:server=y,transport=dt_socket,address=8888,suspend=y` → Starts a remote debugging server on port `8888` and waits for the debugger to attach before running.
+- `-jar naksha-2.2.2-all.jar` → Specifies the Naksha service JAR to run.


See my above comment related to jar version, Make sure to use same convention everywhere.

rlakde · 2025-10-13T18:44:16Z

here-naksha-lib-ext-manager/src/jvmMain/java/com/here/naksha/lib/extmanager/ExtensionCache.java

                .getProperties()
                .getOr(WHITE_LIST_CLASSES, extensionConfig.getWhitelistDelegateClasses());
-        logger.info("Whitelist classes in use for extension {} are {}", extensionIdWthEnv, whitelistClasses);
+        logger.info("Whitelist classes in use for extension {} are {}", extensionIdWthEnv, whitelistClasses.toArray());


Do we need toArray() here? Will it work if we remove it?

I think we need for now. It will not work without it. When I looked into it seems that is problem with proxy model classes like StringList and AnyObject when working with logger. I will add ticket for it.

rlakde · 2025-10-13T18:49:44Z

here-naksha-lib-hub/src/jvmMain/java/com/here/naksha/lib/hub/NakshaHub.java

          extensionIds.add(extensionId);
        } else {
-          logger.error("Environment is missing for an extension Id");
+          logger.info("Environment is missing for an extension Id");


This needs to be an error.

Signed-off-by: Marcin-Here <[email protected]>

docs/latest/EXTENSIONS_TESTING.md

here-naksha-lib-hub/src/jvmMain/java/com/here/naksha/lib/hub/NakshaHubConfig.java

Signed-off-by: Marcin-Here <[email protected]>

* CASL-1358: Extensions local testing Signed-off-by: Marcin-Here <[email protected]> * CASL-1358: README corrections. Signed-off-by: Marcin-Here <[email protected]> * CASL-1358: moved README files to 'latest'. Signed-off-by: Marcin-Here <[email protected]> --------- Signed-off-by: Marcin-Here <[email protected]>

CASL-1358: Extensions local testing

5b5281f

Signed-off-by: Marcin-Here <[email protected]>

Marcin-Here requested review from Amaneusz, hirenkp2000 and rlakde October 13, 2025 13:49

rlakde reviewed Oct 13, 2025

View reviewed changes

docs/latest/EXTENSIONS_TESTING.md Show resolved Hide resolved

rlakde reviewed Oct 13, 2025

View reviewed changes

CASL-1358: README corrections.

99bba6c

Signed-off-by: Marcin-Here <[email protected]>

hirenkp2000 requested changes Oct 14, 2025

View reviewed changes

docs/latest/EXTENSIONS_TESTING.md Show resolved Hide resolved

docs/latest/EXTENSIONS_TESTING.md Show resolved Hide resolved

here-naksha-lib-hub/src/jvmMain/java/com/here/naksha/lib/hub/NakshaHubConfig.java Outdated Show resolved Hide resolved

CASL-1358: moved README files to 'latest'.

5aeccd7

Signed-off-by: Marcin-Here <[email protected]>

Marcin-Here requested review from hirenkp2000 and rlakde October 14, 2025 11:06

hirenkp2000 approved these changes Oct 16, 2025

View reviewed changes

rlakde approved these changes Oct 16, 2025

View reviewed changes

Marcin-Here merged commit 2d1493e into v3 Oct 16, 2025
3 of 4 checks passed

Marcin-Here deleted the CASL-1358_extensions_local_testing_to_v3 branch October 16, 2025 14:16

CASL-1358: Extensions local testing #522

CASL-1358: Extensions local testing #522

Uh oh!

Conversation

Marcin-Here commented Oct 13, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants