Java模拟表单文件上传(微信/中文名乱码问题)

最近在做微信企业号，在上传素材文件时遇到了点问题，主要是中文文件名乱码的问题，开始使用的是httpclient3.x的api去实现，文件上传没问题，就是名称是中文的时候死活都是乱码，自己也设置了很多地方的编码为utf-8，也没有用，后来百度，谷歌，也没有找到解决方案，或许解决方案是有效的，但是到了微信这边就没有用了，后来干脆使用HttpURLConnection解决了问题，另外经过半天鼓捣，也解决了一些其他相关性的问题，对文件上传也有了更深的了解。不过后面用httpclient4.x试了一下，发现也是可以解决问题的。

Http请求

自己写了一个表单，上传文件，提交表单，查看http请求，可以看到。

------WebKitFormBoundary7blBEBTiZtWOX8LI
Content-Disposition: form-data; name="id"


------WebKitFormBoundary7blBEBTiZtWOX8LI
Content-Disposition: form-data; name="msgtype"

file
------WebKitFormBoundary7blBEBTiZtWOX8LI
Content-Disposition: form-data; name="uploadImage"; filename="0.png"
Content-Type: image/png


------WebKitFormBoundary7blBEBTiZtWOX8LI--

表单设置成multipart/form-data之后表单内容就变成上面的格式了，如上表单中有两个属性id,msgtype，其中id内容为空，msgtype值为file，然后还有一个文件，
Content-Disposition: form-data; name=”uploadImage”; filename=”0.png”
其中name是input file 的name值，filename是文件名，注意模拟表单提交的时候，filename必须要有值，而且是要带后缀的，否则提交不成功。

HttpURLConnection实现表单文件提交

这里使用的IOUtils是commons.io的包，也是直接使用close关闭流

/**
     * 模拟上传文件(远程URL)
     * 
     * @Title uploadFile
     * @param uploadUrl   上传路径
     * @param picUrl       远程图片URL
     * @param params       参数内容
     * @return
     * @throws IOException
     * @author zh
     * @date 2016年6月30日 下午4:22:10
     */
    public static String uploadFile(String uploadUrl, URL picUrl, Map<String,String> params) throws IOException {
        return uploadFile(uploadUrl, picUrl.openStream(), picUrl.getFile().substring(picUrl.getFile().lastIndexOf("/")) + 1, params);
    }

    /**
     * 模拟上传文件(本地文件)
     * 
     * @Title uploadFile
     * @param uploadUrl   上传路径
     * @param picUrl       本地文件
     * @param params       参数内容
     * @return
     * @throws IOException
     * @author zh
     * @date 2016年6月30日 下午4:23:15
     */
    public static String uploadFile(String uploadUrl, File file, Map<String,String> params) throws IOException {
        return uploadFile(uploadUrl, new FileInputStream(file), file.getName(), params);
    }

    /**
     * 模拟上传文件（输入流）
     * 
     * @Title uploadFile
     * @param uploadUrl     上传链接
     * @param is            输入流
     * @param filename      文件名
     * @param params        参数
     * @return
     * @throws IOException
     * @author zh
     * @date 2016年6月30日 下午4:08:52
     */
    public static String uploadFile(String uploadUrl, InputStream is, String filename, Map<String,String> params) throws IOException {
        URL urlGet = new URL(uploadUrl);
        HttpURLConnection conn = (HttpURLConnection) urlGet.openConnection();
        conn.setDoOutput(true);
        conn.setDoInput(true);
        conn.setUseCaches(false);
        conn.setRequestMethod("POST");
        conn.setRequestProperty("connection", "Keep-Alive");
        conn.setRequestProperty("user-agent", DEFAULT_USER_AGENT);  
        conn.setRequestProperty("Charsert", "UTF-8");
        // 定义数据分隔线
        String BOUNDARY = "----WebKitFormBoundary7blBEBTiZtWOX8LI"; 
        conn.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + BOUNDARY);

        OutputStream out = new DataOutputStream(conn.getOutputStream());
        // 文件内容
        StringBuilder contentBody = new StringBuilder();
        contentBody.append("--").append(BOUNDARY).append("\r\n");
        contentBody.append("Content-Disposition: form-data;name=\"media\";filename=\""+ filename + "\"\r\n");
        contentBody.append("Content-Type:application/octet-stream\r\n\r\n");
        System.out.println(contentBody);
        out.write(contentBody.toString().getBytes());
        DataInputStream fs = new DataInputStream(is);
        int bytes = 0;  
        byte[] bufferOut = new byte[1024];
        while ((bytes = fs.read(bufferOut)) != -1) {
            out.write(bufferOut, 0, bytes);
        }
        IOUtils.closeQuietly(fs);
        // 参数内容
        if (params != null && params.size() > 0) {
            for (String key : params.keySet()) {
                StringBuilder paramData = new StringBuilder();
                paramData.append("\r\n").append("--").append(BOUNDARY).append("\r\n");
                paramData.append("Content-Disposition: form-data;name=\""+key+"\";");
                paramData.append("\r\n");
                paramData.append("\r\n");
                paramData.append("\""+params.get(key)+"\"");
                System.out.println(paramData);
                out.write(paramData.toString().getBytes());
            }
        }
        // 最后一个片段结尾要用--表示
        byte[] end_data = ("\r\n--" + BOUNDARY + "--\r\n").getBytes();
        out.write(end_data);
        out.flush();
        IOUtils.closeQuietly(out);

        // 定义BufferedReader输入流来读取URL的响应  
        InputStream in = conn.getInputStream();
        BufferedReader read = new BufferedReader(new InputStreamReader(in, Charsets.UTF_8));
        String valueString = null;
        StringBuffer bufferRes = null;
        bufferRes = new StringBuffer();
        while ((valueString = read.readLine()) != null){
            bufferRes.append(valueString);
        }
        IOUtils.closeQuietly(in);
        // 关闭连接
        if (conn != null) {
            conn.disconnect();
        }
        return bufferRes.toString();
    }

