matador

Version 0.5.0

Take your database by the horns.

matador is a ORM framework written in C++. It aims to encapsulate all database stuff (database backends, sql statements, serialization of objects) and provides the user an easy to use interface and a unique container for all objects. Given this container the user has a centralized point of storage for all objects at hand but with the ability to create views on concrete object types.

Features:

• A unique fluent query interface
• Support for SQLite, MySQL and MS SQL Server
• One to one/many relations
• One storage container
• Filter with simple expressions
• Transactions
• STL like interface and iterators

Documentation can be found here.

Example

// use matador' namespace
using namespace matador

// a simple person class
struct person {
  identifier<long> id;   // primary key
  varchar<256> name;
  unsigned int age = 0;
  has_many<string> colors;
  
  person(long i, const std::string n)
    : id(i), name(n)
  {}
  
  template < class SERIALIZER >
  void serialize(SERIALIZER &serializer) {
    serializer.serialize("id", id);
    serializer.serialize("name", name);
    serializer.serialize("age", age);
    serializer.serialize("person_color", colors, "person_id", "color");
  }
};

// prepare the persistence layer
persistence p("sqlite://db.sqlite");
p.attach<person>("person");

// create tables
p.create();

// create a database session
session s(p);

// insert george
// returns an matador::object_ptr<person>
auto george = s.insert(new person(1, "george"));

// modify george
george->age = 35;
s.update(george);
// add color
s.push_back(george->colors, "brown");
// delete george
s.remove(george);

Requirements

The library has almost no dependencies. At least the database library you want to use. If you would like to build from the sources you need at least the cmake build system installed. If you plan to generate an install package on a windows system you need the nullsoft scriptable install system.

Sources

Get the sources from GitHub and enter the created directory:

$ git clone https://github.com/zussel/matador.git
$ cd matador

Building under Linux

Create a build directory change to it and call cmake:

$ mkdir build
$ cd build
$ cmake ..

Then you can build matador from sources:

$ make

Building under Windows (for Visual Studio)

Create a build directory change to it and call cmake:

$ mkdir build
$ cd build
$ cmake -G "Visual Studio *" ..

Where * is one of the "Visual Studio" strings up from "14". See cmake documentation here. After generation you find a matador.sln solution file in the current directory.

Contact

If you have questions or issues concerning matador you can place an issue in my matador github repository or contact me via mail sascha dot kuehl at gmx dot net.