Init

DependentExtensions/SQLite3Plugin/SQLite3ClientPlugin.h

@@ -0,0 +1,133 @@
+/*
+ *  Original work: Copyright (c) 2014, Oculus VR, Inc.
+ *  All rights reserved.
+ *
+ *  This source code is licensed under the BSD-style license found in the
+ *  RakNet License.txt file in the licenses directory of this source tree. An additional grant 
+ *  of patent rights can be found in the RakNet Patents.txt file in the same directory.
+ *
+ *
+ *  Modified work: Copyright (c) 2017, SLikeSoft UG (haftungsbeschränkt)
+ *
+ *  This source code was modified by SLikeSoft. Modifications are licensed under the MIT-style
+ *  license found in the license.txt file in the root directory of this source tree.
+ */
+
+/// \file
+/// \brief Contains code to call sqlite3_exec over a network that does not support shared file handles.
+///
+
+
+
+#ifndef ___SQLITE_3_CLIENT_PLUGIN_H
+#define ___SQLITE_3_CLIENT_PLUGIN_H
+
+#include "slikenet/types.h"
+#include "slikenet/Export.h"
+#include "slikenet/PluginInterface2.h"
+#include "slikenet/PacketPriority.h"
+#include "slikenet/SocketIncludes.h"
+#include "slikenet/DS_Multilist.h"
+#include "slikenet/string.h"
+#include "SQLite3PluginCommon.h"
+
+class RakPeerInterface;
+
+namespace SLNet
+{
+
+/// \brief Handles results of calls to SQLite3Plugin::_sqlite3_exec()
+/// Results from calling SQLite3Plugin::_sqlite3_exec() are handled in this callback.
+/// You should implement the callback, and let the plugin know about it via SQLite3Plugin::AddResultHandler()
+/// Be sure to call SQLite3Plugin::RemoveResultHandler() or SQLite3Plugin::ClearResultHandlers() if you delete the callback
+/// \ingroup SQL_LITE_3_PLUGIN
+class SQLite3PluginResultInterface
+{
+public:
+
+	/// Query executed, possibly returning data or an error message
+	///
+	/// \param[out] inputStatement Passed to SQLite3Plugin::_sqlite3_exec
+	/// \param[out] queryId Returned from SQLite3Plugin::_sqlite3_exec
+	/// \param[out] dbIdentifier Passed to SQLite3Plugin::_sqlite3_exec
+	/// \param[out] table Result of call to _sqlite3_exec, should that statement return a result
+	/// \param[out] errorMsg If _sqlite3_exec failed, then the error message is here, and table will be empty
+	/// \ingroup SQL_LITE_3_PLUGIN
+	virtual void _sqlite3_exec(
+		SLNet::RakString inputStatement,
+		unsigned int queryId,
+		SLNet::RakString dbIdentifier,
+		const SQLite3Table &table,
+		SLNet::RakString errorMsg)=0;
+
+	/// dbIdentifier is unknown on the remote system
+	///
+	/// \param[out] inputStatement Passed to SQLite3Plugin::_sqlite3_exec
+	/// \param[out] queryId Returned from SQLite3Plugin::_sqlite3_exec
+	/// \param[out] dbIdentifier Passed to SQLite3Plugin::_sqlite3_exec
+	/// \ingroup SQL_LITE_3_PLUGIN
+	virtual void OnUnknownDBIdentifier(
+		SLNet::RakString inputStatement,
+		unsigned int queryId,
+		SLNet::RakString dbIdentifier)=0;
+};
+
+/// Sample callback implementation that just prints to the screen the results
+/// \ingroup SQL_LITE_3_PLUGIN
+class SQLite3PluginResultInterface_Printf : public SQLite3PluginResultInterface
+{
+	virtual void _sqlite3_exec(
+		SLNet::RakString inputStatement,
+		unsigned int queryId,
+		SLNet::RakString dbIdentifier,
+		const SQLite3Table &table,
+		SLNet::RakString errorMsg);
+
+	virtual void OnUnknownDBIdentifier(
+		SLNet::RakString inputStatement,
+		unsigned int queryId,
+		SLNet::RakString dbIdentifier);
+};
+
+/// SQLite version 3 supports remote calls via networked file handles, but not over the regular internet
+/// This plugin will serialize calls to and results from sqlite3_exec
+/// That's all it does - any remote system can execute SQL queries.
+/// Intended as a starting platform to derive from for more advanced functionality (security over who can query, etc).
+/// Compatible as a plugin with both RakPeerInterface and PacketizedTCP
+/// \ingroup SQL_LITE_3_PLUGIN
+class RAK_DLL_EXPORT SQLite3ClientPlugin : public PluginInterface2
+{
+public:
+	SQLite3ClientPlugin();
+	virtual ~SQLite3ClientPlugin();
+
+	/// Add an interface to get callbacks for results
+	/// Up to user to make sure the pointer is valid through the lifetime of use
+	void AddResultHandler(SQLite3PluginResultInterface *res);
+	void RemoveResultHandler(SQLite3PluginResultInterface *res);
+	void ClearResultHandlers(void);
+
+	/// Execute a statement on the remote system
+	/// \note Don't forget to escape your input strings. RakString::SQLEscape() is available for this.
+	/// \param[in] dbIdentifier Which database to use, added with AddDBHandle()
+	/// \param[in] inputStatement SQL statement to execute
+	/// \param[in] priority See RakPeerInterface::Send()
+	/// \param[in] reliability See RakPeerInterface::Send()
+	/// \param[in] orderingChannel See RakPeerInterface::Send()
+	/// \param[in] systemAddress See RakPeerInterface::Send()
+	/// \return Query ID. Will be returned in _sqlite3_exec
+	unsigned int _sqlite3_exec(SLNet::RakString dbIdentifier, SLNet::RakString inputStatement,
+		PacketPriority priority, PacketReliability reliability, char orderingChannel, const SystemAddress &systemAddress);
+
+	/// \internal For plugin handling
+	virtual PluginReceiveResult OnReceive(Packet *packet);
+
+	// List of result handlers added with AddResultHandler()
+	DataStructures::List<SQLite3PluginResultInterface *> resultHandlers;
+	// Each query returns a numeric id if you want it. This tracks what id to assign next. Increments sequentially.
+	unsigned int nextQueryId;
+};
+
+}
+
+#endif