0e6a8cbfae
Change-Id: Ib51e2e61432a7ac634d5b8577f75b57507b0ad60 Signed-off-by: Ashod Nakashian <ashod.nakashian@collabora.co.uk> (cherry picked from commit 90516342d154434c3a7ad3d245b00a16b8bb5716)
226 lines
7.8 KiB
C++
226 lines
7.8 KiB
C++
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4; fill-column: 100 -*- */
|
|
/*
|
|
* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <Poco/Net/HTTPRequest.h>
|
|
|
|
#include <common/StringVector.hpp>
|
|
#include <common/Util.hpp>
|
|
#include <common/Log.hpp>
|
|
|
|
/**
|
|
* A class to encapsulate various useful pieces from the request.
|
|
* as well as path parsing goodness.
|
|
*
|
|
* The URI is complex and encapsulates multiple segments with
|
|
* different purposes and consumers. There are three URIs
|
|
* formats/modes that are supported.
|
|
*
|
|
* literal URI: used by ConvertToBroker.
|
|
* Origin: ConvertToBroker::startConversion
|
|
* Format:
|
|
* <anything>
|
|
* Identifier: special constructor that takes a string.
|
|
* Example:
|
|
* convert-to
|
|
*
|
|
* loleaflet URI: used to load loleaflet.html and other static files.
|
|
* Origin: the page where the document will be embedded.
|
|
* Format:
|
|
* /loleaflet/<loolwsd-version-hash>/[path/]<filename>.<ext>[?WOPISrc=<encoded-document-URI>]
|
|
* Identifier: /loleaflet/.
|
|
* Examples:
|
|
* /loleaflet/49c225146/src/map/Clipboard.js
|
|
* /loleaflet/49c225146/loleaflet.html?WOPISrc=http%3A%2F%2Flocalhost%2Fnextcloud%2Findex.php%2Fapps%2Frichdocuments%2Fwopi%2Ffiles%2F593_ocqiesh0cngs&title=empty.odt&lang=en-us&closebutton=1&revisionhistory=1
|
|
*
|
|
* lool URI: used to load the document.
|
|
* Origin: loleaflet.html
|
|
* Format:
|
|
* /lool/<encoded-document-URI+options>/ws?WOPISrc=<encoded-document-URI>&compat=/ws[/<sessionId>/<command>/<serial>]
|
|
* Identifier: /lool/.
|
|
*
|
|
* The 'document-URI' is the original URL in the client that is used to load the document page.
|
|
* The optional section at the end, in square-brackets, is for richproxy.
|
|
*
|
|
* Example:
|
|
* /lool/http%3A%2F%2Flocalhost%2Fowncloud%2Findex.php%2Fapps%2Frichdocuments%2Fwopi%2Ffiles%2F165_ocgdpzbkm39u%3F
|
|
* access_token%3DODhIXdJdbsVYQoKKCuaYofyzrovxD3MQ%26access_token_ttl%3D0%26reuse_cookies%3DXCookieName%253DXCookieValue%253
|
|
* ASuperCookieName%253DBAZINGA/ws?WOPISrc=http%3A%2F%2Flocalhost%2Fowncloud%2Findex.php%2Fapps%2Frichdocuments%2Fwopi%2F
|
|
* files%2F165_ocgdpzbkm39u&compat=/ws/1c99a7bcdbf3209782d7eb38512e6564/write/2
|
|
* Where:
|
|
* encoded-document-URI+options:
|
|
* http%3A%2F%2Flocalhost%2Fowncloud%2Findex.php%2Fapps%2Frichdocuments%2Fwopi%2Ffiles%2F165_ocgdpzbkm39u%3F
|
|
* access_token%3DODhIXdJdbsVYQoKKCuaYofyzrovxD3MQ%26access_token_ttl%3D0%26reuse_cookies%3DXCookieName%253DXCookieValue%253
|
|
* ASuperCookieName%253DBAZINGA
|
|
* encoded-document-URI:
|
|
* http%3A%2F%2Flocalhost%2Fowncloud%2Findex.php%2Fapps%2Frichdocuments%2Fwopi%2Ffiles%2F165_ocgdpzbkm39u
|
|
* sessionId:
|
|
* 1c99a7bcdbf3209782d7eb38512e6564
|
|
* command:
|
|
* write
|
|
* serial:
|
|
* 2
|
|
* In decoded form:
|
|
* document-URI+options:
|
|
* http://localhost/owncloud/index.php/apps/richdocuments/wopi/files/165_ocgdpzbkm39u?access_token=
|
|
* ODhIXdJdbsVYQoKKCuaYofyzrovxD3MQ&access_token_ttl=0&reuse_cookies=XCookieName%3DXCookieValue%3ASuperCookieName%3DBAZINGA
|
|
* document-URI:
|
|
* http://localhost/owncloud/index.php/apps/richdocuments/wopi/files/165_ocgdpzbkm39u
|
|
*
|
|
* Note that the options are still encoded and need decoding separately.
|
|
*
|
|
* Due to the multi-layer nature of the URI, it raises many difficulties, not least
|
|
* the fact that it has multiple query parameters ('?' sections). It also has foreslash
|
|
* delimiters after query parameters.
|
|
*
|
|
* The different sections are henceforth given names to help both in documenting and
|
|
* communicating them, and to facilitate parsing them.
|
|
*
|
|
* /lool/<encoded-document-URI+options>/ws?WOPISrc=<encoded-document-URI>&compat=/ws[/<sessionId>/<command>/<serial>]
|
|
* |--------documentURI---------| |-------WOPISrc------| |--------------compat--------------|
|
|
* |options| |sessionId| |command| |serial|
|
|
* |---------------------------LegacyDocumentURI---------------------------|
|
|
*
|
|
* Alternatively, the LegacyDocumentURI (encoded) could be hexified, as follows:
|
|
* /lool/0x123456789/ws?WOPISrc=<encoded-document-URI>&compat=/ws[/<sessionId>/<command>/<serial>]
|
|
*/
|
|
class RequestDetails
|
|
{
|
|
public:
|
|
|
|
/// The fields of the URI.
|
|
enum class Field
|
|
{
|
|
Type,
|
|
DocumentURI,
|
|
LegacyDocumentURI, //< Legacy, to be removed.
|
|
WOPISrc,
|
|
Compat,
|
|
SessionId,
|
|
Command,
|
|
Serial
|
|
};
|
|
|
|
private:
|
|
|
|
bool _isGet : 1;
|
|
bool _isHead : 1;
|
|
bool _isProxy : 1;
|
|
bool _isWebSocket : 1;
|
|
bool _isMobile : 1;
|
|
std::string _uriString;
|
|
std::string _proxyPrefix;
|
|
std::string _hostUntrusted;
|
|
std::string _documentURI;
|
|
StringVector _pathSegs;
|
|
std::map<std::string, std::string> _params;
|
|
std::map<Field, std::string> _fields;
|
|
std::map<std::string, std::string> _docUriParams;
|
|
|
|
void dehexify();
|
|
void processURI();
|
|
|
|
public:
|
|
|
|
RequestDetails(Poco::Net::HTTPRequest &request, const std::string& serviceRoot);
|
|
RequestDetails(const std::string &mobileURI);
|
|
|
|
// matches the WOPISrc if used. For load balancing
|
|
// must be 2nd element in the path after /lool/<here>
|
|
std::string getLegacyDocumentURI() const { return getField(Field::LegacyDocumentURI); }
|
|
|
|
/// The DocumentURI, decoded. Doesn't contain WOPISrc or any other appendages.
|
|
std::string getDocumentURI() const { return getField(Field::DocumentURI); }
|
|
|
|
const std::map<std::string, std::string>& getDocumentURIParams() const { return _docUriParams; }
|
|
|
|
std::string getURI() const
|
|
{
|
|
return _uriString;
|
|
}
|
|
bool isProxy() const
|
|
{
|
|
return _isProxy;
|
|
}
|
|
const std::string getProxyPrefix() const
|
|
{
|
|
return _proxyPrefix;
|
|
}
|
|
const std::string getHostUntrusted() const
|
|
{
|
|
return _hostUntrusted;
|
|
}
|
|
bool isWebSocket() const
|
|
{
|
|
return _isWebSocket;
|
|
}
|
|
bool isGet() const
|
|
{
|
|
return _isGet;
|
|
}
|
|
bool isGet(const char *path) const
|
|
{
|
|
return _isGet && _uriString == path;
|
|
}
|
|
bool isGetOrHead(const char *path) const
|
|
{
|
|
return (_isGet || _isHead) && _uriString == path;
|
|
}
|
|
|
|
bool equals(std::size_t index, const char* string) const
|
|
{
|
|
return _pathSegs.equals(index, string);
|
|
}
|
|
|
|
/// Return the segment of the URI at index.
|
|
/// URI segments are delimited by '/'.
|
|
std::string operator[](std::size_t index) const
|
|
{
|
|
return _pathSegs[index];
|
|
}
|
|
|
|
/// Returns the number of segments in the URI.
|
|
std::size_t size() const
|
|
{
|
|
return _pathSegs.size();
|
|
}
|
|
|
|
std::string getParam(const std::string& name) const
|
|
{
|
|
const auto it = _params.find(name);
|
|
return it != _params.end() ? it->second : std::string();
|
|
}
|
|
|
|
std::string getField(const Field field) const
|
|
{
|
|
const auto it = _fields.find(field);
|
|
return it != _fields.end() ? it->second : std::string();
|
|
}
|
|
|
|
bool equals(const Field field, const char* string) const
|
|
{
|
|
const auto it = _fields.find(field);
|
|
return it != _fields.end() ? it->second == string : (string == nullptr || *string == '\0');
|
|
}
|
|
|
|
std::string toString() const
|
|
{
|
|
std::ostringstream oss;
|
|
oss << _uriString << ' ' << (_isGet?"G":"")
|
|
<< (_isHead?"H":"") << (_isProxy?"Proxy":"")
|
|
<< (_isWebSocket?"WebSocket":"");
|
|
oss << ", host: " << _hostUntrusted;
|
|
oss << ", path: " << _pathSegs.size();
|
|
for (std::size_t i = 0; i < _pathSegs.size(); ++i)
|
|
oss << "\n[" << i << "] '" << _pathSegs[i] << '\'';
|
|
oss << "\nfull URI: " << _uriString;
|
|
return oss.str();
|
|
}
|
|
};
|
|
|
|
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|