掌握Spring REST TypeScript生成器

在优锐课的java分享中，讨论了关于Spring REST TypeScript生成器，该生成器创建反映后端模型和REST服务的模型和服务。码了很多干货，分享给大家参考学习。

我注意到网络开发人员创建了TypeScript模型和服务来反映我们的后端模型和REST服务。这是一项乏味的工作。更重要的是，在他们最终反映出我们后端的功能之后，这还不是终点。因为我们总是要牢记在软件开发中很常见的一件事...更改。由于一些新的业务需求，修改了后端服务。该更改迫使前端开发人员重新分析后端服务并重构前端应用程序，以便它们与服务器端匹配。

一段时间后，我开始了Web开发的冒险之旅，并提出了可以基于Java中的类型信息生成所有这些代码的想法。我开始寻找一种TypeScript生成器，该生成器将能够基于REST接口在TypeScript中创建模型和服务。正如我的研究表明的那样，已经有一些库提供了这种功能，但是它们都不能满足我们的所有需求，例如：

支持JavaBean约定。
支持FasterXML / Jackson批注。
对Spring框架的支持-生成TypeScript服务，可以调用在Spring中开发的REST API。
生成的服务符合Angular和ReactJS的特定要求（Observable或Promises API）。

因此，我们决定启动一个小型的下班时间项目，该项目将提供上述功能。它可以正常工作，我们提出了可以立即使用的解决方案。它已在我们的大多数基于Angular或React的Web应用程序的商业项目中进行了测试和使用。

正如我们的经验所表明的，我们的图书馆带来了巨大的好处。平均生成的代码占Web应用程序代码库的20％，但是就节省的更改和测试工作而言，它是无价的。由于取得了如此可喜的成果，我们公司决定将项目开源。如果你的开发设置在后端使用Spring框架，在前端使用Angular或React，那么你将获得与我们相同的收益。在这篇简短的文章中，我想介绍如何使用我们的spring-rest-2-ts TypeScript生成器进行REST。

例子

为了了解spring-rest2ts生成器的功能，让我们用Java创建一个简单的模型和REST控制器，我们将展示在TypeScript中生成的内容

 public class BaseDTO {

     private int id;

     @JsonFormat(shape = JsonFormat.Shape.NUMBER)

     private Date updateTimeStamp;

  }

 public class OrderDTO extends BaseDTO {

     private double price;

     @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "dd-MM-yyyy hh:mm:ss")

     private LocalDateTime orderTimestamp;

 }

Spring REST控制器：

 @Controller

 @RequestMapping("api/order")

 public class OrderCtrl {

     @PostMapping(consumes = {"application/json"}, produces = {"application/json"})

     @ResponseBody

     @ResponseStatus(HttpStatus.CREATED)

     public OrderDTO createOrder(@RequestBody OrderDTO entity) {

         return entity;

     }

     @RequestMapping(path = "/{id}", method = RequestMethod.GET, produces = {"application/json"})

     @ResponseBody

     public OrderDTO getOrder(@PathVariable int id) {

         return new OrderDTO();

     }

 }

在TypeScript中，对于DTO类，我们获得了两个具有映射继承的接口，其中每个字段都映射到各自的TypeScript类型：

 export interface Base {

     id: number;

     updateTimeStamp: number;

 }

 export interface Order extends Base {

     price: number;

     /**

      *    pattern : dd-MM-yyyy hh:mm:ss

      */

     orderTimestamp: string;

 }

如我们所见，如果字段具有Jackson批注，则会将其考虑在内。如果不是，则其转换基于Java类型到TypeScript的映射。支持类型名称映射。在Java中，我们通过提供适当的名称映射器来查看OrderDTO，该映射器会切断后缀DTO，然后我们获得Order类型

可观察的基础服务

模型类的映射非常容易理解。更有趣的是Spring REST控制器的映射，在TypeScript中，该映射已生成用于调用端点的实现。这种方法隐藏在方法名称，路径和参数下，因此代码可以抵抗后端的更改。更重要的是，我们将返回类型转换为选定的Web框架。对于Angular 2+，有一个生成的有效Angular服务可用于注入：

 @Injectable()

 export class OrderService {

     httpService: HttpClient;

     public constructor(httpService: HttpClient) {

         this.httpService = httpService;

     }

为OrderCtrl生成了OrderService。在这里，类型名称也由类型名称映射器转换。如果REST API与Web应用程序不在同一主机上，则可以配置baseURL，它可以是整个主机引用的路径前缀

基于承诺的服务

对于使用Promise API生成器的Web框架，正确的配置还能够生成服务类：

 export class OrderService {

     baseURL: URL;

     public constructor(baseURL: URL = new URL(window.document.URL)) {

         this.baseURL = baseURL;

     }

     public createOrder(entity: Order): Promise<Order> {

         const url = new URL('/api/order', this.baseURL);

         return fetch(url.toString(), {

             method: 'POST',

             headers: {'Content-Type': 'application/json'},

             body: JSON.stringify(entity)

         }).then(res => res.json());

     }

     public getOrder(id: number): Promise<Order> {

         const url = new URL('/api/order/' + id + '', this.baseURL);

         return fetch(url.toString(), {method: 'GET'}).then(res => res.json());

     }

 }

组态

由于具有更大的灵活性，因此TypeScript生成器通过代码进行配置。无需配置文件。这样就可以在需要的地方轻松扩展发电机。这是最简单的生成器配置器：

    Rest2tsGenerator tsGenerator = new Rest2tsGenerator();

     // Java Classes filtering

     tsGenerator.setModelClassesCondition(new ExtendsJavaTypeFilter(BaseDTO.class));

     tsGenerator.setRestClassesCondition(new ExtendsJavaTypeFilter(BaseCtrl.class));

     // Java model classes converter setup

     JacksonObjectMapper jacksonObjectMapper = new JacksonObjectMapper();

     jacksonObjectMapper.setFieldsVisibility(JsonAutoDetect.Visibility.ANY);

     modelClassesConverter = new ModelClassesToTsInterfacesConverter(jacksonObjectMapper);

     modelClassesConverter.setClassNameMapper(new SubstringClassNameMapper("DTO", ""));

     tsGenerator.setModelClassesConverter(modelClassesConverter);

     // Spring REST controllers converter

     restClassesConverter = new SpringRestToTsConverter(new Angular4ImplementationGenerator());

     restClassesConverter.setClassNameMapper(new SubstringClassNameMapper("Ctrl", "Service"));

     tsGenerator.setRestClassesConverter(restClassesConverter);

     // set of java root packages for class scanning

     javaPackageSet = Collections.singleton("com.blueveery.springrest2ts.examples");

     tsGenerator.generate(javaPackageSet, Paths.get("../target/ts-code"));

文章写道这里，感谢大家的观看。如有不足支持，欢迎补充评论。

更欢迎朋友们点赞关注，和我一起细说探讨架构那些事。