Jmix 中 REST API 的两种实现( 二 ) _生活百科

<?xml version="1.0" encoding="UTF-8"?><services xmlns="http://jmix.io/schema/rest/services"><service name="sls_ProductService"> <method name="getProductsCheaperThan"> <param name="price" type="java.lang.Double"/> </method></service></services>

在项目的 application.properties 文件中，设置 jmix.rest.services-config 参数，指定上面配置的 xml 文件：

jmix.rest.services-config = com/abmcode/sales/rest-services.xml完成这些配置之后，就可以通过 REST 客户端调用了， URL 为 /rest/services/<service_name>/<method_name> 。例如，通过 Postman 调用：

文章插图

服务 API 会默认使用 Jmix 的安全机制：API 端口需要使用认证 token 进行访问，而且用户需要有访问 REST API 和所查询实体的权限。另外， Jmix 的服务 API 也支持匿名访问。

Spring 控制器 API然后我们再看看 Spring 的 RestController 方式。首先，我们定义一个控制器：

@RestController("sls_ProductController")@RequestMapping("/products")public class ProductController {@Autowiredprivate ProductService productService;@GetMapping("priceunder")public List<Product> getPriceUnder(@RequestParam Double price) throws Throwable {if (price < 0) {throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "价格参数必须大于 0"); // 自定义控制器层的参数检查 ， 抛出请求异常 。}return productService.getProductsCheaperThan(price);}}

Jmix 中的控制器接口默认都是匿名的，但是为匿名用户配置能访问实体信息又不够安全， Jmix 提供了一个应用程序属性，支持使用 Jmix 安全机制对自定义控制器进行保护：
# 支持逗号分隔的多个 patternjmix.rest.authenticatedUrlPatterns=/products/**然后，重启服务就可以通过 Postman 进行调用。注意，这里的 URL 与服务 URL 不同，直接使用了控制器中定义的路径：