微信企业号上传临时素材

• 请求说明
  Https请求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

• 参数说明
  参数 必须 说明
  
  权限说明
  完全公开。所有管理组均可调用，media_id可以共享。

返回说明

{
   "type": "image",
   "media_id": "1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0",
   "created_at": "1380000000"
}

说实话，微信的文档有些地方做的真的不怎么样，而且企业号现在功能也不是太全，比如SaaS套件第三方应用有授权安装的API，却没有取消授权安装的API，有些东西值要调几个API才可以得到，可能他们有他们的考虑吧，不说了，继续说遇到的问题。
使用上面这种方法调用上传素材，然后得到media_id去发送消息，发送文件的时候，如果是中文名的文件，也不会出现乱码了，当然这个上传文件不仅是在微信的时候用，平时需要的各种环境都可以使用，这里拿微信只是举例，如果要使用httpclient，那还是推荐使用httpclient4.x以上的版本吧，貌似这个解决方案多一点。

上传文件

    public static void main(String[] args) throws Exception {
        File file = new File("E:\\中文图片.jpg");
        String access_token = "AasbMO9SCcF3HO0jVLnddQuZo4pUmSYHieqC56vQbBvQgqGWW8spQG5CtWT6Vcjh";
        String uploadUrl = "https://qyapi.weixin.qq.com/cgi-bin/media/upload?type=file&access_token="+ CommonUtil.encode(access_token);
        // 本地文件
        String upload_response = uploadFile(uploadUrl, file, null);
        System.out.println(upload_response);

        // 远程URL文件提交上传
        URL url = new URL("http://www.baidu.com/xx/xxx.zip");
        String upload_response2 = uploadFile(uploadUrl, url, null);
        System.out.println(upload_response2);
    }

小结

这里走了很多弯路，因为在前台页面不可能带上Access_token，为了安全，只能先将文件上传到服务器，然后发送请求到微信，这里就出现了一个问题，服务器是linux的，中文名的文件会乱码，起初是统一替换文件名为一串时间戳的字符，但是在发送消息，类型为文件时，会显示文件名，这样不好，所以必须要显示原文件名，原以为必须要再本地存一份，然后提交给微信，后来发现，远程URL，文件流都可以提交，所以问题就好解决了，本地不需要存了，然后得到文件流，然后得到原文件名，推送给微信，上面给出的三个版本，本地文件，远程URL，文件流的实现版本，总体还是解决了这个问题。

多文件上传版本

