Service invocation

The invocationDemo method in this class obtains the reference to custom-service by using getServiceGateway static method from ServiceGatewayFactory class. The getServiceGateway method takes three arguments to return the service instance. The arguments are as follows:

• String systemId

  This system identifier is same as the one used in service meta information file to declare the service whose instance needs to be obtained.

• String serviceName

  This is name of service whose instance needs to be obtained. It must be same as the one declared in service meta information file.

• Class<T> gatewayClass

  This must be the Class object of ServiceGateway interface (or its child interface). It must match the return value of getServiceInterface method in corresponding service implementation.

The invocationDemo method in the com.example.service.client.CustomServiceClient class uses CustomServiceGateway (gatewayClass) to obtain the service instance of custom-service (serviceName) for the system Foo (systemId). The following code snippet is for your reference:

public void invocationDemo() {
		String systemId = "Foo";
		
		CustomServiceGateway customService = 
ServiceGatewayFactory.getServiceGateway(
				systemId, 
				"custom-service",
				CustomServiceGateway.class
			);
		
		ServiceInput input = new ServiceInput();
		ServiceOutput output = customService.execute(input);
	}

The return type of getServiceGateway is also CustomServiceGateway. Service instance obtained can be used to execute the respective service by supplying the required input object.