JMicro微服务Hello World

概述

JMicro是本人开发的基于Java实现的微服务框架,前两天发布0.0.3正式版本,并已发布到maven中央仓库。

项目源码github:
//github.com/mynewworldyyl/jmicro,
Maven地址:
//mvnrepository.com/search?q=cn.jmicro
Demo://jmicro.cn
账号:test00 密码:1

JMicro是基于Java技术实现的简单轻量(相对于Dubbo,Spring Cloud)微服务平台,让服务开发者及服务使用者完全面向接口或方法,无需关注底层实现,甚至感觉不到跨进程,跨服务调用的存在;可作为Serverless平台基础,跨系统,跨平台,跨语言无差别的一致性使用方式。多租户,账号权限控制,SSL连接(web端同样支持,非HTTPS);原生支持JVM级别的主备实现,多实例集群及纵向分布式解决方案,缓存,分布式锁,原生支持服务路由及负载均衡,可灵活配置的日志分析及呈现方案,精细化的RPC链路监控可以看到RPC相关的全部细节并可重现回放;支持分布式事务;内置高性能可靠消息服务;

安装依赖

JMicro依赖ZK及Redis,为了方便入门的同学,我提供这两包的下载链接如下:

Windows版本Redis:
//pan.baidu.com/s/13i7T1riw10zdqd5oYmJizQ 提取码:whrl

下载Redis后解压到任意目录,双击redis-server.exe文件即可启动单机版本Redis。

 

ZK:
//pan.baidu.com/s/1MLYPLfjUAnkmp1JEjddPJw 提取码:t58p

下载后解到压任意目录,找到bin/zkServer.cmd文件,双击即可运行单机版ZK.

下载并运行样例源码

声明在前:样例只是为了模拟RPC远程服务调用及实现方式,并不会真正做下单或支付操作。

从Github
//github.com/mynewworldyyl/jmicro_demos 下载样例源码到任意目录,如D:\jmicro_demos。cmd命令行窗口进入到D:\opensource\github\jmicro_demos\expjmicro.helloworld目录,运行如下命令

mvn clean install -Dmaven.test.skip=true

如无报错,则进入下一步,如有报错则根据错误提示修正后重新执行以上命令即可。

运行

在每个模块根目录下,有个start.bat的批处理文件,用文本编辑器打开任意一个,里面脚本如下:

title expjmicro.helloworld.order
java ^
-Xbootclasspath/a:%MAVEN_RESP_HOME%\org\javassist\javassist\3.24.0-GA\javassist-3.24.0-GA.jar ^
-javaagent:%MAVEN_RESP_HOME%\cn\jmicro\jmicro.agent\0.0.3-RELEASE\jmicro.agent-0.0.3-RELEASE.jar ^
-jar  %MAVEN_RESP_HOME%\cn\expjmicro\expjmicro.helloworld.order\0.0.3-RELEASE\expjmicro.helloworld.order-0.0.3-RELEASE-with-core.jar ^
-DsysLogLevel=2  -DclientId=25500 -DadminClientId=0  -Dlog4j.configuration=%JMICRO_DEMO_HOME%\log4j.xml -Dpwd=1

 

重点看MAVEN_RESP_HOME和JMICRO_DEMO_HOME这两个环境变量引用,

MAVEN_RESP_HOME表示我们本地maven仓库根目录;

JMICRO_DEMO_HOME表示刚刚下载源代码的根目录;

将这两个变量配置到本机的环境变量中,如我的配置如下图:

 

配置环境变量

配置好环境变量后,分别(无先后顺序)进入shop,order,payment目录运行start.bat文件,如都无报错误,则表示启动3个服务成功;

进入client模块,同样运行start.bat文件,client会每间隔3秒调用一次shop服务模拟一次商品购买操作,请自行查看命令行窗口输出日志。

如果你按以上操作不能让服务运行起来,请评论区骂我!

实现过程

 

服务调用关系图

图中每个矩形代表一个JVM服务。服务接口关系图如下

服务接口类图

ITxShopService:表示商店接口,只提供一个方法Resp<Boolean> buy(int goodId,int num),模拟客户购买商品,其实现代码如下,服务实现类实现接口ITxShopService,并用Component和Service注解,就这样实现了一个远程服务,同时通过Reference注解引用订单服务,是不是很简单!

@Component
@Service(version="0.0.1")
public class TxShopServiceImpl implements ITxShopService {

    private final static Logger logger = LoggerFactory.getLogger(TxShopServiceImpl.class);
    
    @Reference//引用订单服务
    private ITxOrderService orderSrv;
    
@Override
    public Resp<Boolean> buy(int goodId,int num) {
        Resp<Boolean> r = new Resp<>(Resp.CODE_FAIL,false);
        logger.info("开始购买商品:"+goodId+",数量:" + num);
        Good g = new Good();
        g.setId(goodId);
        r = orderSrv.takeOrder(g,num);//调用下单服务
        if(r.getData()) {
            logger.info("购买商品成功:"+goodId+",数量:" + num);
        }else {
            logger.info("购买商品失败:"+goodId+",数量:" + num+",Reason: "+r.getCode()+",msg:"+r.getMsg());
        }
        return r;
    }
}

Client使用商店服务代码如下,只需Reference注解ITxShopService上面的服务接口即可获取服务实例,是不是不敢相信!
@Component  //容器根据此注解实例化组件
public class ShopClient extends PostFactoryAdapter{

    private final static Logger logger = LoggerFactory.getLogger(ShopClient.class);
    
    //Reference注解获得Shop服务代理引用
    @Reference
    private ITxShopService shop;
    
    //容器启动成功后调用此方法
    @Override
    public void afterInit(IObjectFactory of) {
        //为了不Block主线程,我们在此启动一个线程每间隔3秒调用一次商店提供的购买方法
        new Thread(()->{
                for(;true;) {
                        try {
    
                        //调用商店服务
                        Resp<Boolean> rst = shop.buy(1, 1);
                        if(rst.getCode() != Resp.CODE_SUCCESS) {
                            //系统组错误
                            logger.info(rst.getMsg()+"," + rst.getCode());
                        }else if(rst.getData()) {
                            //业务购买失败
                            logger.info("Success buy good");
                        }else {
                            //成功
                            logger.info("Failure buy good");
                        }
                        try {
                            TimeUnit.SECONDS.sleep(3);
                        } catch (InterruptedException e) {
                            logger.error("",e);
                        }
                        }catch(Throwable e) {
                        logger.error(e.getMessage());
                    }
                }
        }).start();
    }
}

 

同理的,下单服务及支付服务实现代码请查看源码,在此不再贴出来了,太烦人了。

必须自夸一下

相比当年入门Dubbo的HelloWorld(Spring Clound更别提了,本人至今还没入门),入门JMicro真的太单了,简单到不相信中间真的做了远程调用。但中间确实启动了多个JVM,如果你还不相信,请将每个服务在不同的物理机上启动,Client也在不同的机器上启动,看效果是不是一样!

这种简单使我不知道再需要说点什么,Component,Service,Reference注解这需要说吗?需要说的请评论区回复,我单独写一篇详细的实现细节。

后面持续发表JMicro实现微服务相关的细节,如超时,重试,熔断,限流,降级,API网关,服务路由,高可用,分布式锁和分布式事务,日志收集,链路监控等,请加关注!