微信企业号上传下载多媒体文件接口详解演示-java

阅读更多

企业在使用接口时，对多媒体文件、多媒体消息的获取和调用等操作，是通过media_id来进行的。通过本接口，企业可以上传或下载多媒体文件。

 

注意，每个多媒体文件（media_id）会在上传到微信服务器3天后自动删除，以节省服务器资源

 

上传媒体文件：

 

/**
 * 上传媒体文件
 * @param accessToken 接口访问凭证
 * @param type 媒体文件类型，分别有图片（image）、语音（voice）、视频（video），普通文件(file)
 * @param media form-data中媒体文件标识，有filename、filelength、content-type等信息
 * @param mediaFileUrl 媒体文件的url
 * 上传的媒体文件限制
    * 图片（image）:1MB，支持JPG格式
    * 语音（voice）：2MB，播放长度不超过60s，支持AMR格式
    * 视频（video）：10MB，支持MP4格式
    * 普通文件（file）：10MB
 * */
public static WeixinMedia uploadMedia(String accessToken, String type, String mediaFileUrl) {
    WeixinMedia weixinMedia = null;
    // 拼装请求地址
    String uploadMediaUrl = "https://qyapi.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE";
    uploadMediaUrl = uploadMediaUrl.replace("ACCESS_TOKEN", accessToken).replace("TYPE", type);

    // 定义数据分隔符
    String boundary = "------------7da2e536604c8";
    try {
        URL uploadUrl = new URL(uploadMediaUrl);
        HttpURLConnection uploadConn = (HttpURLConnection) uploadUrl.openConnection();
        uploadConn.setDoOutput(true);
        uploadConn.setDoInput(true);
        uploadConn.setRequestMethod("POST");
        // 设置请求头Content-Type
        uploadConn.setRequestProperty("Content-Type", "multipart/form-data;boundary=" + boundary);
        // 获取媒体文件上传的输出流（往微信服务器写数据）
        OutputStream outputStream = uploadConn.getOutputStream();

        URL mediaUrl = new URL(mediaFileUrl);
        HttpURLConnection meidaConn = (HttpURLConnection) mediaUrl.openConnection();
        meidaConn.setDoOutput(true);
        meidaConn.setRequestMethod("GET");

        // 从请求头中获取内容类型
        String contentType = meidaConn.getHeaderField("Content-Type");
        // 根据内容类型判断文件扩展名
        String fileExt = WeixinUtil.getFileEndWitsh(contentType);
        // 请求体开始
        outputStream.write(("--" + boundary + "\r\n").getBytes());
        outputStream.write(String.format("Content-Disposition: form-data; name=\"media\"; filename=\"file1%s\"\r\n", fileExt).getBytes());
        outputStream.write(String.format("Content-Type: %s\r\n\r\n", contentType).getBytes());

        // 获取媒体文件的输入流（读取文件）
        BufferedInputStream bis = new BufferedInputStream(meidaConn.getInputStream());
        byte[] buf = new byte[8096];
        int size = 0;
        while ((size = bis.read(buf)) != -1) {
            // 将媒体文件写到输出流（往微信服务器写数据）
            outputStream.write(buf, 0, size);
        }
        // 请求体结束
        outputStream.write(("\r\n--" + boundary + "--\r\n").getBytes());
        outputStream.close();
        bis.close();
        meidaConn.disconnect();

        // 获取媒体文件上传的输入流（从微信服务器读数据）
        InputStream inputStream = uploadConn.getInputStream();
        InputStreamReader inputStreamReader = new InputStreamReader(inputStream, "utf-8");
        BufferedReader bufferedReader = new BufferedReader(inputStreamReader);
        StringBuffer buffer = new StringBuffer();
        String str = null;
        while ((str = bufferedReader.readLine()) != null) {
            buffer.append(str);
        }
        bufferedReader.close();
        inputStreamReader.close();
        // 释放资源
        inputStream.close();
        inputStream = null;
        uploadConn.disconnect();

        // 使用JSON-lib解析返回结果
        JSONObject jsonObject = JSONObject.fromObject(buffer.toString());
        // 测试打印结果
        System.out.println("打印测试结果"+jsonObject);
        weixinMedia = new WeixinMedia();
        weixinMedia.setType(jsonObject.getString("type"));
        // type等于 缩略图（thumb） 时的返回结果和其它类型不一样
        if ("thumb".equals(type))
            weixinMedia.setMediaId(jsonObject.getString("thumb_media_id"));
        else
            weixinMedia.setMediaId(jsonObject.getString("media_id"));
            weixinMedia.setCreatedAt(jsonObject.getInt("created_at"));
    } catch (Exception e) {
        weixinMedia = null;
        String error = String.format("上传媒体文件失败：%s", e);
        System.out.println(error);
    }
    return weixinMedia;
}

下载媒体文件：

 

 

/**
     * 获取媒体文件
     * @param accessToken 接口访问凭证
     * @param media_id 媒体文件id
     * @param savePath 文件在服务器上的存储路径
     * */
    public static String downloadMedia(String accessToken, String mediaId, String savePath) {
        String filePath = null;
        // 拼接请求地址
        String requestUrl = "https://qyapi.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID";
        requestUrl = requestUrl.replace("ACCESS_TOKEN", accessToken).replace("MEDIA_ID", mediaId);
        System.out.println(requestUrl);
        try {
            URL url = new URL(requestUrl);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setDoInput(true);
            conn.setRequestMethod("GET");

            if (!savePath.endsWith("/")) {
                savePath += "/";
            }
            // 根据内容类型获取扩展名
            String fileExt = WeixinUtil.getFileEndWitsh(conn.getHeaderField("Content-Type"));
            // 将mediaId作为文件名
            filePath = savePath + mediaId + fileExt;

            BufferedInputStream bis = new BufferedInputStream(conn.getInputStream());
            FileOutputStream fos = new FileOutputStream(new File(filePath));
            byte[] buf = new byte[8096];
            int size = 0;
            while ((size = bis.read(buf)) != -1)
                fos.write(buf, 0, size);
            fos.close();
            bis.close();

            conn.disconnect();
            String info = String.format("下载媒体文件成功，filePath=" + filePath);
            System.out.println(info);
        } catch (Exception e) {
            filePath = null;
            String error = String.format("下载媒体文件失败：%s", e);
            System.out.println(error);
        }
        return filePath;
    }

main 示例：

 

 

//示例
public static void main(String[] args) {
    /**
     * 上传多媒体文件
     */
    String access_token = WeixinUtil.getAccessToken(ParamesAPI.corpId, ParamesAPI.secret).getToken();
    //地址
    WeixinMedia weixinMedia = uploadMedia(access_token, "image", "http://localhost:8080/weixinClient/images/weather3.jpg");
    //media_id
    System.out.println("media_id："+weixinMedia.getMediaId());
    //类型
    System.out.println("类型："+weixinMedia.getType());
    //时间戳
    System.out.println("时间戳："+weixinMedia.getCreatedAt());
    //打印结果
    if(null!=weixinMedia){
        System.out.println("上传成功！");
    }else{
        System.out.println("上传失败！");
    }

    System.out.println("分割线*******************************************************************************************");
    /**
     * 下载多媒体文件
     */
    String savePath = downloadMedia(access_token, weixinMedia.getMediaId(), "E:/download");
    System.out.println("下载成功之后保存在本地的地址为："+savePath);

}

本地测试打印结果图：

 

 

下载成功之后保存到本地的图片地址图片：