private static final String DEFAULT_USER_AGENT = "Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/33.0.1750.146 Safari/537.36";
/**
     * 模拟上传文件请求
     * 
     * @Title uploadFile 
     * @param uploadUrl  上传url
     * @param files       文件列表
     * @param params      参数列表
     * @return
     * @throws Exception
     * @author zh
     * @date 2016年6月30日 下午3:54:26
     */
    public String uploadFile(String uploadUrl, List<File> files, Map<String,String> params) throws Exception {
        String BOUNDARY = "----WebKitFormBoundary7blBEBTiZtWOX8LI";
        String response = "";
        HttpURLConnection conn = null;  
        try { 
            URL url = new URL(uploadUrl);
            conn = (HttpURLConnection) url.openConnection();
            conn.setDoOutput(true);
            conn.setDoInput(true);
            conn.setUseCaches(false);
            conn.setRequestMethod("POST");
            conn.setRequestProperty("Connection", "Keep-Alive");
            conn.setRequestProperty("Charset", "UTF-8");
            conn.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + BOUNDARY);
            StringBuffer contentBody = new StringBuffer();
            OutputStream out = new DataOutputStream(conn.getOutputStream());
            if (params != null && params.size() > 0) {
                for (String key : params.keySet()) {
                    contentBody.append("\r\n").append("--").append(BOUNDARY).append("\r\n");
                    contentBody.append("Content-Disposition: form-data; name=\"").append(key + "\"");
                    contentBody.append("\r\n").append("\r\n").append(params.get(key)).append("\r\n");
                }
            }
            System.out.println(contentBody);
            out.write(contentBody.toString().getBytes("utf-8"));
            if(files != null && files.size() > 0){
                for (File file : files) {
                    contentBody = new StringBuffer();
                    contentBody.append("\r\n").append("--").append(BOUNDARY).append("\r\n");
                    contentBody.append("Content-Disposition:form-data; name=\"")
                            .append("media\"; ").append("filename=\"").append(file.getName() + "\"")
                            .append("\r\n" + "Content-Type:application/octet-stream")
                            .append("\r\n" + "Content-Transfer-Encoding: binary" + "\r\n" + "\r\n");
                    System.out.println(contentBody.toString());
                    out.write(contentBody.toString().getBytes("utf-8"));
                    DataInputStream dis = new DataInputStream(new FileInputStream(file));
                    int bytes = 0;  
                    byte[] bufferOut = new byte[1024];  
                    while ((bytes = dis.read(bufferOut)) != -1) {  
                        out.write(bufferOut, 0, bytes);  
                    }  
                    dis.close();
                }
            }
            byte[] endData = ("\r\n--" + BOUNDARY + "--\r\n").getBytes();  
            out.write(endData);  
            out.flush();  
            out.close();  

            // 读取返回数据    
            StringBuffer strBuf = new StringBuffer();  
            BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream()));  
            String line = null;  
            while ((line = br.readLine()) != null) {  
              strBuf.append(line).append("\n");  
            }  
            response = strBuf.toString();  
            br.close();  
         } catch (Exception e) {  
            System.out.println("发送POST请求出错。" + uploadUrl);  
            e.printStackTrace();  
        } finally {  
            if (conn != null) {  
                conn.disconnect();  
                conn = null;  
            }  
        }  
        return response;
    }

HttpClient3 实现文件上传版本

    public String uploadFile(String uploadUrl, List<File> files, Map<String,String> params) throws Exception {
        HttpClient client = new HttpClient();
        PostMethod httpPost = new PostMethod(uploadUrl);
        httpPost.setRequestHeader("User-Agent", "AdUU");
        httpPost.setRequestHeader("Accept-Language", "zh-cn,zh;q=0.5");
        httpPost.setRequestHeader("Accept-Charset", "GBK,utf-8;q=0.7,;q=0.7");
        httpPost.setRequestHeader("Connection", "keep-alive");
        ArrayList<PartBase> parts = new ArrayList<PartBase>();
        if (params != null && params.size() > 0) {
            for (String key : params.keySet()) {
                parts.add(new StringPart(key, params.get(key)));
            }
        }
        if (files != null && files.size() > 0)
            for (File file : files) {
                parts.add(new FilePart("upload",file.getName(), file));
            }
        httpPost.setRequestEntity(new MultipartRequestEntity(parts.toArray(new Part[]{}), httpPost.getParams()));
        client.executeMethod(httpPost);
        StringBuilder response = new StringBuilder();
        if (httpPost.getStatusCode() == 200) {
            BufferedReader reader = new BufferedReader(
                    new InputStreamReader(httpPost.getResponseBodyAsStream(), "UTF-8"));
            String line;
            while ((line = reader.readLine()) != null) {
                response.append(line);
            }
            reader.close();
        }
        return response.toString();
    }

