RESTful 一種軟件架構(gòu)風(fēng)格，設(shè)計(jì)風(fēng)格而不是標(biāo)準(zhǔn)，只是提供了一組設(shè)計(jì)原則和約束條件。它主要用于客戶端和服務(wù)器交互類的軟件?；谶@個(gè)風(fēng)格設(shè)計(jì)的軟件可以更簡(jiǎn)潔，更有層次，更易于實(shí)現(xiàn)緩存等機(jī)制。

需要傳遞數(shù)組參數(shù)的情況，如果是一般的form表單，可以直接定義參數(shù)類型為L(zhǎng)ist<String>即可（不能定義為數(shù)組類型，否則只能得到一個(gè)null）。

示例代碼如下：

@POST
@Path("/user" )
public Response createUser(@FormParam("username" ) String username,
      @FormParam( "keyword") List<String> keywords) {

文件上傳接口如何傳遞數(shù)據(jù) 參數(shù)？

但是如果是上傳文件的接口，因?yàn)槭褂昧?@FormDataParam 注解，則不能使用上述用法：

@POST
@Path("/upload" )
@Consumes(MediaType.MULTIPART_FORM_DATA )
public Response uploadFile(@FormDataParam ("filename" ) String filename,
      @FormDataParam( "file") InputStream uploadedInputStream,
      @FormDataParam( "file") FormDataContentDisposition fileDetail ,
      @FormDataParam( "keyword") final List<String> keywords) {

訪問這個(gè)接口時(shí)會(huì)發(fā)生異常：

java.lang.IllegalArgumentException : wrong number of arguments

可見使用 @FormDataParam 注解時(shí)，將參數(shù)類型定義成List<String>是不行的，可以定義成 List<FormDataBodyPart> ，從 FormDataBodyPart對(duì)象中可以取得參數(shù)：

@POST
@Path("/upload" )
@Consumes(MediaType.MULTIPART_FORM_DATA )
public Response uploadFile(@FormDataParam("filename" ) String filename,
 @FormDataParam( "file") InputStream uploadedInputStream,
 @FormDataParam( "file") FormDataContentDisposition fileDetail ,
 @FormDataParam( "keyword") final List<FormDataBodyPart> keywordObjs ) {
   if (keywordObjs != null && ! keywordObjs.isEmpty()) {
 for (FormDataBodyPart keywordObj : keywordObjs) {
   String keyword = keywordObj.getValueAs(String.class);
   System. out.println( "關(guān)鍵字：" + keyword );
     }
   }

RESTful 注解大全

@GET、@POST、@PUT、@DELETE、@HEAD

@GET、@POST、@PUT、@DELETE 以及 @HEAD 均是 HTTP 請(qǐng)求方法指示符注釋。您可以使用它們來綁定根資源或子資源內(nèi)的 Java 方法與 HTTP 請(qǐng)求方法。HTTP GET 請(qǐng)求被映射到由 @GET 注釋的方法；HTTP POST 請(qǐng)求被映射到由 @POST 注釋的方法，以此類推。

@Conumes 和 @Produces

@Conumes注釋代表的是一個(gè)資源可以接受的MIME類型。@Produces注釋代表的是一個(gè)資源可以返回的MIME類型。

@Path

@Path注釋被用來描述根資源、子資源方法或子資源位置。value值可以包含文本字符、變量或具有定制正則表達(dá)式的變量。

您可能感興趣的文章: