WSO2 MSF4J增添对Spring和Swagger的支持

体系结构和设计 开发 Swagger SOA Spring

摘要：

WSO2 MSF4J 2.0增添了对Spring、Swagger定义生成、ExceptionMapper以及StreamingOutput的支持。

正文：

WSO2 MSF4J 2.0已增添了对Spring、Swagger定义生成、ExceptionMapper以及StreamingOutput的支持。

WSO2 MSF4J是一种通过Java构建微服务的开源框架。根据WSO2的介绍，该框架的内存痕迹可低至25MB，启动时间不超过400ms。该框架最近发布的2.0版包含诸多改进，例如：

• 支持Spring注解和运行时。现在可通过Spring bean编写微服务、拦截器（Interceptor），以及异常映射器（Exception mapper）。
• 可生成Swagger定义并支持Swagger注解。
• 支持用ExceptionMapper将微服务的异常连接至HTTP响应。
• 支持通过StreamingOutput让开发者控制如何将响应流回调用方。

WSO2 MSF4J的一些主要功能包括：

• 使用Java注解定义微服务API
• 支持JAX-RS和JSR 250（注解）
• 与其他WSO2开发、部署、监控和缩放工具集成
• 与WSO2 Data Analytics Server集成
• 与WSO2 Identity Server集成
• 包含可出于多种目的（例如日志）捕获消息的API拦截器
• 通过WSO2 DevStudio执行的开发可通过Swagger API定义生成微服务项目
• 消息传输可通过Netty实现
• 请求可通过唯一的消息ID进行追踪

若要使用MSF4J创建微服务，开发者需要通过注解Java类以定义API端点，并使用Runner进行部署。最基本的HelloWorld示例是这样的：

@Path("/hello")
public class HelloService {
    @GET
    @Path("/{name}")
    public String hello(@PathParam("name") String name) {
        return "Hello " + name;
    }
}

可这样部署：

public class Application {
    public static void main(String[] args) {
        new MicroservicesRunner()
                .deploy(new HelloService())
                .start();
    }
}

通过上述操作，下列URL

curl http://localhost:8080/hello/world

就可以生成“Hello World”的响应。

使用WSO2 MSF4J创建的微服务可使用Maven构建并部署到Docker容器中。

作者：Abel Avram，阅读英文原文：WSO2 MSF4J Adds Support for Spring and Swagger