java微信接口之三—上传多媒体文件

时间:2021-02-11 21:46:53

一、微信上传多媒体接口简介

  1、请求:该请求是使用post提交from来实现的,我们可以在网页上进行表单提交来实现。地址为:

  http://file.api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

  其中ACCESS_TOKEN是我们动态获取的,TYPE是 媒体文件类型。有以下几种类型:,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb)。

  post提交的数据就是文件本身,其中该文件对应的name值(微信服务器根据该值获取文件,input 标签的name值)为media(规定值)。

  2、响应:该响应也是以json方式返回的

  正确的时候返回的数据:{"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}

  TYPE为我们传递给服务器的类型,media_id就是文件id,created_at表示创建的时间。

  错误的时候返回的数据:{"errcode":40004,"errmsg":"invalid media type"}

  errcode,为错误代码,errmsg为错误信息

  具体api可查看:http://mp.weixin.qq.com/wiki/index.php?title=%E4%B8%8A%E4%BC%A0%E4%B8%8B%E8%BD%BD%E5%A4%9A%E5%AA%92%E4%BD%93%E6%96%87%E4%BB%B6

二、关于java代码的调用

  在前台进行form提交很容易实现,现在要使用java代码进行表达提交,需要使用到commons-httpclient。httpclient之前在apache是作为commons项目的子项目,而以后才升级到apache的*项目。这里需要使用到的就是之前在作为commons子项目的版本,使用的版本为commons-httpclient-3.0。下载地址为:http://archive.apache.org/dist/httpcomponents/commons-httpclient/3.0/binary/

需要引入的jar文件如下:

java微信接口之三—上传多媒体文件

三、代码实现

 import java.io.File;

 import org.apache.commons.httpclient.methods.PostMethod;
import org.apache.commons.httpclient.methods.multipart.FilePart;
import org.apache.commons.httpclient.methods.multipart.MultipartRequestEntity;
import org.apache.commons.httpclient.methods.multipart.Part;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.HttpStatus;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.util.EntityUtils; import com.google.gson.JsonObject;
import com.google.gson.JsonParser; public class Test
{
public static final String GET_TOKEN_URL = "https://api.weixin.qq.com/cgi-bin/token";// 获取access
public static final String UPLOAD_IMAGE_URL = "http://file.api.weixin.qq.com/cgi-bin/media/upload";// 上传多媒体文件
public static final String APP_ID = "wxa549b28c24cf341e";
public static final String SECRET = "78d8a8cd7a4fa700142d06b96bf44a37"; /**
* 上传多媒体文件
*
* @param url
* 访问url
* @param access_token
* access_token
* @param type
* 文件类型
* @param file
* 文件对象
* @return
*/
public static String uploadImage(String url, String access_token,
String type, File file)
{
org.apache.commons.httpclient.HttpClient client = new org.apache.commons.httpclient.HttpClient();
String uploadurl = String.format("%s?access_token=%s&type=%s", url,
access_token, type);
PostMethod post = new PostMethod(uploadurl);
post
.setRequestHeader(
"User-Agent",
"Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9; rv:30.0) Gecko/20100101 Firefox/30.0");
post.setRequestHeader("Host", "file.api.weixin.qq.com");
post.setRequestHeader("Connection", "Keep-Alive");
post.setRequestHeader("Cache-Control", "no-cache");
String result = null;
try
{
if (file != null && file.exists())
{
FilePart filepart = new FilePart("media", file, "image/jpeg",
"UTF-8");
Part[] parts = new Part[] { filepart };
MultipartRequestEntity entity = new MultipartRequestEntity(
parts, post.getParams());
post.setRequestEntity(entity);
int status = client.executeMethod(post);
if (status == HttpStatus.SC_OK)
{
String responseContent = post.getResponseBodyAsString();
JsonParser jsonparer = new JsonParser();// 初始化解析json格式的对象
JsonObject json = jsonparer.parse(responseContent)
.getAsJsonObject();
if (json.get("errcode") == null)// {"errcode":40004,"errmsg":"invalid media type"}
{ // 上传成功 {"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}
result = json.get("media_id").getAsString();
}
}
}
}
catch (Exception e)
{
e.printStackTrace();
}
finally
{
return result;
}
} public static void main(String[] args) throws Exception
{
String accessToken = getToken(GET_TOKEN_URL, APP_ID, SECRET);// 获取token在微信接口之一中的方法获取token
if (accessToken != null)// token成功获取
{
System.out.println(accessToken);
File file = new File("f:" + File.separator + "2000.JPG"); // 获取本地文件
String id = uploadImage(UPLOAD_IMAGE_URL, accessToken, "image",
file);// 上传文件
if (id != null)
System.out.println(id);
}
} }

上传成功就会打印该文件id。