Yonyou U8Cloud 3.6 二次开发环境搭建及自定义API开发测试

        最新发布的U8Cloud3.6发布后，忍不住拿来尝尝鲜。一路安装配置后，登入系统发现界面风格看着有点像NC65了，菜单布局有原来的Outlook侧边栏，调整为瀑布式菜单，也许是考虑今后功能扩展等，菜单项会增加吧，另外就是新增了一些接口参数，从这里也看出U8Cloud的开放性较57有了很大的改善。详细变化可参考相关的发版文档，这里仅记录一下二次开发环境的搭建以及自定义API接口的开发测试过程。

主界面：

菜单项：

 

  1、eclipse版本和插件

        由于U8C主要程序框架仍是NC57，因此原NC57的开发插件仍可以使用，只是由于U8C使用的是JDK8版本，所以在eclipse3.7版本下不兼容，因此eclipse需要3.8版本以上，本人使用的3.8.2版本，因为版本过高可能导致插件不兼容，即便这样，原插件中的MDP插件（元数据设计插件）在3.8.2也出现了不兼容的情况。不过，NC57的元数据还比较初级，二次开发不使元数据方式有没太大影响。

2、服务启动调整

        中间件的启动参数，需要自己手工调整一下，如果按插件生成的配置，启动中间件会报错并自动终止。具体配置如下：

 

mainClass：nc.bs.mw.start.AloneBootstrap

program args：start

vm args ：-server -Xmx2048m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=1024m -Dsun.reflect.noInflation=true -Dsun.reflect.inflationThreshold=0 -Duser.timezone=GMT+8 -Dnc.server.name=server -Dnc.server.startCount=0 -DNC_JAVA_HOME=${FIELD_NC_HOME}\ufjdk -Dnc.runMode=develop -Dnc.bs.logging.format=text -Dnc.server.location=${FIELD_NC_HOME} -Drun.side=server -Dnc.run.side=server -Disdevelop=true -cp ${FIELD_NC_HOME}\starter.jar;${FIELD_NC_HOME}\ufjdk\lib\tools.jar;${FIELD_NC_HOME}\ant\lib\ant-launcher.jar;${FIELD_NC_HOME}\lib\cnytiruces.jar

正常启动后，控制台显示如下就说明正常了。

 

3、自定义API开发

        在工程的public源码目录中新增自定义API接口u8c.pubitf.action.IAPICustmerDevelop的实现类       

package u8c.impl.userdef.demo.action;

import javax.servlet.http.HttpServletRequest;

import nc.vo.pub.BusinessException;
import u8c.bs.exception.ConfigException;
import u8c.pubitf.action.IAPICustmerDevelop;

public class HelloWorldAction implements IAPICustmerDevelop {

	@Override
	public String doAction(HttpServletRequest requ) throws BusinessException,
			ConfigException {
		// TODO Auto-generated method stub
		return "Hello U8Cloud 3.6!";
	}

}

         导出补丁并到中间件服务器，重启中间件后，通过postman测试（可参考U8Cloud 3.5 试用笔记_hot.wind的博客-CSDN博客中API调用相关内容），api的url为：http://[ip]:[port]/u8cloud/api/dev/define，自定义API需要增加一个请求参数custdevpclass，对应自定义的api接口实现类全路径，示例中为u8c.impl.userdef.demo.action.HelloWorldAction