The session that holds the connection with the cloud. More...

#include <CloudBackend.h>

Public Types
using	LogInDelegatePtr = delegate::LogInDelegatePtr

using	LogInException = delegate::LogInDelegate::Exception

using	LogInError = delegate::LogInDelegate::ErrorInfo

using	CreateAccountDelegatePtr = delegate::CreateAccountDelegatePtr

using	CreateAccountException = delegate::CreateAccountDelegate::Exception

using	CreateAccountError = delegate::CreateAccountDelegate::ErrorInfo

using	CloudBackendListenerDelegatePtr = std::shared_ptr< delegate::CloudBackendListenerDelegate >

using	ListenerHandle = std::uint64_t
	Handle identifying a registered Listener.

using	QueryDelegatePtr = delegate::QueryDelegatePtr

using	QueryJoinDelegatePtr = delegate::QueryJoinDelegatePtr

using	QueryException = delegate::QueryDelegate::Exception

using	QueryJoinError = delegate::QueryJoinDelegate::ErrorInfo

using	QueryError = delegate::QueryDelegate::ErrorInfo

using	SearchException = delegate::QueryDelegate::Exception

using	SearchError = delegate::QueryDelegate::ErrorInfo

Public Member Functions
ListenerHandle	addListener (CloudBackendListenerDelegatePtr listener)
	Listen for changes to specific items. More...

void	removeListener (ListenerHandle handle)
	Delete a specific listener. More...

cbe::QueryChain	query (ContainerId containerId, QueryDelegatePtr queryDelegate)
	Select Item's of a container (table). More...

cbe::QueryChain	query (ContainerId containerId, Filter filter, QueryDelegatePtr queryDelegate)
	Select Item's of a container (table) with a filter (where). More...

cbe::QueryChainExt	query (ContainerId containerId, QueryJoinDelegatePtr queryJoinDelegate)
	Join multiple tables. More...

cbe::QueryChainExt	query (ContainerId containerId, Filter filter, QueryJoinDelegatePtr queryJoinDelegate)
	Join multiple tables using filter (where). More...

cbe::QueryChainSync	query (ContainerId containerId)
	Synchronous [exception]. More...

cbe::QueryChainSync	query (ContainerId containerId, Filter filter)
	Synchronous [exception] filtered. More...

cbe::QueryChainSync	query (ContainerId containerId, QueryJoinError &error)
	Synchronous [non-throwing] query. More...

cbe::QueryChainSync	query (ContainerId containerId, Filter filter, QueryJoinError &error)
	Synchronous [non-throwing] filtered query. More...

cbe::QueryChain	queryWithPath (std::string relativePath, cbe::ContainerId queryRoot, QueryDelegatePtr delegate)
	Queries items of a container with a given path. More...

cbe::QueryChain	queryWithPath (std::string relativePath, QueryDelegatePtr delegate)
	Queries items of a container with a given path relative the home root container. More...

cbe::QueryResult	search (std::string tags, cbe::ContainerId containerId, QueryDelegatePtr delegate)
	Select Object's with specified key/values. More...

cbe::QueryResult	search (std::string tags, cbe::ContainerId containerId)
	Synchronous [exception] Synchronous version of search(std::string, cbe::ContainerId, QueryDelegatePtr) , and throws an exception, SearchException, in case of a failed call. See search(QueryDelegatePtr) More...

cbe::util::Optional< cbe::QueryResult >	search (std::string tags, cbe::ContainerId containerId, SearchError &error)
	Synchronous [non-throwing] search Synchronous version of search(tags, containerId, QueryDelegatePtr) , and throws no exception on error, instead the out/return parameter `error` is used to provide the error information in connection with a failed call. See search(tags, containerId, QueryDelegatePtr) More...

cbe::QueryResult	search (cbe::Filter filter, cbe::ContainerId containerId, QueryDelegatePtr delegate)
	Select Object's with specified key/values using filter. More...

cbe::QueryResult	search (cbe::Filter filter, cbe::ContainerId containerId)
	Synchronous [exception] Synchronous version of search(cbe::Filter, cbe::ContainerId, QueryDelegatePtr) , and throws an exception, SearchException, in case of a failed call. See search(QueryDelegatePtr) More...

cbe::util::Optional< cbe::QueryResult >	search (cbe::Filter filter, cbe::ContainerId containerId, SearchError &error)
	Synchronous [non-throwing] search Synchronous version of search(filter,containerId,QueryDelegatePtr) , and throws no exception on error, instead the out/return parameter `error` is used to provide the error information in connection with a failed call. See search(filter,containerId, QueryDelegatePtr) More...

bool	clearCache ()
	Clear the local cache. More...

