(Fabric 学习四)Fabric Java SDK 连接fabcar网络

参考文章：

修改windows的hosts文件添加SDK的地址映射_水草杰的博客-CSDN博客

​​​​​​SDK-Java跑通fabric2.2自带的fabcar，简单实现_水草杰的博客-CSDN博客
(八)Fabric2.0Java SDK实践-合约交易_Mark_MMXIX的博客-CSDN博客

 

一、打开fabcar网络

在/你自己的路径/github.com/hyperledger/fabric/scripts/fabric-samples/fabcar中启动网络

./networkDown.sh

启动成功后查看启动情况：

docker ps -a

如果容器成功打开，则可以进行下一步操作！

二、创建一个springboot项目

创建一个springboot项目 其中选项建议：

2.0 项目结构目录

这是我们最终要生成的项目结构目录，接下来我们将一个一个创建器中的文件 

2.1 导入fabric有关的maven依赖包

<dependency>
    <groupId>org.hyperledger.fabric-sdk-java</groupId>
    <artifactId>fabric-sdk-java</artifactId>
    <version>1.4.7</version>
</dependency>

<dependency>
    <groupId>org.hyperledger.fabric</groupId>
    <artifactId>fabric-gateway-java</artifactId>
    <version>2.2.0</version>
</dependency>

2.2 resources包下的配置

2.2.1 crypto-config

创建一个crypto-config文件夹，其中存放的是整个网络的证书文件。

而证书文件的获取，是在fabcar网络打开后，返回到test-network文件夹中的organization文件夹中，找到其中的orderOrganization和peerOrganization

找到后将他们复制到我们创建的crypto-config文件夹中，

2.2.2 connection.json 网络连接文件

 这个文件用于和fabric网络进行连接

{
  "name": "basic-network",
  "version": "1.0.0",
  "dependencies": {
  },
  "client": {
    "organization": "Org1",
    "connection": {
      "timeout": {
        "peer": {
          "endorser": "300"
        },
        "orderer": "300"
      }
    }
  },
  "channels": {
    "mychannel": {
      "orderers": [
        "orderer.example.com"
      ],
      "peers": {
        "peer0.org1.example.com": {
          "endorsingPeer": true,
          "chaincodeQuery": true,
          "ledgerQuery": true,
          "eventSource": true
        },
        "peer0.org2.example.com": {
          "endorsingPeer": true,
          "chaincodeQuery": true,
          "ledgerQuery": true,
          "eventSource": true
        }
      }
    }
  },
  "organizations": {
    "Org1": {
      "mspid": "Org1MSP",
      "peers": [
        "peer0.org1.example.com"
      ],
      "certificateAuthorities": [
        "ca-org1"
      ],
      "adminPrivateKeyPEM": {
        "path": "src/main/resources/crypto-config/peerOrganizations/org1.example.com/users/[email protected]/msp/keystore/a2fde5eedd98656e6389b5db4a6d311fa89c9f5de3c1dd75c91a08dfa2d1acd4_sk"
      },
      "signedCertPEM": {
        "path": "src/main/resources/crypto-config/peerOrganizations/org1.example.com/users/[email protected]/msp/signcerts/cert.pem"
      }
    },
    "Org2": {
      "mspid": "Org2MSP",
      "peers": [
        "peer0.org2.example.com"
      ],
      "certificateAuthorities": [
        "ca-org2"
      ],
      "adminPrivateKeyPEM": {
        "path": "src/main/resources/crypto-config/peerOrganizations/org2.example.com/users/[email protected]/msp/keystore/619c1ee996151bb4a6dcf828c1b522bc59c512ee6524b22b70d72046f53e017c_sk"
      },
      "signedCertPEM": {
        "path": "src/main/resources/crypto-config/peerOrganizations/org2.example.com/users/[email protected]/msp/signcerts/cert.pem"
      }
    }
  },
  "orderers": {
    "orderer.example.com": {
      "url": "grpcs://192.168.235.147:7050",
      "mspid": "OrdererMSP",
      "grpcOptions": {
        "ssl-target-name-override": "orderer.example.com",
        "hostnameOverride": "orderer.example.com"
      },
      "tlsCACerts": {
        "path": "src/main/resources/crypto-config/ordererOrganizations/example.com/orderers/orderer.example.com/tls/ca.crt"
      },
      "adminPrivateKeyPEM": {
        "path": "src/main/resources/crypto-config/ordererOrganizations/example.com/users/[email protected]/msp/keystore/4f1821d3b3cf81f20aa151eeb98aca45689a3453017092d04900b910ff2d9ca8_sk"
      },
      "signedCertPEM": {
        "path": "src/main/resources/crypto-config/ordererOrganizations/example.com/users/[email protected]/msp/signcerts/cert.pem"
      }
    }
  },
  "peers": {
    "peer0.org1.example.com": {
      "url": "grpcs://192.168.235.147:7051",
      "grpcOptions": {
        "ssl-target-name-override": "peer0.org1.example.com",
        "hostnameOverride": "peer0.org1.example.com",
        "request-timeout": 120001
      },
      "tlsCACerts": {
        "path": "src/main/resources/crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt"
      }
    },
    "peer0.org2.example.com": {
      "url": "grpcs://192.168.235.147:9051",
      "grpcOptions": {
        "ssl-target-name-override": "peer0.org2.example.com",
        "hostnameOverride": "peer0.org2.example.com",
        "request-timeout": 120001
      },
      "tlsCACerts": {
        "path": "src/main/resources/crypto-config/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt"
      }
    }
  },
  "certificateAuthorities": {
    "ca-org1": {
      "url": "https://192.168.235.147:7054",
      "grpcOptions": {
        "verify": true
      },
      "tlsCACerts": {
        "path": "src/main/resources/crypto-config/peerOrganizations/org1.example.com/ca/ca.org1.example.com-cert.pem"
      },
      "registrar": [
        {
          "enrollId": "admin",
          "enrollSecret": "adminpw"
        }
      ]
    },
    "ca-org2": {
      "url": "https://192.168.235.147:8054",
      "grpcOptions": {
        "verify": true
      },
      "tlsCACerts": {
        "path": "src/main/resources/crypto-config/peerOrganizations/org2.example.com/ca/ca.org2.example.com-cert.pem"
      },
      "registrar": [
        {
          "enrollId": "admin",
          "enrollSecret": "adminpw"
        }
      ]
    }
  }
}

