AFNetworking简单的文件上传Demo，服务端为Java

2017-02-18 本文已影响419人字节码

java servlet实现服务端：接收文件上传，并保存到服务器

// 创建一个servlet，并实现HTTPServlet接口
@WebServlet("/upload2")
@MultipartConfig
public class UploadDemo2Servlet extends HttpServlet {
    private static final long serialVersionUID = 1L;

    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    
        request.setCharacterEncoding("UTF-8");
        
        // 获取上传组件part
        Part part = request.getPart("f");
        String dis = part.getHeader("Content-disposition");
        
        // 获取文件的真实名称
        String filename = dis.substring(dis.indexOf("filename=")+10, dis.length()-1);
        System.out.println("文件的名称："+ filename);
        
        // 获取随机的文件名
        String uuidName = UploadUtils.getUUIDName(filename);
        System.out.println("随机文件名："+uuidName);
        
        // 获取文件存放的目录--文件夹
        String dir = UploadUtils.getDir(uuidName);
        String dirPath = this.getServletContext().getRealPath("/upload"+dir);
        File file = new File(dirPath);
        if (!file.exists()) {
            // 当文件不存在，就创建
            file.mkdirs();
        }
        System.out.println("文件目录:" + dirPath);
        
        
        InputStream input = part.getInputStream();
        // 获取文件的路径
        File filePath = new File(file, uuidName);
        FileOutputStream output = new FileOutputStream(filePath);
                // 对拷流，保存文件到服务端
        IOUtils.copy(input, output);
        System.out.println("文件的完整路径：" + filePath);
        // 关闭资源
        output.close();
        input.close();
        // 删除临时文件
        part.delete();
    }


    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // TODO Auto-generated method stub
        doGet(request, response);
    }
}

web端测试接口

/// 创建一个jsp或html文件
<form action="/FileUploadDemo/upload2" method="post" enctype="multipart/form-data">
        选择文件：<input type="file" name="f"/>
        <input type="submit" value="上传"/>
</form>

iOS 使用AFNetworking测试接口

主要说明ANF上传文件时multipart/form-data要传的4个参数与服务端之间的关系

[formData appendPartWithFileData:fileData name:@"file" fileName:fileName mimeType:mimeType];

fileData是要上传文件的二进制数据
name主要用于java中获取Part(文件上传组件对象的)，此name值必须是与服务端约定好的固定值，不然服务器收到错误的name值时，就无法创建Part对象，最终肯定上传失败的，此name值在HTML5页面<input type="file" name="f"/>
fileName为文件的名称
mimeType为文件类型
有些App在上传时可能有其他参数需要传，可以将其放入HTTP请求的请求体中，AFN直接在paramters中即可

/// 使用AFN 上传图片
- (void)upload:(UIImage *)image name:(NSString *)name {
    
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
    /// responseSerializer.acceptableContentTypes中不添加@"multipart/form-data",也是可以的
//    manager.responseSerializer.acceptableContentTypes = [NSSet setWithObjects:@"application/json", @"text/json", @"text/javascript", @"text/html", @"text/plain", @"image/jpeg", @"image/png", @"text/plain", @"multipart/form-data", nil];

    
    [manager POST:@"http://192.168.1.101:8080/FileUploadDemo/upload2" parameters:nil constructingBodyWithBlock:^(id<AFMultipartFormData>  _Nonnull formData) {
        
        /// fileData是要上传文件的二进制数据
        NSData *fileData = UIImagePNGRepresentation(image);
        /// 此name主要用于java中获取Part(文件上传组件对象的)，此name值必须是与服务端约定好的固定值，不然服务器到错误的name值时，就无法创建Part对象，最终肯定上传失败的，此name值在HTML5页面中用input标签type="f" 然后设置name值
        NSString *name = @"f";
        /// fileName为文件的名称
        NSString *fileName = [NSString stringWithFormat:@"%@.png", name];
        /// mimeType为文件类型
        NSString *mimeType = @"image/png";
        
        [formData appendPartWithFileData:fileData name:@"file" fileName:fileName mimeType:mimeType];
        
    } progress:^(NSProgress * _Nonnull uploadProgress) {
        NSLog(@"%@", uploadProgress);
    } success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
        NSLog(@"%@", responseObject);
    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"%@", error);
    }];
}

了解什么是multipart/form-data请求：

根据http/1.1 rfc 2616的协议规定，我们的请求方式只有OPTIONS、GET、HEAD、POST、PUT、DELETE、TRACE等，那为何还会有multipart/form-data请求之说呢？

http协议是规定了以ASCII码传输，建立在tcp、ip协议之上的应用层规范，规范内容把http请求分为3个部门：状态行，请求头，请求体。所有的方法、实现都是围绕如何运用和组织这三部分来完成的。换句话来说就是万变不离其中，只要我们了解了http请求的组成部分后，自然就可以应变任何实际工作中的需求和问题了。

关于状态行，请求头，请求体等三部分的具体内容，可以参考官方的协议文档，这里主要分析multipart/form-data请求。

既然http协议本身的原始方法不支持multipart/form-data请求，那这个请求自然就是由这些原始的方法演变而来的：

1、multipart/form-data的基础方法是post，也就是说是由post方法来组合实现的
2、multipart/form-data与post方法的不同之处：请求头，请求体。
3、multipart/form-data的请求头必须包含一个特殊的头信息：Content-Type，且其值也必须规定为multipart/form-data，同时还需要规定一个内容分割符用于分割请求体中的多个post的内容，如文件内容和文本内容自然需要分割开来，不然接收方就无法正常解析和还原这个文件了。具体的头信息如下：

Content-Type: multipart/form-data; boundary=${bound}

//其中${bound} 是一个占位符，代表我们规定的分割符，可以自己任意规定，但为了避免和正常文本重复了，尽量要使用复杂一点的内容。如：--------------------56423498738365

4、multipart/form-data的请求体也是一个字符串，不过和post的请求体不同的是它的构造方式，post是简单的name=value值连接，而multipart/form-data则是添加了分隔符等内容的构造体。具体格式如下:

--${bound}
Content-Disposition: form-data; name="Filename"

HTTP.pdf
--${bound}
Content-Disposition: form-data; name="file000"; filename="HTTP协议详解.pdf"
Content-Type: application/octet-stream

%PDF-1.5
file content
%%EOF

--${bound}
Content-Disposition: form-data; name="Upload"

Submit Query
--${bound}--

其中${bound}为之前头信息中的分割符，如果头信息中规定为123，那么这里也要为123,；可以很容易看出，这个请求体是多个相同的部分组成的：每一个部分都是以--加分隔符开始的，然后是该部分内容的描述信息，然后一个回车，然后是描述信息的具体内容；如果传送的内容是一个文件的话，那么还会包含文件名信息，以及文件内容的类型。上面的第二个小部分其实是一个文件体的结构，最后会以--分割符--结尾，表示请求体结束。
综上，可以知道要发送一个multipart/form-data的请求，其实任何支持post请求的工具或语言都可以支持，只是自己要稍微包装一下便可。