2015年4月23日木曜日

Graphviz 各種 Tips

概要

GraphvizのTipsをメモ

環境

  • CentOS 6.6 64bit
  • Graphviz 2.26.0-10

Tips

画像を埋め込む方法

jenkins [label = <<TABLE><TR><TD><IMG SRC="jenkins.png"/></TD></TR></TABLE>>, shape = plaintext];

HTMLライクな構文を使用すると埋め込むことができる
上記の場合はdotファイルと同じディレクトリにpngファイルを配置すればOK
shape=plaintextを画像のオブジェクトを枠線を削除するために利用

複数のclusterに所属させる方法

複数のsubgraphに所属される方法とも言うと思います

subgraph cluster_one {
  label = "one";
  subgraph cluster_two {
    host001;
    label = "two";
    color = blue;
  }
}

subgraphの宣言の中にsubgraphを書けばOK
上記の場合はこんな感じになります
test.png

cluster内のオブジェクトがエッジで接続されている場合にオブジェクトを並列にする方法

subgraph cluster_one {
  label = "one";
  subgraph cluster_two {
    rank = same {
      host001 -> host002;
    }
    label = "two";
    color = blue;
  }
}

rank = sameを使います
host001とhost002は横に並びます
rankdir=LRにすると縦に並びます
test2.png
rank = sameを使わないと以下の通り
test2-2.png

2015年4月22日水曜日

Jenkins の Workflow Plugin を使ってみた

概要

JenkinsのWorkflow Pluginを使ってみました
ビルドをchainするプラグインは他にもBuild Pipelineなどがあります
今回使うWorkflowプラグインも同じような種類のプラグインですがBuild Pipelineで問題だった点をいろいろ解決してくれているプラグインになります
インストールから簡単なサンプルの動作まで紹介します

環境

  • CentOS 6.6 64bit
  • Jenkins 1.6.10
  • Workflow Plugin 1.5

各種インストール

  • Jenkins
    ここを参考にyumでインストールしました
    Workflowプラグインを動かすためには1.580.1以上のバージョンが必要です

  • Workflowプラグインのインストール

Jenkinsの管理 -> プラグインの管理 -> Workflow: Aggregator

をインストールします
依存するプラグインも一緒にインストールされます
プラグインをインストールしたらJenkinsを一旦再起動しましょう

Workflowジョブを作成する

普通にジョブを作成する手順と同じです
Build Pipelineの場合はジョブを「下流」「上流」でchainすることで実現し、ビューでBuild Pipelineビューを作りましたが、Workflowプラグインはビューを作成しません

ジョブの種類を選択する部分で「Workflow」という項目が増えているのでこれを選択することでWorkflow用のジョブを作成することができます
create_workflow_job.png
これを選択して適当なWorkflowジョブを作成してください

Groovy でジョブのフローを記述する

ここがWorkflowプラグインの一番の肝になると思います
ジョブの設定を開くと「Definition Groovy CPS DSL」という項目でフリーのテキストエリアでScriptを記載する部分があると思います
ここにGroovyスクリプトを記載していきます

Workflowプラグインはジョブの流れや処理をGroovyのスクリプトで制御できるプラグインになります

とりあえずHello world

まずはジョブを成功させてみましょう
以下のScriptを記述してジョブを保存してください

echo 'hello from Workflow'

hello_world_workflow.png

そしてジョブを実行してみましょう
ビルド結果を確認するとechoした文章が出力されていると思います
result_hello_world_workflow.png

またScriptは以下のように記載することもできます

echo("hello from Workflow");

書きやすい方で書いてみましょう

複数のジョブを実行してみる

今回は既存の複数のジョブをWorkflow用のジョブから順番に実行できるようにしてみます
既存のジョブ名はそれぞれ「test1_job」「test2_job」とします
以下のようのScriptを記載しましょう

build 'test1_job'
build 'test2_job'

保存してジョブを実行してみます

実行結果をみると指定したジョブが上から順に実行されましたというログだけが出ています
なのでWorkflowから実行したジョブのビルド結果は各ジョブのビルド結果を見る必要があります

とりあえず既存のジョブをchainするだけならWorkflow Pluginでも簡単にできました

最後に