cbe::Account	account ()
	Returns an account object with information on the user. More...

std::string	version () const
	Returns the version number of the SDK. More...

cbe::GroupManager	groupManager ()
	Gets the group manager. More...

cbe::ShareManager	shareManager ()
	Gets the share manager. More...

cbe::PublishManager	publishManager ()
	Gets the publish manager. More...

void	terminate ()
	Terminates the CloudBackend service. More...

cbe::SubscribeManager	subscribeManager ()
	Gets the subscribe manager. More...

	CloudBackend (cbe::DefaultCtor)
	Default constructor. More...

	operator bool () const
	Checks if the current instance is real. More...

Static Public Member Functions
static cbe::CloudBackend	logIn (const std::string &username, const std::string &password, const std::string &tenant, const std::string &client, LogInDelegatePtr delegate)
	Logs in to the CloudBackend service. More...

static cbe::CloudBackend	logIn (const std::string &username, const std::string &password, const std::string &tenant, const std::string &client)
	Synchronous [exception] logIn. More...

static cbe::CloudBackend	logIn (const std::string &username, const std::string &password, const std::string &tenant, const std::string &client, LogInError &error)
	Synchronous [non-throwing] logIn. More...

static cbe::UserId	createAccount (const std::string &username, const std::string &password, const std::string &email, const std::string &firstName, const std::string &lastName, const std::string &tenant, const std::string &client, CreateAccountDelegatePtr delegate)
	Creates a user account. More...

static cbe::UserId	createAccount (const std::string &username, const std::string &password, const std::string &email, const std::string &firstName, const std::string &lastName, const std::string &tenant, const std::string &client)
	Synchronous [exception] Creates a user account. More...

static cbe::util::Optional< cbe::UserId >	createAccount (const std::string &username, const std::string &password, const std::string &email, const std::string &firstName, const std::string &lastName, const std::string &tenant, const std::string &client, CreateAccountError &error)
	Synchronous [no exception] Synchronous version of createAccount(username,password,email,firstname,lastname,tenant,client,CreateAccountDelegatePtr) , and throws no exception on error, instead the out/return parameter `error` is used to provide the error information in connection with a failed call. See createAccount(username,password,email,firstname,lastname,tenant,client,CreateAccountDelegatePtr) More...

static cbe::Container	castContainer (cbe::Item item)
	Casts an item to a container. More...

static cbe::Object	castObject (cbe::Item item)
	Casts an item to an object. More...

Detailed Description

The session that holds the connection with the cloud.

It ensures the connection is authenticated.

Member Typedef Documentation

◆ LogInDelegatePtr

using cbe::CloudBackend::LogInDelegatePtr = delegate::LogInDelegatePtr

Pointer to cbe::delegate::LogInDelegate() that is passed into asynchronous version of method logIn()

◆ LogInException

using cbe::CloudBackend::LogInException = delegate::LogInDelegate::Exception

See also: delegate::LogInDelegate::Exception

◆ LogInError

using cbe::CloudBackend::LogInError = delegate::LogInDelegate::ErrorInfo

Forms the type of the error return parameter for the synchronous version of method logIn()

See also: delegate::LogInDelegate::ErrorInfo

◆ CreateAccountDelegatePtr

using cbe::CloudBackend::CreateAccountDelegatePtr = delegate::CreateAccountDelegatePtr

Pointer to delegate::CreateAccountDelegate that is passed into asynchronous version of method createAccount()

◆ CreateAccountException

using cbe::CloudBackend::CreateAccountException = delegate::CreateAccountDelegate::Exception

See delegate::CreateAccountDelegate::Exception

◆ CreateAccountError

using cbe::CloudBackend::CreateAccountError = delegate::CreateAccountDelegate::ErrorInfo

Forms the type of the error return parameter for the synchronous version of method createAccount()
See delegate::CreateAccountDelegate::ErrorInfo

◆ CloudBackendListenerDelegatePtr

using cbe::CloudBackend::CloudBackendListenerDelegatePtr = std::shared_ptr<delegate::CloudBackendListenerDelegate>

Pointer to delegate::CloudBackendListenerDelegate that is passed into asynchronous version of method addListener(CloudBackendListenerDelegatePtr)

◆ QueryDelegatePtr

using cbe::CloudBackend::QueryDelegatePtr = delegate::QueryDelegatePtr

Pointer to delegate::QueryDelegate that is passed into asynchronous version of methods:

◆ QueryJoinDelegatePtr

using cbe::CloudBackend::QueryJoinDelegatePtr = delegate::QueryJoinDelegatePtr

Pointer to delegate::QueryJoinDelegate that is passed into asynchronous version of methods

◆ QueryException

