Class: AlRdbwPostgres

Inherits:
AlRdbw
  • Object
show all
Defined in:
lib/al_rdbw_postgres.rb,
lib/al_persist_postgres.rb

Overview

リレーショナルデータベースラッパー PostgreSQL版

Constant Summary

@@suitable_dbms =

Returns connectメソッドが生成するオブジェクトのためのクラス (継承アトリビュート)

Returns:

  • (Object)

    connectメソッドが生成するオブジェクトのためのクラス (継承アトリビュート)

self

Instance Attribute Summary (collapse)

Attributes inherited from AlRdbw

#conn_info, #flag_transaction, #handle

Instance Method Summary (collapse)

Methods inherited from AlRdbw

#close, connect, #get_handle, #initialize, #purge, #transaction_active?

Constructor Details

This class inherits a constructor from AlRdbw

Instance Attribute Details

- (Object) result (readonly)

Returns クエリ実行結果

Returns:

  • (Object)

    クエリ実行結果



24
25
26
# File 'lib/al_rdbw_postgres.rb', line 24

def result
  @result
end

Instance Method Details

- (AlPersistSqlite) [](tname)

tableを指定して、Persistオブジェクトを生成 syntax sugar

Parameters:

  • tname (String)

    テーブル名

Returns:



52
53
54
# File 'lib/al_persist_postgres.rb', line 52

def []( tname )
  return AlPersistPostgres.new( self, tname )
end

- (Boolean) commit

TODO:

トランザクションコミット

実装中。トランザクションがSQLレベルで失敗する条件をテストして返り値に反映する

Returns:

  • (Boolean)

    成否



249
250
251
252
253
254
255
# File 'lib/al_rdbw_postgres.rb', line 249

def commit()
  return false  if ! @flag_transaction
  @result = get_handle().exec( "commit transaction;" )
  @result.clear()
  @flag_transaction = false
  return true
end

- (Hash) delete(table, where_cond)

delete文の発行ヘルパー

Parameters:

  • table (String)

    テーブル名

  • where_cond (Hash)

    where条件

Returns:

  • (Hash)

    結果のHash



218
219
220
221
222
223
224
225
226
# File 'lib/al_rdbw_postgres.rb', line 218

def delete( table, where_cond )
  (where, wval) = make_where_condition( where_cond )
  sql = "delete from #{table} where #{where};"
  @result = get_handle().exec( sql, wval )
  ret = { :cmdtuples=>@result.cmdtuples }

  @result.clear()
  return ret
end

- (Hash) execute(sql, var = []) Also known as: exec

Note:

任意SQLの実行

アクションクエリの実行用。selectは、select()メソッドを使う。

Parameters:

  • sql (String)

    SQL文

  • var (Array) (defaults to: [])

    パラメータクエリ用変数

Returns:

  • (Hash)

    結果



53
54
55
56
57
58
# File 'lib/al_rdbw_postgres.rb', line 53

def execute( sql, var = [] )
  @result = get_handle().exec( sql, var )
  ret = { :cmdtuples=>@result.cmdtuples }
  @result.clear()
  return ret
end

- (Hash) insert(table, values)

insert文の発行ヘルパー

Parameters:

  • table (String)

    テーブル名

  • values (Hash)

    insertする値のhash

Returns:

  • (Hash)

    結果のHash



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
# File 'lib/al_rdbw_postgres.rb', line 150

def insert( table, values )
  col = ""
  plh = ""
  val = []
  cnt = 1
  values.each do |k,v|
    col << "#{k},"
    plh << "$#{cnt},"
    cnt += 1
    if v.class == Array
      val << v.join( ',' )
    else
      val << v
    end
  end
  col.chop!
  plh.chop!

  sql = "insert into #{table} (#{col}) values (#{plh});"
  @result = get_handle().exec( sql, val )
  ret = { :cmdtuples=>@result.cmdtuples }

  @result.clear()
  return ret
end

- (Object) open_connection

TODO:

RDBサーバとのコネクションを開始する

コネクションエラー時のエラー処理をどこでするかを明確化して実装しなければならない。 下請けにするライブラリの都合などを鑑みて、全体統一を図る必要があるだろう。 それには、現在のSQLiteとPostgreSQLだけでは、サンプルが足りないように思う。



35
36
37
38
39
40
41
# File 'lib/al_rdbw_postgres.rb', line 35

