Fabric-Java-SDK公式ドキュメント

4804 ワード

Fabric-Java-SDK公式ドキュメント

  • GitHubからJava-SDK
  • を取得
  • 構築1.3.0-SNAPSHOT
  • 最新のFabric
  • を導入
  • SDK依存
  • SDK
  • を使用
  • 構築ユニットテスト
  • エンドツーエンドの試験例:
  • SDKは、JavaアプリケーションがHyperledgerチャネルとユーザーチェーンコードのライフサイクルを管理し、channel上でchaincode、query blocks、transactionsを実行し、チャネル上のイベントを監視する方法を提供します.
    注意:SDKはクライアントのアプリケーションにチャネルとユーザーワークピースを定義する永続的な方法を提供しない.これは組み込みアプリケーションに管理され、クライアントのコンテキストでJavaシーケンス化によってチャネルをシーケンス化することができ、逆シーケンス化されたチャネルは初期化されていない.アプリケーションはバージョン間のシーケンス化ファイルの移行を処理する必要がある.

    GitHubからJava-SDKを取得

    git clone https://github.com/hyperledger/fabric-sdk-java.git
    cd fabric-sdk-java/
    git checkout -b release-1.2
    

    Javaアプリケーションで最新のv 1を使用する.3.xバージョン
    
    
        org.hyperledger.fabric-sdk-java
        fabric-sdk-java
        1.3.0-SNAPHOST
    
    

    制限
  • TCerts:JIRA FAB-1401
  • はサポートされていません.
  • HSM:JIRA FAB-3137
  • はサポートしていません

    1.3.0-SNAPSHOTの構築


    SNAPSHOTを利用して以下の内容をアプリケーションに追加できるpomを構築したい.xmlで
    
    
    snapshots-repo
    https://oss.sonatype.org/content/repositories/snapshots
    
    false
    
    
    true
    
    
    
    
    
    
    
    
    org.hyperledger.fabric-sdk-java
    fabric-sdk-java
    1.3.0-SNAPSHOT
    
    
    
    

    最新のFabricの導入


    Fabricネットワークの起動(SDKは永続性メソッドを提供しないため、この手順はテストフェーズのたびに実行する必要があります)
    Eclipseにインストールの準備:
  • JDK1.8以上
  • Apach Maven

  • JavaHOME/binとmavenを環境変数pathに追加する(具体的にはask baiduが可能)Eclipse 1をインストールする.
  • 最新のEclipseクライアント
  • をダウンロード
  • If you want to contribute to the project, you will need to make sure you are logged in to Gerrit and have setup your SSH keys. For more information on this, refer to: http://hyperledger-fabric.readthedocs.io/en/latest/Gerrit/lf-account.html
  • GerritからJavaSDKをダウンロード:https://gerrit.hyperledger.org/r/fabric-sdk-java
  • 必要なら、まずmavenをダウンロードして構成してください.https://maven.apache.org/download.cgi
  • 手順3の項目をインポートします.File>Import>Maven>Existing Maven Projectです.注意:エラーが発生した場合:Failed to read the project description file for‘fabric-sdk-java’.The file has been changed on dist, and it now contains invalid information. The project will not function properly until the description file is restored to a valid state. 削除プロジェクトと.classpathファイル、再インポート
  • 完了、ここでエラーが発生した場合:No marketplace entries found to handle maven-antrun-plugin:1.4:run in Eclipse.Please see Help for more information. 続行点が完了すれば、後で自動的に
  • を解決します.
  • ダウンロード依存、fabric-sdk-javaフォルダに入り、コマンドを実行:mvn install-DSkip Tests
  • 手順6の実行後、エラー:Plugin execution not covered by lifecycle configuration:org.apache.maven.plugins:maven-antrun-plugin:1.4:run.右クリックエラーで選択:Mark goal run as ignored in eclipse.
  • Checkstyle:Project"Properties"Checkstyleを起動し、「Checkstyle active for this project」「files outsides source directories」and「dericed files」
  • を選択します.
  • 「Local Check Configurations」を非表示にして「New」External Configuration Fileを選択し、「Browser」をキャンセルし、fabric-sdk-javaルートディレクトリから「checkstyle-config.xml」
  • を選択
  • 「Apple and Close」
  • を隠す
    以上の手順でインストールしました

    SDK依存


    SDKはサードパーティ製パッケージに依存しており、まず条件が必要です.
  • JDK1.8以上
  • Apache Maven 3.5.0

  • SDKの使用


    コンパイル上記の基本環境が完成すると、構築します.JArファイルの場合、コマンドで
    mvn install
     
    
    mvn install -Dskip Tests
    

    ビルドユニットテスト


    構築ユニットテストは、ユニットテストの位置でmvn installを用いて構築することができる.JArファイルintegrationテストを実行するには、Fabric-ca、Fabric peers、Fabric orderersを提供して完全なFabricネットワークテストを行い、mavenコマンドを使用して統合テストを行う必要があります.
    mvn clean install -DskiplTs=false -Dmaven.test.failure.ignore=false javadoc:javadoc
    

    エンドツーエンドのテスト例:


    src/test/java/org/hyperledger/fabric/sdkintegration/End2endIT.JAva:チェーンコードのインストール(installing)、初期化(instantiating)、呼び出し(invoking)、クエリー(querying)を含む完全な例である.Hyperledgerチャネルを構築し、Chaincodeコードを配置し、Chaincodeを呼び出してデータ転送操作を実行し、生成されたブロックチェーンの状態を照会する.
    src/test/java/org/hyperledger/fabric/sdkintegration/End2endAndBackAgainIT.JAva:End 2 endITで展示されています.JAvaに基づいてチャネルオブジェクトを再作成する、チェーンコードやチェーンコード操作などを更新する.
    End2endIT.JAvaとEnd 2 endAndBackAgainiT.JAvaにはほとんどのSDKができることが含まれており、SDKを学ぶ前にFabricについて理解しなければならない.そして、この2つの例を走って、理解すれば、それらを切り取ってあなたのアプリケーションに貼り付けることができます.エンドツーエンドのテスト環境
    テスト環境は、1つのFabric orderer、2つの組織(peerOrg 1、peerOrg 2)に定義され、各組織には2つのpeer、1つのfabric-caサービスが含まれます.