今回はBuild Pipelineのようにジョブをchainすることが目的だったので紹介は以上ですが、Workflow Pluguinで用意されている機能はもっとたくさんあります
SCMからリソースを取得したり、分散ビルドしたり、成果物を保存したりといったビルドの基本的な機能も実装されているので、これらをGroovyで書くことができます

感想も

かなりちょっとしか使っていませんが使ってみた感想としてはまだまだ発展の余地はあるかなと思いました
Build Pipelineに比べて優れているのは、それぞれのジョブ同士が疎結合のままchainすることができるので、ジョブを単体で実行することができる状態を保つことができます
もう少し言うとBuild Pipelineを使うと必ず下流、上流が結びついているので単体で実行すると勝手に下流のジョブも流れてしまいます
また上流のビルドパラメータを下流に引き継ぐようなジョブを作成していると、必ず上流から実行しないとパラメータの値がないので下流のジョブを単体で実行することができません
この辺のジョブの疎結合はWorkflow Pluginのほうが優れている点だと思います

ただ、Workflow Pluginではフローの可視化ができなかったり、ビルド結果の詳細を確認するには実行したジョブ側を見なければいけなかったりといろいろと改善してほしいポイントはあると思いました
ジョブの一覧でも、どのジョブがWorkflowジョブなのか一見するとわからないので命名規則でカバーしなければいけないのか、、とかも感じまいsた

なので今のところは各自のユースケースにあったプラグインを選択すればいいと思いますが、個人的には今後はWorkflow Pluginが来ると思います
理由としてはやはりビルドの内容をGroovyで完全にコード化できる点かなと思います
Infrastructure as a Codeではないですが、ジョブの状態がコードがされていれば見える化もしやすいですし、git で管理することもできるのでジョブの内容自体をCIすることもできるようになると思います

えー、いろいろ書きましたがとりあえず好感触を得ることができました
今後の発展も期待して使い続けたいと思います

参考サイト

2015年4月16日木曜日

CentOS 6.6 に yum でJenkins をインストールする方法

概要

専用のリポジトリを追加すればyumでインストールおよびパッケージ管理できるみたいなので試してみました
過去に紹介した記事だとTomcat+warファイル方式でやっています
yum でインストールすれば起動スクリプトも作ってくれるので便利です

環境

  • CentOS 6.6 64bit
  • Jenkins
  • Java 1.8.0_31 (OpenJDK)

インストール

リポジトリ追加

wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/redhat/jenkins.repo
rpm --import http://pkg.jenkins-ci.org/redhat/jenkins-ci.org.key

で完了です
/etc/yum.repos.dにJenkins専用のリポジトリファイルを作成して検証のために公開鍵をrpmにインポートしています
インポートした鍵情報を確認した場合は

rpm -qa | grep gpg-pubkey

で表示される鍵情報のRPMに対して詳細情報を表示するオプションを付与して実行すればOKです

rpm -qli gpg-pubkey-xxxxxxxx-yyyyyy

xxxxxxxx-yyyyyy はランダムな文字列が入っているはずです

yum インストール

yum -y install jenkins

でOKです
2015/04/16 時点では1.609-1.1という最新版のJenkinsがインストールされました

インストールされたものを確認

  • JENKINS_HOME
    デフォルトでは/var/lib/jenkinsになっていました
    起動オプションで指定するだけなので変更したい場合はJenkinsの起動スクリプトを変更すればOKだと思います

  • warファイルの場所
    /usr/lib/jenkins/jenkins.war

  • Jenkinsのログ
    /var/log/jenkins/jenkins.log

  • その他一覧

インストールされた全資材を確認したい場合は-qliオプションで確認できます

rpm -qli jenkins-1.609-1.1.noarch

一応自分が確認した段階では以下の通りでした

/etc/init.d/jenkins
/etc/logrotate.d/jenkins
/etc/sysconfig/jenkins
/usr/lib/jenkins
/usr/lib/jenkins/jenkins.war
/usr/sbin/rcjenkins
/var/cache/jenkins
/var/lib/jenkins
/var/log/jenkins

動作確認

  • 起動と停止
service jenkins start
service jenkins stop

起動すると8080でLISTENします
既存のプロセス(Tomcatとか)が8080を使っている場合は停止してから実行してください
親プロセス配下に50個ほど子プロセスができるようです

