java微信接口之三—上传多媒体文件
一、微信上传多媒体接口简介
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为错误信息
二、关于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文件如下:
三、代码实现
1 import java.io.File; 2 3 import org.apache.commons.httpclient.methods.PostMethod; 4 import org.apache.commons.httpclient.methods.multipart.FilePart; 5 import org.apache.commons.httpclient.methods.multipart.MultipartRequestEntity; 6 import org.apache.commons.httpclient.methods.multipart.Part; 7 import org.apache.http.HttpEntity; 8 import org.apache.http.HttpResponse; 9 import org.apache.http.HttpStatus; 10 import org.apache.http.client.HttpClient; 11 import org.apache.http.client.methods.HttpGet; 12 import org.apache.http.impl.client.DefaultHttpClient; 13 import org.apache.http.util.EntityUtils; 14 15 import com.google.gson.JsonObject; 16 import com.google.gson.JsonParser; 17 18 public class Test 19 { 20 public static final String GET_TOKEN_URL = "https://api.weixin.qq.com/cgi-bin/token";// 获取access 21 public static final String UPLOAD_IMAGE_URL = "http://file.api.weixin.qq.com/cgi-bin/media/upload";// 上传多媒体文件 22 public static final String APP_ID = "wxa549b28c24cf341e"; 23 public static final String SECRET = "78d8a8cd7a4fa700142d06b96bf44a37"; 24 25 /** 26 * 上传多媒体文件 27 * 28 * @param url 29 * 访问url 30 * @param access_token 31 * access_token 32 * @param type 33 * 文件类型 34 * @param file 35 * 文件对象 36 * @return 37 */ 38 public static String uploadImage(String url, String access_token, 39 String type, File file) 40 { 41 org.apache.commons.httpclient.HttpClient client = new org.apache.commons.httpclient.HttpClient(); 42 String uploadurl = String.format("%s?access_token=%s&type=%s", url, 43 access_token, type); 44 PostMethod post = new PostMethod(uploadurl); 45 post 46 .setRequestHeader( 47 "User-Agent", 48 "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9; rv:30.0) Gecko/20100101 Firefox/30.0"); 49 post.setRequestHeader("Host", "file.api.weixin.qq.com"); 50 post.setRequestHeader("Connection", "Keep-Alive"); 51 post.setRequestHeader("Cache-Control", "no-cache"); 52 String result = null; 53 try 54 { 55 if (file != null && file.exists()) 56 { 57 FilePart filepart = new FilePart("media", file, "image/jpeg", 58 "UTF-8"); 59 Part[] parts = new Part[] { filepart }; 60 MultipartRequestEntity entity = new MultipartRequestEntity( 61 parts, 62 63 post.getParams()); 64 post.setRequestEntity(entity); 65 int status = client.executeMethod(post); 66 if (status == HttpStatus.SC_OK) 67 { 68 String responseContent = post.getResponseBodyAsString(); 69 JsonParser jsonparer = new JsonParser();// 初始化解析json格式的对象 70 JsonObject json = jsonparer.parse(responseContent) 71 .getAsJsonObject(); 72 if (json.get("errcode") == null)// {"errcode":40004,"errmsg":"invalid media type"} 73 { // 上传成功 {"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789} 74 result = json.get("media_id").getAsString(); 75 } 76 } 77 } 78 } 79 catch (Exception e) 80 { 81 e.printStackTrace(); 82 } 83 finally 84 { 85 return result; 86 } 87 } 88 89 public static void main(String[] args) throws Exception 90 { 91 String accessToken = getToken(GET_TOKEN_URL, APP_ID, SECRET);// 获取token在微信接口之一中的方法获取token 92 if (accessToken != null)// token成功获取 93 { 94 System.out.println(accessToken); 95 File file = new File("f:" + File.separator + "2000.JPG"); // 获取本地文件 96 String id = uploadImage(UPLOAD_IMAGE_URL, accessToken, "image", 97 file);// 上传文件 98 if (id != null) 99 System.out.println(id); 100 } 101 } 102 103 }
上传成功就会打印该文件id。