ClickHouse/libs/libmysqlxx/include/mysqlxx/Query.h

#pragma once

#include <sstream>
#include <ostream>

#include <mysqlxx/UseQueryResult.h>
#include <mysqlxx/StoreQueryResult.h>


namespace mysqlxx
{


/** Запрос.
  * Ссылается на Connection. Если уничтожить Connection, то Query станет некорректным и пользоваться им будет нельзя.
  *
  * Пример использования:
  *		mysqlxx::Query query = connection.query();
  *		query << "SELECT 1 AS x, 2 AS y, 3 AS z";
  *		query << " LIMIT 1";
  *		mysqlxx::UseQueryResult result = query.use();
  *
  *		while (mysqlxx::Row row = result.fetch())
  *			std::cout << row["x"] << std::endl;
  *
  * В отличие от библиотеки mysql++, запрос можно копировать.
  * (то есть, запрос можно класть в контейнеры STL и ничего с ним не будет)
  *
  * Внимание! Один объект запроса можно использовать только из одного потока.
  */
class Query : public std::ostream
{
public:
	Query(Connection * conn_, const std::string & query_string = "");
	Query(const Query & other);
	Query & operator= (const Query & other);
	~Query();

	/** Сбросить текст запроса. Это используется, если нужно написать новый запрос в том же объекте. */
	void reset();

	/** Выполнить запрос, результат которого не имеет значения (почти всё кроме SELECT). */
	void execute();

	/** Выполнить запрос, с возможностью загружать на клиента строки одна за другой.
	  * То есть, оперативка расходуется только на одну строку.
	  */
	UseQueryResult use();

	/** Выполнить запрос с загрузкой на клиента всех строк.
	  * Требуется оперативка, чтобы вместить весь результат, зато к строкам можно обращаться в произвольном порядке.
	  */
	StoreQueryResult store();

	/// Значение auto increment после последнего INSERT-а.
	UInt64 insertID();

	/// Для совместимости, то же, что insertID().
	UInt64 insert_id() { return insertID(); }

	/// Получить текст запроса (например, для вывода его в лог). См. ещё operator<< ниже.
	std::string str() const
	{
		return query_buf.str();
	}

private:
	Connection * conn;
	std::stringbuf query_buf;

	void executeImpl();
};


/// Вывести текст запроса в ostream.
inline std::ostream & operator<< (std::ostream & ostr, const Query & query)
{
	return ostr << query.rdbuf();
}


}