Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
RWebWindowWSHandler.hxx
Go to the documentation of this file.
1// Author: Sergey Linev <s.linev@gsi.de>
2// Date: 2018-08-20
3// Warning: This is part of the ROOT 7 prototype! It will change without notice. It might trigger earthquakes. Feedback is welcome!
4
5/*************************************************************************
6 * Copyright (C) 1995-2019, Rene Brun and Fons Rademakers. *
7 * All rights reserved. *
8 * *
9 * For the licensing terms see $ROOTSYS/LICENSE. *
10 * For the list of contributors see $ROOTSYS/README/CREDITS. *
11 *************************************************************************/
12
13#ifndef ROOT7_RWebWindowWSHandler
14#define ROOT7_RWebWindowWSHandler
15
16#include "THttpWSHandler.h"
17#include "TEnv.h"
18#include "TUrl.h"
19
20#include <ROOT/RWebWindow.hxx>
21
22#include <string>
23
24using namespace std::string_literals;
25
26namespace ROOT {
27
28/// just wrapper to deliver websockets call-backs to the RWebWindow class
29
31
32protected:
33 Bool_t ProcessBatchHolder(std::shared_ptr<THttpCallArg> &arg) override
34 {
36 }
37
38 void VerifyDefaultPageContent(std::shared_ptr<THttpCallArg> &arg) override
39 {
40 auto token = fWindow.GetConnToken();
41 if (!token.empty()) {
42 TUrl url;
43 url.SetOptions(arg->GetQuery());
44 // refuse connection which does not provide proper token
45 if (!url.HasOption("token") || (token != url.GetValueFromOptions("token"))) {
46 // refuce loading of default web page without token
47 arg->SetContent("refused");
48 arg->Set404();
49 return;
50 }
51 }
52
53 auto version = fWindow.GetClientVersion();
54 if (!version.empty()) {
55 // replace link to JSROOT modules in import statements emulating new version for browser
56 std::string search = "from './jsrootsys/"s;
57 std::string replace = "from './"s + version + "/jsrootsys/"s;
58 arg->ReplaceAllinContent(search, replace);
59 // replace link to ROOT ui5 modules in import statements emulating new version for browser
60 search = "from './rootui5sys/"s;
61 replace = "from './"s + version + "/rootui5sys/"s;
62 arg->ReplaceAllinContent(search, replace);
63 // replace link on old JSRoot.core.js script - if still appears
64 search = "jsrootsys/scripts/JSRoot.core."s;
65 replace = version + "/jsrootsys/scripts/JSRoot.core."s;
66 arg->ReplaceAllinContent(search, replace, true);
67 arg->AddNoCacheHeader();
68 }
69
70 std::string more_args;
71
72 std::string wskind = arg->GetWSKind();
73 if ((wskind == "websocket") && (GetBoolEnv("WebGui.WSLongpoll") == 1))
74 wskind = "longpoll";
75 if (!wskind.empty() && (wskind != "websocket"))
76 more_args.append("socket_kind: \""s + wskind + "\","s);
77 std::string wsplatform = arg->GetWSPlatform();
78 if (!wsplatform.empty() && (wsplatform != "http"))
79 more_args.append("platform: \""s + wsplatform + "\","s);
80 const char *ui5source = gEnv->GetValue("WebGui.openui5src","");
81 if (ui5source && *ui5source)
82 more_args.append("openui5src: \""s + ui5source + "\","s);
83 const char *ui5libs = gEnv->GetValue("WebGui.openui5libs","");
84 if (ui5libs && *ui5libs)
85 more_args.append("openui5libs: \""s + ui5libs + "\","s);
86 const char *ui5theme = gEnv->GetValue("WebGui.openui5theme","");
87 if (ui5theme && *ui5theme)
88 more_args.append("openui5theme: \""s + ui5theme + "\","s);
89 int credits = gEnv->GetValue("WebGui.ConnCredits", 10);
90 if ((credits > 0) && (credits != 10))
91 more_args.append("credits: "s + std::to_string(credits) + ","s);
92 if ((fWindow.GetWidth() > 0) && (fWindow.GetHeight() > 0))
93 more_args.append("winW:"s + std::to_string(fWindow.GetWidth()) + ",winH:"s + std::to_string(fWindow.GetHeight()) + ","s);
94 if ((fWindow.GetX() >= 0) && (fWindow.GetY() >= 0))
95 more_args.append("winX:"s + std::to_string(fWindow.GetX()) + ",winY:"s + std::to_string(fWindow.GetY()) + ","s);
96 auto user_args = fWindow.GetUserArgs();
97 if (!user_args.empty())
98 more_args.append("user_args: "s + user_args + ","s);
99 if (!more_args.empty()) {
100 std::string search = "connectWebWindow({"s;
101 std::string replace = search + more_args;
102 arg->ReplaceAllinContent(search, replace, true);
103 arg->AddNoCacheHeader();
104 }
105 }
106
107public:
108 RWebWindow &fWindow; ///<! window reference
109
110 /// constructor
112 : THttpWSHandler(name, "RWebWindow websockets handler", kFALSE), fWindow(wind)
113 {
114 }
115
116 ~RWebWindowWSHandler() override = default;
117
118 /// returns content of default web-page
119 /// THttpWSHandler interface
120 TString GetDefaultPageContent() override { return IsDisabled() ? "" : fWindow.fDefaultPage.c_str(); }
121
122 /// returns true when window allowed to serve files relative to default page
123 Bool_t CanServeFiles() const override { return !IsDisabled(); }
124
125 /// Process websocket request - called from THttpServer thread
126 /// THttpWSHandler interface
128 {
129 if (!arg || IsDisabled()) return kFALSE;
130 return fWindow.ProcessWS(*arg);
131 }
132
133 /// Allow processing of WS actions in arbitrary thread
134 Bool_t AllowMTProcess() const override { return fWindow.fProcessMT; }
135
136 /// Allows usage of special threads for send operations
137 Bool_t AllowMTSend() const override { return fWindow.fSendMT; }
138
139 /// React on completion of multi-threaded send operation
140 void CompleteWSSend(UInt_t wsid) override { if (!IsDisabled()) fWindow.CompleteWSSend(wsid); }
141
142 static int GetBoolEnv(const std::string &name, int dfl = -1);
143};
144
145} // namespace ROOT
146
147#endif
constexpr Bool_t kFALSE
Definition RtypesCore.h:101
R__EXTERN TEnv * gEnv
Definition TEnv.h:170
char name[80]
Definition TGX11.cxx:110
just wrapper to deliver websockets call-backs to the RWebWindow class
RWebWindow & fWindow
! window reference
~RWebWindowWSHandler() override=default
Bool_t AllowMTSend() const override
Allows usage of special threads for send operations.
Bool_t CanServeFiles() const override
returns true when window allowed to serve files relative to default page
Bool_t ProcessWS(THttpCallArg *arg) override
Process websocket request - called from THttpServer thread THttpWSHandler interface.
Bool_t ProcessBatchHolder(std::shared_ptr< THttpCallArg > &arg) override
Method used to accept or reject root_batch_holder.js request.
Bool_t AllowMTProcess() const override
Allow processing of WS actions in arbitrary thread.
void VerifyDefaultPageContent(std::shared_ptr< THttpCallArg > &arg) override
Method called when default page content is prepared for use By default no-cache header is provided.
void CompleteWSSend(UInt_t wsid) override
React on completion of multi-threaded send operation.
static int GetBoolEnv(const std::string &name, int dfl=-1)
Parse boolean gEnv variable which should be "yes" or "no".
TString GetDefaultPageContent() override
returns content of default web-page THttpWSHandler interface
RWebWindowWSHandler(RWebWindow &wind, const char *name)
constructor
Represents web window, which can be shown in web browser or any other supported environment.
std::string fDefaultPage
! HTML page (or file name) returned when window URL is opened
bool fSendMT
! true is special threads should be used for sending data
std::string GetClientVersion() const
Returns current client version.
int GetX() const
returns configured window X position (-1 - default)
bool ProcessBatchHolder(std::shared_ptr< THttpCallArg > &arg)
Process special http request, used to hold headless browser running Such requests should not be repli...
unsigned GetHeight() const
returns configured window height (0 - default)
std::string GetConnToken() const
Returns configured connection token.
std::string GetUserArgs() const
Returns configured user arguments for web window See SetUserArgs method for more details.
int GetY() const
returns configured window Y position (-1 - default)
bool ProcessWS(THttpCallArg &arg)
Processing of websockets call-backs, invoked from RWebWindowWSHandler Method invoked from http server...
unsigned GetWidth() const
returns configured window width (0 - default) actual window width can be different
void CompleteWSSend(unsigned wsid)
Complete websocket send operation Clear "doing send" flag and check if next operation has to be start...
bool fProcessMT
! if window event processing performed in dedicated thread
virtual Int_t GetValue(const char *name, Int_t dflt) const
Returns the integer value for a resource.
Definition TEnv.cxx:491
Contains arguments for single HTTP call.
Class for user-side handling of websocket with THttpServer.
Bool_t IsDisabled() const
Returns true when processing of websockets is disabled, set shortly before handler need to be destroy...
Basic string class.
Definition TString.h:139
This class represents a WWW compatible URL.
Definition TUrl.h:33
const char * GetValueFromOptions(const char *key) const
Return a value for a given key from the URL options.
Definition TUrl.cxx:660
void SetOptions(const char *opt)
Definition TUrl.h:87
Bool_t HasOption(const char *key) const
Returns true if the given key appears in the URL options list.
Definition TUrl.cxx:683
This file contains a specialised ROOT message handler to test for diagnostic in unit tests.