summaryrefslogtreecommitdiff
path: root/client/model.h
blob: 5371c4b16b7ed7290b15017f7b2fa8c3e4bd0fcb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
// model.h

/**
*    Copyright (C) 2008 10gen Inc.
*
*    This program is free software: you can redistribute it and/or  modify
*    it under the terms of the GNU Affero General Public License, version 3,
*    as published by the Free Software Foundation.
*
*    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 Affero General Public License for more details.
*
*    You should have received a copy of the GNU Affero General Public License
*    along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/

#pragma once

#include "dbclient.h"

/* Model is a base class for defining objects which are serializable to the Mongo
   database via the database driver.

   *Definition*
   Your serializable class should inherit from Model and implement the abstract methods
   below.

   *Loading*
   To load, first construct an (empty) objet.  Then call load().  Do not load an object
   more than once.
*/

class Model {
public:
    Model() { }
    virtual ~Model() { }

    virtual const char * getNS() = 0;
    virtual void serialize(BSONObjBuilder& to) = 0;
    virtual void unserialize(BSONObj& from) = 0;

    /* Define this as you see fit if you are using the default conn() implementation. */
    static DBClientWithCommands *globalConn;

    /* Override this if you need to do fancier connection management than simply using globalConn. */
    virtual DBClientWithCommands* conn() {
        return globalConn;
    }

    /* true if successful */
    bool load(BSONObj& query);
};