PathParam和FormDataParam

Question

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

我有 include pattern =“com.sun.jersey.multipart.FormDataParam” include pattern =“javax.ws.rs.PathParam”

在enunciate.xml文件中。

有什么建议吗？

---＆GT;＆GT;＆GT; 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

---＆GT;＆GT;＆GT;浏览器中的文档：

参数 名称描述类型默认 spacecraftId（没有提供文档）路径 uploadedInputStream（没有提供文档）formdata 处理（没有提供文件）formdata fileType（没有提供文档）formdata inputGroup（没有提供文档）formdata creationTime（没有提供文档）formdata 校验和（没有提供文件）formdata

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

谢谢，

Answer 1

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

要在说明中提供文本，请使用JavaDoc。请参阅format of a doc comment。