Blockchain as a Service:Java SDK クイックスタート

SSL 接続ファイルおよびアカウント認証情報の収集

BaaS プラットフォームとの SSL 接続を確立するため、以下の 4 つのファイルを準備してください。

TEE ハードウェアプライバシー対応コントラクトチェーンファイルの収集（該当する場合）

ご使用のコントラクトチェーンが Trusted Execution Environment（TEE）ハードウェアプライバシー構成を採用している場合は、以下のファイルも準備してください。標準コントラクトチェーンの場合は、このステップはスキップしてください。

プロジェクト構造の設定

1. IntelliJ IDEA で Maven プロジェクトを作成します。

2. プロジェクト内、java ディレクトリ配下にカスタムパッケージ（例： com.example.demo）を作成します。その後、DemoSample.java をダウンロードし、その内容全体をパッケージ内にコピーします。

3. 上記の 4 つの認証情報ファイルを resources ディレクトリに配置します。

   your-project/
   ├── src/
   │   └── main/
   │       ├── java/
   │       │   └── com/example/demo/
   │       │       └── DemoSample.java      # アプリケーションのエントリポイント
   │       └── resources/
   │           ├── client.crt              # クライアント証明書
   │           ├── client.key              # クライアント秘密鍵
   │           ├── trustCa                 # CA trustStore（パスワード：mychain）
   │           └── user.key                # トランザクション用アカウント秘密鍵
   └── pom.xml

デモプロジェクトでは、スマートコントラクトのコンパイル済みバイトコードが必要です。Solidity コントラクトの記述方法については、「Solidity コントラクト開発」をご参照ください。Solidity コンパイラについては、「Solidity コントラクトコンパイラ」をご参照ください。

Maven 依存関係の追加

pom.xml に以下の内容を追加します。SDK の依存関係は、常に最新バージョンを使用してください。

<dependencies>
    <dependency>
        <groupId>com.alipay.mychainx</groupId>
        <artifactId>mychainx-sdk</artifactId>
        <!-- 最新バージョンの SDK を使用してください。 -->
        <version>0.10.2.12</version>
    </dependency>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-log4j12</artifactId>
        <version>1.8.0-alpha0</version>
    </dependency>
</dependencies>

<build>
    <extensions>
        <extension>
            <groupId>kr.motd.maven</groupId>
            <artifactId>os-maven-plugin</artifactId>
            <version>1.6.1</version>
        </extension>
    </extensions>
</build>

Netty の読み込みエラーが発生した場合、netty-tcnative-openssl-static アーティファクトを除外します。

<dependencies>
    <dependency>
        <groupId>com.alipay.mychainx</groupId>
        <artifactId>mychainx-sdk</artifactId>
        <!-- 最新バージョンの SDK を使用してください。 -->
        <version>0.10.2.12</version>
        <exclusions>
            <exclusion>
                <groupId>io.netty</groupId>
                <artifactId>netty-tcnative-openssl-static</artifactId>
            </exclusion>
        </exclusions>
    </dependency>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-log4j12</artifactId>
        <version>1.8.0-alpha0</version>
    </dependency>
</dependencies>

<build>
    <extensions>
        <extension>
            <groupId>kr.motd.maven</groupId>
            <artifactId>os-maven-plugin</artifactId>
            <version>1.6.1</version>
        </extension>
    </extensions>
</build>

ログ出力の設定

log4j.properties ファイルを resources ディレクトリに追加します。

log4j.rootLogger=INFO, R

# ログ出力先はコンソールです。
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=[QC] %p [%t] %C.%M(%L) | %m%n

# ログ出力先はファイルです。
log4j.appender.R=org.apache.log4j.DailyRollingFileAppender
log4j.appender.R.File=./sdk.log
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%d-[TS] %p %t %c - %m%n

# mychain-sdk のログ出力制御設定
log4j.logger.MychainClient=OFF

log4j ではなく logback を使用する場合は、以下の設定を logback 構成に追加します。

<logger name="MychainClient" level="OFF"/>