Implement object loading views

See section 10.2 in the manual for details.

4 files changed, 1275 insertions, 0 deletions

diff --git a/common/view/basics/driver.cxx b/common/view/basics/driver.cxx
new file mode 100644
index 0000000..e1a72f7
--- /dev/null
+++ b/common/view/basics/driver.cxx
@@ -0,0 +1,662 @@
+// file      : common/view/basics/driver.cxx
+// copyright : Copyright (c) 2009-2013 Code Synthesis Tools CC
+// license   : GNU GPL v2; see accompanying LICENSE file
+
+// Test view basics.
+//
+
+#include <memory>   // std::auto_ptr
+#include <cassert>
+#include <iostream>
+
+#include <odb/database.hxx>
+#include <odb/transaction.hxx>
+
+#include <common/common.hxx>
+#include <common/config.hxx> // DATABASE_XXX
+
+#include "test.hxx"
+#include "test-odb.hxx"
+
+using namespace std;
+using namespace odb::core;
+
+template <typename V>
+void
+view1_check (odb::result<V>& r)
+{
+  typedef odb::result<V> result;
+
+  typename result::iterator i (r.begin ());
+
+  assert (i != r.end ());
+  assert (i->first == "Jane" && i->last == "Doe" && i->age == 29);
+
+  assert (++i != r.end ());
+  V v;
+  i.load (v);
+  assert (v.first == "John" && v.last == "Doe" && v.age == 30);
+
+  assert (++i == r.end ());
+}
+
+template <typename V>
+void
+view2_test (const auto_ptr<database>& db)
+{
+  typedef odb::query<V> query;
+  typedef odb::result<V> result;
+  typedef typename result::iterator iterator;
+
+  transaction t (db->begin ());
+
+  {
+    result r (db->query<V> ());
+    iterator i (r.begin ());
+    assert (i != r.end ());
+    assert (i->count == 4);
+  }
+
+  {
+    result r;
+    if (db->id () != odb::id_oracle)
+      r = db->query<V> ("age < 31");
+    else
+      r = db->query<V> ("\"age\" < 31");
+
+    iterator i (r.begin ());
+    assert (i != r.end ());
+    assert (i->count == 2);
+  }
+
+  {
+    result r (db->query<V> (query::age < 31));
+    iterator i (r.begin ());
+    assert (i != r.end ());
+    assert (i->count == 2);
+  }
+
+  {
+    auto_ptr<V> v (db->query_one<V> ());
+    assert (v->count == 4);
+  }
+
+  {
+    auto_ptr<V> v;
+    if (db->id () != odb::id_oracle)
+      v.reset (db->query_one<V> ("age < 31"));
+    else
+      v.reset (db->query_one<V> ("\"age\" < 31"));
+    assert (v->count == 2);
+  }
+
+  {
+    auto_ptr<V> v (db->query_one<V> (query::age < 31));
+    assert (v->count == 2);
+  }
+
+  t.commit ();
+}
+
+template <typename V>
+void
+view4_test (const auto_ptr<database>& db)
+{
+  typedef odb::query<V> query;
+  typedef odb::result<V> result;
+  typedef typename result::iterator iterator;
+
+  transaction t (db->begin ());
+
+  {
+    result r;
+    if (db->id () != odb::id_oracle)
+      r = db->query<V> ((query::person::age > 30) + "ORDER BY age");
+    else
+      r = db->query<V> ((query::person::age > 30) + "ORDER BY \"age\"");
+
+    iterator i (r.begin ());
+
+    assert (i != r.end ());
+    assert (i->first_name == "Joe" && i->last_name == "Dirt" &&
+            i->name == "United States");
+
+    assert (++i != r.end ());
+    assert (i->first_name == "Johan" && i->last_name == "Johansen" &&
+            i->name == "Sweden");
+
+    assert (++i == r.end ());
+  }
+
+  {
+    result r (db->query<V> (
+                (query::person::age > 30) +
+                "ORDER BY " + query::person::age));
+
+    iterator i (r.begin ());
+
+    assert (i != r.end ());
+    assert (i->first_name == "Joe" && i->last_name == "Dirt" &&
+            i->name == "United States");
+
+    assert (++i != r.end ());
+    assert (i->first_name == "Johan" && i->last_name == "Johansen" &&
+            i->name == "Sweden");
+
+    assert (++i == r.end ());
+  }
+
+  {
+    result r (db->query<V> (query::residence::code == "US"));
+
+    iterator i (r.begin ());
+
+    assert (i != r.end ());
+    assert (i->first_name == "Joe" && i->last_name == "Dirt" &&
+            i->name == "United States");
+
+    assert (++i == r.end ());
+  }
+
+  t.commit ();
+}
+
+template <typename V>
+void
+view6_test (const auto_ptr<database>& db, const odb::query<V>& q)
+{
+  typedef odb::result<V> result;
+  typedef typename result::iterator iterator;
+
+  transaction t (db->begin ());
+
+  {
+    result r (db->query<V> (q));
+
+    iterator i (r.begin ());
+
+    assert (i != r.end ());
+    assert (i->first_name == "John" && i->last_name == "Doe" &&
+            i->employer == "Simple Tech, Inc");
+
+    assert (++i != r.end ());
+    assert (i->first_name == "Joe" && i->last_name == "Dirt" &&
+            i->employer == "Simple Tech, Inc");
+
+    assert (++i == r.end ());
+  }
+
+  t.commit ();
+}
+
+int
+main (int argc, char* argv[])
+{
+  try
+  {
+    auto_ptr<database> db (create_database (argc, argv));
+
+    //
+    //
+    {
+      country ca ("CA", "Canada");
+      country za ("ZA", "South Africa");
+      country us ("US", "United States");
+      country se ("SE", "Sweden");
+
+      person p1 (1, "John", "Doe", 30, male, measures (60, 160), &ca, &ca);
+      person p2 (2, "Jane", "Doe", 29, female, measures (70, 170), &za, &us);
+      person p3 (3, "Joe", "Dirt", 31, male, measures (80, 180), &us, &za);
+      person p4 (4, "Johan", "Johansen", 32, male, measures (90, 190), &se,
+                 &se);
+
+      p2.husband = &p1;
+
+      employer st ("Simple Tech, Inc");
+      employer ct ("Complex Tech, Inc");
+
+      p2.previous_employer = st.name;
+      p3.previous_employer = ct.name;
+
+      st.employees.push_back (&p1);
+      st.employees.push_back (&p3);
+      st.head_count = 2;
+
+      ct.employees.push_back (&p2);
+      ct.employees.push_back (&p4);
+      ct.head_count = 2;
+
+      transaction t (db->begin ());
+      db->persist (ca);
+      db->persist (za);
+      db->persist (us);
+      db->persist (se);
+
+      db->persist (p1);
+      db->persist (p2);
+      db->persist (p3);
+      db->persist (p4);
+
+      db->persist (st);
+      db->persist (ct);
+      t.commit ();
+    }
+
+    // view1
+    //
+    {
+      typedef odb::result<view1> result;
+
+      {
+        transaction t (db->begin ());
+
+        {
+          result r (db->query<view1> ());
+          assert (size (r) == 4);
+        }
+
+        {
+          result r;
+          if (db->id () != odb::id_oracle)
+            r = db->query<view1> ("ORDER BY age");
+          else
+            r = db->query<view1> ("ORDER BY \"age\"");
+
+          assert (size (r) == 4);
+        }
+
+        {
+          result r;
+          if (db->id () != odb::id_oracle)
+            r = db->query<view1> ("age < 31 ORDER BY age");
+          else
+            r = db->query<view1> ("\"age\" < 31 ORDER BY \"age\"");
+
+          view1_check (r);
+        }
+
+        t.commit ();
+      }
+    }
+
+    // view1a
+    //
+    {
+      typedef odb::result<view1a> result;
+
+      {
+        transaction t (db->begin ());
+
+        result r (db->query<view1a> ());
+        view1_check (r);
+
+        t.commit ();
+      }
+    }
+
+    // view1b
+    //
+    {
+      typedef odb::result<view1b> result;
+
+      {
+        transaction t (db->begin ());
+
+        result r (db->query<view1b> ());
+        view1_check (r);
+
+        t.commit ();
+      }
+
+      // No native parameter support in dynamic multi-database mode.
+      //
+#ifndef DATABASE_COMMON
+      {
+        typedef odb::query<view1b> query;
+
+        transaction t (db->begin ());
+
+#ifndef DATABASE_ORACLE
+        result r (db->query<view1b> ("first = " + query::_val ("Jane")));
+#else
+        result r (db->query<view1b> ("\"first\" = " + query::_val ("Jane")));
+#endif
+
+        result::iterator i (r.begin ());
+
+        assert (i != r.end ());
+        assert (i->first == "Jane" && i->last == "Doe");
+        assert (++i == r.end ());
+
+        t.commit ();
+      }
+#endif
+    }
+
+    // view1c
+    //
+    {
+      typedef odb::result<view1c> result;
+
+      {
+        transaction t (db->begin ());
+
+        result r;
+        if (db->id () != odb::id_oracle)
+          r = db->query<view1c> ("SELECT first, last, age "
+                                 "FROM t_view_b_person "
+                                 "WHERE age < 31 ORDER BY age");
+        else
+          r = db->query<view1c> ("SELECT \"first\", \"last\", \"age\" "
+                                 "FROM \"t_view_b_person\" "
+                                 "WHERE \"age\" < 31 ORDER BY \"age\"");
+        view1_check (r);
+
+        t.commit ();
+      }
+    }
+
+    // view1d
+    //
+    {
+      typedef odb::result<view1d> result;
+
+      {
+        transaction t (db->begin ());
+
+        {
+          result r;
+          if (db->id () != odb::id_oracle)
+            r = db->query<view1d> ("age < 31 ORDER BY age");
+          else
+            r = db->query<view1d> ("\"age\" < 31 ORDER BY \"age\"");
+
+          view1_check (r);
+        }
+
+        t.commit ();
+      }
+    }
+
+    // view2
+    //
+    view2_test<view2> (db);
+    view2_test<view2a> (db);
+    view2_test<view2b> (db);
+    view2_test<view2c> (db);
+
+    // view3
+    //
+    {
+      typedef odb::result<const view3> result; // Test const result.
+
+      {
+        transaction t (db->begin ());
+
+        {
+          result r (db->query<view3> ());
+
+          size_t count (0);
+          for (result::iterator i (r.begin ()); i != r.end (); ++i)
+          {
+            if (i->last_name == "Doe")
+              assert (i->count == 2);
+            else if (i->last_name == "Dirt" ||
+                     i->last_name == "Johansen")
+              assert (i->count == 1);
+            else
+              assert (false);
+
+            count++;
+          }
+
+          assert (count == 3);
+        }
+
+        t.commit ();
+      }
+    }
+
+    // view3a
+    //
+    {
+      typedef odb::query<view3a> query;
+      typedef odb::result<view3a> result;
+
+      {
+        transaction t (db->begin ());
+
+        {
+          result r (db->query<view3a> (query::last_name == "Doe"));
+          result::iterator i (r.begin ());
+
+          assert (i != r.end ());
+          assert (i->last_name == "Doe" && i->count == 2);
+          assert (++i == r.end ());
+        }
+
+        t.commit ();
+      }
+    }
+
+    // view4
+    //
+    view4_test<view4> (db);
+    view4_test<view4a> (db);
+
+    // view5
+    //
+    {
+      typedef odb::query<view5> query;
+      typedef odb::result<view5> result;
+
+      {
+        transaction t (db->begin ());
+
+        {
+          result r (
+            db->query<view5> (
+              query::residence::name == query::nationality::name));
+
+          result::iterator i (r.begin ());
+
+          assert (i != r.end ());
+          assert (i->first_name == "John" && i->last_name == "Doe" &&
+                  i->rname == "Canada" && i->rname == "Canada");
+
+          assert (++i != r.end ());
+          assert (i->first_name == "Johan" && i->last_name == "Johansen" &&
+                  i->rname == "Sweden" && i->rname == "Sweden");
+
+          assert (++i == r.end ());
+        }
+
+        t.commit ();
+      }
+    }
+
+    // view6
+    //
+    view6_test<view6> (
+      db, odb::query<view6>::employer::name == "Simple Tech, Inc");
+
+    view6_test<view6a> (
+      db, odb::query<view6a>::employer::name == "Simple Tech, Inc");
+
+    view6_test<view6b> (
+      db, odb::query<view6b>::employer::name == "Simple Tech, Inc");
+
+    // No native parameter support in dynamic multi-database mode.
+    //
+#ifndef DATABASE_COMMON
+    view6_test<view6c> (
+#ifndef DATABASE_ORACLE
+      db, "e.name = " + odb::query<view6c>::_val ("Simple Tech, Inc"));
+#else
+      db, "\"e\".\"name\" = " + odb::query<view6c>::_val ("Simple Tech, Inc"));
+#endif
+#endif
+
+    // view7
+    //
+    {
+      typedef odb::query<view7> query;
+      typedef odb::result<view7> result;
+
+      {
+        transaction t (db->begin ());
+
+        {
+          result r (db->query<view7> (query::person::last_name == "Doe"));
+
+          result::iterator i (r.begin ());
+
+          assert (i != r.end ());
+          assert (i->first_name == "Jane" && i->last_name == "Doe" &&
+                  !i->head_count.null () && *i->head_count == 2);
+
+          assert (++i != r.end ());
+          assert (i->first_name == "John" && i->last_name == "Doe" &&
+                  i->head_count.null ());
+
+          assert (++i == r.end ());
+        }
+
+        t.commit ();
+      }
+    }
+
+    // view8
+    //
+    {
+      typedef odb::result<view8> result;
+
+      {
+        transaction t (db->begin ());
+
+        {
+          result r (db->query<view8> ());
+
+          result::iterator i (r.begin ());
+
+          assert (i != r.end ());
+          assert (i->wife_name == "Jane" && i->husb_name == "John");
+          assert (++i == r.end ());
+        }
+
+        t.commit ();
+      }
+    }
+
+    // view9
+    //
+    {
+      typedef odb::query<view9> query;
+      typedef odb::result<view9> result;
+
+      {
+        transaction t (db->begin ());
+
+        {
+          // Test case-insensitive clause prefix detection.
+          //
+          result r (db->query<view9> ("where" + (query::gender == female)));
+
+          result::iterator i (r.begin ());
+
+          assert (i != r.end ());
+          assert (i->first_name == "Jane" && i->last_name == "Doe" &&
+                  i->gender == female);
+          assert (++i == r.end ());
+        }
+
+        t.commit ();
+      }
+    }
+
+    // view10
+    //
+    {
+      typedef odb::query<view10> query;
+      typedef odb::result<view10> result;
+
+      {
+        transaction t (db->begin ());
+
+        {
+          result r (db->query<view10> (
+                      query::measures.weight > 60 &&
+                      query::measures.hight < 190));
+
+          result::iterator i (r.begin ());
+
+          assert (i != r.end ());
+          assert (i->last_name == "Doe" &&
+                  i->measures.weight == 70 && i->measures.hight == 170);
+
+          assert (++i != r.end ());
+          assert (i->last_name == "Dirt" &&
+                  i->measures.weight == 80 && i->measures.hight == 180);
+
+          assert (++i == r.end ());
+        }
+
+        t.commit ();
+      }
+    }
+
+    // view11
+    //
+    {
+      typedef odb::result<view11> result;
+
+      {
+        transaction t (db->begin ());
+
+        {
+          result r (db->query<view11> ());
+
+          result::iterator i (r.begin ());
+
+          assert (i != r.end ());
+          assert (i->last_name == "Doe" && i->hight == 170);
+
+          assert (++i != r.end ());
+          assert (i->last_name == "Dirt" && i->hight == 180);
+
+          assert (++i == r.end ());
+        }
+
+        t.commit ();
+      }
+    }
+
+    // view12
+    //
+    {
+      typedef odb::query<view12> query;
+      typedef odb::result<view12> result;
+
+      {
+        transaction t (db->begin ());
+
+        {
+          result r (db->query<view12> (query::last_name == "Dirt"));
+
+          result::iterator i (r.begin ());
+
+          assert (i != r.end ());
+          assert (i->residence == "US");
+          assert (++i == r.end ());
+        }
+
+        t.commit ();
+      }
+    }
+  }
+  catch (const odb::exception& e)
+  {
+    cerr << e.what () << endl;
+    return 1;
+  }
+}
diff --git a/common/view/basics/makefile b/common/view/basics/makefile
new file mode 100644
index 0000000..7598bb7
--- /dev/null
+++ b/common/view/basics/makefile
@@ -0,0 +1,118 @@
+# file      : common/view/basics/makefile
+# copyright : Copyright (c) 2009-2013 Code Synthesis Tools CC
+# license   : GNU GPL v2; see accompanying LICENSE file
+
+include $(dir $(lastword $(MAKEFILE_LIST)))../../../build/bootstrap.make
+
+cxx_tun := driver.cxx
+odb_hdr := test.hxx
+genf    := $(call odb-gen,$(odb_hdr))
+gen     := $(addprefix $(out_base)/,$(genf))
+cxx_obj := $(addprefix $(out_base)/,$(cxx_tun:.cxx=.o)) $(filter %.o,$(gen:.cxx=.o))
+cxx_od  := $(cxx_obj:.o=.o.d)
+
+common.l             := $(out_root)/libcommon/common/common.l
+common.l.cpp-options := $(out_root)/libcommon/common/common.l.cpp-options
+
+# Import.
+#
+$(call import,\
+  $(scf_root)/import/odb/stub.make,\
+  odb: odb,odb-rules: odb_rules)
+
+# Build.
+#
+$(driver): $(cxx_obj) $(common.l)
+$(cxx_obj) $(cxx_od): cpp_options := -I$(out_base) -I$(src_base)
+$(cxx_obj) $(cxx_od): $(common.l.cpp-options)
+
+$(gen): $(odb)
+$(gen): odb := $(odb)
+$(gen) $(dist): export odb_options += --generate-schema --generate-query \
+--generate-prepared --table-prefix t_view_b_
+$(gen): cpp_options := -I$(src_base)
+$(gen): $(common.l.cpp-options)
+
+ifneq ($(db_id),common)
+$(gen): odb_options += --database $(db_id)
+else
+$(gen): odb_options += --multi-database dynamic
+endif
+
+$(call include-dep,$(cxx_od),$(cxx_obj),$(gen))
+
+# Alias for default target.
+#
+$(out_base)/: $(driver)
+
+# Dist
+#
+name := $(subst /,-,$(subst $(src_root)/common/,,$(src_base)))
+
+$(dist): sources := $(cxx_tun)
+$(dist): headers := $(odb_hdr)
+$(dist): data_dist := test.std
+$(dist): export name := $(name)
+$(dist): export extra_dist := $(data_dist) $(call vc8projs,$(name)) \
+$(call vc9projs,$(name)) $(call vc10projs,$(name)) $(call vc11projs,$(name)) \
+$(call vc12projs,$(name))
+$(dist):
+	$(call dist-data,$(sources) $(headers) $(data_dist))
+	$(call meta-automake,../../template/Makefile.am)
+	$(call meta-vc8projs,../../template/template,$(name))
+	$(call meta-vc9projs,../../template/template,$(name))
+	$(call meta-vc10projs,../../template/template,$(name))
+	$(call meta-vc11projs,../../template/template,$(name))
+	$(call meta-vc12projs,../../template/template,$(name))
+
+# Test.
+#
+ifneq ($(db_id),common)
+$(eval $(call test-rule))
+else
+$(foreach d,$(databases),$(eval $(call test-rule,$d)))
+endif
+
+# Clean.
+#
+$(clean):                            \
+  $(driver).o.clean                  \
+  $(addsuffix .cxx.clean,$(cxx_obj)) \
+  $(addsuffix .cxx.clean,$(cxx_od))  \
+  $(addsuffix .hxx.clean,$(filter %.cxx,$(gen)))
+	$(call message,,rm -f $(out_base)/test.out)
+
+# Generated .gitignore.
+#
+ifeq ($(out_base),$(src_base))
+$(driver): | $(out_base)/.gitignore
+
+$(out_base)/.gitignore: files := driver $(genf)
+$(clean): $(out_base)/.gitignore.clean
+
+$(call include,$(bld_root)/git/gitignore.make)
+endif
+
+# How to.
+#
+$(call include,$(bld_root)/dist.make)
+$(call include,$(bld_root)/meta/vc8proj.make)
+$(call include,$(bld_root)/meta/vc9proj.make)
+$(call include,$(bld_root)/meta/vc10proj.make)
+$(call include,$(bld_root)/meta/vc11proj.make)
+$(call include,$(bld_root)/meta/vc12proj.make)
+$(call include,$(bld_root)/meta/automake.make)
+
+$(call include,$(bld_root)/cxx/standard.make) # cxx_standard
+ifdef cxx_standard
+$(gen): odb_options += --std $(cxx_standard)
+$(call include,$(odb_rules))
+endif
+
+$(call include,$(bld_root)/cxx/cxx-d.make)
+$(call include,$(bld_root)/cxx/cxx-o.make)
+$(call include,$(bld_root)/cxx/o-e.make)
+
+# Dependencies.
+#
+$(call import,$(src_root)/libcommon/makefile)
diff --git a/common/view/basics/test.hxx b/common/view/basics/test.hxx
new file mode 100644
index 0000000..18fae4b
--- /dev/null
+++ b/common/view/basics/test.hxx
@@ -0,0 +1,495 @@
+// file      : common/view/basics/test.hxx
+// copyright : Copyright (c) 2009-2013 Code Synthesis Tools CC
+// license   : GNU GPL v2; see accompanying LICENSE file
+
+#ifndef TEST_HXX
+#define TEST_HXX
+
+#include <string>
+#include <vector>
+#include <cstddef> // std::size_t
+
+#include <odb/core.hxx>
+#include <odb/nullable.hxx>
+
+struct employer;
+
+#pragma db object
+struct country
+{
+  country (const std::string& c, std::string const& n)
+      : code (c), name (n)
+  {
+  }
+
+  country ()
+  {
+  }
+
+  #pragma db id
+  std::string code; // ISO 2-letter country code.
+
+  std::string name;
+};
+
+enum gender_type {male, female};
+
+#pragma db value
+struct measures
+{
+  measures (unsigned short w, unsigned short h) : weight (w), hight (h) {}
+  measures () {}
+
+  unsigned short weight;
+  unsigned short hight;
+};
+
+#pragma db object
+struct person
+{
+  typedef ::measures measures_type;
+
+  person (unsigned long i,
+          const std::string& fn,
+          const std::string& ln,
+          unsigned short a,
+          gender_type g,
+          const measures_type m,
+          country* r,
+          country* n)
+      : id (i),
+        first_name_ (fn),
+        last_name_ (ln),
+        age (a),
+        gender (g),
+        measures (m),
+        residence (r),
+        nationality (n),
+        husband (0)
+  {
+  }
+
+  person ()
+  {
+  }
+
+  #pragma db id
+  unsigned long id;
+
+  #pragma db column("first")
+  std::string first_name_;
+
+  #pragma db column("last")
+  std::string last_name_;
+
+  unsigned short age;
+
+  // #pragma db type("INT") - in MySQL test type pragma copying
+  gender_type gender;
+
+  measures_type measures;
+
+  #pragma db not_null
+  country* residence;
+
+  #pragma db not_null
+  country* nationality;
+
+  #pragma db inverse(employees)
+  employer* employed_by;
+
+  // A non-pointer relationship.
+  //
+  odb::nullable<std::string> previous_employer;
+
+  person* husband; // Self-reference.
+};
+
+#pragma db object
+struct employer
+{
+  employer (const std::string& n)
+      : name (n)
+  {
+  }
+
+  employer ()
+  {
+  }
+
+  #pragma db id
+  std::string name;
+  unsigned int head_count;
+  std::vector<person*> employees;
+};
+
+//
+// General view with no associated objects.
+//
+
+// Complete suffix query template.
+//
+#ifndef ODB_DATABASE_ORACLE
+#  pragma db view query("SELECT first, last, age FROM t_view_b_person")
+#else
+#  pragma db view query("SELECT \"first\", \"last\", \"age\" " \
+                        "FROM \"t_view_b_person\"")
+#endif
+struct view1
+{
+  std::string first;
+  std::string last;
+  unsigned short age;
+};
+
+// Complete query.
+//
+#ifndef ODB_DATABASE_ORACLE
+#  pragma db view query("SELECT first, last, age " \
+                        "FROM t_view_b_person "    \
+                        "WHERE age < 31 ORDER BY age")
+#else
+#  pragma db view query("SELECT \"first\", \"last\", \"age\" " \
+                        "FROM \"t_view_b_person\" "            \
+                        "WHERE \"age\" < 31 ORDER BY \"age\"")
+#endif
+struct view1a
+{
+  std::string first;
+  std::string last;
+  unsigned short age;
+};
+
+// Complete placeholder query template.
+//
+#ifndef ODB_DATABASE_ORACLE
+#  pragma db view query("SELECT first, last, age " \
+                        "FROM t_view_b_person "    \
+                        "WHERE age < 31 AND (?) ORDER BY age")
+#else
+#  pragma db view query("SELECT \"first\", \"last\", \"age\" " \
+                        "FROM \"t_view_b_person\" "            \
+                        "WHERE \"age\" < 31 AND (?) ORDER BY \"age\"")
+#endif
+struct view1b
+{
+  std::string first;
+  std::string last;
+  unsigned short age;
+};
+
+// Runtime query.
+//
+#pragma db view //query()
+struct view1c
+{
+  std::string first;
+  std::string last;
+  unsigned short age;
+};
+
+// Assembled SELECT and FROM-lists.
+//
+#pragma db view table("t_view_b_person")
+struct view1d
+{
+  #pragma db column("first")
+  std::string first;
+
+  #pragma db column("last")
+  std::string last;
+
+  #pragma db column("age")
+  unsigned short age;
+};
+
+//
+// Count view plus associated object.
+//
+
+// Complete suffix query.
+//
+#ifndef ODB_DATABASE_ORACLE
+#  pragma db view object(person) \
+  query("SELECT count(id) FROM t_view_b_person")
+#else
+#  pragma db view object(person) \
+  query("SELECT count(\"id\") FROM \"t_view_b_person\"")
+#endif
+struct view2
+{
+  std::size_t count;
+};
+
+// Generated query, literal column.
+//
+#pragma db view object(person)
+struct view2a
+{
+#ifndef ODB_DATABASE_ORACLE
+  #pragma db column("count(id)")
+#else
+  #pragma db column("count(\"id\")")
+#endif
+  std::size_t count;
+};
+
+// Generated query, qualified literal column.
+//
+#pragma db view object(person)
+struct view2b
+{
+#ifndef ODB_DATABASE_ORACLE
+  #pragma db column("count(t_view_b_person.id)")
+#else
+  #pragma db column("count(\"t_view_b_person\".\"id\")")
+#endif
+  std::size_t count;
+};
+
+// Generated query, expression column.
+//
+#pragma db view object(person)
+struct view2c
+{
+  #pragma db column("count(" + person::id + ")")
+  std::size_t count;
+};
+
+//
+// Aggregate view plus associated object with a custom alias.
+//
+
+// Complete suffix query.
+//
+#ifndef ODB_DATABASE_ORACLE
+#  pragma db view object(person = test) \
+  query("SELECT last, count(last) "     \
+        "FROM t_view_b_person "         \
+        "GROUP BY last")
+#else
+#  pragma db view object(person = test)     \
+  query("SELECT \"last\", count(\"last\") " \
+        "FROM \"t_view_b_person\" "         \
+        "GROUP BY \"last\"")
+#endif
+struct view3
+{
+  std::string last_name;
+  std::size_t count;
+};
+
+// Generated query with integrated query condition and placeholder.
+//
+#pragma db view object(person = test) \
+  query((?) + "GROUP BY" + test::last_name_)
+struct view3a
+{
+  // Automatically resolved to test::last_name_.
+  //
+  std::string last_name;
+
+  #pragma db column("count(" + test::last_name_ + ")")
+  std::size_t count;
+};
+
+//
+// JOIN view plus associated objects, some with custom aliases.
+//
+
+// Complete suffix query.
+//
+#ifndef ODB_DATABASE_ORACLE
+#  pragma db view object(person) object(country = residence)  \
+  query("SELECT first, last, residence.name "                 \
+        "FROM t_view_b_person "                               \
+        "LEFT JOIN t_view_b_country AS residence "            \
+        "ON t_view_b_person.residence = residence.code")
+#else
+#  pragma db view object(person) object(country = residence)   \
+  query("SELECT \"first\", \"last\", \"residence\".\"name\" "  \
+        "FROM \"t_view_b_person\" "                            \
+        "LEFT JOIN \"t_view_b_country\" \"residence\" "        \
+        "ON \"t_view_b_person\".\"residence\" = \"residence\".\"code\"")
+#endif
+struct view4
+{
+  std::string first_name;
+  std::string last_name;
+  std::string name;
+};
+
+// Generated query.
+//
+#pragma db view object(person) \
+  object(country = residence: person::residence)
+struct view4a
+{
+  std::string first_name;
+  std::string last_name;
+  std::string name;
+};
+
+//
+// JOIN the same object twice.
+//
+#pragma db view object(person) \
+  object(country = residence: person::residence) \
+  object(country = nationality: person::nationality) \
+  query((?) + "ORDER BY" + person::age)
+struct view5
+{
+  std::string first_name;
+  std::string last_name;
+
+  #pragma db column(residence::name)
+  std::string rname;
+
+  #pragma db column(nationality::name)
+  std::string nname;
+};
+
+//
+// JOIN via one(i)-to-many relationship.
+//
+
+// Automatic relationship discovery.
+//
+#pragma db view object(person) object(employer)
+struct view6
+{
+  std::string first_name;
+  std::string last_name;
+
+  #pragma db column(::employer::name)
+  std::string employer;
+};
+
+// Manual relationship specification, left side.
+//
+#pragma db view object(person) object(employer: person::employed_by)
+struct view6a
+{
+  std::string first_name;
+  std::string last_name;
+
+  #pragma db column(::employer::name)
+  std::string employer;
+};
+
+// Manual relationship specification, right side.
+//
+#pragma db view object(person) object(employer: employer::employees)
+struct view6b
+{
+  std::string first_name;
+  std::string last_name;
+
+  #pragma db column(::employer::name)
+  std::string employer;
+};
+
+// The same using tables.
+//
+#if defined(ODB_DATABASE_ORACLE)
+#pragma db view table("t_view_b_person" = "p")                                  \
+  table("t_view_b_employer_employees" = "ee": "\"ee\".\"value\" = \"p\".\"id\"")\
+  table("t_view_b_employer" = "e": "\"ee\".\"object_id\" = \"e\".\"name\"")
+#elif defined(ODB_DATABASE_MSSQL)
+#pragma db view table("t_view_b_person" = "p")                   \
+  table("t_view_b_employer_employees" = "ee": "ee.value = p.id") \
+  table("t_view_b_employer" = "e": "[ee].[object_id] = e.name")
+#elif defined(ODB_DATABASE_MYSQL)
+#pragma db view table("t_view_b_person" = "p")                   \
+  table("t_view_b_employer_employees" = "ee": "ee.value = p.id") \
+  table("t_view_b_employer" = "e": "`ee`.`object_id` = e.name")
+#else
+#pragma db view table("t_view_b_person" = "p")                   \
+  table("t_view_b_employer_employees" = "ee": "ee.value = p.id") \
+  table("t_view_b_employer" = "e": "\"ee\".\"object_id\" = e.name")
+#endif
+struct view6c
+{
+  #pragma db column("p.first")
+  std::string first_name;
+
+  #pragma db column("p.last")
+  std::string last_name;
+
+  #pragma db column("e"."name")
+  std::string employer;
+};
+
+//
+// JOIN via a custom condition.
+//
+#pragma db view object(person) \
+  object(employer: person::previous_employer == employer::name)\
+  query((?) + "ORDER BY" + person::age)
+struct view7
+{
+  std::string first_name;
+  std::string last_name;
+
+  odb::nullable<unsigned int> head_count;
+};
+
+//
+// Self-JOIN.
+//
+#pragma db view object(person = wife) object(person = husb) \
+  query (wife::husband.is_not_null ())
+struct view8
+{
+  #pragma db column(wife::first_name_)
+  std::string wife_name;
+
+  #pragma db column(husb::first_name_)
+  std::string husb_name;
+};
+
+//
+// Enum mapping.
+//
+#pragma db view object(person)
+struct view9
+{
+  std::string first_name;
+  std::string last_name;
+  gender_type gender;
+};
+
+//
+// Composite in view.
+//
+#pragma db view object(person) query((?) + "ORDER BY" + person::age)
+struct view10
+{
+  std::string last_name;
+  ::measures measures;
+};
+
+//
+// Composite in object.
+//
+#pragma db view object(person) \
+  query((person::measures.weight > 60 && person::measures.hight < 190 && (?)) \
+        + "ORDER BY" + person::age)
+struct view11
+{
+  std::string last_name;
+
+  #pragma db column(person::measures.hight)
+  unsigned short hight;
+};
+
+//
+// Extract object pointer as object id.
+//
+#pragma db view object(person)
+struct view12
+{
+  std::string residence;
+};
+
+#endif // TEST_HXX
diff --git a/common/view/basics/test.std b/common/view/basics/test.std
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/common/view/basics/test.std