android使用HttpURLConnection实现带参数文件上传

原文地址：http://www.android100.org/html/201508/17/173844.html

文件上传是常见功能，然而android网上大多数的文件上传都使用httpclient，而且需要添加一个httpmine-jar，其实HttpURLConnection也可以实现文件上传，但是它在移动端有个弊端，就是不能上传大文件，所以这次说的方式，只能上传一些较小的文件。

文件上传，并且带上一些参数，这需要我们了解http请求的构造方式，也就是它的格式。

HttpURLConnection需要我们自己构造请求头部，也就是我们要拼接出一个正确完整的请求。

下面来看一个典型的例子

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--

上面的例子中，我们首先看

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功能避免了建立或者重新建立连接

第七行：换行，这个换行是必须的，我们使用 来进行换行

然后就是参数内容部分了，先来看

--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，我们看下一个参数，也是同理

--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--

OK，大家仔细看上面的格式，不能出一点差错，因为格式不对，就上传不了了。

接下来，我们直接看我写的一个带参数文件上传工具类

/**
* 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 =
;

public static void upload(String host,File file,Map params,FileUploadListener listener){
String BOUNDARY = UUID.randomUUID().toString(); //边界标识 随机生成 String PREFIX = -- , LINE_END =
;
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 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> headers);
}
},list,string>,string>

使用方式是这样的：

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 map = new HashMap();
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> headers) {
Log.i(cky, res);
}
});
}
}.start();
}
},>,string>,string>