[FAB-13798] New interfaces

Change-Id: Iae4feff52035131d3ee9c31051c305de6b453fa9
Signed-off-by: gennady <[email protected]>

Author: gennadylaventman

fabric-chaincode-shim/build.gradle

@@ -63,7 +63,9 @@ jacocoTestCoverageVerification {
             element = 'CLASS'
             excludes = ['org.hyperledger.fabric.shim.helper.Channel',
                         'org.hyperledger.fabric.shim.impl.Handler',
-                        'org.hyperledger.fabric.shim.impl.ChaincodeSupportStream.1']
+                        'org.hyperledger.fabric.shim.impl.ChaincodeSupportStream.1',
+                        'org.hyperledger.fabric.contract.ContractRouter',
+                        'org.hyperledger.fabric.contract.routing.TransactionType']
             limit {
                 minimum = 0.86
             }

fabric-chaincode-shim/src/main/java/org/hyperledger/fabric/contract/ContractRouter.java

@@ -0,0 +1,49 @@
+/*
+Copyright IBM Corp., DTCC All Rights Reserved.
+
+SPDX-License-Identifier: Apache-2.0
+*/
+
+package org.hyperledger.fabric.contract;
+
+import org.hyperledger.fabric.contract.execution.ExecutionService;
+import org.hyperledger.fabric.contract.routing.ContractScanner;
+import org.hyperledger.fabric.shim.ChaincodeBase;
+import org.hyperledger.fabric.shim.ChaincodeStub;
+
+/**
+ * Router class routes Init/Invoke requests to contracts.
+ * Implements {@link org.hyperledger.fabric.shim.Chaincode} interface.
+ */
+public class ContractRouter extends ChaincodeBase {
+
+    private ContractScanner scanner;
+    private ExecutionService executor;
+
+    public ContractRouter() {
+    }
+
+    public void findAllContracts() {
+
+    }
+
+    public void startRouting(String[] args) {
+        start(args);
+    }
+
+    @Override
+    public Response init(ChaincodeStub stub) {
+        return newErrorResponse();
+    }
+
+    @Override
+    public Response invoke(ChaincodeStub stub) {
+        return newErrorResponse();
+    }
+
+    public static void main(String[] args) {
+        ContractRouter cfc = new ContractRouter();
+        cfc.findAllContracts();
+        cfc.startRouting(args);
+    }
+}

fabric-chaincode-shim/src/main/java/org/hyperledger/fabric/contract/execution/ExecutionService.java

@@ -0,0 +1,18 @@
+/*
+Copyright IBM Corp., DTCC All Rights Reserved.
+
+SPDX-License-Identifier: Apache-2.0
+*/
+
+package org.hyperledger.fabric.contract.execution;
+
+import org.hyperledger.fabric.contract.routing.Routing;
+import org.hyperledger.fabric.shim.Chaincode;
+
+/**
+ * Service that executes {@link InvocationRequest} (wrapped INit/Invoke + extra data) using routing information {@link Routing}
+ */
+public interface ExecutionService {
+
+    Chaincode.Response executeRequest(Routing rd, InvocationRequest req);
+}

fabric-chaincode-shim/src/main/java/org/hyperledger/fabric/contract/execution/InvocationRequest.java

@@ -0,0 +1,21 @@
+/*
+Copyright IBM Corp., DTCC All Rights Reserved.
+
+SPDX-License-Identifier: Apache-2.0
+*/
+
+package org.hyperledger.fabric.contract.execution;
+
+import java.util.List;
+
+/**
+ * All information needed to find {@link org.hyperledger.fabric.contract.annotation.Contract} and invoke the request
+ */
+public interface InvocationRequest {
+    String DEFAULT_NAMESPACE = "default";
+
+    String getNamespace();
+    String getMethod();
+    List<byte[]> getArgs();
+    String getRequestName();
+}

fabric-chaincode-shim/src/main/java/org/hyperledger/fabric/contract/routing/ContractScanner.java

@@ -0,0 +1,36 @@
+/*
+Copyright IBM Corp., DTCC All Rights Reserved.
+
+SPDX-License-Identifier: Apache-2.0
+*/
+
+package org.hyperledger.fabric.contract.routing;
+
+import org.hyperledger.fabric.contract.execution.InvocationRequest;
+
+/**
+ * Scan and keep all chaincode requests -> contract routing information
+ */
+public interface ContractScanner {
+
+    /**
+     * Scan classpath for all contracts and build routing information for all contracts
+     * @throws IllegalAccessException
+     * @throws InstantiationException
+     */
+    void findAndSetContracts() throws IllegalAccessException, InstantiationException;
+
+    /**
+     * Get routing information {@link Routing} based on info from {@link InvocationRequest}
+     * @param req
+     * @return
+     */
+    Routing getRouting(InvocationRequest req);
+
+    /**
+     * In case no specific {@link Routing}, get default {@link Routing}
+     * @param req
+     * @return
+     */
+    Routing getDefaultRouting(InvocationRequest req);
+}

fabric-chaincode-shim/src/main/java/org/hyperledger/fabric/contract/routing/Routing.java

@@ -0,0 +1,26 @@
+/*
+Copyright IBM Corp., DTCC All Rights Reserved.
+
+SPDX-License-Identifier: Apache-2.0
+*/
+
+package org.hyperledger.fabric.contract.routing;
+
+import org.hyperledger.fabric.contract.ContractInterface;
+
+import java.lang.reflect.Method;
+
+/**
+ * Routing information for each contract method
+ */
+public interface Routing {
+
+    ContractInterface getContractObject();
+
+    Method getMethod();
+
+    Class getContractClass();
+
+    TransactionType getType();
+
+}

fabric-chaincode-shim/src/main/java/org/hyperledger/fabric/contract/routing/TransactionType.java

@@ -0,0 +1,13 @@
+/*
+Copyright IBM Corp., DTCC All Rights Reserved.
+
+SPDX-License-Identifier: Apache-2.0
+*/
+package org.hyperledger.fabric.contract.routing;
+
+public enum TransactionType {
+    INIT,
+    INVOKE,
+    QUERY,
+    DEFAULT
+}