6

我能够使用Play设置Swagger并尝试 Swagger-ui ......我必须说它真的很棒。

ApiOperation用,等记录我的控制器的操作ApiImplicitPara很容易，并且可以按预期工作。

不过，由于我对 Swagger 的了解有限，在为 type 的隐式参数定义架构时遇到了问题body。我想映射到隐式参数的类如下所示：

@ApiModel(value "User", description = "Represents an user")
class User private(private var json: JsValue) {

  private def setValue(key: JsPath, value: JsValue) = {
    value match {
      case JsNull => json.transform(key.json.prune).map(t => json = t)
      case _ => json.transform((__.json.update(key.json.put(value)))).map(t => json = t)
    }
  }

  def asJson = json

  @ApiModelProperty(value = "User's id", dataType = "String", required = false)
  def id_= (v: Option[String]) = setValue((__ \ 'id), Json.toJson(v))
  def id = json as (__ \ 'id).readNullable[String]
  @ApiModelProperty(value = "User's email address", dataType = "String", required = true)
  def email = json as (__ \ 'email).read[String]
  def email_= (v: String) = setValue((__ \ 'email), Json.toJson(v))
  @ApiModelProperty(value = "User's firstName", dataType = "String", required = true)
  def firstName = json as (__ \ 'firstName).read[String]
  def firatName_= (v: String) = setValue((__ \ 'firstName), Json.toJson(v))
  ...
}

object User {

  def apply(
    id: Option[String],
    email: String,
    firstName: String,
  ): JsResult[User] = apply(Json.obj(
    "id" -> id,
    "email" -> email,
    "firstName" -> firstName,
    ...
  ))
}

我的模型类的内部表示是 JSON……然后我只提供读取/修改内部 JSON 的 getter 和 setter——这个解决方案让我可以非常快速地处理 JSON，并且我可以将对象按原样传递给 MongoDB。

问题是Swagger为上面的类生成的模型是这样的：

User {
  json(JsValue),
  id(String): User's id,
  email(String): User's email,
  firstName(String): User's first name,
  ...
}

如何防止 Swagger 放入json模型？

4

1 回答 1

1

尝试这个：

 @ApiModelProperty(required = false, hidden = true) 
 def asJson = json
于 2016-03-28T04:51:22.737 回答