Go语言视频零基础入门到精通

admin

REST的文件上传，好像是标准API并没有提供一种比较好的方式。
我用的是JBOSS WILDLFY服务器，它的rest实现是jboss resteasy。Resteasy的文件上传就比较方便了。
如果使用jboss resteasy，那么就可以使用

1. org.jboss.resteasy.annotations.providers.multipart.MultipartForm

复制代码

注解来实现文件的上传。
那么这个注解为什么能实现文件上传呢？
REST EASY中有这么一个类：

1. org.jboss.resteasy.plugins.providers.multipart.MultipartFormAnnotationReader

复制代码

它的源码是这样子的：

1. @Provider
2. @Consumes("multipart/form-data")
3. public class MultipartFormAnnotationReader implements MessageBodyReader<Object>
4. {……}

复制代码

@Provider注解是注册自定义MessageBodyReader必须要用到的一个注解。MessageBodyReader的作用就是将http请求转化了某个类的对象。@Consumes("multipart/form-data")表示只接收MIME TYPE为multipart/form-data的请求。MessageBodyReader<Object>泛型了Object表示可以接受任意类型为方法参数。但是我们在看看源代码。

1. public boolean isReadable(Class<?> type, Type genericType,
2.                              Annotation[] annotations, MediaType mediaType)
3.    {
4.       return FindAnnotation.findAnnotation(annotations, MultipartForm.class) != null
5.               || type.isAnnotationPresent(MultipartForm.class);
6.    }

复制代码

在isReadable方法中进行了判断，可以看到只有加了@MultipartForm注解的，这个方法才会返回true。这就是我们使用这个注解的原因。
当然@Consumes("multipart/form-data")的MessageBodyReader在jboss resteasy中还有许多。因为这个注解特别好用，所以我就讲了这一个。
下面写个demo。这是一个rest的资源类：

1. package restfile;
3. import java.io.UnsupportedEncodingException;
5. import javax.ws.rs.POST;
6. import javax.ws.rs.Path;
7. import javax.ws.rs.Produces;
9. import org.jboss.resteasy.annotations.providers.multipart.MultipartForm;
11. @Path("upload.html")
12. public class FileUpload {
14.         @POST
15.         @Produces("text/html;charset=utf-8")
16.         public String upload(@MultipartForm Form form) throws UnsupportedEncodingException {
17.                 return new String(form.getFile(), "utf-8");
18.         }
19. }

复制代码

在我的这个资源类里面，我仅仅是将上传的文件内容以HTML的形式发发送给浏览器，有兴趣的可以写一个html文件上传试一试。
至于那个Form是很简单的，代码如下：

1. package restfile;
3. import javax.ws.rs.FormParam;
5. public class Form {
7. @FormParam("file")
8. private byte[] file;
10.         public byte[] getFile() {
11.                 return file;
12.         }
14.         public void setFile(byte[] file) {
15.                 this.file = file;
16.         }
17. }

复制代码

用的是标准的@FormParam注解来告诉框架，要从请求中的file字段来取数据。Resteasy的这个技术可以将上传的东西直接转变为byte数组，用起来特别方便。