java,28629 -Dcom.sun.akuma.Daemon=daemonized -Djava.awt.headless=true -DJENKINS_HOME=/var/lib/jenkins -jar /usr/lib/jenkins/jenkins.war --logfile=/var/log/jenkins/jenkins.log --webroot=/var/cache/jenkins/war --daemon--httpPo
  {java},28632
  {java},28635
  {java},28638
  ・・・
  この配下に更に50個ほどの子プロセスがあった
  • UIにアクセス

http://hostname:8080/
でJenkinsのホームにアクセスできます
デフォルトではID/PWは設定されていません

  • 自動起動設定
chkconfig jenkins on

service起動できるのでもちろんchkconfig も使うことができます

最後に

アップデートの検証までは実施していないのですがおそらくyumでupdateできると思います
できない場合はJenkinsの画面から実施する感じだと思います

2015年4月15日水曜日

Capistrano 3.4 を触ったのでメモ

概要

ようやくバージョン3を触ったので忘れないようにメモしておきます
インストールから簡単なレシピ作成まで実施してみました

環境

  • CentOS 6.6 64bit
  • Ruby 2.2.1
  • Gem 2.4.6
  • Capistrano 3.4.0

インストール

事前にRubyおよびGemのインストールは完了しておいてください

gem install capistrano

でインストールは完了です

初期化

cap install

適当なディレクトリに移動した上で上記のコマンドを実行しましょう
Capistranoの実行に必要なファイル群を自動で生成してくれます
Capistrano2ではcapifyというコマンドが使われていたのですが、それは使えなくなったようです

ファイル確認

cap install後に作成されるファイルは以下の通りでした

合計 12
drwxr-xr-x 3 root root 4096  4月 15 20:17 2015 config
drwxr-xr-x 3 root root 4096  4月 15 20:17 2015 lib
-rw-r--r-- 1 root root  837  4月 15 20:17 2015 Capfile

動作確認

cap console

指定したホストに任意のコマンドを発行できるようにしてみます

  • vim Capfile
require 'capistrano/console'

上記を追記します

  • vim config/deploy/production.rb
role :web, %w{host1 host2}

host1, host2 にはアクセスしたいサーバを指定します
IPでもOKです
host1, host2 にノンパスでSSHアクセスできるのであれば設定はこれでOKです
SSHに認証がある場合は以下も実施します

  • vim config/deploy/production.rb
set :ssh_options, {
  user: 'root',
  keys: %w(/path/to/key.pem),
  forward_agent: false,
  auth_methods: %w(publickey),
  passphrase: 'password'
}

上記はユーザがrootで公開鍵/path/to/key.pemを使ってパスワードに「password」を使って認証する場合の設定です
ポートは指定していないので22番になります
また上記の設定はすべてのサーバの認証に使われる情報なので今回の場合はhost1とhost2の両方で同じ認証である必要があります

設定は以上です
では実行してみましょう

cap production console ROLES=web

とするとproduction>というプロンプトになるのでコマンドを何か実行してみましょう
role :webで指定したhost1とhost2に同じコマンドが発行されてその結果が返ってくると思います

実行時に指定しているproductionを指定しないとconfig/deploy/staging.rbというファイルが読み込まれて実行されます
Capistrano3ではマルチ環境に対応しているため、サービス環境に対して実行したい場合はproductionを付与する必要があります

対話的ではありますがcap consoleだけでもできるようになっていればかなりオペレーションがかなり簡易になると思います

レシピを作成する

せっかくなので独自のレシピも作成してみましょう

  • vim config/deploy.rb
namespace :test do

  desc 'Show hostname'
  task :show_hostname do
    on roles :web do
      execute 'hostname'
    end
  end

end

上記を最下部に追記します
タスク自体は非常に単純でロール:webに属するサーバ郡に対してhostnameコマンドを実行するだけです
追記したらタスクを実行してみます

cap -T

でタスクの一覧が確認できます

cap production test:show_hostname

でタスクを実行することができます

今回はconfig/deploy.rbにレシピを追加しましたがどうやらlib/capistrano/tasks配下に.rakeファイルを作成していくのがCapistrano3では普通のようです

最後に

Capistrano2に慣れているとだいぶ使い勝手変わっているので初めは困惑するかもしれません
タスクの書き方は基本的には変わりませんが、duplicatedになっているメソッド等もありそうなので、ドキュメントを見ながら作成したほうがいいかと思います

