All Products
Search

This Product

    Blockchain as a Service:Environment Interface

    Document Center

    Blockchain as a Service:Environment Interface

    Last Updated:May 21, 2019

    Initialize environment

    init

    Initialize the environment configuration.

    • Function
    1. public MychainBaseResult<Response> init(MychainEnv env)
    • Request parameters
    Parameter Required Type Description
    env true MychainEnv Contract platform environment
    • Examples
    1. MychainEnv env = buildMychainEnv();
    2. Mychain  sdk = new Mychain();
    3. sdk.init(env);
    5. private static MychainEnv initMychainEnv() {
    6.     return initMychainEnv("test_sdk");
    7. }
    9. private static MychainEnv buildMychainEnv(String identity) {
    10.     InetSocketAddress inetSocketAddress = InetSocketAddress.createUnresolved(host, port);
    11.     String keyFilePath = "client.key";
    12.     String certFilePath = "client.crt";
    13.     String trustStoreFilePath = "trustCa";
    15.     // any user key for sign message
    16.     String userPrivateKeyFile = "user.key";
    17.     PrivateKey userPrivateKey = KeyLoder.getPrivateKeyFromPKCS8(DemoSample.class.getClassLoader().getResourceAsStream(userPrivateKeyFile),keyPassword);
    19.     // build ssl option
    20.     ISslOption sslOption = new SslBytesOption.Builder()
    21.         .keyBytes(Utils.readFileToByteArray(DemoSample.class.getClassLoader().getResource(keyFilePath).getPath()))
    22.         .certBytes(Utils.readFileToByteArray(DemoSample.class.getClassLoader().getResource(certFilePath).getPath()))
    23.         .keyPassword(keyPassword)
    24.         .setUserPrivateKey(userPrivateKey)
    25.         .trustStorePassword(trustStorePassword)
    26.         .trustStoreBytes(
    27.             Utils.readFileToByteArray(DemoSample.class.getClassLoader().getResource(trustStoreFilePath).getPath()))
    28.         .build();
    30.     // multi nodes configuration
    31.     List<SocketAddress> backupNodes = new ArrayList<SocketAddress>();
    32.     backupNodes.add(InetSocketAddress.createUnresolved("101.132.187.0", 58321));
    33.     backupNodes.add(InetSocketAddress.createUnresolved("101.132.46.192", 58322));
    34.     backupNodes.add(InetSocketAddress.createUnresolved("106.14.166.129", 58323));
    36.     return MychainEnv.build(identity, ClientTypeEnum.TLS, HashTypeEnum.SHA256,
    37.         SignTypeEnum.ECDSA, CodecTypeEnum.RLP, inetSocketAddress, sslOption, backupNodes);
    38. }

    Multi-node configuration

    The SDK supports multi-node configuration. When the primary node is unavailable, the SDK automatically switches to another available node for re-connection to ensure service stability.

    • Examples
    1. MychainEnv env = buildMychainEnv();
    2. Mychain  sdk = new Mychain();
    3. sdk.init(env);
    5. private static MychainEnv initMychainEnv() {
    6.     return initMychainEnv("test_sdk");
    7. }
    9. private static MychainEnv buildMychainEnv(String identity) {
    10.     InetSocketAddress inetSocketAddress = InetSocketAddress.createUnresolved(host, port);
    11.     String keyFilePath = "client.key";
    12.     String certFilePath = "client.crt";
    13.     String trustStoreFilePath = "trustCa";
    15.     // build ssl option
    16.     ISslOption sslOption = new SslBytesOption.Builder()
    17.         .keyBytes(Utils.readFileToByteArray(DemoSample.class.getClassLoader().getResource(keyFilePath).getPath()))
    18.         .certBytes(Utils.readFileToByteArray(DemoSample.class.getClassLoader().getResource(certFilePath).getPath()))
    19.         .keyPassword(keyPassword)
    20.         .trustStorePassword(truseStorePassword)
    21.         .trustStoreBytes(
    22.             Utils.readFileToByteArray(DemoSample.class.getClassLoader().getResource(trustStoreFilePath).getPath()))
    23.         .build();
    25.     // multi nodes configuration
    26.     List<SocketAddress> backupNodes = new ArrayList<SocketAddress>();
    27.     backupNodes.add(InetSocketAddress.createUnresolved("101.132.187.0", 58321));
    28.     backupNodes.add(InetSocketAddress.createUnresolved("101.132.46.192", 58322));
    29.     backupNodes.add(InetSocketAddress.createUnresolved("106.14.166.129", 58323));
    31.     return MychainEnv.build(identity, ClientTypeEnum.TLS, HashTypeEnum.SHA256,
    32.         SignTypeEnum.ECDSA, CodecTypeEnum.RLP, inetSocketAddress, sslOption, backupNodes);
    33. }