阿里HSF框架整合springboot全注解demo开发记录
网上教程挺多的,详细过程就不说了,记录下关键节点。
整个框架demo分三层,服务层:hsf-server,接口层:hsf-api,消费层:hsf-web。
前期准备:
1、taobao-tomcat-7.0.59
2、taobao-hsf.sar:将其放入taobao-tomcat-7.0.59的deploy中
3、edas-lite-configcenter:启动
4、修改host:localhost jmenv.tbsite.net
5、设置taobao-tomcat的VM Options:-Dpandora.location=D:\WorkSpace\tomct\taobao-tomcat-7.0.59\deploy\taobao-hsf.sar
一、接口层
定义接口。
二、服务层
1、加入接口层的依赖:
<dependency>
<groupId>com.example</groupId>
<artifactId>hsf-api</artifactId>
<version>0.0.1-SNAPSHOT</version>
</dependency>
完整pom如下:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<!--<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<!–<version>2.2.2.RELEASE</version>–>
<!–<version>2.1.6.RELEASE</version>–>
<version>1.5.8.RELEASE</version>
<relativePath/> <!– lookup parent from repository –>
</parent>-->
<parent>
<groupId>com.example</groupId>
<artifactId>hsf-demo</artifactId>
<version>0.0.1-SNAPSHOT</version>
</parent>
<groupId>com.example</groupId>
<artifactId>hsf-server</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>war</packaging>
<name>hsf-server</name>
<description>Demo project for Spring Boot</description>
<properties>
<java.version>1.8</java.version>
</properties>
<dependencies>
<!--hsf-api-->
<dependency>
<groupId>com.example</groupId>
<artifactId>hsf-api</artifactId>
<version>0.0.1-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>com.alibaba.edas</groupId>
<artifactId>edas-sdk</artifactId>
<version>1.5.4</version>
</dependency>
<dependency>
<groupId>com.alibaba.boot</groupId>
<artifactId>pandora-hsf-spring-boot-autoconfigure</artifactId>
<version>2017-10-stable</version>
</dependency>
<dependency>
<groupId>com.alibaba.middleware</groupId>
<artifactId>sdk</artifactId>
<version>999-not-exist-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jetty</artifactId>
<scope>provided</scope>
</dependency>
<!--热部署-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<version>2.0.4.RELEASE</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.3</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
<exclusions>
<exclusion>
<groupId>org.junit.vintage</groupId>
<artifactId>junit-vintage-engine</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<fork>true</fork><!--r热加载用-->
</configuration>
</plugin>
</plugins>
</build>
2、创建service,实现接口,并加注解:
@HSFProvider(serviceGroup = “HSF”, serviceInterface = IDemoService.class, serviceVersion = “1.0.0”)
3、启动hsf-server
即可在http://jmenv.tbsite.net:8080/#/dsConfig中查看服务。
三、消费层
1、消费层需在服务层的基础上加上如下依赖(重要):
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-hsf</artifactId>
<version>1.3</version>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-pandora</artifactId>
<version>1.3</version>
</dependency>
2、在启动类的main中加入:
PandoraBootstrap.run(args);
SpringApplication.run(HsfWebApplication.class, args);
PandoraBootstrap.markStartupAndWait();
3、注入接口:
@HSFConsumer(serviceGroup = "HSF", serviceVersion = "1.0.0")
IDemoService demoService;
4、启动服务,即可测试。
四、遇到的坑:
1、@HSFConsumer、@HSFProvider注解要用com.alibaba.boot.hsf.annotation的。
2、用idea的taobao-tomcat的VM Options一定要配,用其他开发工具的网上找一下吧。
3、消费层的这两个依赖一定不能忘,否则接口无法实例化,会报错。
4、消费层的启动类一定要加PandoraBootstrap.run(args)与 PandoraBootstrap.markStartupAndWait();
5、消费层与服务层的serviceGroup、serviceVersion 要相同。
补充:1、@HSFConsumer、@HSFProvider注解可以使用com.taobao.hsf.app.spring.util.annotation的,不过消费层要在启动类上加@EnableHSF注解(com.taobao.hsf.app.spring.util.annotation.EnableHSF)