<commit_before><img src="http://developer.postgresql.org/~josh/graphics/logos/elephant-64.png" />
# PostgreSQL JDBC driver

[![Build Status](https://travis-ci.org/pgjdbc/pgjdbc.svg?branch=master)](https://travis-ci.org/pgjdbc/pgjdbc)
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/org.postgresql/postgresql/badge.svg)](https://maven-badges.herokuapp.com/maven-central/org.postgresql/postgresql)
[![Join the chat at https://gitter.im/pgjdbc/pgjdbc](https://badges.gitter.im/pgjdbc/pgjdbc.svg)](https://gitter.im/pgjdbc/pgjdbc?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

This is a simple readme describing how to compile and use the PostgreSQL JDBC driver.

 - [Commit Message Guidelines](#commit)

## Info

This isn't a guide on how to use JDBC - for that refer to [Oracle's website](http://www.oracle.com/technetwork/java/javase/jdbc/) and the [JDBC tutorial](http://docs.oracle.com/javase/tutorial/jdbc/).

For problems with this driver, refer to driver's [home page](http://jdbc.postgresql.org/) and associated [mailing list](http://archives.postgresql.org/pgsql-jdbc/).

## Downloading pre-built drivers

Most people do not need to compile PgJDBC. You can download prebuilt versions of the driver 
from the [Postgresql JDBC site](http://jdbc.postgresql.org/) or using your chosen dependency management tool:

### Maven
```xml
<dependency>
  <groupId>org.postgresql</groupId>
  <artifactId>postgresql</artifactId>
  <version>9.4.1207</version> <!-- Java 8 -->
  <version>9.4.1207.jre7</version> <!-- Java 7 -->
  <version>9.4.1207.jre6</version> <!-- Java 6 -->
</dependency>
```
### Gradle
Java 8:
```
'org.postgresql:postgresql:9.4.1207'
```
Java 7:
```
'org.postgresql:postgresql:9.4.1207.jre7'
```
Java 6:
```
'org.postgresql:postgresql:9.4.1207.jre6'
```
### Ivy
Java 8:
```xml
<dependency org="org.postgresql" name="postgresql" rev="9.4.1207"/>
```
Java 7:
```xml
<dependency org="org.postgresql" name="postgresql" rev="9.4.1207.jre7"/>
```
Java 6:
```xml
<dependency org="org.postgresql" name="postgresql" rev="9.4.1207.jre6"/>
```

### Development snapshots

Snapshot builds (builds from `master` branch) are deployed to Maven Central, so you can test current development version via
```xml
<dependency>
  <groupId>org.postgresql</groupId>
  <artifactId>postgresql</artifactId>
  <version>9.4.1208-SNAPSHOT</version> <!-- Java 8 -->
  <version>9.4.1208.jre7-SNAPSHOT</version> <!-- Java 7 -->
  <version>9.4.1208.jre6-SNAPSHOT</version> <!-- Java 6 -->
</dependency>
```

## Build requirements

In order to build the source code for PgJDBC you will need the following tools:

- A git client
- A recent version of Maven (3.x)
- A JDK for the JDBC version you'd like to build (JDK6 for JDBC 4, JDK7 for JDBC 4.1 or JDK8 for JDBC 4.2)
- A running PostgreSQL instance

Additionally, in order to update translations (not typical), you will need the following additional tools:

-  the gettext package, which contains the commands "msgfmt", "msgmerge", and "xgettext"

## Checking out the source code

The PgJDBC project uses git for version control. You can check out the current code by running:

    git clone https://github.com/pgjdbc/pgjdbc.git
    
This will create a pgjdbc directory containing the checked-out source code.
In order do build jre7 or jre6 compatible versions, check out those repositories under `pgjdbc`

    cd pgjdbc # <-- that is pgjdbc/pgjdbc.git clone
    git clone https://github.com/pgjdbc/pgjdbc-jre7.git
    git clone https://github.com/pgjdbc/pgjdbc-jre6.git
<commit_msg>doc: 9.4.1208 is released, update versions in readme.md<commit_after><img src="http://developer.postgresql.org/~josh/graphics/logos/elephant-64.png" />
# PostgreSQL JDBC driver

[![Build Status](https://travis-ci.org/pgjdbc/pgjdbc.svg?branch=master)](https://travis-ci.org/pgjdbc/pgjdbc)
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/org.postgresql/postgresql/badge.svg)](https://maven-badges.herokuapp.com/maven-central/org.postgresql/postgresql)
[![Join the chat at https://gitter.im/pgjdbc/pgjdbc](https://badges.gitter.im/pgjdbc/pgjdbc.svg)](https://gitter.im/pgjdbc/pgjdbc?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

This is a simple readme describing how to compile and use the PostgreSQL JDBC driver.

 - [Commit Message Guidelines](#commit)

## Info

This isn't a guide on how to use JDBC - for that refer to [Oracle's website](http://www.oracle.com/technetwork/java/javase/jdbc/) and the [JDBC tutorial](http://docs.oracle.com/javase/tutorial/jdbc/).

For problems with this driver, refer to driver's [home page](http://jdbc.postgresql.org/) and associated [mailing list](http://archives.postgresql.org/pgsql-jdbc/).

## Downloading pre-built drivers

Most people do not need to compile PgJDBC. You can download prebuilt versions of the driver 
from the [Postgresql JDBC site](http://jdbc.postgresql.org/) or using your chosen dependency management tool:

### Maven
```xml
<dependency>
  <groupId>org.postgresql</groupId>
  <artifactId>postgresql</artifactId>
  <version>9.4.1208</version> <!-- Java 8 -->
  <version>9.4.1208.jre7</version> <!-- Java 7 -->
  <version>9.4.1208.jre6</version> <!-- Java 6 -->
</dependency>
```
### Gradle
Java 8:
```
'org.postgresql:postgresql:9.4.1208'
```
Java 7:
```
'org.postgresql:postgresql:9.4.1208.jre7'
```
Java 6:
```
'org.postgresql:postgresql:9.4.1208.jre6'
```
### Ivy
Java 8:
```xml
<dependency org="org.postgresql" name="postgresql" rev="9.4.1208"/>
```
Java 7:
```xml
<dependency org="org.postgresql" name="postgresql" rev="9.4.1208.jre7"/>
```
Java 6:
```xml
<dependency org="org.postgresql" name="postgresql" rev="9.4.1208.jre6"/>
```

### Development snapshots

Snapshot builds (builds from `master` branch) are deployed to Maven Central, so you can test current development version via
```xml
<dependency>
  <groupId>org.postgresql</groupId>
  <artifactId>postgresql</artifactId>
  <version>9.4.1209-SNAPSHOT</version> <!-- Java 8 -->
  <version>9.4.1209.jre7-SNAPSHOT</version> <!-- Java 7 -->
  <version>9.4.1209.jre6-SNAPSHOT</version> <!-- Java 6 -->
</dependency>
```

## Build requirements

In order to build the source code for PgJDBC you will need the following tools:

- A git client
- A recent version of Maven (3.x)
- A JDK for the JDBC version you'd like to build (JDK6 for JDBC 4, JDK7 for JDBC 4.1 or JDK8 for JDBC 4.2)
- A running PostgreSQL instance

Additionally, in order to update translations (not typical), you will need the following additional tools:

-  the gettext package, which contains the commands "msgfmt", "msgmerge", and "xgettext"

## Checking out the source code

The PgJDBC project uses git for version control. You can check out the current code by running:

    git clone https://github.com/pgjdbc/pgjdbc.git
    
This will create a pgjdbc directory containing the checked-out source code.
In order do build jre7 or jre6 compatible versions, check out those repositories under `pgjdbc`

    cd pgjdbc # <-- that is pgjdbc/pgjdbc.git clone
    git clone https://github.com/pgjdbc/pgjdbc-jre7.git
    git clone https://github.com/pgjdbc/pgjdbc-jre6.git

{'fraction_non_alphanumeric': 0.14925998324490367, 'fraction_numerical': 0.030717676626640603, 'mean_word_length': 4.472116119174943, 'pattern_counts': {'":': 0, '<': 73, '<?xml version=': 0, '>': 71, 'https://': 20, 'lorem ipsum': 0, 'www.': 2, 'xml': 10}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 6, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '273078', 'n_tokens_mistral': 2737, 'n_tokens_neox': 2451, 'n_words': 649}