Code Monkey home page Code Monkey logo

slick-pg's Introduction

Slick-pg

Slick extensions for PostgreSQL, to support a series of pg data types and related operators/functions.

####Currently supported pg types:

  • ARRAY
  • Date/Time
  • Range
  • Hstore
  • JSON
  • text Search
  • postgis Geometry
  • Composite type (basic)

** tested on PostgreSQL v9.3 with Slick v2.0.0.

Install

To use slick-pg in sbt project, add the following to your project file:

libraryDependencies += "com.github.tminglei" % "slick-pg_2.10" % "0.5.1.3"

If you need play-json support, pls append dependency:

libraryDependencies += "com.github.tminglei" % "slick-pg_play-json_2.10" % "0.5.1.3"

If you need joda-time support, pls append dependency:

libraryDependencies += "com.github.tminglei" % "slick-pg_joda-time_2.10" % "0.5.1.3"

If you need jts geom support, pls append dependency:

libraryDependencies += "com.github.tminglei" % "slick-pg_jts_2.10" % "0.5.1.3"

If you need json4s support, pls append dependency:

libraryDependencies += "com.github.tminglei" % "slick-pg_json4s_2.10" % "0.5.1.3"

If you need threeten support, pls append dependency:

libraryDependencies += "com.github.tminglei" % "slick-pg_threeten_2.10" % "0.5.1.3"

Or, in maven project, you can add slick-pg to your pom.xml like this:

<dependency>
    <groupId>com.github.tminglei</groupId>
    <artifactId>slick-pg_2.10</artifactId>
    <version>0.5.1.3</version>
</dependency>

<!-- append play-json/json4s/joda-time/jts/threeten dependencies if needed -->

Usage

Before using it, you need integrate it with PostgresDriver maybe like this:

import slick.driver.PostgresDriver
import com.github.tminglei.slickpg._

trait MyPostgresDriver extends PostgresDriver
                          with PgArraySupport
                          with PgDateSupport
                          with PgRangeSupport
                          with PgHStoreSupport
                          with PgPlayJsonSupport
                          with PgSearchSupport
                          with PgPostGISSupport {

  override val Implicit = new ImplicitsPlus {}
  override val simple = new SimpleQLPlus {}

  //////
  trait ImplicitsPlus extends Implicits
                        with ArrayImplicits
                        with DateTimeImplicits
                        with RangeImplicits
                        with HStoreImplicits
                        with JsonImplicits
                        with SearchImplicits
                        with PostGISImplicits

  trait SimpleQLPlus extends SimpleQL
                        with ImplicitsPlus
                        with SearchAssistants
                        with PostGISAssistants
}

object MyPostgresDriver extends MyPostgresDriver

then in your codes you can use it like this:

import MyPostgresDriver.simple._

class TestTable(tag: Tag) extends Table[Test](tag, Some("xxx"), "Test") {
  def id = column[Long]("id", O.AutoInc, O.PrimaryKey)
  def during = column[Range[Timestamp]]("during")
  def location = column[Point]("location")
  def text = column[String]("text", O.DBType("varchar(4000)"))
  def props = column[Map[String,String]]("props_hstore")
  def tags = column[List[String]]("tags_arr")

  def * = (id, during, location, text, props, tags) <> (Test.tupled, Test.unapply)
}

object tests extends TableQuery(new TestTable(_)) {
  ///
  def byId(ids: Long*) = tests.where(_.id inSetBind ids).map(t => t)
  // will generate sql like: select * from test where tags && ?
  def byTag(tags: String*) = tests.where(_.tags @& tags.toList.bind).map(t => t)
  // will generate sql like: select * from test where during && ?
  def byTsRange(tsRange: Range[Timestamp]) = tests.where(_.during @& tsRange.bind).map(t => t)
  // will generate sql like: select * from test where case(props -> ? as [T]) == ?
  def byProperty[T](key: String, value: T) = tests.where(_.props.>>[T](key.bind) === value.bind).map(t => t)
  // will generate sql like: select * from test where ST_DWithin(location, ?, ?)
  def byDistance(point: Point, distance: Int) = tests.where(r => r.location.dWithin(point.bind, distance.bind)).map(t => t)
  // will generate sql like: select id, text, ts_rank(to_tsvector(text), to_tsquery(?)) from test where to_tsvector(text) @@ to_tsquery(?) order by ts_rank(to_tsvector(text), to_tsquery(?))
  def search(queryStr: String) = tests.where(tsVector(_.text) @@ tsQuery(queryStr.bind)).map(r => (r.id, r.text, tsRank(tsVector(r.text), tsQuery(queryStr.bind)))).sortBy(_._3)
}

...
 

Configurable type/mappers

Since v0.2.0, slick-pg started to support configurable type/mappers.

Here's the related technical details:

All pg type oper/functions related codes and some core type mapper logics were extracted to a new sub project "slick-pg_core", and the oper/functions and type/mappers binding related codes were retained in the main project "slick-pg".

So, if you need bind different scala type/mappers to a pg type oper/functions, you can do it as "slick-pg" currently did.

####Built in supported type/mappers:

scala Type pg Type
List[T] ARRAY
sql Date
Time
Timestamp
slickpg Interval
Calendar
date
time
timestamp
interval
timestamptz
jada LocalDate
LocalTime
LocalDateTime
Period
DateTime
date
time
timestamp
interval
timestamptz
threeten.bp LocalDate
LocalTime
LocalDateTime
Duration
ZonedDateTime
date
time
timestamp
interval
timestamptz
slickpg Range[T] range
Map[String,String] hstore
json4s JValue json
play-json JsValue json
(TsQuery+TsVector) text search
jts Geometry postgis geometry

Build instructions

slick-pg uses sbt for building. Assume you have already installed sbt, then you can simply clone the git repository and build slick-pg in the following way:

./sbt update
./sbt compile

To run the test suite, you need:

  • create a user 'test' and db 'test' on your local postgres server, and
  • the user 'test' should be an super user and be the owner of db 'test'

Then you can run the tests like this:

./sbt test

ps: in the code of unit tests, the slick database is setup like this:

val db = Database.forURL(url = "jdbc:postgresql://localhost/test?user=test", driver = "org.postgresql.Driver")

Support details

Version history

v0.5.1 (22-Feb-2014):

  1. added more postgis/geom functions

v0.5.0 (7-Feb-2014):

  1. upgrade to slick v2.0.0
  2. add basic composite type support
  3. array support: allow nested composite type
  4. add play-json support
  5. add timestamp with zone support
  6. modularization for third party scala type (e.g. play-json/jts) support

v0.2.2 (04-Nov-2013):

  1. support Joda date/time, binding to Pg Date/Time
  2. support threetenbp date/time, binding to Pg Date/Time

v0.2.0 (01-Nov-2013):

  1. re-arch to support configurable type/mappers

v0.1.5 (29-Sep-2013):

  1. support pg json

v0.1.2 (31-Jul-2013):

  1. add pg datetime support

v0.1.0 (20-May-2013):

  1. support pg array
  2. support pg range
  3. support pg hstore
  4. support pg search
  5. support pg geometry

License

Licensing conditions (BSD-style) can be found in LICENSE.txt.

slick-pg's People

Contributors

tminglei avatar hsyed avatar freaky-namuh avatar jbnunn avatar michaelfester avatar oleastre avatar t3hnar avatar

Watchers

 avatar James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.