// oBase.h: interface for the oBase class.
//
//////////////////////////////////////////////////////////////////////
#pragma once
/************************************************************************
MeOS - Orienteering Software
Copyright (C) 2009-2021 Melin Software HB
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, either version 3 of the License, or
(at your option) any later version.
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, see .
Melin Software HB - software@melin.nu - www.melin.nu
Eksoppsvägen 16, SE-75646 UPPSALA, Sweden
************************************************************************/
#include "TimeStamp.h"
#include "stdafx.h"
#include
#include
class oEvent;
class gdioutput;
class oDataInterface;
class oDataConstInterface;
class oDataContainer;
typedef void * pvoid;
typedef vector> * pvectorstr;
struct SqlUpdated;
class oBase {
public:
class oBaseReference {
private:
oBase * ref = nullptr;
public:
oBase * get() {
return ref;
}
friend class oBase;
};
/** Indicate if a change is transient (quiet) or should be written to database. */
enum class ChangeType {
Quiet,
Update
};
private:
protected:
int Id;
TimeStamp Modified;
string sqlUpdated; //SQL TIMESTAMP
private:
const static unsigned long long BaseGenStringFlag = 1ull << 63;
const static unsigned long long Base36StringFlag = 1ull << 62;
const static unsigned long long ExtStringMask = ~(BaseGenStringFlag | Base36StringFlag);
shared_ptr myReference;
protected:
int counter;
oEvent *oe;
bool Removed;
// True if the object is incorrect and needs correction
// An example is if id changed as we wrote. Then owner
// needs to be updated.
bool correctionNeeded = false;
private:
bool implicitlyAdded = false;
bool addedToEvent = false;
// Changed in client, not yet sent to server
bool changed;
// Changed in client, silent mode, should not be sent to server
bool transientChanged;
bool localObject;
protected:
/// Mark the object as "changed" (locally or remotely), eg lists and other views may need update
virtual void changedObject() = 0;
/** Change the id of the object */
virtual void changeId(int newId);
/** Get internal data buffers for DI */
virtual oDataContainer &getDataBuffers(pvoid &data, pvoid &olddata, pvectorstr &strData) const = 0;
virtual int getDISize() const = 0;
void setLocalObject() { localObject = true; }
// Merge into this entity
virtual void merge(const oBase &input, const oBase *base) = 0;
void clearDuplicateBase(int newId);
public:
/// Mark the object as changed (on client) and that it needs synchronize to server
void updateChanged(ChangeType ct = ChangeType::Update);
void update(SqlUpdated &info) const;
// Get a safe reference to this object
const shared_ptr &getReference() {
if (!myReference) {
myReference = make_shared();
myReference->ref = this;
}
return myReference;
}
// Returns true if the object is local, not stored in DB/On disc
bool isLocalObject() { return localObject; }
/// Returns textual information on the object
virtual wstring getInfo() const = 0;
//Called (by a table) when user enters data in a cell
// Returned first is zero or a second table row to reload.
// Returned second is true to reload entire table
virtual pair inputData(int id, const wstring &input, int inputId,
wstring &output, bool noUpdate) {output=L""; return make_pair(0,false);}
//Called (by a table) to fill a list box with contents in a table
virtual void fillInput(int id, vector< pair > &elements, size_t &selected)
{throw std::exception("Not implemented");}
oEvent *getEvent() const {return oe;}
int getId() const {return Id;}
bool isChanged() const {return changed;}
bool isRemoved() const {return Removed;}
int getAge() const {return Modified.getAge();}
unsigned int getModificationTime() const {return Modified.getModificationTime();}
// If there is a change marked as quiet, make it permanent.
void makeQuietChangePermanent();
bool synchronize(bool writeOnly=false);
wstring getTimeStamp() const;
string getTimeStampN() const;
const string &getStamp() const;
bool existInDB() const { return !sqlUpdated.empty(); }
void setImplicitlyCreated() { implicitlyAdded = true; }
bool isImplicitlyCreated() const { return implicitlyAdded; }
bool isAddedToEvent() const { return addedToEvent; }
void addToEvent(oEvent *e, const oBase *src);
oDataInterface getDI();
oDataConstInterface getDCI() const;
// Remove object from the competition
virtual void remove() = 0;
// Check if object can be remove (is not used by someone else)
virtual bool canRemove() const = 0;
/// Set an external identifier (0 if none)
void setExtIdentifier(__int64 id);
/// Get an external identifier (or 0) if none
__int64 getExtIdentifier() const;
wstring getExtIdentifierString() const;
void setExtIdentifier(const wstring &str);
bool isStringIdentifier() const;
// Convert an external to a int id. The result
// need not be unique, of course.
static int idFromExtId(__int64 extId);
static void converExtIdentifierString(__int64 raw, wchar_t bf[16]);
static __int64 converExtIdentifierString(const wstring &str);
oBase(oEvent *poe);
oBase(const oBase &in);
oBase(oBase &&in);
const oBase &operator=(const oBase &in);
virtual ~oBase();
friend class RunnerDB;
friend class MeosSQL;
friend class oEvent;
friend class oDataInterface;
friend class oDataContainer;
friend class MetaListContainer;
};
typedef oBase * pBase;