Tips

デフォルトで用意してあるデプロイタスクが邪魔という場合にはCapfileに記載してあるrequire 'capistrano/deploy'をコメントアウトすればOKです
ただそうするとrestartというメソッドが使えなくなるのでconfig/deploy.rbに記載してあるdeployタスクも削除しないとエラーで怒られてしまいます

2015年4月14日火曜日

1つの git を複数のリポジトリに分割する方法

概要

1つの巨大なgitを複数のgit環境に分割してみたいと思います
初めは小さなプロジェクトで1つのgitからスタートしたが、次第にプロジェクトが大きくなり、その過程でgitを複数作らなくて同じgitにpushし続けた結果いろんなソースコードが混じった巨大なgitが出来てしまった
なんてことはあると思います

環境

  • git 2.1.1

分割する方法

例として自分のGitHubアカウントを使って分割してみます

分割先のリポジトリを作成する

まず分割先のリポジトリを作成しましょう
名前は何でもOKです
できれば空のリポジトリとして作成しましょう
空じゃなくてもOKですが、空リポジトリの方が簡単です
create-repo-for-split.png

分割対象のリポジトリをcloneする

これが巨大な1つgitリポジトリになります
ご自身の環境に合わせて分割したいリポジトリをローカルにcloneしてください
すでにある場合は特に何もしなくてOKです
今回はテスト用に自分のリポジトリを使ってみます

git clone https://github.com/kakakikikeke/cookbooks-emacs.git

ローカルでリポジトリをcloneする

Remoteからcloneしてきたリポジトリをローカルで操作します
まずは分割元のリポジトリを分割先のリポジトリに丸々cloneします

mkdir split-repo-test
git clone cookbooks-emacs/ split-repo-test/

これでローカル上で全く同じリポジトリができました

cloneした分割先のリポジトリでフィルタをかける

これが今回の肝となる作業だと思います
先ほどcloneした分割先のリポジトリに移動してフィルタをかけます
フィルタをかけることで必要なディレクトリ配下のみを管理git配下で管理できるようになります

cd split-repo-test
git filter-branch --subdirectory-filter files/ HEAD

とすることで files/ ディレクトリ配下をgitリポジトリで管理できるようになります
今回はサンプルにfilesというディレクトリがあるのでそれを指定していますが、ここは自身の環境に合わせて分割したいディレクトリを指定してください
完了後にlsでリポジトリを確認するとフィルタされたディレクトリ配下のリソースだけがあると思います
またgit logでログを確認すると他のディレクトリに対するコミットログがなくなっていると思います

リモートリポジトリを変更する

このままだとリモートリポジトリは分割元のリモートリポジトリになっているので push すると大変なことになります
分割後のリポジトリは作業冒頭でGithub上に作成したリモートリポジトリになるのでこれに変更します

cd split-repo-test
git remote set-url origin https://github.com/kakakikikeke/split-repo-test.git

これでpushしてみましょう

git push -u origin master

認証が成功して push できたあとでGithubを見てみると分割されたリソースがpushされていることを確認できると思います
goal-repo-for-split.png

すでに誰かがmasterブランチにpushしてしまっている場合は一旦git pullしてから push しましょう

最後に

今後は分割したリポジトリにコミットしていけばOKです
既存のリポジトリはgit rmしちゃっていいと思いますが、git rmだけだと歴史には残ってしまうので歴史からも完全に削除したい場合は、こちらもgit filter-branchを使うといいみたいです

2015年4月10日金曜日

Handler processing failed; nested exception is java.lang.NoClassDefFoundError: Could not initialize class org.hibernate.validator.internal.engine.messageinterpolation.InterpolationTerm

概要

Springでバリデーションルールを作成するときに@Maxや@Minなどを使います
バリデーションルールを作成した上でテストを実施すると掲題のエラーが発生しました
プロジェクト上ではエラーにならずテストを実行すると発生する感じで若干ハマったので対応方法を紹介します

環境

  • Windows 7 64bit
  • Java 1.8.0_25
  • Maven 3.2.2
  • Eclipse 4.4 Luna
  • Spring 4.1.5 RELEASE

開発シーン詳細