其中所有的私钥、证书和ip等都要换成自己的。

换成之后我们需要在windows下本地设置hosts映射文件

映射文件具体位置：c:\Windows\System32\drivers\etc

记事本打开hosts文件，然后添加

192.168.235.147 peer0.org1.example.com
192.168.235.147 peer0.org2.example.com
192.168.235.147 orderer.example.com

这里的ip地址用自己的ip地址，不要用我的！！！

2.2.3 fabric.config.properties文件

# 网络配置文件路径
networkConfigPath = src/main/resources/connection.json
# 用户1，机构2证书路径
certificatePath = src/main/resources/crypto-config/peerOrganizations/org2.example.com/msp/signcerts/cert.pem
# 用户1，机构2证书私钥路径
privateKeyPath = src/main/resources/crypto-config/peerOrganizations/org2.example.com/msp/keystore/b30daf192d9ca39fd68817a73f02fde2bb62a637c68b133ede02a74bb43fb191_sk
# 通道名字
channelName = mychannel

# 链码名字
contractName = fabcar

 这里存放着用户的文件，我使用org2证书进行连接

2.3 java包中的文件

2.3.1 HyperLedgerFabricGatewayJavaConfig 文件

package com.xzd.javasdkfirstdemo;

import lombok.AllArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.hyperledger.fabric.gateway.*;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.io.IOException;
import java.io.InputStream;
import java.io.Reader;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.security.InvalidKeyException;
import java.security.PrivateKey;
import java.security.cert.CertificateException;
import java.security.cert.X509Certificate;
import java.util.Properties;

@Configuration
@AllArgsConstructor
@Slf4j
public class HyperLedgerFabricGatewayJavaConfig {


    @Bean
    public Gateway gateway() throws Exception {
        // 主要读取java的配置文件
        Properties properties = new Properties();
        InputStream inputStream = Gateway.class.getResourceAsStream("/fabric.config.properties");
        properties.load(inputStream);

        String networkConfigPath = properties.getProperty("networkConfigPath");
        String certificatePath = properties.getProperty("certificatePath");
        X509Certificate certificate = readX509Certificate(Paths.get(certificatePath));
        String privateKeyPath = properties.getProperty("privateKeyPath");
        PrivateKey privateKey = getPrivateKey(Paths.get(privateKeyPath));
        Wallet wallet = Wallets.newInMemoryWallet();
        wallet.put("user1", Identities.newX509Identity("Org2MSP",certificate,privateKey));

        Gateway.Builder builder = Gateway.createBuilder()
                .identity(wallet , "user1")
                .networkConfig(Paths.get(networkConfigPath));

        Gateway gateway = builder.connect();

        log.info("=========================================== connected fabric gateway {} " , gateway);

        return gateway;
    }



    /*获取合约的办法*/
    @Bean
    public Contract fabcar(Gateway gateway) {
        // 获取mychannel的网络 也就是通道
        Network network = gateway.getNetwork("mychannel");
        // 获取contract的链码 名字为fabcar
        Contract contract = network.getContract("fabcar");
        return contract;
    }
    /*获取证书的办法*/
    private static X509Certificate readX509Certificate(final Path certificatePath) throws IOException, CertificateException {
        // 通过路径获取到文件 如果成功获取 返回身份识别证书的结果
        try (Reader certificateReader = Files.newBufferedReader(certificatePath, StandardCharsets.UTF_8)) {
            return Identities.readX509Certificate(certificateReader);
        }
    }
    /*获取私钥的办法 */
    private static PrivateKey getPrivateKey(final Path privateKeyPath) throws IOException, InvalidKeyException {
        // 通过路径获取到文件 如果成功获取 返回身份识别私钥的结果
        try (Reader privateKeyReader = Files.newBufferedReader(privateKeyPath, StandardCharsets.UTF_8)) {
            return Identities.readPrivateKey(privateKeyReader);
        }
    }
}

