学习目标

1.学会开发苍穹微服务；

2.掌握不同苍穹微服务类型的调用方式。

内容简介

本文主要介绍微服务如何开发及调用。

微服务开发简介

苍穹采用微服务架构，微服务最小的粒度是应用，也就是说每个应用可以独立开发和部署运行。分应用部署情况下，对于平台应用而言平台的功能为通用型，jar包会在每一个节点上进行部署。而对于业务而言其功能jar包只会部署在自身所在的应用节点上。那不同业务应用出现跨应用调用的场景下，为了调用到正确的节点需要根据苍穹提供的实现方式进行微服务的开发。

微服务开发

二开微服务必须由服务工厂注册定义才能使用，因此必须要有服务工厂类，服务工厂路由规则为：{isv标识|公司标识}.{云id}.{应用id}.ServiceFactory
如：

新建服务工厂示例：isv.ti.bo.ServiceFactory

package xx.xx.xx.xx.xx; 
import kd.bos.dataentity.TypesContainer; 
 import java.util.HashMap; 
 import java.util.Map;  
 /** 
 * 二开微服务工厂类 
 * 
 */ 
public class ServiceFactory {
     private static Map<String, String> serviceMap = new HashMap<>(); 
     static {         serviceMap.put("TestService", "xx.xx.xx.xx.xx.TestServiceImpl");     }   
     public static Object getService(String serviceName) {     
     String className = serviceMap.get(serviceName);    
     return TypesContainer.getOrRegisterSingletonInstance(className); 
     }
}

新建微服务接口示例：isv.ti.bo.mservice.TestService

public interface TestService {  
   String sayHello(String msg);  
   Map<String, Object> getParams(Map<String, Object> params);
   }

新建微服务接口示例：isv.ti.bo.mserviceTestServiceImp

 public class TestServiceImpl implements TestService { 
   @Override   
   public String sayHello(String name, String msg) {    
   return this.getClass().getName() + name + " : say " + msg;     }  
   @Override
   public Map<String, Object> getParams(Map<String, Object> params) { 
   Map<String, Object> result = new HashMap<>(4);   
      // TODO STH         return result;     
      } 
      }

微服务调用

kd.bos.servicehelper.DispatchServiceHelper微服务调用帮助类为微服务调用上层封装，简化集群中不同微服务之间的调用操作。微服务调用帮助类中区分了以下类型的调用:

平台微服务调用：该类别的微服务调用会依据负载均衡算法调用到集群中任一节点

业务微服务调用：该类别的微服务调用会调用到指定的业务集群的节点上

二开微服务调用：该类别的微服务调用会调用到指定二开注册的微服务节点上

微服务调用帮助类API介绍

1、通过应用Id获取平台提供的微服务接口

static <T> T getBOSService(String appId, String serviceName, Class<T> bizCls)

传入参数：

参数名称	参数	参数类型	是否必传
应用Id	appId	String	是
注册的服务名称	serviceName	String	是
微服务接口类	bizCls	Class	是

返回数据：微服务代理实现，Class

2、平台微服务调用

static Object invokeBOSService(String appId, String serviceName, String methodName, Object... paras)

传入参数：

参数名称	参数	参数类型	是否必传
应用Id	appId	String	是
注册的服务名称	serviceName	String	是
调用服务方法	methodName	String	是
方法入参	paras	Object[]	是

返回数据：微服务调用返回结果，Object

3、业务微服务调用

static <T> T invokeBizService(String cloudId, String appId, String serviceName, String methodName, Object... paras)

传入参数：

参数名称	参数	参数类型	是否必传
云Id	cloudId	String	是
应用Id	appId	String	是
注册的服务名称	serviceName	String	是
调用服务方法	methodName	String	是
方法入参	paras	Object[]	是

返回数据：微服务调用返回结果，Object

4、二开微服务调用

static <T> T invokeService(String factoryQualifiedPrefix, String appId, String serviceName, String methodName, Object... paras)

传入参数：

参数名称	参数	参数类型	是否必传
Factory类限定前缀，如：服务工厂`isv.ti.bo.ServiceFactory` 的 `factoryQualifiedPrefix`为`isv.ti.bo`	factoryQualifiedPrefix	String	是
应用Id	appId	String	是
注册的服务名称	serviceName	String	是
调用服务方法	methodName	String	是
方法入参	paras	Object[]	是

返回数据：微服务调用返回结果，Object

微服务开发调用实例

https://vip.kingdee.com/article/82065157714706944

苍穹微服务开发及调用

恭喜您！