View Image

QxOrm is a C++ library designed to provide Object Relational Mapping (ORM) feature to C++ users.

With a simple C++ setting function by class (like Hibernate XML mapping file), you will have access to the following features :
persistence : communication with a lot of databases (with 1-1, 1-n, n-1 and n-n relationships)
serialization : binary and XML format
reflection (or introspection) : access to classes definitions, retrieve properties and call classes methods

QxOrm aims to simplify C++ development and provides a lot of functionalities.
Here is a list of advantages of QxOrm :
non intrusive : the C++ setting function doesn't modified class definition, QxOrm can be used in existing projects
no code generation
no XML mapping file
classes doesn't need to inherit from a 'super object'
template meta-programming : no macro hack
works with Visual C++ 2008 or 2010 on Windows, GCC 4.4.1 on Linux and Mac OS X, and MinGW on Windows (other platforms will be tested soon : smartphones, etc...)
only one file to include in precompiled-header (need precompiled-header file to reduce compilation times)

QxOrm contains the following modules :

QxDao : based on QtSql engine of Qt, this module allows to communicate (select, update, delete, transaction...) with many databases by mapping each field of a table with properties of a C++ class. The relationships 1-1, 1-n, n-1 and n-n are very easy to setup in C++ code. This module supports object-oriented programming : inheritance, polymorphism, modularity. It supports also a lot of containers (stl, boost and Qt : std::vector, std::list, boost::unordered_map, QList, QHash...).

QxRegister, QxDataMember, QxFactory and QxFunction : QxOrm emulates reflection (or introspection) mechanism (like other languages : Java, C#...).

QxService : based on QtNetwork engine of Qt library, this module provides an easy and powerful way to create C++ application server (services concept with request from client and reply from server). QxService uses serialization and introspection from QxOrm library to transfer over network any class or structure. For more details on QxService module, a tutorial is available here.

QxCollection : based on boost::multi_index_container, this collection has advantages of std::vector (insertion order + quick access by index) and boost::unordered_map or QHash (quick access by a key : hash-map). QxCollection is adapted to contain the elements resulting from a database.

QxSerialize : this module is based on the excellent library boost::serialization. Any class defined by QxOrm can be serialize into binary and XML format. This module also allows to clone all instances of objects. Most of Qt objects (QObject, QString, QDate, QTime, QDateTime, QList, QHash...) are compatible with QxSerialize module.

QxTraits : boost library provides a lot of generic traits. QxOrm uses them but needs new functionalities that are not present in boost.

QxCache : QxOrm's cache can contain all types of objects. It can make it possible for example to memorize data resulting from a database to avoid too frequent requests. This cache is generic and can be used in other contexts than QxOrm.

QxValidator : this module provides a validation engine for classes registered into QxOrm context. To use this validation engine, you have to define your constraints into the mapping function per class : void qx::register_class. If for an instance of class, at least one constraint violation is detected, then the instance is invalid : the object cannot be saved into database (INSERT or UPDATE). For more informations about QxValidator module, goto the FAQ of QxOrm library.