123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701 |
- #ifndef BOOST_MYSQL_CONNECTION_HPP
- #define BOOST_MYSQL_CONNECTION_HPP
- #include <boost/mysql/buffer_params.hpp>
- #include <boost/mysql/diagnostics.hpp>
- #include <boost/mysql/error_code.hpp>
- #include <boost/mysql/execution_state.hpp>
- #include <boost/mysql/handshake_params.hpp>
- #include <boost/mysql/metadata_mode.hpp>
- #include <boost/mysql/results.hpp>
- #include <boost/mysql/rows_view.hpp>
- #include <boost/mysql/statement.hpp>
- #include <boost/mysql/string_view.hpp>
- #include <boost/mysql/detail/access.hpp>
- #include <boost/mysql/detail/any_stream_impl.hpp>
- #include <boost/mysql/detail/channel_ptr.hpp>
- #include <boost/mysql/detail/execution_concepts.hpp>
- #include <boost/mysql/detail/network_algorithms.hpp>
- #include <boost/mysql/detail/rebind_executor.hpp>
- #include <boost/mysql/detail/socket_stream.hpp>
- #include <boost/mysql/detail/throw_on_error_loc.hpp>
- #include <boost/mysql/detail/writable_field_traits.hpp>
- #include <boost/assert.hpp>
- #include <type_traits>
- #include <utility>
- namespace boost {
- namespace mysql {
- template <class... StaticRow>
- class static_execution_state;
- /**
- * \brief A connection to a MySQL server.
- * \details
- * Represents a connection to a MySQL server.
- *\n
- * `connection` is the main I/O object that this library implements. It owns a `Stream` object that
- * is accessed by functions involving network operations, as well as session state. You can access
- * the stream using \ref connection::stream, and its executor via \ref connection::get_executor. The
- * executor used by this object is always the same as the underlying stream.
- *\n
- * \par Thread safety
- * Distinct objects: safe. \n
- * Shared objects: unsafe. \n
- * This class is <b>not thread-safe</b>: for a single object, if you
- * call its member functions concurrently from separate threads, you will get a race condition.
- */
- template <class Stream>
- class connection
- {
- detail::channel_ptr channel_;
- diagnostics& shared_diag() noexcept { return channel_.shared_diag(); }
- #ifndef BOOST_MYSQL_DOXYGEN
- friend struct detail::access;
- #endif
- public:
-
- template <
- class... Args,
- class EnableIf = typename std::enable_if<std::is_constructible<Stream, Args...>::value>::type>
- connection(Args&&... args) : connection(buffer_params(), std::forward<Args>(args)...)
- {
- }
-
- template <
- class... Args,
- class EnableIf = typename std::enable_if<std::is_constructible<Stream, Args...>::value>::type>
- connection(const buffer_params& buff_params, Args&&... args)
- : channel_(
- buff_params.initial_read_size(),
- std::unique_ptr<detail::any_stream>(new detail::any_stream_impl<Stream>(std::forward<Args>(args
- )...))
- )
- {
- }
-
- connection(connection&& other) = default;
-
- connection& operator=(connection&& rhs) = default;
- #ifndef BOOST_MYSQL_DOXYGEN
- connection(const connection&) = delete;
- connection& operator=(const connection&) = delete;
- #endif
-
- using executor_type = typename Stream::executor_type;
-
- executor_type get_executor() { return stream().get_executor(); }
-
- using stream_type = Stream;
-
- Stream& stream() noexcept { return detail::cast<Stream>(channel_.stream()); }
-
- const Stream& stream() const noexcept { return detail::cast<Stream>(channel_.stream()); }
-
- bool uses_ssl() const noexcept { return channel_.stream().ssl_active(); }
-
- metadata_mode meta_mode() const noexcept { return channel_.meta_mode(); }
-
- void set_meta_mode(metadata_mode v) noexcept { channel_.set_meta_mode(v); }
-
- template <typename EndpointType>
- void connect(
- const EndpointType& endpoint,
- const handshake_params& params,
- error_code& ec,
- diagnostics& diag
- )
- {
- static_assert(
- detail::is_socket_stream<Stream>::value,
- "connect can only be used if Stream satisfies the SocketStream concept"
- );
- detail::connect_interface<Stream>(channel_.get(), endpoint, params, ec, diag);
- }
-
- template <typename EndpointType>
- void connect(const EndpointType& endpoint, const handshake_params& params)
- {
- static_assert(
- detail::is_socket_stream<Stream>::value,
- "connect can only be used if Stream satisfies the SocketStream concept"
- );
- error_code err;
- diagnostics diag;
- connect(endpoint, params, err, diag);
- detail::throw_on_error_loc(err, diag, BOOST_CURRENT_LOCATION);
- }
-
- template <
- typename EndpointType,
- BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_connect(
- const EndpointType& endpoint,
- const handshake_params& params,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- static_assert(
- detail::is_socket_stream<Stream>::value,
- "async_connect can only be used if Stream satisfies the SocketStream concept"
- );
- return async_connect(endpoint, params, this->shared_diag(), std::forward<CompletionToken>(token));
- }
-
- template <
- typename EndpointType,
- BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_connect(
- const EndpointType& endpoint,
- const handshake_params& params,
- diagnostics& diag,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- static_assert(
- detail::is_socket_stream<Stream>::value,
- "async_connect can only be used if Stream satisfies the SocketStream concept"
- );
- return detail::async_connect_interface<Stream>(
- channel_.get(),
- endpoint,
- params,
- diag,
- std::forward<CompletionToken>(token)
- );
- }
-
- void handshake(const handshake_params& params, error_code& ec, diagnostics& diag)
- {
- detail::handshake_interface(channel_.get(), params, ec, diag);
- }
-
- void handshake(const handshake_params& params)
- {
- error_code err;
- diagnostics diag;
- handshake(params, err, diag);
- detail::throw_on_error_loc(err, diag, BOOST_CURRENT_LOCATION);
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_handshake(
- const handshake_params& params,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_handshake(params, shared_diag(), std::forward<CompletionToken>(token));
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_handshake(
- const handshake_params& params,
- diagnostics& diag,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return detail::async_handshake_interface(
- channel_.get(),
- params,
- diag,
- std::forward<CompletionToken>(token)
- );
- }
-
- template <BOOST_MYSQL_EXECUTION_REQUEST ExecutionRequest, BOOST_MYSQL_RESULTS_TYPE ResultsType>
- void execute(const ExecutionRequest& req, ResultsType& result, error_code& err, diagnostics& diag)
- {
- detail::execute_interface(channel_.get(), req, result, err, diag);
- }
-
- template <BOOST_MYSQL_EXECUTION_REQUEST ExecutionRequest, BOOST_MYSQL_RESULTS_TYPE ResultsType>
- void execute(const ExecutionRequest& req, ResultsType& result)
- {
- error_code err;
- diagnostics diag;
- execute(req, result, err, diag);
- detail::throw_on_error_loc(err, diag, BOOST_CURRENT_LOCATION);
- }
-
- template <
- BOOST_MYSQL_EXECUTION_REQUEST ExecutionRequest,
- BOOST_MYSQL_RESULTS_TYPE ResultsType,
- BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_execute(
- ExecutionRequest&& req,
- ResultsType& result,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_execute(
- std::forward<ExecutionRequest>(req),
- result,
- shared_diag(),
- std::forward<CompletionToken>(token)
- );
- }
-
- template <
- BOOST_MYSQL_EXECUTION_REQUEST ExecutionRequest,
- BOOST_MYSQL_RESULTS_TYPE ResultsType,
- BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_execute(
- ExecutionRequest&& req,
- ResultsType& result,
- diagnostics& diag,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return detail::async_execute_interface(
- channel_.get(),
- std::forward<ExecutionRequest>(req),
- result,
- diag,
- std::forward<CompletionToken>(token)
- );
- }
-
- template <
- BOOST_MYSQL_EXECUTION_REQUEST ExecutionRequest,
- BOOST_MYSQL_EXECUTION_STATE_TYPE ExecutionStateType>
- void start_execution(
- const ExecutionRequest& req,
- ExecutionStateType& st,
- error_code& err,
- diagnostics& diag
- )
- {
- detail::start_execution_interface(channel_.get(), req, st, err, diag);
- }
-
- template <
- BOOST_MYSQL_EXECUTION_REQUEST ExecutionRequest,
- BOOST_MYSQL_EXECUTION_STATE_TYPE ExecutionStateType>
- void start_execution(const ExecutionRequest& req, ExecutionStateType& st)
- {
- error_code err;
- diagnostics diag;
- start_execution(req, st, err, diag);
- detail::throw_on_error_loc(err, diag, BOOST_CURRENT_LOCATION);
- }
-
- template <
- BOOST_MYSQL_EXECUTION_REQUEST ExecutionRequest,
- BOOST_MYSQL_EXECUTION_STATE_TYPE ExecutionStateType,
- BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_start_execution(
- ExecutionRequest&& req,
- ExecutionStateType& st,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_start_execution(
- std::forward<ExecutionRequest>(req),
- st,
- shared_diag(),
- std::forward<CompletionToken>(token)
- );
- }
-
- template <
- BOOST_MYSQL_EXECUTION_REQUEST ExecutionRequest,
- BOOST_MYSQL_EXECUTION_STATE_TYPE ExecutionStateType,
- BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_start_execution(
- ExecutionRequest&& req,
- ExecutionStateType& st,
- diagnostics& diag,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return detail::async_start_execution_interface(
- channel_.get(),
- std::forward<ExecutionRequest>(req),
- st,
- diag,
- std::forward<CompletionToken>(token)
- );
- }
-
- void query(string_view query_string, results& result, error_code& err, diagnostics& diag)
- {
- execute(query_string, result, err, diag);
- }
-
- void query(string_view query_string, results& result) { execute(query_string, result); }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_query(
- string_view query_string,
- results& result,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_query(query_string, result, shared_diag(), std::forward<CompletionToken>(token));
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_query(
- string_view query_string,
- results& result,
- diagnostics& diag,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_execute(query_string, result, diag, std::forward<CompletionToken>(token));
- }
-
- void start_query(string_view query_string, execution_state& st, error_code& err, diagnostics& diag)
- {
- start_execution(query_string, st, err, diag);
- }
-
- void start_query(string_view query_string, execution_state& st) { start_execution(query_string, st); }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_start_query(
- string_view query_string,
- execution_state& st,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_start_query(query_string, st, shared_diag(), std::forward<CompletionToken>(token));
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_start_query(
- string_view query_string,
- execution_state& st,
- diagnostics& diag,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_start_execution(query_string, st, diag, std::forward<CompletionToken>(token));
- }
-
- statement prepare_statement(string_view stmt, error_code& err, diagnostics& diag)
- {
- return detail::prepare_statement_interface(channel_.get(), stmt, err, diag);
- }
-
- statement prepare_statement(string_view stmt)
- {
- error_code err;
- diagnostics diag;
- statement res = prepare_statement(stmt, err, diag);
- detail::throw_on_error_loc(err, diag, BOOST_CURRENT_LOCATION);
- return res;
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code, ::boost::mysql::statement))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code, statement))
- async_prepare_statement(
- string_view stmt,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_prepare_statement(stmt, shared_diag(), std::forward<CompletionToken>(token));
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code, ::boost::mysql::statement))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code, statement))
- async_prepare_statement(
- string_view stmt,
- diagnostics& diag,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return detail::async_prepare_statement_interface(
- channel_.get(),
- stmt,
- diag,
- std::forward<CompletionToken>(token)
- );
- }
-
- template <
- BOOST_MYSQL_WRITABLE_FIELD_TUPLE WritableFieldTuple,
- class EnableIf =
- typename std::enable_if<detail::is_writable_field_tuple<WritableFieldTuple>::value>::type>
- void execute_statement(
- const statement& stmt,
- const WritableFieldTuple& params,
- results& result,
- error_code& err,
- diagnostics& diag
- )
- {
- execute(stmt.bind(params), result, err, diag);
- }
-
- template <
- BOOST_MYSQL_WRITABLE_FIELD_TUPLE WritableFieldTuple,
- class EnableIf =
- typename std::enable_if<detail::is_writable_field_tuple<WritableFieldTuple>::value>::type>
- void execute_statement(const statement& stmt, const WritableFieldTuple& params, results& result)
- {
- execute(stmt.bind(params), result);
- }
-
- template <
- BOOST_MYSQL_WRITABLE_FIELD_TUPLE WritableFieldTuple,
- BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type),
- class EnableIf =
- typename std::enable_if<detail::is_writable_field_tuple<WritableFieldTuple>::value>::type>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_execute_statement(
- const statement& stmt,
- WritableFieldTuple&& params,
- results& result,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_execute_statement(
- stmt,
- std::forward<WritableFieldTuple>(params),
- result,
- shared_diag(),
- std::forward<CompletionToken>(token)
- );
- }
-
- template <
- BOOST_MYSQL_WRITABLE_FIELD_TUPLE WritableFieldTuple,
- BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type),
- class EnableIf =
- typename std::enable_if<detail::is_writable_field_tuple<WritableFieldTuple>::value>::type>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_execute_statement(
- const statement& stmt,
- WritableFieldTuple&& params,
- results& result,
- diagnostics& diag,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_execute(
- stmt.bind(std::forward<WritableFieldTuple>(params)),
- result,
- diag,
- std::forward<CompletionToken>(token)
- );
- }
-
- template <
- BOOST_MYSQL_WRITABLE_FIELD_TUPLE WritableFieldTuple,
- class EnableIf =
- typename std::enable_if<detail::is_writable_field_tuple<WritableFieldTuple>::value>::type>
- void start_statement_execution(
- const statement& stmt,
- const WritableFieldTuple& params,
- execution_state& st,
- error_code& err,
- diagnostics& diag
- )
- {
- start_execution(stmt.bind(params), st, err, diag);
- }
-
- template <
- BOOST_MYSQL_WRITABLE_FIELD_TUPLE WritableFieldTuple,
- class EnableIf =
- typename std::enable_if<detail::is_writable_field_tuple<WritableFieldTuple>::value>::type>
- void start_statement_execution(
- const statement& stmt,
- const WritableFieldTuple& params,
- execution_state& st
- )
- {
- start_execution(stmt.bind(params), st);
- }
-
- template <
- BOOST_MYSQL_WRITABLE_FIELD_TUPLE WritableFieldTuple,
- BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type),
- class EnableIf =
- typename std::enable_if<detail::is_writable_field_tuple<WritableFieldTuple>::value>::type>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_start_statement_execution(
- const statement& stmt,
- WritableFieldTuple&& params,
- execution_state& st,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_start_statement_execution(
- stmt,
- std::forward<WritableFieldTuple>(params),
- st,
- shared_diag(),
- std::forward<CompletionToken>(token)
- );
- }
-
- template <
- BOOST_MYSQL_WRITABLE_FIELD_TUPLE WritableFieldTuple,
- BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type),
- class EnableIf =
- typename std::enable_if<detail::is_writable_field_tuple<WritableFieldTuple>::value>::type>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_start_statement_execution(
- const statement& stmt,
- WritableFieldTuple&& params,
- execution_state& st,
- diagnostics& diag,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_start_execution(
- stmt.bind(std::forward<WritableFieldTuple>(params)),
- st,
- diag,
- std::forward<CompletionToken>(token)
- );
- }
-
- template <BOOST_MYSQL_FIELD_VIEW_FORWARD_ITERATOR FieldViewFwdIterator>
- void start_statement_execution(
- const statement& stmt,
- FieldViewFwdIterator params_first,
- FieldViewFwdIterator params_last,
- execution_state& st,
- error_code& ec,
- diagnostics& diag
- )
- {
- start_execution(stmt.bind(params_first, params_last), st, ec, diag);
- }
-
- template <BOOST_MYSQL_FIELD_VIEW_FORWARD_ITERATOR FieldViewFwdIterator>
- void start_statement_execution(
- const statement& stmt,
- FieldViewFwdIterator params_first,
- FieldViewFwdIterator params_last,
- execution_state& st
- )
- {
- start_execution(stmt.bind(params_first, params_last), st);
- }
-
- template <
- BOOST_MYSQL_FIELD_VIEW_FORWARD_ITERATOR FieldViewFwdIterator,
- BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_start_statement_execution(
- const statement& stmt,
- FieldViewFwdIterator params_first,
- FieldViewFwdIterator params_last,
- execution_state& st,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_start_statement_execution(
- stmt,
- params_first,
- params_last,
- st,
- shared_diag(),
- std::forward<CompletionToken>(token)
- );
- }
-
- template <
- BOOST_MYSQL_FIELD_VIEW_FORWARD_ITERATOR FieldViewFwdIterator,
- BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_start_statement_execution(
- const statement& stmt,
- FieldViewFwdIterator params_first,
- FieldViewFwdIterator params_last,
- execution_state& st,
- diagnostics& diag,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_start_execution(
- stmt.bind(params_first, params_last),
- st,
- diag,
- std::forward<CompletionToken>(token)
- );
- }
-
- void close_statement(const statement& stmt, error_code& err, diagnostics& diag)
- {
- detail::close_statement_interface(channel_.get(), stmt, err, diag);
- }
-
- void close_statement(const statement& stmt)
- {
- error_code err;
- diagnostics diag;
- close_statement(stmt, err, diag);
- detail::throw_on_error_loc(err, diag, BOOST_CURRENT_LOCATION);
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_close_statement(
- const statement& stmt,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_close_statement(stmt, shared_diag(), std::forward<CompletionToken>(token));
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_close_statement(
- const statement& stmt,
- diagnostics& diag,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return detail::async_close_statement_interface(
- channel_.get(),
- stmt,
- diag,
- std::forward<CompletionToken>(token)
- );
- }
-
- rows_view read_some_rows(execution_state& st, error_code& err, diagnostics& diag)
- {
- return detail::read_some_rows_dynamic_interface(channel_.get(), st, err, diag);
- }
-
- rows_view read_some_rows(execution_state& st)
- {
- error_code err;
- diagnostics diag;
- rows_view res = read_some_rows(st, err, diag);
- detail::throw_on_error_loc(err, diag, BOOST_CURRENT_LOCATION);
- return res;
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code, ::boost::mysql::rows_view))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code, rows_view))
- async_read_some_rows(
- execution_state& st,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_read_some_rows(st, shared_diag(), std::forward<CompletionToken>(token));
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code, ::boost::mysql::rows_view))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code, rows_view))
- async_read_some_rows(
- execution_state& st,
- diagnostics& diag,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return detail::async_read_some_rows_dynamic_interface(
- channel_.get(),
- st,
- diag,
- std::forward<CompletionToken>(token)
- );
- }
- #ifdef BOOST_MYSQL_CXX14
-
- template <class SpanStaticRow, class... StaticRow>
- std::size_t read_some_rows(
- static_execution_state<StaticRow...>& st,
- span<SpanStaticRow> output,
- error_code& err,
- diagnostics& diag
- )
- {
- return detail::read_some_rows_static_interface(channel_.get(), st, output, err, diag);
- }
-
- template <class SpanStaticRow, class... StaticRow>
- std::size_t read_some_rows(static_execution_state<StaticRow...>& st, span<SpanStaticRow> output)
- {
- error_code err;
- diagnostics diag;
- std::size_t res = read_some_rows(st, output, err, diag);
- detail::throw_on_error_loc(err, diag, BOOST_CURRENT_LOCATION);
- return res;
- }
-
- template <
- class SpanStaticRow,
- class... StaticRow,
- BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code, std::size_t))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code, std::size_t))
- async_read_some_rows(
- static_execution_state<StaticRow...>& st,
- span<SpanStaticRow> output,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_read_some_rows(st, output, shared_diag(), std::forward<CompletionToken>(token));
- }
-
- template <
- class SpanStaticRow,
- class... StaticRow,
- BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code, std::size_t))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code, std::size_t))
- async_read_some_rows(
- static_execution_state<StaticRow...>& st,
- span<SpanStaticRow> output,
- diagnostics& diag,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return detail::async_read_some_rows_static_interface(
- channel_.get(),
- st,
- output,
- diag,
- std::forward<CompletionToken>(token)
- );
- }
- #endif
-
- template <BOOST_MYSQL_EXECUTION_STATE_TYPE ExecutionStateType>
- void read_resultset_head(ExecutionStateType& st, error_code& err, diagnostics& diag)
- {
- return detail::read_resultset_head_interface(channel_.get(), st, err, diag);
- }
-
- template <BOOST_MYSQL_EXECUTION_STATE_TYPE ExecutionStateType>
- void read_resultset_head(ExecutionStateType& st)
- {
- error_code err;
- diagnostics diag;
- read_resultset_head(st, err, diag);
- detail::throw_on_error_loc(err, diag, BOOST_CURRENT_LOCATION);
- }
-
- template <
- BOOST_MYSQL_EXECUTION_STATE_TYPE ExecutionStateType,
- BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_read_resultset_head(
- ExecutionStateType& st,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return async_read_resultset_head(st, shared_diag(), std::forward<CompletionToken>(token));
- }
-
- template <
- BOOST_MYSQL_EXECUTION_STATE_TYPE ExecutionStateType,
- BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_read_resultset_head(
- ExecutionStateType& st,
- diagnostics& diag,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return detail::async_read_resultset_head_interface(
- channel_.get(),
- st,
- diag,
- std::forward<CompletionToken>(token)
- );
- }
-
- void ping(error_code& err, diagnostics& diag) { detail::ping_interface(channel_.get(), err, diag); }
-
- void ping()
- {
- error_code err;
- diagnostics diag;
- ping(err, diag);
- detail::throw_on_error_loc(err, diag, BOOST_CURRENT_LOCATION);
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_ping(CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
- {
- return async_ping(shared_diag(), std::forward<CompletionToken>(token));
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_ping(diagnostics& diag, CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
- {
- return detail::async_ping_interface(channel_.get(), diag, std::forward<CompletionToken>(token));
- }
-
- void reset_connection(error_code& err, diagnostics& diag)
- {
- detail::reset_connection_interface(channel_.get(), err, diag);
- }
-
- void reset_connection()
- {
- error_code err;
- diagnostics diag;
- reset_connection(err, diag);
- detail::throw_on_error_loc(err, diag, BOOST_CURRENT_LOCATION);
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_reset_connection(CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
- {
- return async_reset_connection(shared_diag(), std::forward<CompletionToken>(token));
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_reset_connection(
- diagnostics& diag,
- CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type)
- )
- {
- return detail::async_reset_connection_interface(
- channel_.get(),
- diag,
- std::forward<CompletionToken>(token)
- );
- }
-
- void close(error_code& err, diagnostics& diag)
- {
- static_assert(
- detail::is_socket_stream<Stream>::value,
- "close can only be used if Stream satisfies the SocketStream concept"
- );
- detail::close_connection_interface(channel_.get(), err, diag);
- }
-
- void close()
- {
- static_assert(
- detail::is_socket_stream<Stream>::value,
- "close can only be used if Stream satisfies the SocketStream concept"
- );
- error_code err;
- diagnostics diag;
- close(err, diag);
- detail::throw_on_error_loc(err, diag, BOOST_CURRENT_LOCATION);
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_close(CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
- {
- static_assert(
- detail::is_socket_stream<Stream>::value,
- "async_close can only be used if Stream satisfies the SocketStream concept"
- );
- return async_close(shared_diag(), std::forward<CompletionToken>(token));
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_close(diagnostics& diag, CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
- {
- static_assert(
- detail::is_socket_stream<Stream>::value,
- "async_close can only be used if Stream satisfies the SocketStream concept"
- );
- return detail::async_close_connection_interface(
- channel_.get(),
- diag,
- std::forward<CompletionToken>(token)
- );
- }
-
- void quit(error_code& err, diagnostics& diag)
- {
- detail::quit_connection_interface(channel_.get(), err, diag);
- }
-
- void quit()
- {
- error_code err;
- diagnostics diag;
- quit(err, diag);
- detail::throw_on_error_loc(err, diag, BOOST_CURRENT_LOCATION);
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_quit(CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
- {
- return async_quit(shared_diag(), std::forward<CompletionToken>(token));
- }
-
- template <BOOST_ASIO_COMPLETION_TOKEN_FOR(void(::boost::mysql::error_code))
- CompletionToken BOOST_ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
- BOOST_ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken, void(error_code))
- async_quit(diagnostics& diag, CompletionToken&& token BOOST_ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
- {
- return detail::async_quit_connection_interface(
- channel_.get(),
- diag,
- std::forward<CompletionToken>(token)
- );
- }
-
- template <typename Executor1>
- struct rebind_executor
- {
-
- using other = connection<typename detail::rebind_executor<Stream, Executor1>::type>;
- };
- };
- constexpr unsigned short default_port = 3306;
- constexpr const char* default_port_string = "3306";
- }
- }
- #endif
|