Connection

Connectionクラス

Connection オブジェクトは、DBとの接続と一対一に対応する。各 Statement の生成機能を持つ。

Connection の生成

Connection オブジェクトは、Driver の connect() 関数を用いて生成する:

  connect(const char* host,
          const char* port,
          const char* db,
          const char* user,
          const char* pass)

各文字列は、DBMS 用接続ライブラリにそのまま渡される(ので char である)。

host, port, user, pass はそれぞれ IPアドレス、ポート番号、接続ユーザー名とパスワードである。 NULL を指定すると、各 DBMS のデフォルト値が使われる。

db には接続先となる初期データベースを指定する。DBMS によっては付加的な情報を追加できる。

PostgreSQL については、 http://www.postgresql.jp/document/8.4/html/libpq-connect.html などを参照。 connect() の引数は "host=... port=... user=... password=... dbname=..." という形へ整形される。

connect() は Connection を返す。先に述べたように、この Connection は SharedPtr である。失敗した場合は == NULL になる。