# NIFTYCloud SDK for Java forked from AWS SDK for Java [![Build Status](https://travis-ci.org/aws/aws-sdk-java.png?branch=master)](https://travis-ci.org/aws/aws-sdk-java)

**NIFTYCloud SDK for Java** を利用することでJava開発者は [NIFTY Cloud エンジニアリングパーツ][niftycloud-engineeringparts] の[Relational DataBase (RDB)][niftycloud-rdb] (AWS RDS 相当)、 [Message Queue (MQ)][niftycloud-mq] (AWS Sqs 相当)、 [Domain Name Service (DNS)][niftycloud-dns] (AWS Route53 相当)の機能を簡単に利用することができます。
また、当SDKは [Amazon Web Services][aws] 提供の [AWS SDK for Java][aws-sdk-website] にNIFTY Cloud用の機能を利用できるように手を入れたもので、1つのSDKで両方を合わせて利用することも可能です

[zip ファイル][install-jar] からダウンロードするだけ利用開始可能です。

* [API Docs][niftycloud-docs-api]
* [SDK Homepage][niftycloud-sdk-website]

## 機能

* [NIFTYCloud エンジニアリングパーツ][niftycloud-engineeringparts] の API は [Amazon Web Service][aws] と数点を除き互換性があります。
* 同一の SDK で NIFTY Cloud と AWS のサービスを利用することができます。
* その他の特徴については [AWS SDK for Java](https://github.com/aws/aws-sdk-java/blob/master/README.md#features) を参照して下さい。

## 利用できない機能

* NIFTY Cloud では Amazon では利用可能な [IAM Instance Profile Credentials][aws-iam-credentials] を利用することができません。ご注意下さい。

## はじめよう

1. NIFTY Cloud を開始するためには、アカウントが必要です。次の[リンク先](http://cloud.nifty.com/flow/#flow)の手順に従って作成してください。
1. **最小要件** - **Java 1.6+** の SDK が必要です。要件についてのより詳細な情報やSDKの最適な設定については [Java Development Environment][aws-docs-signup] の AWS デベロッパーガイドのセクションを参照して下さい。
1. **SDK のインストール** - Zipファイルをダウンロードして中のjarファイルを追加して下さい。
1. **SDK を利用する** - [AWS デベロッパーガイド][aws-docs-guide] になれるのが一番よい方法です。


## ドキュメント

`ant javadoc` を実行することで、javadocを作成することができます。


## テスト

元々のAWS SDK for Javaには付属されていなかったテストコードを追加してあります。
`ant compile` を行うと、compileが行われる際に、src/test/resources/AwsCredentials.properties が作成されます。
このファイルにaccess key や secret key、各種serviceのendpointなどを適切に指定し `ant test` を実行することで実際のサービスにつないでテストを行うことができます。

note: 但し、テストの際に利用したクラウドの費用は開発者の方のご負担となります。

現在、用意しているテストは主にNIFTY Cloud エンジニアリングパーツに特有の機能がメインで、共通の部分については一部しか実装していません。


[niftycloud-docs-api]: http://cloud.nifty.com/api/index.htm
[niftycloud-sdk-website]: http://cloud.nifty.com/guide/index.htm
[niftycloud-engineeringparts]: http://cloud.nifty.com/
[niftycloud]: http://cloud.nifty.com/
[niftycloud-mq]: http://cloud.nifty.com/service/mq/index.htm
[niftycloud-rdb]: http://cloud.nifty.com/service/rdb/index.htm
[niftycloud-dns]: http://cloud.nifty.com/service/dns/index.htm
[aws]: http://aws.amazon.com/
[aws-install-jar]: http://sdk-for-java.amazonwebservices.com/latest/aws-java-sdk.zip
[aws-sdk-website]: http://aws.amazon.com/sdkforjava
[aws-sdk-forum]: http://developer.amazonwebservices.com/connect/forum.jspa?forumID=70
[aws-sdk-issues]: https://github.com/aws/aws-sdk-java/issues
[aws-sdk-license]: http://aws.amazon.com/apache2.0/
[aws-docs-api]: http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/index.html
[aws-docs-signup]: http://docs.aws.amazon.com/AWSSdkDocsJava/latest/DeveloperGuide/java-dg-setup.html
[aws-iam-credentials]: http://docs.aws.amazon.com/AWSSdkDocsJava/latest/DeveloperGuide/java-dg-roles.html
[aws-docs-guide]: http://docs.aws.amazon.com/AWSSdkDocsJava/latest/DeveloperGuide/welcome.html
