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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
|
This example shows how to declare and use views in ODB. It includes views
that show how to load a subset of data member from objects and tables,
perform aggregate queries, and join multiple objects and tables using
object relationships and custom join conditions.
The example uses the shared_ptr smart pointer from TR1 and requires a C++
compiler with TR1 support or an external TR1 implementation, such as the
one provided by Boost.
The example consists of the following files:
employee.hxx
Header file defining the 'country', 'employer', and 'employee' persistent
classes. The example also uses a "legacy" 'employee_extra' table that is
not mapped to a persistent class.
After the persistent classes, this header defines a number of views that
show how to obtain various information from the above object model.
employee-odb.hxx
employee-odb.ixx
employee-odb.cxx
employee.sql
The first three files contain the database support code and the last file
contains the database schema for the employee.hxx header.
These files are generated by the ODB compiler from employee.hxx using the
following command line:
odb -d <database> --generate-schema --generate-query \
--default-pointer std::tr1::shared_ptr employee.hxx
Where <database> stands for the database system we are using, for example,
'mysql'.
The --default-pointer option is used to make TR1 shared_ptr the default
object pointer.
database.hxx
Contains the create_database() function which instantiates the concrete
database class corresponding to the database system we are using.
driver.cxx
Driver for the example. It includes the employee.hxx and employee-odb.hxx
headers to gain access to the persistent classes and their database support
code. It also includes database.hxx for the create_database() function
declaration.
In main() the driver first calls create_database() to obtain the database
instance. It then creates the legacy 'employee_extra' table and proceeds
to populate the database with a number of 'employee', 'employer', and
'project' objects. Once this is done, the driver uses views defined in
employee.hxx to load and print various information about the object model.
To run the example we may first need to create the database schema (for some
database systems, such as SQLite, the schema is embedded into the generated
code which makes this step unnecessary). Using MySQL as an example, this
can be achieved with the following command:
mysql --user=odb_test --database=odb_test < employee.sql
Here we use 'odb_test' as the database login and also 'odb_test' as the
database name.
Once the database schema is ready, we can run the example (using MySQL as
the database):
./driver --user odb_test --database odb_test
|