ServiceComb官方的示例还是太复杂了,本文创建一个更简单的ServiceComb restful项目。
一、创建项目
创建一个Maven项目,编辑pom.xml文件,添加如下依赖:
<dependencies>
<dependency>
<groupId>org.apache.servicecomb</groupId>
<artifactId>java-chassis-spring-boot-starter-servlet</artifactId>
</dependency>
</dependencies>
applicaton.properties 文件
server.port=8080
APPLICATION_ID=hello
service_description.name=helloworld
service_description.version=0.1
servicecomb.service.registry.address=http://127.0.0.1:30100
servicecomb.rest.address=0.0.0.0:${server.port}
service_description.environment=development
除了最后一行
service_description.environment=development
,每一行都是必须的。最后一行的作用是:在开发阶段,可以不太关注服务的版本号,否者可能会提示服务名及版本号的问题。
其中服务注册中心是:http://127.0.0.1:30100,先不使用,等到文末再介绍。
Java代码
程序入口代码添加@EnableServiceComb
@SpringBootApplication
@EnableServiceComb
public class HelloApplication {
public static void main(String[] args) {
SpringApplication.run(HelloApplication.class, args);
}
}
创建hello服务,新建HelloEndpoint.java
,内容如下:
@RestSchema(schemaId = "hello")
@RequestMapping(path = "/")
public class HelloEndpoint {
@GetMapping(path = "/hello")
public String hello() {
return "Hello World!";
}
}
注意:
@RequestMapping(path = "/")
不可省略,这和Spring Boot 的@RestController
不同。
运行应用:
mvn spring-boot:run
使用curl localhost:8080/hello
访问站点
$ curl localhost:8080/hello
"Hello World!"
注意:返回值是带双引号的,这与Spring Boot web项目不同。
返回的结果是带引号的字符串,而一般情况返回字符串,我们不希望带引号,可以修改HelloEndpoint.java
@RequestMapping(path = "/", produces = MediaType.TEXT_PLAIN_VALUE)
再次访问,返回值就不带引号了。
$ curl localhost:8080/hello
Hello World!
添加依赖:
<dependency>
<groupId>org.hibernate</groupId>
<artifactId>hibernate-validator</artifactId>
</dependency>
添加本依赖后可以使用IDE运行程序了。
完整代码请访问:https://github.com/redexpress/servicecomb-tutorial/tree/main/hello
重构代码
新增加一个Hello接口
public interface Hello {
String hello();
}
让HelloEndpoint 实现 Hello接口
public class HelloEndpoint implements Hello {
省略其它代码
二、启用注册中心
从https://servicecomb.apache.org/release/service-center-downloads/下载ServiceComb Service-Center
我下载的是Mac系统使用的Apache ServiceComb Service-Center 1.3.0 (LATEST) Darwin版。
start-service-center.sh
启动注册中心服务,端口30100。
start-frontend.sh
启动注册中心前端页面,端口是30103。
从图上可以看到我们部署的helloworld服务。