android使用HttpURLConnection实现带参数文件上传-原创手记-慕课网

文件上传是常见功能，然而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();
}
}

原文链接：http://www.apkbus.com/blog-896840-63473.html