aboutsummaryrefslogtreecommitdiff
path: root/odb/oracle/statement.hxx
blob: add263aaac9808601a69706366c17f6206c3b2c1 (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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
// file      : odb/oracle/statement.hxx
// author    : Constantin Michael <constantin@codesynthesis.com>
// copyright : Copyright (c) 2005-2011 Code Synthesis Tools CC
// license   : ODB NCUEL; see accompanying LICENSE file

#ifndef ODB_ORACLE_STATEMENT_HXX
#define ODB_ORACLE_STATEMENT_HXX

#include <odb/pre.hxx>

#include <string>
#include <cstddef>  // std::size_t

#include <odb/forward.hxx>

#include <odb/details/shared-ptr.hxx>

#include <odb/oracle/version.hxx>
#include <odb/oracle/binding.hxx>
#include <odb/oracle/forward.hxx>
#include <odb/oracle/oracle-fwd.hxx>
#include <odb/oracle/auto-handle.hxx>

#include <odb/oracle/details/export.hxx>

namespace odb
{
  namespace oracle
  {
    class LIBODB_ORACLE_EXPORT statement: public details::shared_base
    {
    public:
      virtual
      ~statement () = 0;

    protected:
      statement (connection&, const std::string& statement);

      // Bind output parameters to this statement. This function must only
      // be called once. Multiple calls to it will result in memory leaks due
      // to lost OCIBind resources.
      //
      void
      bind_param (bind*, std::size_t count, std::size_t offset);

      // Bind input parameters to this statement. This function must only be
      // called once. Multiple calls to it will result in memory leaks due to
      // lost OCIDefine resources.
      //
      void
      bind_result (bind*,
                   std::size_t count,
                   std::size_t lob_prefetch_size = 0);

      // Stream the result LOBs, calling user callbacks where necessary.
      //
      void
      stream_result_lobs ();

    protected:
      connection& conn_;
      auto_handle<OCIStmt> stmt_;

      bind* result_binds_;
      std::size_t count_;
    };

    class LIBODB_ORACLE_EXPORT select_statement: public statement
    {
    public:
      virtual
      ~select_statement ();

      select_statement (connection& conn,
                        const std::string& statement,
                        binding& cond,
                        binding& data,
                        std::size_t lob_prefetch_size = 0);
      enum result
      {
        success,
        no_data
      };

      void
      execute ();

      result
      fetch ();

      void
      free_result ();

    private:
      select_statement (const select_statement&);
      select_statement& operator= (const select_statement&);

    private:
      bool done_;
    };

    class LIBODB_ORACLE_EXPORT insert_statement: public statement
    {
    public:
      virtual
      ~insert_statement ();

      insert_statement (connection& conn,
                        const std::string& statement,
                        binding& data,
                        bool returning);

      // Return true if successful and false if the row is a duplicate. All
      // other errors are reported by throwing exceptions.
      //
      bool
      execute ();

      unsigned long long
      id ();

    private:
      insert_statement (const insert_statement&);
      insert_statement& operator= (const insert_statement&);

      // Only OCI versions 11.2 and greater support conversion of the internal
      // Oracle type NUMBER to an external 64-bit integer type. If we detect
      // version 11.2 or greater we provide an unsigned long long image.
      // Otherwise, we revert to using a 32-bit unsigned integer.
      //
    public:
      struct id_bind_type
      {
        union
        {
          unsigned int value32;
          unsigned long long value64;
        } id;

        sb2 indicator;
      };

    private:
      id_bind_type id_bind_;
    };

    class LIBODB_ORACLE_EXPORT update_statement: public statement
    {
    public:
      virtual
      ~update_statement ();

      update_statement (connection& conn,
                        const std::string& statement,
                        binding& cond,
                        binding& data);
      void
      execute ();

    private:
      update_statement (const update_statement&);
      update_statement& operator= (const update_statement&);
    };

    class LIBODB_ORACLE_EXPORT delete_statement: public statement
    {
    public:
      virtual
      ~delete_statement ();

      delete_statement (connection& conn,
                        const std::string& statement,
                        binding& cond);

      unsigned long long
      execute ();

    private:
      delete_statement (const delete_statement&);
      delete_statement& operator= (const delete_statement&);
    };
  }
}

#include <odb/post.hxx>

#endif // ODB_ORACLE_STATEMENT_HXX