AthenaRequest Class

(QtAws::Athena::AthenaRequest)

The AthenaRequest class provides an interface for Athena requests. More...

Public Types

enum Action { BatchGetNamedQueryAction, BatchGetQueryExecutionAction, CreateNamedQueryAction, DeleteNamedQueryAction, ..., StopQueryExecutionAction }
flags Actions

Public Functions

AthenaRequest(const Action action)
AthenaRequest(const AthenaRequest &other)
Action action() const
QString actionString() const
QString apiVersion() const
void setAction(const Action action)
void setApiVersion(const QString &version)
AthenaRequest &operator=(const AthenaRequest &other)
virtual bool operator==(const AthenaRequest &other) const

Protected Functions

AthenaRequest(AthenaRequestPrivate * const d)
int clearParameter(const QString &name)
void clearParameters()
QVariant parameter(const QString &name, const QVariant &defaultValue = QVariant()) const
const QVariantMap &parameters() const
void setParameter(const QString &name, const QVariant &value)
void setParameters(const QVariantMap &parameters)

Reimplemented Protected Functions

virtual QNetworkRequest unsignedRequest(const QUrl &endpoint) const override

Detailed Description

The AthenaRequest class provides an interface for Athena requests.

Member Type Documentation

enum AthenaRequest::Action
flags AthenaRequest::Actions

This enum describes the actions that can be performed as Athena requests.

ConstantValueDescription
QtAws::Athena::AthenaRequest::BatchGetNamedQueryAction0Athena BatchGetNamedQuery action.
QtAws::Athena::AthenaRequest::BatchGetQueryExecutionAction1Athena BatchGetQueryExecution action.
QtAws::Athena::AthenaRequest::CreateNamedQueryAction2Athena CreateNamedQuery action.
QtAws::Athena::AthenaRequest::DeleteNamedQueryAction3Athena DeleteNamedQuery action.
QtAws::Athena::AthenaRequest::GetNamedQueryAction4Athena GetNamedQuery action.
QtAws::Athena::AthenaRequest::GetQueryExecutionAction5Athena GetQueryExecution action.
QtAws::Athena::AthenaRequest::GetQueryResultsAction6Athena GetQueryResults action.
QtAws::Athena::AthenaRequest::ListNamedQueriesAction7Athena ListNamedQueries action.
QtAws::Athena::AthenaRequest::ListQueryExecutionsAction8Athena ListQueryExecutions action.
QtAws::Athena::AthenaRequest::StartQueryExecutionAction9Athena StartQueryExecution action.
QtAws::Athena::AthenaRequest::StopQueryExecutionAction10Athena StopQueryExecution action.

The Actions type is a typedef for QFlags<Action>. It stores an OR combination of Action values.

Member Function Documentation

AthenaRequest::AthenaRequest(const Action action)

Constructs a AthenaRequest object for Athena action.

AthenaRequest::AthenaRequest(const AthenaRequest &other)

Constructs a copy of other.

[protected] AthenaRequest::AthenaRequest(AthenaRequestPrivate * const d)

Constructs aa AthenaRequest object with private implementation d.

This overload allows derived classes to provide their own private class implementation that inherits from AthenaRequestPrivate.

Action AthenaRequest::action() const

Returns the Athena action to be performed by this request.

See also setAction().

QString AthenaRequest::actionString() const

Returns the name of the Athena action to be performed by this request.

QString AthenaRequest::apiVersion() const

Returns the Athena API version implemented by this request.

See also setApiVersion().

[protected] int AthenaRequest::clearParameter(const QString &name)

Removes the a name parameter from the request, then returns the number of paramters removed (typically 0 or 1).

[protected] void AthenaRequest::clearParameters()

Removes all parameters from the request.

[protected] QVariant AthenaRequest::parameter(const QString &name, const QVariant &defaultValue = QVariant()) const

Returns the value of the name pararemter if set; defaultValue otherwise.

See also setParameter().

[protected] const QVariantMap &AthenaRequest::parameters() const

Returns the parameters included in this request.

See also setParameters().

void AthenaRequest::setAction(const Action action)

Sets the Athena action to be performed by this request to action.

See also action().

void AthenaRequest::setApiVersion(const QString &version)

Sets the Athena API version to include in this request to version.

See also apiVersion().

[protected] void AthenaRequest::setParameter(const QString &name, const QVariant &value)

Sets the name parameter to value.

See also parameter().

[protected] void AthenaRequest::setParameters(const QVariantMap &parameters)

Sets the paramters for this request to parameters. Any request parameters set previously will be discarded.

See also parameters().

[override virtual protected] QNetworkRequest AthenaRequest::unsignedRequest(const QUrl &endpoint) const

Reimplemented from AwsAbstractRequest::unsignedRequest().

Returns a network request for the Athena request using the given endpoint.

This Athena implementation builds request URLs by combining the common query parameters (such as Action and Version), with any that have been added (via setParameter) by child classes.

AthenaRequest &AthenaRequest::operator=(const AthenaRequest &other)

Sets the AthenaRequest object to be equal to other.

[virtual] bool AthenaRequest::operator==(const AthenaRequest &other) const

Returns true if this request is equal to other; false otherwise.

Note, most derived *Request classes do not need to provider their own implementations of this function, since most such request classes rely on this class' parameters functionality for all request parameters, and that parameters map is already checked via this implementation.

© 2018 Paul Colby Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.