Development and Release

Setting up local development environment for datasource-proxy.

Requirement

java5+ for runtime.

For development, JDK7 is required to be compatible with JDBC4.1 API(from java7).

In compilation phase, target is set to 1.5, thus distribution(jar file) runs with java5+.

---

Release

for my reminder

Prerequisite

• install PGP
• configure ~/.m2/settings.xml

PGP installation

install for mac

> sudo port install gnupg

generate key-pair

> gpg --gen-key
Real name: Tadaya Tsuyukubo
Email address: [email protected]
Comment:

keys are stored in ~/.gnupg

confirm generated key

> gpg --list-keys
> gpg --list-secret-keys

to get public key-id, use gpg --list-keys:

> gpg --list-keys
...
pub   2048R/[KEY_ID] 2013-10-04
...

distribute public key

> gpg --keyserver hkp://pool.sks-keyservers.net --send-keys [KEY_ID]

settings.xml configuration

• need to provide credential for sonatype's staging repository

add to ~/.m2/settings.xml

<settings>
  ...
  <servers>

    <!-- for release version staging -->
    <server>
      <id>sonatype-nexus-staging</id>
      <username>your-jira-id</username>
      <password>your-jira-pwd</password>
    </server>

    <!-- for snapshot -->
    <server>
      <id>sonatype-nexus-snapshots</id>
      <username>your-jira-id</username>
      <password>your-jira-pwd</password>
    </server>

  </servers>
  ...
</settings>

• use JIRA (https://issues.sonatype.org) ID and pass.

Javadoc

> git clone [email protected]:ttddyy/datasource-proxy.git
> cd datasource-proxy

# generate javadoc
> git checkout [VERSION_TAG]
> JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.7.0_07.jdk/Contents/Home mvn javadoc:javadoc

# add javadoc to github pages
> git checkout gh-pages
> cp -R target/site/apidocs javadoc/v[VERSION]
> git add javddoc/v[VERSION]
> git commit -m "..."
> git push  # or git push origin gh-pages