You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
86 lines
3.0 KiB
86 lines
3.0 KiB
// Copyright (c) 2012-present The upper.io/db authors. All rights reserved.
|
|
//
|
|
// Permission is hereby granted, free of charge, to any person obtaining
|
|
// a copy of this software and associated documentation files (the
|
|
// "Software"), to deal in the Software without restriction, including
|
|
// without limitation the rights to use, copy, modify, merge, publish,
|
|
// distribute, sublicense, and/or sell copies of the Software, and to
|
|
// permit persons to whom the Software is furnished to do so, subject to
|
|
// the following conditions:
|
|
//
|
|
// The above copyright notice and this permission notice shall be
|
|
// included in all copies or substantial portions of the Software.
|
|
//
|
|
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
|
|
// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
|
// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
|
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
|
|
package sqlbuilder
|
|
|
|
import (
|
|
"database/sql"
|
|
|
|
db "github.com/upper/db/v4"
|
|
)
|
|
|
|
// Tx represents a transaction on a SQL database. A transaction is like a
|
|
// regular Session except it has two extra methods: Commit and Rollback.
|
|
//
|
|
// A transaction needs to be committed (with Commit) to make changes permanent,
|
|
// changes can be discarded before committing by rolling back (with Rollback).
|
|
// After either committing or rolling back a transaction it can not longer be
|
|
// used and it's automatically closed.
|
|
type Tx interface {
|
|
// All db.Session methods are available on transaction sessions. They will
|
|
// run on the same transaction.
|
|
db.Session
|
|
|
|
Commit() error
|
|
|
|
Rollback() error
|
|
}
|
|
|
|
// Adapter represents a SQL adapter.
|
|
type Adapter interface {
|
|
// New wraps an active *sql.DB session and returns a SQLBuilder database. The
|
|
// adapter needs to be imported to the blank namespace in order for it to be
|
|
// used here.
|
|
//
|
|
// This method is internally used by upper-db to create a builder backed by the
|
|
// given database. You may want to use your adapter's New function instead of
|
|
// this one.
|
|
New(*sql.DB) (db.Session, error)
|
|
|
|
// NewTx wraps an active *sql.Tx transation and returns a SQLBuilder
|
|
// transaction. The adapter needs to be imported to the blank namespace in
|
|
// order for it to be used.
|
|
//
|
|
// This method is internally used by upper-db to create a builder backed by the
|
|
// given transaction. You may want to use your adapter's NewTx function
|
|
// instead of this one.
|
|
NewTx(*sql.Tx) (Tx, error)
|
|
|
|
// Open opens a SQL database.
|
|
OpenDSN(db.ConnectionURL) (db.Session, error)
|
|
}
|
|
|
|
type dbAdapter struct {
|
|
Adapter
|
|
}
|
|
|
|
func (d *dbAdapter) Open(conn db.ConnectionURL) (db.Session, error) {
|
|
sess, err := d.Adapter.OpenDSN(conn)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return sess.(db.Session), nil
|
|
}
|
|
|
|
func NewCompatAdapter(adapter Adapter) db.Adapter {
|
|
return &dbAdapter{adapter}
|
|
}
|