aaacf88071
popup containing a wxGrid object.
BasePicker : Abstract class adding a popup to wxPickerBase styled with
a wxTextCtrl.
BaseGridPicker : Abstract class adding a wxGrid in the popup.
JsonGridPickerCtrl : UI control storing the tabular data in a JSON
array.
LBoundJsonGridPicker : connect JsonGridPicker to database.
LGridJsonCellEditor : use LBoundJsonGridPicker in other wxGrid objects.
LGridJsonCellRenderer : render cell JSON data.
XmlGridPickerCtrl : UI control storing the tabular data in as XML
document.
LBoundXmlGridPicker : connect XmlGridPicker to database.
LGridXmlCellEditor : grid editor for LBoundXmlGridPicker.
LGridXmlCellRenderer : grid renderer for LBoundXmlGridPicker.
JsonHelper and XmlHelper : for applications to quickly get intent value
from database data..
The structure of managed tabular data :
Column 1 : Intent - this is what we want to store/edit. This can be
telephone numbers, email addresses, instant messaging addresses...
any single line piece of information that can exist many times for one
entity (person, company...).
Column 2 : Type - A short description of the intent : 'Home, Work,
Mobile, Fax, Other...'. It is displayed in a non editable wxComboBox.
Column 3 : Preferred - One line of data can be selected as the preferred
one. It is not mandatory, but it must be a single choice.
Column 4 : Notes - single line notes.
Adjust sql scripts and L7.dox.
Applied ANSI formatting style to all files.
Other changes :
Work around a nasty misbehavior.
Grid columns edited by a translated combobox expect full string
data as cell values. LResultSet::BEData() will report these mapped strings,
instead of database real data. LBoundComboBox::IsDirty() will always be
true even if the editor is unchanged once created.
Simplest workaround : disconnect m_BoundComboBox if unchanged.
LGridTextEditor::ProvideFormEditor() : set the form editor's value
explicitely.; wxTextCtrl does not interpret data it receives
LBoundControl::SetNull must be void.
LBoundGrid : Unbind:: instructions should limit to the widget's id, like Bind::
LConnection::GetReturnedKeys should return NULL.
LConnection::SetData should return void.
Notes : wxJSON must be configured with the same prefix as wxWidgets,
here /usr/local/{wxWidgets,wxWidgets-Release}.
109 lines
2.8 KiB
C++
109 lines
2.8 KiB
C++
/*
|
|
* File: LSQConnection.h
|
|
* Author: SET - nmset@netcourrier.com
|
|
* License : LGPL version 2.1
|
|
* Copyright SET, M. D. - © 2014
|
|
*
|
|
* Created on 25 mai 2014, 16:07
|
|
*/
|
|
|
|
#ifdef USE_LIBSQ
|
|
#ifndef LSQCONNECTION_H
|
|
#define LSQCONNECTION_H
|
|
|
|
#include <sqlite3.h>
|
|
#include <vector>
|
|
#include <wx/wx.h>
|
|
#include "LConnection.h"
|
|
|
|
/**
|
|
* SQLite namespace.
|
|
*
|
|
* Please note USE_LIBSQ pre-processor directive must be defined to include the SQLite backend.
|
|
*/
|
|
namespace SQ
|
|
{
|
|
#define CNSQMC wxString(_T("CNSQM"))
|
|
|
|
class SQresult;
|
|
|
|
/**
|
|
Minimalist class managing an SQLite3 connection; derives from LConnection.
|
|
*/
|
|
class LSQConnection : public LConnection
|
|
{
|
|
public:
|
|
LSQConnection();
|
|
/**
|
|
*
|
|
* @param newInfo : connection information. A file path, or memory/temporary database string instructions.
|
|
*/
|
|
LSQConnection(const wxString& newInfo);
|
|
/**
|
|
* The connection is closed in the destructor.
|
|
*/
|
|
virtual ~LSQConnection();
|
|
/**
|
|
*
|
|
* @return the last backend error message, may be NULL.
|
|
*/
|
|
const char* GetLastLibMessage() const;
|
|
/**
|
|
* Establishes a new connection, creating the SQLIte database if necessary.
|
|
* Does nothing if a connection already exists.
|
|
* @return true if a new connection is established, or if a connection already esists. False on error.
|
|
*/
|
|
bool Connect();
|
|
/**
|
|
*
|
|
* @return a pointer to the sqlite3 real database pointer.
|
|
*/
|
|
void * Get() const;
|
|
/**
|
|
* Checks if the sqlite3 pointer is not NULL.
|
|
* @return true if the sqlite3 pointer is not NULL.
|
|
*/
|
|
bool IsValid() const;
|
|
/**
|
|
* Closes the connection. Error message pointer is set to NULL.
|
|
*/
|
|
void Close();
|
|
/**
|
|
* Calls sqlite3_get_table and returns rows from a SELECT query.
|
|
* @param newSql a valid SQL statement.
|
|
* @return an untyped pointer to an SQresult referencing the data, or NULL if error.
|
|
*/
|
|
void * ExecuteSQL(const wxString& newSql);
|
|
/**
|
|
* Intended for database actions that do not fetch table rows. Calls sqlite3_exec.
|
|
* @param newSql : : a valid SQL statement.
|
|
* @return true on success, false otherwise.
|
|
*/
|
|
bool ExecuteUpdateSQL(const wxString& newSql);
|
|
/**
|
|
*
|
|
* @param col : unused
|
|
* @return an insert row identifier is always returned, even if the table does not have an autoincrement column.
|
|
*/
|
|
const wxAny GetReturnedValue(const unsigned int unused) const;
|
|
|
|
private:
|
|
sqlite3 * m_conn;
|
|
char * m_errMsg;
|
|
/**
|
|
* Forwards SQLite messages to InformLibMessage
|
|
* @param
|
|
*/
|
|
void InformSQMessage(const char * SQmsg) const;
|
|
wxArrayPtrVoid evtHandlers;
|
|
/**
|
|
* Informs application that registers LConnectionEvent handlers here.
|
|
* @param msg
|
|
*/
|
|
void InformLibMessage(const LInformation& msg) const;
|
|
};
|
|
|
|
}
|
|
#endif /* LSQCONNECTION_H */
|
|
#endif
|