com.sap.cloud.sdk.services.scp.blockchain.hyperledgerfabric

Class FabricService

java.lang.Object

com.sap.cloud.sdk.services.scp.blockchain.hyperledgerfabric.FabricService

@Beta
public class FabricService
extends Object

SAP Cloud Platform Blockchain using Hyperledger Fabric adapter service. Facilitates access to chaincode interfaces.

Be aware that this class is in Beta (as indicated by the annotation) and therefore subject to breaking changes.

Method Summary

Modifier and Type	Method and Description
static FabricService	create() Create a service instance looking for an instance of service type 'hyperledger-fabric'.
String	getServiceUrl() Access to the Fabric service root URL.
String	invokeOrQuery(FabricInvocationType invocationType, String chainCodeId, String function, String... params) Access a function exposed by a chaincode.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

create

@Nonnull
public static FabricService create()
                                     throws CloudPlatformException

Create a service instance looking for an instance of service type 'hyperledger-fabric'.

Returns:

the new instance

Throws:

CloudPlatformException - if service information cannot be found or is incompletely specified

invokeOrQuery

@Nonnull
public String invokeOrQuery(@Nonnull
                                     FabricInvocationType invocationType,
                                     @Nonnull
                                     String chainCodeId,
                                     @Nonnull
                                     String function,
                                     @Nonnull
                                     String... params)
                              throws FabricServiceFailureException,
                                     IllegalArgumentException,
                                     com.google.gson.JsonIOException,
                                     CloudPlatformException

Access a function exposed by a chaincode.

Parameters:

invocationType - lightweight query or transaction via invoke.

chainCodeId - identifying the chain code.

function - the name of the function to be invoked.

params - parameters to the function call.

Returns:

the string response returned by the function, decoded as UTF-8 string.

Throws:

IllegalArgumentException - if the chaincodeId argument contains whitespace.

FabricServiceFailureException - if the service invocation fails.

com.google.gson.JsonIOException - if the encoding of the request fails.

CloudPlatformException - if there is a problem authorizing the access.

getServiceUrl

@Nonnull
public String getServiceUrl()

Access to the Fabric service root URL.

Returns:

the url

toString

@Nonnull
public String toString()

Overrides:

toString in class Object