Hyperledger Fabric Java SDK链码调用操作步骤咨询

Got it, since you've already spun up your Hyperledger Fabric network via the command line, let's walk through the exact steps to invoke chaincode using the Java SDK. I'll break this down into practical, easy-to-follow stages:

Before diving into code, double-check these are in place:

• Fabric Java SDK Dependency: Add this to your Maven pom.xml (or equivalent for Gradle) to pull in the necessary libraries:

  <dependency>
      <groupId>org.hyperledger.fabric</groupId>
      <artifactId>fabric-gateway-java</artifactId>
      <version>2.2.20</version> <!-- Use the version compatible with your Fabric network -->
  </dependency>
  

• Network Configuration Files: Grab the crypto materials (user certs/keys, MSP configs) from your crypto-config folder, plus a connection.json file that defines your peer/orderer endpoints (you can generate this from your network config or craft it manually).
• Chaincode Status: Confirm your chaincode is installed on peers and instantiated/committed to your target channel (since you built the network via CLI, this should already be done—but a quick sanity check never hurts!).

Step 1: Set Up the Fabric Gateway #

The Gateway API is the recommended way to interact with Fabric networks now—it simplifies connection management.

1. Create a Wallet and Import User Identity:

   import org.hyperledger.fabric.gateway.*;
   import java.nio.file.Path;
   import java.nio.file.Paths;
   
   // Path to your crypto materials
   Path userCertPath = Paths.get("crypto-config/peerOrganizations/org1.example.com/users/User1@org1.example.com/msp/signcerts/User1@org1.example.com-cert.pem");
   Path userKeyPath = Paths.get("crypto-config/peerOrganizations/org1.example.com/users/User1@org1.example.com/msp/keystore/priv_sk");
   
   // Create a wallet and import the user identity
   Wallet wallet = Wallets.newFileSystemWallet(Paths.get("wallet"));
   X509Certificate userCert = Identities.readX509Certificate(userCertPath);
   PrivateKey userKey = Identities.readPrivateKey(userKeyPath);
   Identity userIdentity = Identities.newX509Identity("Org1MSP", userCert, userKey);
   wallet.put("user1", userIdentity);
   

2. Connect to the Gateway:

   // Load connection profile
   Path connectionProfile = Paths.get("connection.json");
   Gateway.Builder builder = Gateway.createBuilder()
           .identity(wallet, "user1")
           .networkConfig(connectionProfile)
           .discovery(true); // Enable service discovery if your network uses it
   
   // Connect to the gateway (use try-with-resources to auto-close connections)
   try (Gateway gateway = builder.connect()) {
       // Rest of your code goes inside this block
   }
   

Step 2: Get Channel and Contract References #

Once connected, fetch the channel and chaincode contract you want to interact with:

// Get the channel instance (replace "mychannel" with your channel name)
Network network = gateway.getNetwork("mychannel");

// Get the contract instance (replace "mychaincode" with your chaincode ID)
Contract contract = network.getContract("mychaincode");

Step 3: Submit a Transaction (Invoke Chaincode) #

Use submitTransaction for write operations that modify the ledger—this sends the transaction to the orderer and waits for commit confirmation:

try {
    // Replace "transfer" with your chaincode function name, followed by arguments
    byte[] result = contract.submitTransaction("transfer", "Alice", "Bob", "100");
    System.out.println("Transaction submitted successfully: " + new String(result));
} catch (ContractException e) {
    System.err.println("Transaction failed: " + e.getMessage());
    // Handle error (e.g., retry, log details)
}

Step 4: Evaluate a Transaction (Query Chaincode) #

For read-only operations that don't modify the ledger, use evaluateTransaction—this queries a peer directly without going through the orderer:

try {
    // Replace "getBalance" with your query function, followed by arguments
    byte[] result = contract.evaluateTransaction("getBalance", "Alice");
    System.out.println("Alice's balance: " + new String(result));
} catch (ContractException e) {
    System.err.println("Query failed: " + e.getMessage());
}

Step 5: Clean Up Resources #

The try-with-resources block for the Gateway will automatically close connections when done, but make sure you don't leave any lingering resources open if you're managing connections manually.

• Network Access: Ensure your Java app can reach the peer/orderer endpoints (check firewall rules, port forwarding if running in containers).
• MSP Matching: The user's MSP ID (e.g., "Org1MSP") must exactly match the MSP configured in your Fabric network.
• Permissions: Make sure the user identity has the necessary ACLs to execute the chaincode function (check your channel's configtx.yaml if you run into permission errors).

内容的提问来源于stack exchange，提问作者Sudharasan D