summaryrefslogtreecommitdiffstats
path: root/sql/protocol.h
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-05-04 18:07:14 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-05-04 18:07:14 +0000
commita175314c3e5827eb193872241446f2f8f5c9d33c (patch)
treecd3d60ca99ae00829c52a6ca79150a5b6e62528b /sql/protocol.h
parentInitial commit. (diff)
downloadmariadb-10.5-upstream/1%10.5.12.tar.xz
mariadb-10.5-upstream/1%10.5.12.zip
Adding upstream version 1:10.5.12.upstream/1%10.5.12upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'sql/protocol.h')
-rw-r--r--sql/protocol.h331
1 files changed, 331 insertions, 0 deletions
diff --git a/sql/protocol.h b/sql/protocol.h
new file mode 100644
index 00000000..eb11304a
--- /dev/null
+++ b/sql/protocol.h
@@ -0,0 +1,331 @@
+#ifndef PROTOCOL_INCLUDED
+#define PROTOCOL_INCLUDED
+
+/* Copyright (c) 2002, 2010, Oracle and/or its affiliates. All rights reserved.
+ Copyright (c) 2020, MariaDB Corporation.
+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; version 2 of the License.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1335 USA */
+
+#ifdef USE_PRAGMA_INTERFACE
+#pragma interface /* gcc class implementation */
+#endif
+
+#include "sql_error.h"
+#include "my_decimal.h" /* my_decimal */
+#include "sql_type.h"
+
+class i_string;
+class Field;
+class Send_field;
+class THD;
+class Item_param;
+struct TABLE_LIST;
+typedef struct st_mysql_field MYSQL_FIELD;
+typedef struct st_mysql_rows MYSQL_ROWS;
+
+class Protocol
+{
+protected:
+ String *packet;
+ /* Used by net_store_data() for charset conversions */
+ String *convert;
+ uint field_pos;
+#ifndef DBUG_OFF
+ const Type_handler **field_handlers;
+ bool valid_handler(uint pos, protocol_send_type_t type) const
+ {
+ return field_handlers == 0 ||
+ field_handlers[field_pos]->protocol_send_type() == type;
+ }
+#endif
+ uint field_count;
+ virtual bool net_store_data(const uchar *from, size_t length);
+ virtual bool net_store_data_cs(const uchar *from, size_t length,
+ CHARSET_INFO *fromcs, CHARSET_INFO *tocs);
+ virtual bool net_send_ok(THD *, uint, uint, ulonglong, ulonglong, const char *,
+ bool, bool);
+ virtual bool net_send_error_packet(THD *, uint, const char *, const char *);
+#ifdef EMBEDDED_LIBRARY
+ char **next_field;
+ MYSQL_FIELD *next_mysql_field;
+ MEM_ROOT *alloc;
+#endif
+ bool needs_conversion(CHARSET_INFO *fromcs,
+ CHARSET_INFO *tocs) const
+ {
+ // 'tocs' is set 0 when client issues SET character_set_results=NULL
+ return tocs && !my_charset_same(fromcs, tocs) &&
+ fromcs != &my_charset_bin &&
+ tocs != &my_charset_bin;
+ }
+ /*
+ The following two are low-level functions that are invoked from
+ higher-level store_xxx() funcs. The data is stored into this->packet.
+ */
+ bool store_string_aux(const char *from, size_t length,
+ CHARSET_INFO *fromcs, CHARSET_INFO *tocs);
+
+ virtual bool send_ok(uint server_status, uint statement_warn_count,
+ ulonglong affected_rows, ulonglong last_insert_id,
+ const char *message, bool skip_flush);
+
+ virtual bool send_eof(uint server_status, uint statement_warn_count);
+
+ virtual bool send_error(uint sql_errno, const char *err_msg,
+ const char *sql_state);
+
+ CHARSET_INFO *character_set_results() const;
+
+public:
+ THD *thd;
+ Protocol(THD *thd_arg) { init(thd_arg); }
+ virtual ~Protocol() {}
+ void init(THD* thd_arg);
+
+ enum { SEND_NUM_ROWS= 1, SEND_EOF= 2 };
+ virtual bool send_result_set_metadata(List<Item> *list, uint flags);
+ bool send_list_fields(List<Field> *list, const TABLE_LIST *table_list);
+ bool send_result_set_row(List<Item> *row_items);
+
+ bool store(I_List<i_string> *str_list);
+ bool store(const char *from, CHARSET_INFO *cs);
+ bool store_warning(const char *from, size_t length);
+ String *storage_packet() { return packet; }
+ inline void free() { packet->free(); }
+ virtual bool write();
+ inline bool store(int from)
+ { return store_long((longlong) from); }
+ inline bool store(uint32 from)
+ { return store_long((longlong) from); }
+ inline bool store(longlong from)
+ { return store_longlong((longlong) from, 0); }
+ inline bool store(ulonglong from)
+ { return store_longlong((longlong) from, 1); }
+ inline bool store(String *str)
+ { return store((char*) str->ptr(), str->length(), str->charset()); }
+
+ virtual bool prepare_for_send(uint num_columns)
+ {
+ field_count= num_columns;
+ return 0;
+ }
+ virtual bool flush();
+ virtual void end_partial_result_set(THD *thd);
+ virtual void prepare_for_resend()=0;
+
+ virtual bool store_null()=0;
+ virtual bool store_tiny(longlong from)=0;
+ virtual bool store_short(longlong from)=0;
+ virtual bool store_long(longlong from)=0;
+ virtual bool store_longlong(longlong from, bool unsigned_flag)=0;
+ virtual bool store_decimal(const my_decimal *)=0;
+ virtual bool store_str(const char *from, size_t length,
+ CHARSET_INFO *fromcs, CHARSET_INFO *tocs)=0;
+ virtual bool store_float(float from, uint32 decimals)=0;
+ virtual bool store_double(double from, uint32 decimals)=0;
+ virtual bool store(MYSQL_TIME *time, int decimals)=0;
+ virtual bool store_date(MYSQL_TIME *time)=0;
+ virtual bool store_time(MYSQL_TIME *time, int decimals)=0;
+ virtual bool store(Field *field)=0;
+
+ // Various useful wrappers for the virtual store*() methods.
+ // Backward wrapper for store_str()
+ bool store(const char *from, size_t length, CHARSET_INFO *cs)
+ {
+ return store_str(from, length, cs, character_set_results());
+ }
+ bool store_lex_cstring(const LEX_CSTRING &s,
+ CHARSET_INFO *fromcs,
+ CHARSET_INFO *tocs)
+ {
+ return store_str(s.str, (uint) s.length, fromcs, tocs);
+ }
+ bool store_binary_string(const char *str, size_t length)
+ {
+ return store_str(str, (uint) length, &my_charset_bin, &my_charset_bin);
+ }
+ bool store_ident(const LEX_CSTRING &s)
+ {
+ return store_lex_cstring(s, system_charset_info, character_set_results());
+ }
+ // End of wrappers
+
+ virtual bool send_out_parameters(List<Item_param> *sp_params)=0;
+#ifdef EMBEDDED_LIBRARY
+ bool begin_dataset();
+ bool begin_dataset(THD *thd, uint numfields);
+ virtual void remove_last_row() {}
+#else
+ void remove_last_row() {}
+#endif
+ enum enum_protocol_type
+ {
+ /*
+ Before adding a new type, please make sure
+ there is enough storage for it in Query_cache_query_flags.
+ */
+ PROTOCOL_TEXT= 0, PROTOCOL_BINARY= 1, PROTOCOL_LOCAL= 2,
+ PROTOCOL_DISCARD= 3 /* Should be last, not used by Query_cache */
+ };
+ virtual enum enum_protocol_type type()= 0;
+
+ virtual bool net_send_eof(THD *thd, uint server_status, uint statement_warn_count);
+ bool net_send_error(THD *thd, uint sql_errno, const char *err,
+ const char* sqlstate);
+ void end_statement();
+
+ friend int send_answer_1(Protocol *protocol, String *s1, String *s2,
+ String *s3);
+ friend int send_header_2(Protocol *protocol, bool for_category);
+};
+
+
+/** Class used for the old (MySQL 4.0 protocol). */
+
+class Protocol_text :public Protocol
+{
+ StringBuffer<FLOATING_POINT_BUFFER> buffer;
+ bool store_numeric_string_aux(const char *from, size_t length);
+public:
+ Protocol_text(THD *thd_arg, ulong prealloc= 0)
+ :Protocol(thd_arg)
+ {
+ if (prealloc)
+ packet->alloc(prealloc);
+ }
+ void prepare_for_resend() override;
+ bool store_null() override;
+ bool store_tiny(longlong from) override;
+ bool store_short(longlong from) override;
+ bool store_long(longlong from) override;
+ bool store_longlong(longlong from, bool unsigned_flag) override;
+ bool store_decimal(const my_decimal *) override;
+ bool store_str(const char *from, size_t length,
+ CHARSET_INFO *fromcs, CHARSET_INFO *tocs) override;
+ bool store(MYSQL_TIME *time, int decimals) override;
+ bool store_date(MYSQL_TIME *time) override;
+ bool store_time(MYSQL_TIME *time, int decimals) override;
+ bool store_float(float nr, uint32 decimals) override;
+ bool store_double(double from, uint32 decimals) override;
+ bool store(Field *field) override;
+
+ bool send_out_parameters(List<Item_param> *sp_params) override;
+
+ bool store_numeric_zerofill_str(const char *from, size_t length,
+ protocol_send_type_t send_type);
+
+#ifdef EMBEDDED_LIBRARY
+ void remove_last_row() override;
+#endif
+ virtual bool store_field_metadata(const THD *thd, const Send_field &field,
+ CHARSET_INFO *charset_for_protocol,
+ uint pos);
+ bool store_item_metadata(THD *thd, Item *item, uint pos);
+ bool store_field_metadata_for_list_fields(const THD *thd, Field *field,
+ const TABLE_LIST *table_list,
+ uint pos);
+ enum enum_protocol_type type() override { return PROTOCOL_TEXT; };
+};
+
+
+class Protocol_binary final :public Protocol
+{
+private:
+ uint bit_fields;
+public:
+ Protocol_binary(THD *thd_arg) :Protocol(thd_arg) {}
+ bool prepare_for_send(uint num_columns) override;
+ void prepare_for_resend() override;
+#ifdef EMBEDDED_LIBRARY
+ bool write() override;
+ bool net_store_data(const uchar *from, size_t length) override;
+ bool net_store_data_cs(const uchar *from, size_t length,
+ CHARSET_INFO *fromcs, CHARSET_INFO *tocs) override;
+#endif
+ bool store_null() override;
+ bool store_tiny(longlong from) override;
+ bool store_short(longlong from) override;
+ bool store_long(longlong from) override;
+ bool store_longlong(longlong from, bool unsigned_flag) override;
+ bool store_decimal(const my_decimal *) override;
+ bool store_str(const char *from, size_t length,
+ CHARSET_INFO *fromcs, CHARSET_INFO *tocs) override;
+ bool store(MYSQL_TIME *time, int decimals) override;
+ bool store_date(MYSQL_TIME *time) override;
+ bool store_time(MYSQL_TIME *time, int decimals) override;
+ bool store_float(float nr, uint32 decimals) override;
+ bool store_double(double from, uint32 decimals) override;
+ bool store(Field *field) override;
+
+ bool send_out_parameters(List<Item_param> *sp_params) override;
+
+ enum enum_protocol_type type() override { return PROTOCOL_BINARY; };
+};
+
+
+/*
+ A helper for "ANALYZE $stmt" which looks a real network procotol but doesn't
+ write results to the network.
+
+ At first glance, class select_send looks like a more appropriate place to
+ implement the "write nothing" hook. This is not true, because
+ - we need to evaluate the value of every item, and do it the way
+ select_send does it (i.e. call item->val_int() or val_real() or...)
+ - select_send::send_data() has some other code, like telling the storage
+ engine that the row can be unlocked. We want to keep that also.
+ as a result, "ANALYZE $stmt" uses a select_send_analyze which still uses
+ select_send::send_data() & co., and also uses Protocol_discard object.
+*/
+
+class Protocol_discard final : public Protocol
+{
+public:
+ Protocol_discard(THD *thd_arg) : Protocol(thd_arg) {}
+ bool write() override { return 0; }
+ bool send_result_set_metadata(List<Item> *, uint) override { return 0; }
+ bool send_eof(uint, uint) override { return 0; }
+ void prepare_for_resend() override { IF_DBUG(field_pos= 0,); }
+ bool send_out_parameters(List<Item_param> *sp_params) override { return false; }
+
+ /*
+ Provide dummy overrides for any storage methods so that we
+ avoid allocating and copying of data
+ */
+ bool store_null() override { return false; }
+ bool store_tiny(longlong) override { return false; }
+ bool store_short(longlong) override { return false; }
+ bool store_long(longlong) override { return false; }
+ bool store_longlong(longlong, bool) override { return false; }
+ bool store_decimal(const my_decimal *) override { return false; }
+ bool store_str(const char *, size_t, CHARSET_INFO *, CHARSET_INFO *) override
+ {
+ return false;
+ }
+ bool store(MYSQL_TIME *, int) override { return false; }
+ bool store_date(MYSQL_TIME *) override { return false; }
+ bool store_time(MYSQL_TIME *, int) override { return false; }
+ bool store_float(float, uint32) override { return false; }
+ bool store_double(double, uint32) override { return false; }
+ bool store(Field *) override { return false; }
+ enum enum_protocol_type type() override { return PROTOCOL_DISCARD; };
+};
+
+
+void send_warning(THD *thd, uint sql_errno, const char *err=0);
+void net_send_progress_packet(THD *thd);
+uchar *net_store_data(uchar *to,const uchar *from, size_t length);
+uchar *net_store_data(uchar *to,int32 from);
+uchar *net_store_data(uchar *to,longlong from);
+
+#endif /* PROTOCOL_INCLUDED */