using cbe::CloudBackend::QueryException = delegate::QueryDelegate::Exception

See also: delegate::QueryDelegate::Exception

◆ QueryJoinError

using cbe::CloudBackend::QueryJoinError = delegate::QueryJoinDelegate::ErrorInfo

See also: delegate::QueryJoinDelegate::ErrorInfo

◆ QueryError

using cbe::CloudBackend::QueryError = delegate::QueryDelegate::ErrorInfo

See also: delegate::QueryDelegate::ErrorInfo

◆ SearchException

using cbe::CloudBackend::SearchException = delegate::QueryDelegate::Exception

Pointer to cbe::delegate::QueryDelegate that is passed into asynchronous version of method search() See delegate::object::QueryDelegate::Exception

◆ SearchError

using cbe::CloudBackend::SearchError = delegate::QueryDelegate::ErrorInfo

Forms the type of the error return parameter for the synchronous version of method search()
See delegate::QueryDelegate::ErrorInfo

Constructor & Destructor Documentation

◆ CloudBackend()

cbe::CloudBackend::CloudBackend ( cbe::DefaultCtor )

Default constructor.

Construct a new object with the DefaultCtor to enable the operator bool() test

Member Function Documentation

◆ logIn() [1/3]

static cbe::CloudBackend cbe::CloudBackend::logIn	(	const std::string &	username,
		const std::string &	password,
		const std::string &	tenant,
		const std::string &	client,
		LogInDelegatePtr	delegate
	)

static

Logs in to the CloudBackend service.

When finished with the usage of the CloudBackend service, call method CloudBackend::terminate() in all cases.

The authentication to the account is determined by username, password and tenant.

Asynchronous version of this service function.

Parameters

username	Name of the user to be signed in.
password	Password for the user to be signed in.
tenant	The identifier for the tenant, formerly known as `source`.
client	Identifier of what type of client the program is running on. This is used by the tenant for statistics and selective communication with the users. The tenant administrator defines what client names to use.
delegate	Pointer to a be::CloudBackend::LogInDelegate() instance that is implemented by the user to receive the response of this login request. This is accomplished in terms of the LogInDelegate callback functions onLogInSuccess() and onLogInError().

Example: Async login
#include "cbe/CloudBackend.h"

~~~

#include <condition_variable>

#include <mutex>

~~~

int main() {

// First, declare and implement a LogInDelegate class

class MyLogInDelegate : public cbe::delegate::LogInDelegate {

std::mutex mutex{};

std::condition_variable conditionVariable{};

// Indicates operation completed - success or failure

bool called{};

public:

// Default construct this CloudBackend member. If the method

// onLogInSuccess() will not not be called, this default constructed state

// implies that this cloudBackend object is not valid due to a successful

// log in

cbe::CloudBackend cloudBackend{ cbe::DefaultCtor{} };

// Default construct this cbe::delegate::Error member, If the method

// onLogInError() will not not be called, this default constructed state

// implies no error. Otherwise, thus error object will contain the error

// information.

cbe::delegate::Error error{};

// Implement the cbe::delegate::LogInDelegate interface callbacks (private

// cause they are only used by the SDK):

private:

// Callback called upon successful login.

void onLogInSuccess(cbe::CloudBackend&& cloudBackend) final {

{

std::lock_guard<std::mutex> lock(mutex);

// Put error member into the default constructed state to

// indicate success (i.e., no error)

error = cbe::delegate::Error{};

// Change state of cloudBackend member to indicate success

this->cloudBackend = std::move(cloudBackend);

// Indicate operation completed, member cloudBackend non-default

// constructed state indicates success

called = true;

}

conditionVariable.notify_one();

}

// Callback called upon failed login.

void onLogInError(Error&& error, cbe::util::Context&& context) final {

{

std::lock_guard<std::mutex> lock(mutex);

// Put cloudBackend member into the default constructed state to

// indicate no-success

cloudBackend = cbe::CloudBackend{ cbe::DefaultCtor{} };

// Change state of error member to indicate failure

this->error = std::move(error);

// Indicate operation completed, member member cloudBackend default

// constructed state indicates failure

called = true;

}

conditionVariable.notify_one();

}

// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

public:

void waitForRsp() {

std::unique_lock<std::mutex> lock(mutex);

conditionVariable.wait(lock, [this]{ return called; });

// Reset called flag, so current delegate instance can be reused

called = false;

}

}; // struct MyLogInDelegate

~~~

~~~

// Second, initiate the login:

static constexpr const char* const username = "~~~";

static constexpr const char* const password = "~~~";

static constexpr const char* const tenant = "~~~";

static constexpr const char* const client = "linux_desktop";

~~~

std::shared_ptr<MyLogInDelegate> myLogInDelegate =

std::make_shared<MyLogInDelegate>();

// Invoke the login (cast to return value to void to indicate is deliberately

// discarded)

cbe::CloudBackend cloudBackend = cbe::CloudBackend::logIn(username, password, tenant, client, myLogInDelegate);

// Await the login procedure to run to completion

myLogInDelegate->waitForRsp();

// Test if login failed

if (myLogInDelegate->error) {

std::cout << "Failed to login: error={" << myLogInDelegate->error << '}'

<< std::endl;

// Bail out!

~~~

}

// Since we have a complete CloudBackend object now, copy it from the delegate

cloudBackend = myLogInDelegate->cloudBackend;

// Dispose the delegate object, not needed anymore

myLogInDelegate.reset();

// Do your stuff

~~~

// End of program, tell cbe to terminate the session

cloudBackend.terminate();

}

