Sockets » History » Revision 2
Revision 1 (Denis Kildishev, 08/24/2022 08:50 PM) → Revision 2/3 (Denis Kildishev, 08/24/2022 08:50 PM)
h1. Web Sockets
Now requality starts several web sockets for different editors. Current mapping is
markup editor: 9920
Requirements editor1 (unieditor): 9921
Report view (reportView): 9922;
Requirements editor2 (moduleeditor): 9923
Requirements editor1 (review, in read-only mode): 9924
Web sockets uses JSON in messages.
Common format of client-server request includes
{"operation":"{op}", "location":"{loc}","session":"{sess}"}
where {op} is the name of operation(for ex. "init"),
{loc} is uri like http://localhost:9807/SMiqI3pGjPql/documents/stpo::6bc8a38f-45ba-4c82-bba8-db0c74e06125//?inTool=1&port=9920&document=6bc8a38f-45ba-4c82-bba8-db0c74e06125&session=4741003328181833534&
{sess} is generated session identification, for ex. 4741003328181833534
Requests may also include more parameters like, for example, init uses parameter "document",
like "document":"6bc8a38f-45ba-4c82-bba8-db0c74e06125"
Each new connection to server requires first call of init operation.
As an full example may be
{"operation":"init", "location":"http://localhost:9807/SMiqI3pGjPql/documents/stpo::6bc8a38f-45ba-4c82-bba8-db0c74e06125//?inTool=1&port=9920&document=6bc8a38f-45ba-4c82-bba8-db0c74e06125&session=4741003328181833534&","session":"4741003328181833534", "document":"6bc8a38f-45ba-4c82-bba8-db0c74e06125"}
or for one more editor
{"operation":"init", "location":"http://localhost:9807/r4AV8F78228D/reports/stpo::33cfa331-7d99-47e3-9c4a-0455df4101b5/jetos-reqs.stpo2.html?inTool=1&port=9922&document=33cfa331-7d99-47e3-9c4a-0455df4101b5&session=8974468582254662369&","session":"8974468582254662369", "document":"33cfa331-7d99-47e3-9c4a-0455df4101b5"}
Server-client messages are mostly formed as follows:
{"operation":"{op}", "data":{data}}
where op is the name of operation(for example, update of selection listed below)
and {data} is an json object storing all passed data according to operation kind
for example,
{"data":{"nextId":"011","requirementId":"Requirements","requirementUUID":"4e24f8a1-22b8-40b7-b406-01acc4d89d52"},"operation":"updateSelection"}
h1. Resources provider
Resources(and editors) are available at port 9807. URI is formed mostly according to given template:
http://{ip}:9807/{appSessId}/{editor}/{project}::{nodeUUId}/{resPath}?{params}
where ip is ip address of server(commonly localhost)
appSessId - randomly generated on app start string
editor - one of set{markup,unieditor,reportView,moduleeditor,review}
project - name of project
nodeUUId - id of node where editor needs to be openned
resPath - path to resources. For documents resources(markup) were provided from corresponding document. Default path points at document xhtml file. If uri points at resource like /image.png it will be taken from corresponding resources folder of node. But if some commonly used resource like jquery is requested then it will be loaded from plugin folder jstools(used to load ckeditor and jquery and so on).
params - set of additional parameters passed to script. For example, ?inTool=1&port=9922&document=33cfa331-7d99-47e3-9c4a-0455df4101b5&session=8974468582254662369& - port is socket port, document - uuid of node and session is session identification, isTool - param used to determine if editor was started from eclipse
As example can be URL for markup
http://localhost:9807/r4AV8F78228D/reports/stpo::33cfa331-7d99-47e3-9c4a-0455df4101b5/jetos-reqs.stpo2.html?inTool=1&port=9922&document=33cfa331-7d99-47e3-9c4a-0455df4101b5&session=8974468582254662369&