:body-params 与 compojure-api 中的 :form-params

Question

在使用 compojure-api 创建 API 时，在实践中使用 :body-params 和 :form-params 有什么区别？例如：

(POST* "/register" []
    :body-params [username :- String,
                  password :- String]
    (ok)))

对

(POST* "/register" []
    :form-params [username :- String,
                  password :- String]
    (ok)))

对于将由单页 clojurescript 应用和/或原生移动应用使用的 API，应该使用哪一个？

Answer 1

它与支持的内容类型有关：

• form-params 旨在与内容类型“application/x-www-form-urlencoded”（一种表单）一起使用
• body-params 旨在用于也将位于具有其他内容类型（edn、json、transit 等）的正文中的参数。

您需要使用 :body-params 从您的 clojurescript 或移动应用程序中使用它。

使用form-params 或body-params 将影响参数的验证方式、从请求的哪个部分获取参数以及如果使用swagger 扩展将如何生成swagger.json 文件。

compojure-api 中的很多东西如果不映射到 swagger 中的概念就很难理解。 Looking into the code 我们可以在 the swagger parameter specs 中找到像“consumes”或“formData”这样的招摇术语。