cbe::CloudBackend
The session that holds the connection with the cloud.
Definition: CloudBackend.h:47

cbe::CloudBackend::logIn
static cbe::CloudBackend logIn(const std::string &username, const std::string &password, const std::string &tenant, const std::string &client, LogInDelegatePtr delegate)
Logs in to the CloudBackend service.

cbe::CloudBackend::terminate
void terminate()
Terminates the CloudBackend service.

cbe::delegate::Error
Definition: Error.h:14

cbe::delegate::LogInDelegate
Definition: LogInDelegate.h:25

cbe::DefaultCtor
DefaultCtor
Default constructor marker.
Definition: Types.h:204

cbe::util::Context
Definition: Context.h:11

◆ logIn() [2/3]

static cbe::CloudBackend cbe::CloudBackend::logIn	(	const std::string &	username,
		const std::string &	password,
		const std::string &	tenant,
		const std::string &	client
	)

static

Synchronous [exception] logIn.

Synchronous version of logIn(), and throws an exception, LogInException, in case of a failed login.

Returns: A CloudBackend instance — if login was successful.

Exceptions

LogInException

Example: Synchronous [exception] logIn
cbe::CloudBackend cloudBackend{ cbe::DefaultCtor{} };

try {

cloudBackend = cbe::CloudBackend::logIn(username, password, tenant, client);

}

catch (cbe::CloudBackend::LogInException& e) {

std::cout << "Failed to login: error={" << e << '}'

<< std::endl;

// Bail out!

~~~

}

catch (std::runtime_error& e) {

std::cout << "Got runtime exception: {" << e << '}'

<< std::endl;

}

catch (...) {

std::cout << "Got other exception!"

<< std::endl;

}