開発はEclipse上で行っておりSpringフレームワークを使ったWebAPIを作成しています
プロジェクトはMavenでビルドすることができるようになっています
Springにあるバリデーションの機能を使うためにBeansクラスを作成してそのBeansクラスがリクエストのパラメータをバインドするように実装しています
バインドするBeansクラス上で各パラメータにバリデーション用のアノテーションを付与しています
この状態でMaven経由でテストを実施するとバリデーションを使う部分で掲題のエラーが発生しました

対応方法

バリデーション用のアノテーションを使うために以下のようにpom.xmlを記載しました

<!-- Hibernate Validation -->
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>5.1.3.Final</version>
</dependency>
<dependency>
    <groupId>javax.el</groupId>
    <artifactId>javax.el-api</artifactId>
    <version>3.0.1-b04</version>
</dependency>
<dependency>
    <groupId>org.glassfish.web</groupId>
    <artifactId>el-impl</artifactId>
    <version>2.2</version>
    <scope>test</scope>
</dependency>

ポイントは最後のel-implでこれがないと掲題のエラーが発生する感じです
もちろんel-implがなくてもプロジェクトのエラーは発生しませんがmvn testを実行するとエラーが発生する感じでした

開発している環境にもよりますがといあえず自分は上記で解決できたので紹介します

2015年4月9日木曜日

Signature Version 4 を計算する Java 実装を作った

概要

http://docs.aws.amazon.com/ja_jp/general/latest/gr/sigv4-signed-request-examples.html
で紹介されているpython実装をJavaに書き換えました

環境

  • Java 1.8.0_25

ソースコード

Githubで公開しているので最新版はそちらを御覧ください

package com.kakakikikeke.sample.v4;

import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.HashMap;
import java.util.Map;
import java.util.Map.Entry;

import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;

import org.apache.commons.httpclient.Header;
import org.apache.commons.httpclient.HttpClient;
import org.apache.commons.httpclient.HttpException;
import org.apache.commons.httpclient.HttpMethodBase;
import org.apache.commons.httpclient.methods.GetMethod;
import org.apache.commons.httpclient.methods.PostMethod;

import com.kakakikikeke.sample.utils.Utils;

public class Signature4Creator {

    static byte[] getHmacSHA256(String data, byte[] key) throws Exception {
        Mac mac = Mac.getInstance("HmacSHA256");
        mac.init(new SecretKeySpec(key, "HmacSHA256"));
        return mac.doFinal(data.getBytes("UTF-8"));
    }

    static byte[] getSignatureKey(String key, String dateStamp, String regionName, String serviceName) throws Exception {
        byte[] kSecret = ("AWS4" + key).getBytes("UTF-8");
        byte[] kDate = getHmacSHA256(dateStamp, kSecret);
        byte[] kRegion = getHmacSHA256(regionName, kDate);
        byte[] kService = getHmacSHA256(serviceName, kRegion);
        byte[] kSigning = getHmacSHA256("aws4_request", kService);
        return kSigning;
    }

    static String getHmacSHA256Digest(String data, byte[] key) throws Exception {
        Mac mac = Mac.getInstance("HmacSHA256");
        mac.init(new SecretKeySpec(key, "HmacSHA256"));
        byte[] digest = mac.doFinal(data.getBytes("UTF-8"));
        StringBuffer buffer = new StringBuffer();
        for (int i = 0; i < digest.length; i++) {
            String tmp = Integer.toHexString(digest[i] & 0xff);
            if (tmp.length() == 1) {
                buffer.append("0").append(tmp);
            } else {
                buffer.append(tmp);
            }
        }
        return buffer.toString();
    }

    static String getDigest(String str) throws UnsupportedEncodingException, NoSuchAlgorithmException {
        MessageDigest md = MessageDigest.getInstance("SHA-256");
        md.update(str.getBytes("UTF-8"));
        byte[] digest = md.digest();
        StringBuffer buffer = new StringBuffer();
        for (int i = 0; i < digest.length; i++) {
            String tmp = Integer.toHexString(digest[i] & 0xff);
            if (tmp.length() == 1) {
                buffer.append("0").append(tmp);
            } else {
                buffer.append(tmp);
            }
        }
        return buffer.toString();
    }