2.3.2 JavasdkfirstdemoApplication 启动类

package com.xzd.javasdkfirstdemo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.context.properties.EnableConfigurationProperties;

@SpringBootApplication
@EnableConfigurationProperties
public class JavasdkfirstdemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(JavasdkfirstdemoApplication.class, args);
    }

}

2.3.3 操作链码的控制层 FabcarController 文件

package com.xzd.javasdkfirstdemo;

import com.google.common.collect.Maps;
import lombok.AllArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.codec.binary.StringUtils;
import org.hyperledger.fabric.gateway.*;
import org.hyperledger.fabric.sdk.Peer;
import org.springframework.web.bind.annotation.*;

import java.util.EnumSet;
import java.util.Map;
import java.util.concurrent.ConcurrentMap;
import java.util.concurrent.TimeoutException;

@RestController
@RequestMapping("/car")
@Slf4j
@AllArgsConstructor
public class FabcarController {
    final Gateway gateway;

    final Contract contract;
    /*根据key查询对应的car*/
    @GetMapping("/{key}")
    public Map<String, Object> queryCarByKey(@PathVariable String key) throws GatewayException {

        Map<String, Object> result = Maps.newConcurrentMap();
        byte[] queryAssets = contract.evaluateTransaction("QueryCar",key);

        result.put("payload", StringUtils.newStringUtf8(queryAssets));
        result.put("status", "ok");

        return result;


    }

    /*查询所有的car*/
    @GetMapping("/all")
    public Map<String, Object> queryAllCar() throws GatewayException{

        Map<String, Object> result = Maps.newConcurrentMap();
        byte[] queryAllAssets = contract.evaluateTransaction("QueryAllCars");

        result.put("payload", StringUtils.newStringUtf8(queryAllAssets));
        result.put("status", "ok");

        return result;
    }
    
    /*新增一个car的资产*/
    @PostMapping("/add")
    @ResponseBody
    public Map<String,Object> createCar(@RequestParam("carnumber")String carnumber,@RequestParam("make")String make,
                                        @RequestParam("model")String model,@RequestParam("colour")String colour,
                                        @RequestParam("owner")String owner) throws GatewayException, TimeoutException, InterruptedException {
        Network network = gateway.getNetwork("mychannel");
        Map<String, Object> result = Maps.newConcurrentMap();
        byte[] transaction = contract.createTransaction("CreateCar")
                .setEndorsingPeers(network.getChannel().getPeers(EnumSet.of(Peer.PeerRole.ENDORSING_PEER)))
                .submit(carnumber,make,model,colour,owner);
        result.put("payload", StringUtils.newStringUtf8(contract.evaluateTransaction("QueryCar",carnumber)));
        result.put("status", "ok");
        return result;
    }

    /*将一个car资产转移到另一个owner上*/
    @PutMapping("/update")
    @ResponseBody
    public Map<String,Object> updateCarOwner(@RequestParam("carnumber")String carnumber,@RequestParam("newowner")String newowner) throws GatewayException,InterruptedException, TimeoutException, ContractException {
        Map<String, Object> result = Maps.newConcurrentMap();
        byte[] transaction = contract.submitTransaction("ChangeCarOwner", carnumber, newowner);
        result.put("payload", StringUtils.newStringUtf8(contract.evaluateTransaction("QueryCar",carnumber)));
        result.put("status", "ok");
        return result;
    }


}

全部写好之后，启动boot项目！

写好控制类后，我们用接口测试工具postman来测试一下！

2.4 测试接口

2.4.1 获取所有的car

 2.4.2 根据key查询car

2.4.3 创建一个car资产

 

2.4.4 将car转移给新的owner

测试成功！ 简单的java sdk demo完成！

=======================2023.02.24新增================================

问题1：Error creating bean with name 'gateway' defined in class path resource...

答：一旦出现这个问题，就说明gateway连接区块链失败了，这个时候一定要检查一下你本地目录中规定证书的指定配置文件（比如我文中的fabric.config.properties文件），很有可能连接的路径写错了导致gateway出错。

问题2：可以对每一个组织的成员的配置文件进行拆分。

比如我将org1和org2进行了拆分。

当我们启动项目时，可以设置指定配置文件

 

-Dspring.config.location=classpath:/application-test-network-org1.properties

 保证你当前使用的是哪个组织的配置文件。