文件上传是常见功能,然而Android网上大多数的文件上传都使用httpclient,而且需要添加一个httpmine-jar,其实HttpURLConnection也可以实现文件上传,但是它在移动端有个弊端,就是不能上传大文件,所以这次说的方式,只能上传一些较小的文件。
文件上传,并且带上一些参数,这需要我们了解http请求的构造方式,也就是它的格式。
HttpURLConnection需要我们自己构造请求头部,也就是我们要拼接出一个正确完整的请求。
下面来看一个典型的例子
[java] view plain copy
POST /api/feed/ HTTP/1.1
Accept-Encoding: gzip
Content-Length: 225873
Content-Type: multipart/form-data; boundary=OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp
Host: www.myhost.com
Connection: Keep-Alive
--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp
Content-Disposition: form-data; name="param1"
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
888
--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp
Content-Disposition: form-data; name="param2"
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
"nihao"
--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp
Content-Disposition: form-data; name="images"; filename="/storage/emulated/0/Camera/jdimage/1xh0e3yyfmpr2e35tdowbavrx.jpg"
Content-Type: application/octet-stream
Content-Transfer-Encoding: binary
这里是图片的二进制数据
--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp--
上面的例子中,我们首先看
[java] view plain copy
POST /api/feed/ HTTP/1.1
Accept-Encoding: gzip
Content-Length: 225873
Content-Type: multipart/form-data; boundary=OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp
Host: www.myhost.com
Connection: Keep-Alive
第一行:为POST方式,要请求的子路径为/api/feed/,例如我们的服务器地址为www.myhost.com,然后我们的这个请求的完整路径就是www.myhost.com/api/feed/,最后说明了HTTP协议的版本号为1.1
第二行:数据压缩方式
第三行:数据长度
第四行:multipart/form-data;是指上传的数据类型,这里是指文件形式。boundary是我们必须指定的一个分界符,不同参数之间要用这个分界符隔开。而OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp就是具体的分界符,这个参数我们可以自己随机生成的。
第五行:主机地址
第六行:持久连接,Keep-Alive功能避免了建立或者重新建立连接
第七行:换行,这个换行是必须的,我们使用\r\n来进行换行
然后就是参数内容部分了,先来看
[java] view plain copy
--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp
Content-Disposition: form-data; name="param1"
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
888
我们把上面的看成一个整体
第一行:我要先用分隔符来声明一个参数的开始。注意,分隔符前面还加了两横“--”,这个也是必须加上的!
第二行:name="param1",其实param1就是传递的参数的键值,例如在get方式中,我们这样写http://www.baidu.com?param1=888
第三行:同样是内容格式,不过这次是指定传文本,所以是text/plain; 另外,指定了编码方式charset=UTF-8
第四行:描述的是消息请求(request)和响应(response)所附带的实体对象(entity)的传输形式,简单文本数据我们设置为8bit,文件参数我们设置为binary就行
第五行:换行,这个是必须的!
第六行:参数值,例如http://www.baidu.com?param1=888,就是888
OK,我们看下一个参数,也是同理
[java] view plain copy
--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp
Content-Disposition: form-data; name="param2"
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
"nihao"
然后下一个参数,就是文件了
虽然指定的内容不一样,但是格式是一样的
[java] view plain copy
--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp
Content-Disposition: form-data; name="images"; filename="/storage/emulated/0/Camera/jdimage/1xh0e3yyfmpr2e35tdowbavrx.jpg"
Content-Type: application/octet-stream
Content-Transfer-Encoding: binary
这里是图片的二进制数据
--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp--
OK,大家仔细看上面的格式,不能出一点差错,因为格式不对,就上传不了了。
接下来,我们直接看我写的一个带参数文件上传工具类
[java] view plain copy
/**
* Created by kaiyi.cky on 2015/8/16.
*/
public class FileUploader {
private static final String TAG = "uploadFile";
private static final int TIME_OUT = 10*10000000; //超时时间
private static final String CHARSET = "utf-8"; //设置编码
private static final String PREFIX = "--";
private static final String LINE_END = "\r\n";
public static void upload(String host,File file,Map<String,String> params,FileUploadListener listener){
String BOUNDARY = UUID.randomUUID().toString(); //边界标识 随机生成 String PREFIX = "--" , LINE_END = "\r\n";
String CONTENT_TYPE = "multipart/form-data"; //内容类型
try {
URL url = new URL(host);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setReadTimeout(TIME_OUT);
conn.setConnectTimeout(TIME_OUT);
conn.setRequestMethod("POST"); //请求方式
conn.setRequestProperty("Charset", CHARSET);//设置编码
conn.setRequestProperty("connection", "keep-alive");
conn.setRequestProperty("Content-Type", CONTENT_TYPE + ";boundary=" + BOUNDARY);
conn.setDoInput(true); //允许输入流
conn.setDoOutput(true); //允许输出流
conn.setUseCaches(false); //不允许使用缓存
if(file!=null) {
/** * 当文件不为空,把文件包装并且上传 */
OutputStream outputSteam=conn.getOutputStream();
DataOutputStream dos = new DataOutputStream(outputSteam);
StringBuffer sb = new StringBuffer();
sb.append(LINE_END);
if(params!=null){//根据格式,开始拼接文本参数
for(Map.Entry<String,String> entry:params.entrySet()){
sb.append(PREFIX).append(BOUNDARY).append(LINE_END);//分界符
sb.append("Content-Disposition: form-data; name=\"" + entry.getKey() + "\"" + LINE_END);
sb.append("Content-Type: text/plain; charset=" + CHARSET + LINE_END);
sb.append("Content-Transfer-Encoding: 8bit" + LINE_END);
sb.append(LINE_END);
sb.append(entry.getValue());
sb.append(LINE_END);//换行!
}
}
sb.append(PREFIX);//开始拼接文件参数
sb.append(BOUNDARY); sb.append(LINE_END);
/**
* 这里重点注意:
* name里面的值为服务器端需要key 只有这个key 才可以得到对应的文件
* filename是文件的名字,包含后缀名的 比如:abc.png
*/
sb.append("Content-Disposition: form-data; name=\"img\"; filename=\""+file.getName()+"\""+LINE_END);
sb.append("Content-Type: application/octet-stream; charset="+CHARSET+LINE_END);
sb.append(LINE_END);
//写入文件数据
dos.write(sb.toString().getBytes());
InputStream is = new FileInputStream(file);
byte[] bytes = new byte[1024];
long totalbytes = file.length();
long curbytes = 0;
Log.i("cky","total="+totalbytes);
int len = 0;
while((len=is.read(bytes))!=-1){
curbytes += len;
dos.write(bytes, 0, len);
listener.onProgress(curbytes,1.0d*curbytes/totalbytes);
}
is.close();
dos.write(LINE_END.getBytes());\\一定还有换行
byte[] end_data = (PREFIX+BOUNDARY+PREFIX+LINE_END).getBytes();
dos.write(end_data);
dos.flush();
/**
* 获取响应码 200=成功
* 当响应成功,获取响应的流
*/
int code = conn.getResponseCode();
sb.setLength(0);
BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream()));
String line;
while((line=br.readLine())!=null){
sb.append(line);
}
listener.onFinish(code,sb.toString(),conn.getHeaderFields());
}
} catch (MalformedURLException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
}
public interface FileUploadListener{
public void onProgress(long pro,double precent);
public void onFinish(int code,String res,Map<String,List<String>> headers);
}
}
使用方式是这样的:
[java] view plain copy
public class MainActivity extends FragmentActivity {
File sdDir;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
sdDir = null;
boolean sdCardExist = Environment.getExternalStorageState()
.equals(Environment.MEDIA_MOUNTED); //判断sd卡是否存在
if(sdCardExist) {
sdDir = Environment.getExternalStorageDirectory();//获取跟目录
}
final HashMap<String,String> map = new HashMap<String,String>();
map.put("aa","bb");
new Thread(){
@Override
public void run() {
FileUploader.upload("上传地址", new File(sdDir.getPath() + "/文件名"), map, new FileUploader.FileUploadListener() {
@Override
public void onProgress(long pro, double precent) {
Log.i("cky", precent+"");
}
@Override
public void onFinish(int code, String res, Map<String, List<String>> headers) {
Log.i("cky", res);
}
});
}
}.start();
}
}