def open_connection()
  return false  if ! @conn_info

  @handle = PGconn.connect( @conn_info )
  @handle.set_client_encoding( AL_CHARSET.to_s )
  @conn_info = nil
end

- (Boolean) rollback

トランザクションロールバック

Returns:

  • (Boolean)

    成否



263
264
265
266
267
268
269
# File 'lib/al_rdbw_postgres.rb', line 263

def rollback()
  return false  if ! @flag_transaction
  @result = get_handle().exec( "rollback transaction;" )
  @result.clear()
  @flag_transaction = false
  return true
end

- (Array<Hash>) select(sql, where_cond = nil)

select文の発行ヘルパー

Examples:

where condition
 use Array
  select( "select * from t1 where id=$1;", [2] )
 use Hash
  select( "select * from t1 _WHERE_;",
    { :id=>2, :age=>nil, "name like"=>"a%" } )

Parameters:

  • sql (String)

    SQL文

  • where_cond (Array, Hash, String) (defaults to: nil)

    where条件

Returns:

  • (Array<Hash>)

    結果の配列



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
# File 'lib/al_rdbw_postgres.rb', line 76

def select( sql, where_cond = nil )
  case where_cond
  when NilClass
    @result = get_handle().exec( sql )
    
  when Array
    @result = get_handle().exec( sql, where_cond )

  when Hash
    s = sql.split( '_WHERE_' )
    raise "SQL error in select()"  if s.size != 2
    (where, val) = make_where_condition( where_cond )
    @result = get_handle().exec( "#{s[0]} where #{where} #{s[1]}", val )

  when String
    sql.sub!( '_WHERE_', "where #{where_cond}" )
    @result = get_handle().exec( sql )

  else
    raise "where_cond error in select()"
  end

  if @result.result_status != PGresult::PGRES_TUPLES_OK
    raise "SQL error. result is not TUPLES_OK."
  end

  #
  # データの取り出しとデータタイプの変換
  #  number means PostgreSQL's Object ID.
  #  see src/include/catalog/pg_type.h
  #
  ret = []
  @result.each do |r|
    i = 0
    a = {}
    r.each do |k,v|
      if v != nil
        case @result.ftype( i )
        when 16               # bool
          v = (v == "t") ? "true" : "false"

        when 20,21,23, 26     # int, OID
          v = v.to_i

        when 25,1042,1043     # text, char, varchar
          v.force_encoding( AL_CHARSET )

        when 700,701          # float
          v = v.to_f

        when 1082,1083,1114,1184   # date,time,timestamp
          v = Time.parse( v )

        end
      end

      a[k.to_sym] = v
      i += 1
    end
    ret << a
  end
  @result.clear()

  return ret
end

- (AlPersistSqlite) table(tname, pkey = nil)

tableを指定して、Persistオブジェクトを生成

Parameters:

  • tname (String)

    テーブル名

  • pkey (Array<String,Symbol>, String, Symbol) (defaults to: nil)

    プライマリキー

Returns:



42
43
44
# File 'lib/al_persist_postgres.rb', line 42

def table( tname, pkey = nil )
  return AlPersistPostgres.new( self, tname, pkey )
end

- (Boolean) transaction

トランザクション開始

Returns:

  • (Boolean)

    成否



234
235
236
237
238
239
# File 'lib/al_rdbw_postgres.rb', line 234

def transaction()
  return false  if @flag_transaction
  @result = get_handle().exec( "begin transaction;" )
  @result.clear()
  return @flag_transaction = true
end

- (Hash) update(table, values, where_cond)

update文の発行ヘルパー

Parameters:

  • table (String)

    テーブル名

  • values (Hash)

    updateする値のhash

  • where_cond (Hash)

    where条件

Returns:

  • (Hash)

    結果のHash



185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
# File 'lib/al_rdbw_postgres.rb', line 185

def update( table, values, where_cond )
  columns = ""
  cnt = 1
  val = []
  values.each do |k,v|
    columns << "#{k}=$#{cnt},"
    cnt += 1
    if v.class == Array
      val << v.join( ',' )
    else
      val << v
    end
  end
  columns.chop!

  (where, wval) = make_where_condition( where_cond, cnt )

  sql = "update #{table} set #{columns} where #{where};"
  @result = get_handle().exec( sql, val + wval )
  ret = { :cmdtuples=>@result.cmdtuples }

  @result.clear()
  return ret
end