REST API中使用了PathParam和FormDataParam,但来自ununciate的文档指示PathParam的“路径”,FormDataParam的“ formdata”?

我有
包括pattern =“ com.sun.jersey.multipart.FormDataParam”
包括pattern =“ 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


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

参量
名称描述类型默认
spacecraftId(未提供文档)路径
uploadInputStream(未提供文档)formdata
处理(未提供文档)formdata
fileType(未提供文档)formdata
inputGroup(未提供文档)formdata
creationTime(未提供文档)formdata
校验和(不提供文档)formdata

顺便说一句,如何将信息显示到“描述”字段中?

谢谢,

最佳答案

文档正在尝试描述如何使用参数。因此,“ spacecraftid”是“ path”参数,而“ fileType”是“ formdata”参数。

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

10-08 01:21