cbe::delegate::LogInDelegate::Exception
exception thrown by cbe::CloudBackend::logIn(const std::string&,const std::string&,...
Definition: LogInDelegate.h:62

◆ logIn() [3/3]

static cbe::CloudBackend cbe::CloudBackend::logIn	(	const std::string &	username,
		const std::string &	password,
		const std::string &	tenant,
		const std::string &	client,
		LogInError &	error
	)

static

Synchronous [non-throwing] logIn.

Synchronous version of logIn(), and throws no exception on error, instead the out/return parameter error is used to provide the error information.

Parameters

[out] error Return parameter containing the error information in case of a failed login.
The return value, of type CloudBackend, will indicate false on a failed login, and the LogInError object passed in will we be populated with the error information.

Returns: If empty, false, an error has occurred. I.e., the login has failed, and the error information has been passed out via the error out/return parameter.

Example: Synchronous [non-throwing] logIn
cbe::CloudBackend cloudBackend{ cbe::DefaultCtor{} };

cbe::CloudBackend::LogInError error{};

cloudBackend = cbe::CloudBackend::logIn(username, password, tenant, error, client);

if (!cloudBackend) {

std::cout << "Failed to login: error={" << error << '}'

<< std::endl;

// Bail out!

~~~

}

cbe::delegate::LogInDelegate::ErrorInfo
Definition: LogInDelegate.h:45

◆ createAccount() [1/3]

static cbe::UserId cbe::CloudBackend::createAccount	(	const std::string &	username,
		const std::string &	password,
		const std::string &	email,
		const std::string &	firstName,
		const std::string &	lastName,
		const std::string &	tenant,
		const std::string &	client,
		CreateAccountDelegatePtr	delegate
	)

static

Creates a user account.

This method is only granted to the tenant administrator.

Asynchronous version of this service function.

Parameters

username	Username for the new account
password	Password for the new account
email	Email address to owner of the new account
firstName	First name of the owner of the new account
lastName	Last name of the owner of the new account
tenant	The identifier for the tenant, formerly known as `source`.
client	Describing platform running the software. Names defined by the tenant administrator.
delegate	Pointer to a delegate::CreateAccountDelegate instance that is implemented by the user.

◆ createAccount() [2/3]

static cbe::UserId cbe::CloudBackend::createAccount	(	const std::string &	username,
		const std::string &	password,
		const std::string &	email,
		const std::string &	firstName,
		const std::string &	lastName,
		const std::string &	tenant,
		const std::string &	client
	)

static

Synchronous [exception] Creates a user account.

Synchronous version of createAccount(), and throws an exception, CreateAccountException, in case of a failed account creation.

See createAccount()

Returns: A CloudBackend instance associated with the created account — if account creation was successful.

Exceptions

CreateAccountException

◆ createAccount() [3/3]

static cbe::util::Optional<cbe::UserId> cbe::CloudBackend::createAccount	(	const std::string &	username,
		const std::string &	password,
		const std::string &	email,
		const std::string &	firstName,
		const std::string &	lastName,
		const std::string &	tenant,
		const std::string &	client,
		CreateAccountError &	error
	)

static

Synchronous [no exception] Synchronous version of createAccount(username,password,email,firstname,lastname,tenant,client,CreateAccountDelegatePtr) , and throws no exception on error, instead the out/return parameter error is used to provide the error information in connection with a failed call.
See createAccount(username,password,email,firstname,lastname,tenant,client,CreateAccountDelegatePtr)

Parameters

[out] error Return parameter containing the error information in case of a failed call.
An empty return value will indicate failure, and the CreateAccountError object passed in will we be populated with the error information.

Returns: Empty — i.e., false — indicates a failed call, and the error information is passed out via the error out/return parameter.

◆ addListener()

ListenerHandle cbe::CloudBackend::addListener ( CloudBackendListenerDelegatePtr listener )

Listen for changes to specific items.

Adds a listener that will receive updates as changes occur on the account.

Note: removeListener() should always be called when no longer using the delegate.

Parameters

listener Delegate is a shared pointer to the class delegate::CloudBackendListenerDelegate that the user has implemented

Returns: Handle identifying the registration of the listener.
To be used when de-registering with method removeListener(ListenerHandle).

◆ removeListener()

void cbe::CloudBackend::removeListener ( ListenerHandle handle )

Delete a specific listener.

Removes a listener that will receive updates as changes occur on the account

Parameters

handle Handle previously retrieved from method addListener(CloudBackendListenerDelegatePtr).

◆ query() [1/8]

cbe::QueryChain cbe::CloudBackend::query	(	ContainerId	containerId,
		QueryDelegatePtr	queryDelegate
	)

Select Item's of a container (table).

Inquires for a set of Items from the provided Container, identified by containerId. Response is delivered asynchronously via the delegate::QueryDelegate callback interface passed in as argument via parameter queryDelegate .
This overload of join() accepting a QueryDelegate-pointer as parameter has two use cases:

To make a solely query() call without an additional chained join()-call.
To make a query() call with a desired chained join() call.
In this latter case, the overloaded query()-functions:
- query(ContainerId,delegate::QueryJoinDelegatePtr)
- query(ContainerId,Filter,delegate::QueryJoinDelegatePtr)
both accepting a QueryJoinDelegate as delegate argument, must be used.

Asynchronous version of this service function.

Parameters

containerId	Id of the container which contents will inquired.
queryDelegate	Pointer to a QueryDelegate instance, implemented by the user, that receives the response of this query request. I.e., either the QueryDelegate callback function onQuerySuccess() or onQueryError() will be called in the event of success, or failure respectively.

Example

Async query

  ~~~
  std::shared_ptr<MyQueryDelegate> queryDelegate =
                                     std::make_shared<MyQueryDelegate>();
  const cbe::ContainerId myContainerId =
                                    cloudBackend.account().rootContainer().id();
  cloudBackend.query(myContainerId, queryDelegate);
  queryDelegate->waitForRsp();
  if (queryDelegate->errorInfo) {
    std::cout << "Query failed:" << std::endl;
    std::cout << "ErrorInfo = " << queryDelegate->errorInfo << std::endl;
  } else {
    cbe::QueryResult::ItemsSnapshot itemsSnapshot =
                                  queryDelegate->queryResult.getItemsSnapshot();
    for (auto& item : itemsSnapshot) {
        std::cout << item.name() << std::endl;
    }
  }
  ~~~

To use the code above, we must first login and then declare a QueryDelegate class.
See also:

Async login
Here, we retrieve the cloudBackend object.
Example QueryDelegatePtr of a QueryDelegate implementation class
Here, class MyQueryDelegate is defined.

◆ query() [2/8]

cbe::QueryChain cbe::CloudBackend::query	(	ContainerId	containerId,
		Filter	filter,
		QueryDelegatePtr	queryDelegate
	)

Select Item's of a container (table) with a filter (where).

Same as query(ContainerId,QueryDelegatePtr), but with an additional parameter filter.

Parameters

filter Filter specifying the constraints of the requested items.

◆ query() [3/8]

cbe::QueryChainExt cbe::CloudBackend::query	(	ContainerId	containerId,
		QueryJoinDelegatePtr	queryJoinDelegate
	)

Join multiple tables.

Same as query(ContainerId,delegate::QueryDelegatePtr), but with a QueryJoinDelegate as delegate, queryJoinDelegate.

See also: query(ContainerId,delegate::QueryDelegatePtr)

Parameters

queryJoinDelegate Pointer to a QueryJoinDelegate instance, implemented by the user, that receives the response of this query request.
I.e., either its callback function onQueryJoinSuccess() or onQueryJoinError() will be called in the event of success or failure respectively.

◆ query() [4/8]

cbe::QueryChainExt cbe::CloudBackend::query	(	ContainerId	containerId,
		Filter	filter,
		QueryJoinDelegatePtr	queryJoinDelegate
	)

Join multiple tables using filter (where).

Same as query(ContainerId,delegate::QueryJoinDelegatePtr), but with an additional Filter parameter filter.

Parameters

filter Filter specifying the constraints of the requested items.

◆ query() [5/8]

cbe::QueryChainSync cbe::CloudBackend::query ( ContainerId containerId )

Synchronous [exception].

Synchronous version of query(ContainerId,delegate::QueryDelegatePtr), and throws an exception, QueryException, in case of a failed query.

Returns: Upon success, a QueryResult object - in fact an instance of QueryChainSync that is a subclass of QueryResult.

Exceptions

QueryException

Example

Sync [exception] query

  ~~~
  const cbe::ContainerId myContainerId = cloudBackend.account().rootContainer().id();
  try
  {
    auto queryResult = cloudBackend.query(myContainerId).getQueryResult();
    cbe::QueryResult::ItemsSnapshot itemsSnapshot = queryResult.getItemsSnapshot();
    for (auto& item : itemsSnapshot) {
        std::cout << item.name() << std::endl;
    }
  }
  catch (const cbe::CloudBackend::QueryException& e)
  {
    std::cout << "Error!" << std::endl << e.what() << std::endl;
    ~~~
  }
  ~~~

To use the code above, we must first login.
See also:

Sync [exception] login
Here, we retrieve the cloudBackend class object.

◆ query() [6/8]

cbe::QueryChainSync cbe::CloudBackend::query	(	ContainerId	containerId,
		Filter	filter
	)

Synchronous [exception] filtered.

Extended version of query(ContainerId) with an additional filter parameter filter.

Parameters

filter Filter specifying the constraints of the requested items.

◆ query() [7/8]

cbe::QueryChainSync cbe::CloudBackend::query	(	ContainerId	containerId,
		QueryJoinError &	error
	)

Synchronous [non-throwing] query.

In line with synchronous query(ContainerId), but throws no exception on error, instead the out/return parameter error is used to provide the error information.

Parameters

[out] error Return parameter containing the error information in case of a failed query.
The return value, of type QueryChainSync, will indicate false on a failed query, and the passed in QueryJoinError object will we be populated with the error information.
Since there might be multiple chained calls after the return from this method, the error information will also contain the index of the failed chained join() call.

Returns: An object of QueryResult - in fact an instance of QueryChainSync that is a subclass of QueryResult.
If empty - i.e., false an error has occurred, i.e., a failed query, and the error information has been passed out via the error out/return parameter.

Example: Sync [non-throwing] query
~~~

const cbe::ContainerId myContainerId = cloudBackend.account().rootContainer().id();

cbe::CloudBackend::QueryError queryError;

auto queryResult = cloudBackend.query(myContainerId).getQueryResult();

if (queryError) {

std::cout << "Error! " << queryError << std::endl;

~~~

} else {

cbe::QueryResult::ItemsSnapshot itemsSnapshot = queryResult.getItemsSnapshot();

for (auto& item : itemsSnapshot) {

std::cout << item.name() << std::endl;

}

}

~~~

cbe::delegate::QueryDelegate::ErrorInfo
Definition: QueryDelegate.h:61

◆ query() [8/8]

cbe::QueryChainSync cbe::CloudBackend::query	(	ContainerId	containerId,
		Filter	filter,
		QueryJoinError &	error
	)

Synchronous [non-throwing] filtered query.

Extended version of query(ContainerId,QueryJoinError&) with an additional filter parameter filter.

See also

query(ContainerId,QueryJoinError&) To use the code above, we must first login.
See also:

Sync [non-throwing] login
Here, we retrieve the cloudBackend class object.

◆ queryWithPath() [1/2]

cbe::QueryChain cbe::CloudBackend::queryWithPath	(	std::string	relativePath,
		cbe::ContainerId	queryRoot,
		QueryDelegatePtr	delegate
	)

Queries items of a container with a given path.

Note: .. or . relative path options are not permitted.
Only top down search from start point, queryRoot id to downwards path in container tree.

Parameters

relativePath	The relative path from the `queryRoot`. E.g.: `/Documents/Pictures` from a `queryRoot` that has the nested containers `Documents` and `Pictures`.
queryRoot	The container id forming the root of this query.
delegate	Pointer to a delegate::QueryDelegate instance that is implemented by the user.

◆ queryWithPath() [2/2]

cbe::QueryChain cbe::CloudBackend::queryWithPath	(	std::string	relativePath,
		QueryDelegatePtr	delegate
	)

Queries items of a container with a given path relative the home root container.

Same as queryWithPath(std::string, cbe::ContainerId, QueryDelegatePtr), but with the queryRoot parameter omitted. Instead, here the home root container is used as top container in the search tree.

◆ search() [1/6]

cbe::QueryResult cbe::CloudBackend::search	(	std::string	tags,
		cbe::ContainerId	containerId,
		QueryDelegatePtr	delegate
	)

Select Object's with specified key/values.

Search the whole container for tags related to Objects in the container structure.
E.g., Key = Name, Value Contract/Object/Song => Name:Contract1 .

Search handles tags in combination / conjunction of keys and/or key values separated by |.
E.g., Name:*|Country:Sweden|Country:Norway.
This would search for objects with key Name of any value and where key Country is either Sweden or Norway.

Parameters

tags	Is a string of key tags or key:value pairs that are separated by \|.
containerId	Is the cbe::ContainerId id of the rootContainer to start the search of objects in. E.g., if starting in the rootContainer, the whole account will be searched for matching tags, key/value's.
delegate	Is the callback pointer to where the API returns from either cache or Server.

◆ search() [2/6]

cbe::QueryResult cbe::CloudBackend::search	(	std::string	tags,
		cbe::ContainerId	containerId
	)

Synchronous [exception] Synchronous version of search(std::string, cbe::ContainerId, QueryDelegatePtr) , and throws an exception, SearchException, in case of a failed call.
See search(QueryDelegatePtr)

Returns: Information about the search — if the call was successful.
See cbe::cbe::QueryResult

Exceptions

SearchException

◆ search() [3/6]

cbe::util::Optional<cbe::QueryResult> cbe::CloudBackend::search	(	std::string	tags,
		cbe::ContainerId	containerId,
		SearchError &	error
	)

Synchronous [non-throwing] search Synchronous version of search(tags, containerId, QueryDelegatePtr) , and throws no exception on error, instead the out/return parameter error is used to provide the error information in connection with a failed call.
See search(tags, containerId, QueryDelegatePtr)

Parameters

[out] error Return parameter containing the error information in case of a failed call.
An empty return value will indicate failure, and the SearchError object passed in will we be populated with the error information.

Returns: Empty — i.e., false — indicates a failed call, and the error information is passed out via the error out/return parameter.

◆ search() [4/6]

cbe::QueryResult cbe::CloudBackend::search	(	cbe::Filter	filter,
		cbe::ContainerId	containerId,
		QueryDelegatePtr	delegate
	)

Select Object's with specified key/values using filter.

Search the whole container with sub-containers related to Objects in the container hierarchy structure.
E.g., Key = Name, Value Contract/Object/Song => Name:Contract1 .

Search handles tags in combination / conjunction of keys and/or key values separated by |.
E.g., Name:*|Country:Sweden|Country:Norway, this would search for objects with key Name of any value and where key Country is either Sweden or Norway.

See Filter.

Parameters

filter	is a cbe::Filter on which you can set how you want data to be ordered when searching. Remember to set the queryString to be keys/tags or key:value pairs that are separated by \|.
containerId	is the ContainerId of the Container to start the search of Objects in. E.g., if starting in the rootContainer, the whole account will be searched for matching tags, key/value's.
delegate	is the callback pointer to where the API returns from either cache or Server.

◆ search() [5/6]

cbe::QueryResult cbe::CloudBackend::search	(	cbe::Filter	filter,
		cbe::ContainerId	containerId
	)

Synchronous [exception] Synchronous version of search(cbe::Filter, cbe::ContainerId, QueryDelegatePtr) , and throws an exception, SearchException, in case of a failed call.
See search(QueryDelegatePtr)

Pointer to cbe::delegate::QueryDelegate that is passed into asynchronous version of method search() See delegate::object::QueryDelegate::Exception

Returns: Information about the search — if the call was successful.
See cbe::cbe::QueryResult

Exceptions

SearchException

◆ search() [6/6]

cbe::util::Optional<cbe::QueryResult> cbe::CloudBackend::search	(	cbe::Filter	filter,
		cbe::ContainerId	containerId,
		SearchError &	error
	)

Synchronous [non-throwing] search Synchronous version of search(filter,containerId,QueryDelegatePtr) , and throws no exception on error, instead the out/return parameter error is used to provide the error information in connection with a failed call.
See search(filter,containerId, QueryDelegatePtr)

Forms the type of the error return parameter for the synchronous version of method search()
See delegate::QueryDelegate::ErrorInfo

Parameters

[out] error Return parameter containing the error information in case of a failed call.
An empty return value will indicate failure, and the SearchError object passed in will we be populated with the error information.

Returns: Empty — i.e., false — indicates a failed call, and the error information is passed out via the error out/return parameter.

◆ castContainer()

static cbe::Container cbe::CloudBackend::castContainer ( cbe::Item item )

static

Casts an item to a container.

If the provided cbe::Item "item" is not a cbe::Container "container", an empty container instance is returned

◆ castObject()

static cbe::Object cbe::CloudBackend::castObject ( cbe::Item item )

static

Casts an item to an object.

If the provided cbe::Item "item" is not a cbe::Object "object", an empty object instance is returned

◆ clearCache()

bool cbe::CloudBackend::clearCache ( )

Clear the local cache.

Use if there is a local SDK memory issue.

Returns: true success; false failed

◆ account()

cbe::Account cbe::CloudBackend::account ( )

Returns an account object with information on the user.

Returns: cbe::Account

◆ version()

std::string cbe::CloudBackend::version ( ) const

Returns the version number of the SDK.

Returns: std::string

◆ groupManager()

cbe::GroupManager cbe::CloudBackend::groupManager ( )

Gets the group manager.

Returns: cbe::GroupManager

◆ shareManager()

cbe::ShareManager cbe::CloudBackend::shareManager ( )

Gets the share manager.

Returns: cbe::ShareManager

◆ publishManager()

cbe::PublishManager cbe::CloudBackend::publishManager ( )

Gets the publish manager.

Returns: cbe::PublishManager

◆ terminate()

void cbe::CloudBackend::terminate ( )

Terminates the CloudBackend service.

Shall also be called in connection with a failed log in.

◆ subscribeManager()

cbe::SubscribeManager cbe::CloudBackend::subscribeManager ( )

Gets the subscribe manager.

Returns: cbe::SubscribeManager

◆ operator bool()

cbe::CloudBackend::operator bool ( ) const

explicit

Checks if the current instance is real.

An "unreal" instance implies typically a failed login event.

Relies on the Default constructor CloudBackend(cbe::DefaultCtor)

Returns: true : is real; false : unreal; got nullptr; if current instance is unbound/undefined. I.e., if it is only default constructed.

The documentation for this class was generated from the following file:

include/cbe/CloudBackend.h

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Typedef Documentation

◆ LogInDelegatePtr

◆ LogInException

◆ LogInError

◆ CreateAccountDelegatePtr

◆ CreateAccountException

◆ CreateAccountError

◆ CloudBackendListenerDelegatePtr

◆ QueryDelegatePtr

◆ QueryJoinDelegatePtr

◆ QueryException

◆ QueryJoinError

◆ QueryError

◆ SearchException

◆ SearchError

Constructor & Destructor Documentation

◆ CloudBackend()

Member Function Documentation

◆ logIn() [1/3]

◆ logIn() [2/3]

◆ logIn() [3/3]

◆ createAccount() [1/3]

◆ createAccount() [2/3]

◆ createAccount() [3/3]

◆ addListener()

◆ removeListener()

◆ query() [1/8]

◆ query() [2/8]

◆ query() [3/8]

◆ query() [4/8]

◆ query() [5/8]

◆ query() [6/8]

◆ query() [7/8]

◆ query() [8/8]

◆ queryWithPath() [1/2]

◆ queryWithPath() [2/2]

◆ search() [1/6]

◆ search() [2/6]

◆ search() [3/6]

◆ search() [4/6]

◆ search() [5/6]

◆ search() [6/6]

◆ castContainer()

◆ castObject()

◆ clearCache()

◆ account()

◆ version()

◆ groupManager()

◆ shareManager()

◆ publishManager()

◆ terminate()

◆ subscribeManager()

◆ operator bool()