最后说一点，如果是实现微信上传的话， 最好还是使用HttpURLConnection版本，或者用httpclient4.x以上版本，这样就解决了中文文件名上传的问题。

HttpClient4.x 解决微信上传素材中文名乱码问题

测试通过版本：

• httpclient 4.5.2
• httpcore 4.4.4
• httpmime 4.5.2

import java.io.File;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;

import org.apache.http.Consts;
import org.apache.http.HttpEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.mime.HttpMultipartMode;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class Upload {

    public static String uploadFile(String uploadUrl, List<File> files, Map<String,String> params) {
        CloseableHttpClient httpclient = HttpClients.createDefault();
        CloseableHttpResponse response = null;
        HttpEntity entity = null;
        String result = "";
        try{
            HttpPost httpPost = new HttpPost(uploadUrl);
            httpPost.setHeader("User-Agent", "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/52.0.2723.3 Safari/537.36");
            httpPost.setHeader("Accept-Language", "zh-cn,zh;q=0.5");
            httpPost.setHeader("Accept-Charset", "UTF-8,utf-8;q=0.7,;q=0.7");
            httpPost.setHeader("Connection", "keep-alive");

            MultipartEntityBuilder multipartEntityBuilder = MultipartEntityBuilder.create();
            // 这里是解决中文名乱码的关键，很多地方说设置HttpMultipartMode.BROWSER_COMPATIBLE，到微信这里就不行了
            multipartEntityBuilder.setMode(HttpMultipartMode.RFC6532);
            // 这里是个坑，乱码问题首先想到的是设置编码，可是设置这个之后，微信就报41005错误了。大坑大坑。。具体原因我也不清楚
//          multipartEntityBuilder.setCharset(Consts.UTF_8);
            if(params != null && params.size() > 0){
                for (Map.Entry<String, String> entry : params.entrySet()) {
                    multipartEntityBuilder.addTextBody(entry.getKey(), entry.getValue().toString(), ContentType.create("text/plain", Consts.UTF_8));
                }
            }
            if (files != null && files.size() > 0){
                for (File file : files) {
                    multipartEntityBuilder.addBinaryBody("media", file);
                }
            }
            httpPost.setEntity(multipartEntityBuilder.build());

            response = httpclient.execute(httpPost);
            entity = response.getEntity();
            if (response.getStatusLine().getStatusCode() == 200) {
                result = EntityUtils.toString(response.getEntity());
            }
        }catch(Exception e){
            e.printStackTrace();
        }finally{
            try {
                if(entity != null){
                    EntityUtils.consume(entity);
                }
                if(response != null){
                    response.close();
                }
                if(httpclient != null){
                    httpclient.close();
                }
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
        return result;
    }

    public static void main(String[] args) {
        String access_token = "1zavF25bdA-bunJWhbfM0TNdJyrfonKpCLwBk--TllY232BFXVcCapnNNTAigasb";
        List<File> files = new ArrayList<File>();
        files.add(new File("E:\\中文.txt"));
        String result = uploadFile("https://qyapi.weixin.qq.com/cgi-bin/media/upload?access_token="+access_token+"&type=file", files, null);
        //{"type":"file","media_id":"1cn4gBj-jg6phmUZSqqRjbOYye56CdgPaTmgunfJ7yvhW44yaD-Py0mbA9lyZ6Ckhjli9JKIKibFv8kq385eWhg","created_at":1468382218}
        System.out.println(result);
    }

}

注释部分是重点，网上很多解决方案都试过了，不行，首先想到的是设置编码，结果反而导致上传文件不成功了，微信返回41005之类的错误代码，很多地方说设置HttpMultipartMode.BROWSER_COMPATIBLE，到微信这里就不行了，所以解决中文名乱码的关键代码是multipartEntityBuilder.setMode(HttpMultipartMode.RFC6532);这样上传素材之后拿到的media_id然后去发送消息的时候，中文名就不会乱码了。