Restful传递数组参数及注解大全
RESTful一种软件架构风格,设计风格而不是标准,只是提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存等机制。
需要传递数组参数的情况,如果是一般的form表单,可以直接定义参数类型为List<String>即可(不能定义为数组类型,否则只能得到一个null)。
示例代码如下:
@POST @Path("/user") publicResponsecreateUser(@FormParam("username")Stringusername, @FormParam("keyword")List<String>keywords){
文件上传接口如何传递数据参数?
但是如果是上传文件的接口,因为使用了@FormDataParam注解,则不能使用上述用法:
@POST @Path("/upload") @Consumes(MediaType.MULTIPART_FORM_DATA) publicResponseuploadFile(@FormDataParam("filename")Stringfilename, @FormDataParam("file")InputStreamuploadedInputStream, @FormDataParam("file")FormDataContentDispositionfileDetail, @FormDataParam("keyword")finalList<String>keywords){
访问这个接口时会发生异常:
java.lang.IllegalArgumentException :wrongnumberofarguments
可见使用@FormDataParam注解时,将参数类型定义成List<String>是不行的,可以定义成List<FormDataBodyPart>,从FormDataBodyPart对象中可以取得参数:
@POST @Path("/upload") @Consumes(MediaType.MULTIPART_FORM_DATA) publicResponseuploadFile(@FormDataParam("filename")Stringfilename, @FormDataParam("file")InputStreamuploadedInputStream, @FormDataParam("file")FormDataContentDispositionfileDetail, @FormDataParam("keyword")finalList<FormDataBodyPart>keywordObjs){ if(keywordObjs!=null&&!keywordObjs.isEmpty()){ for(FormDataBodyPartkeywordObj:keywordObjs){ Stringkeyword=keywordObj.getValueAs(String.class); System.out.println("关键字:"+keyword); } }
RESTful注解大全
@GET、@POST、@PUT、@DELETE、@HEAD
@GET、@POST、@PUT、@DELETE以及@HEAD均是HTTP请求方法指示符注释。您可以使用它们来绑定根资源或子资源内的Java方法与HTTP请求方法。HTTPGET请求被映射到由@GET注释的方法;HTTPPOST请求被映射到由@POST注释的方法,以此类推。
@Conumes和@Produces
@Conumes注释代表的是一个资源可以接受的MIME类型。@Produces注释代表的是一个资源可以返回的MIME类型。
@Path
@Path注释被用来描述根资源、子资源方法或子资源位置。value值可以包含文本字符、变量或具有定制正则表达式的变量。