    static void execUrl(String url, Map<String, String> headers) throws HttpException, IOException {
        // HttpMethodBase hmb = new GetMethod(url);
        // for POST Method
        HttpMethodBase hmb = new PostMethod(url);
        for (Entry<String, String> entry : headers.entrySet()) {
            hmb.setRequestHeader(entry.getKey(), entry.getValue());
        }
        System.out.println("======url======");
        System.out.println(url);
        System.out.println("======headers======");
        for (Header header : hmb.getRequestHeaders()) {
            System.out.println(header.getName());
            System.out.println(header.getValue());
        }
        HttpClient hc = new HttpClient();
        hc.getHostConfiguration().setProxy("sample.proxy.com", 8080);
        int code = hc.executeMethod(hmb);
        String body = hmb.getResponseBodyAsString();
        System.out.println(code);
        System.out.println(body);
    }

    public static void main(String[] args) throws Exception {
        // String method = "GET";
        // for POST Method
        String method = "POST";
        String service = "ec2";
        String host = "ec2.amazonaws.com";
        String region = "us-east-1";
        String endpoint = "https://ec2.amazonaws.com";
        String requestParameters = "Action=DescribeRegions&Version=2013-10-15";
        String accessKey = "Please input your aws accessKey";
        String secretKey = "Please input your aws secretKey";
        String amzdate = Utils.getTimestamp("yyyyMMdd'T'HHmmss'Z'", "UTC");
        String datestamp = Utils.getTimestamp("yyyyMMdd", "UTC");
        // Take 1
        String canonicalURI = "/";
        String canonicalQueryString = requestParameters;
        String canonicalHeaders = "host:" + host + "\n" + "x-amz-date:" + amzdate + "\n";
        String signedHeaders = "host;x-amz-date";
        String payloadHash = getDigest("");
        String canonicalRequest = method + "\n" + canonicalURI + "\n" + canonicalQueryString + "\n" + canonicalHeaders + "\n" + signedHeaders + "\n" + payloadHash;
        System.out.println("======canonicalRequest======");
        System.out.println(canonicalRequest);
        // Take 2
        String algorithm = "AWS4-HMAC-SHA256";
        String credentialScope = datestamp + "/" + region + "/" + service + "/" + "aws4_request";
        String stringToSign = algorithm + "\n" + amzdate + "\n" + credentialScope + "\n" + getDigest(canonicalRequest);
        System.out.println("======stringToSign======");
        System.out.println(stringToSign);
        // Take 3
        byte[] signingKey = getSignatureKey(secretKey, datestamp, region, service);
        String signature = getHmacSHA256Digest(stringToSign, signingKey);
        System.out.println("======signature======");
        System.out.println(signature);
        // Take 4
        String authorizationHeader = algorithm + " " + "Credential=" + accessKey + "/" + credentialScope + ", " + "SignedHeaders=" + signedHeaders + ", " + "Signature=" + signature;
        System.out.println("======authorizationHeader======");
        System.out.println(authorizationHeader);
        // Send Request
        String requestURL = endpoint + "?" + canonicalQueryString;
        System.out.println("======requestURL======");
        System.out.println(requestURL);
        Map<String, String> headers = new HashMap<String, String>();
        headers.put("host", host);
        headers.put("x-amz-date", amzdate);
        headers.put("Authorization", authorizationHeader);
        execUrl(requestURL, headers);
    }

}

mainで宣言している文字列部分を必要な情報に書き換えれば別のAPIも呼び出すことができると思います
サンプルではEC2のDescribeRegionsをコールしています

AccessKeyとSecretKeyを自分のキーに書き換えてください

プロキシを通すのが前提になっているソースなので不要であればexecUrlメソッドのプロキシの部分をコメントアウトするか削除してください

結構いろいろなライブラリを使っているので必要に合わせてjarをインポートしてください
Mavenであればpom.xmlを公開しているので、同じものを書けばOKです

書き換えたらこのクラス自体を実行すればOKです

最後に

Signature Version 4はややこしすぎて困ります
Java SDKを使えばいいじゃんという話ですが、AWS互換APIとかを作っている方とかは実装がどうなっているのか知りたくなると思います
SDKの実装見ればいいじゃんという話にもなりますが、SDKのソースを見るのが結構たいへんで見てもどこを持ってくればいいのかよくわからず、結局いろいろドキュメントとか読みながら頑張ってJavaで書いてみました