From 7295b4877fb1bc279f9932ab026d68133695647a Mon Sep 17 00:00:00 2001 From: Marco Del Tufo <marco.deltufo@exact-lab.it> Date: Tue, 1 Aug 2023 10:02:08 +0000 Subject: [PATCH] Update as-api-listener.md --- .../server-side-extensions/as-api-listener.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/software-developer-documentation/server-side-extensions/as-api-listener.md b/docs/software-developer-documentation/server-side-extensions/as-api-listener.md index 0c66bc7154a..7fc6a014237 100644 --- a/docs/software-developer-documentation/server-side-extensions/as-api-listener.md +++ b/docs/software-developer-documentation/server-side-extensions/as-api-listener.md @@ -58,7 +58,10 @@ is provided with the V3 API jar and provides 3 methods: session token used for the operation, the operation result and any exception that happened during the operation. - + +| :warning: Implicit Requirements | +|:---------------------------| +| **Requirement 1: Â The Listener should be Thread Safe Code**<br /><br />A single instance of the Listener is created during the server startup.<br /><br />Since a single instance is used to serve all requests thread safe code is a requirement.<br /><br />We strongly suggest to not to keep any state.<br /><br />**Requirement 2: The Listener should not throw Exceptions**<br /><br />If the listener throw an exception it will make the API call fail.<br /><br />**Requirement 3: The Listener should use IOperation and IOperationResult as indicated below**<br /><br />All API Operations go through every listener so the method signatures should use IOperation and IOperationResult.<br /><br />Please use instanceof for safe casting. | Implicit Requirements -- GitLab