PathParam 和 FormDataParam

Question

PathParam 和 FormDataParam 在 REST API 中使用，但来自 enunciate 的文档指出 PathParam 的“路径”和 FormDataParam 的“formdata”？

我有 包括模式=“com.sun.jersey.multipart.FormDataParam” 包括模式="javax.ws.rs.PathParam"

在 enunciate.xml 文件中。

有什么建议吗？

--->>> REST API：

@POST
@Produces({MediaType.TEXT_XML, MediaType.TEXT_PLAIN})
@Consumes("multipart/form-data")
public Response postStagedFileDataForm(
    FormDataMultiPart fdmp,
    @PathParam("spacecraftId") String spacecraftId,
    @FormDataParam("uploadedFile") InputStream uploadedInputStream,
    @FormDataParam("uploadedFile") FormDataContentDisposition disposition,
    @FormDataParam("fileType") String fileType,
    @FormDataParam("group") String inputGroup,
    @FormDataParam("creationTime") String creationTime,
    @FormDataParam("checksum") String checksum,
    @Context HttpServletRequest servletRequest)
throws IOException

--->>> 浏览器中的文档：

参数 名称 描述 类型 默认 航天器Id（未提供文档）路径 uploadInputStream（未提供文档）formdata 处置（未提供文件）formdata fileType（未提供文档）formdata inputGroup（未提供文档）formdata 创建时间（未提供文档）表单数据 校验和（未提供文档）formdata

顺便问一下，如何在“描述”字段中显示信息？

谢谢，

Answer 1

文档试图描述如何使用这些参数。所以“spacecraftid”是一个“path”参数，“fileType”是一个“formdata”参数。

要在描述中提供文本，请使用 JavaDoc。见format of a doc comment。