欢迎访问 生活随笔！
TAG聚合

生活随笔

当前位置： 首页 > 编程资源 > 编程问答 >内容正文

编程问答

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

发布时间：2025/3/15 编程问答 46 豆豆
生活随笔 收集整理的这篇文章主要介绍了 android使用HttpURLConnection/HttpClient实现带参数文件上传 小编觉得挺不错的,现在分享给大家,帮大家做个参考.

本文参考自【http://blog.csdn.net/crazy__chen/article/details/47703781】

在Android 2.3及以上版本，使用的是HttpURLConnection，而在Android 2.2及以下版本，使用的是HttpClient
HttpClient
DefaultHttpClient和它的兄弟AndroidHttpClient都是HttpClient具体的实现类，它们都拥有众多的API，而且实现比较稳定，bug数量也很少。
但同时也由于HttpClient的API数量过多，使得我们很难在不破坏兼容性的情况下对它进行升级和扩展，所以目前Android团队在提升和优化HttpClient方面的工作态度并不积极。
HttpURLConnection
HttpURLConnection是一种多用途、轻量极的HTTP客户端，使用它来进行HTTP操作可以适用于大多数的应用程序。虽然HttpURLConnection的API提供的比较简单，但是同时这也使得我们可以更加容易地去使用和扩展它。
不过在Android 2.2版本之前，HttpURLConnection一直存在着一些令人厌烦的bug。比如说对一个可读的InputStream调用close()方法时，就有可能会导致连接池失效了。那么我们通常的解决办法就是直接禁用掉连接池的功能：
private void disableConnectionReuseIfNecessary() {
// 这是一个2.2版本之前的bug
if (Integer.parseInt(Build.VERSION.SDK) < Build.VERSION_CODES.FROYO) {
System.setProperty("http.keepAlive", "false");
}

}

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

在Android 2.3版本的时候，我们加入了更加透明化的响应压缩。HttpURLConnection会自动在每个发出的请求中加入如下消息头，并处理相应的返回结果： 
Accept-Encoding: gzip
配置你的Web服务器来支持对客户端的响应进行压缩的功能，从而可以在这一改进上获取到最大的好处。如果在压缩响应的时候出现了问题，这篇文档会告诉你如何禁用掉这个功能。
但是如果启动了响应压缩的功能，HTTP响应头里的Content-Length就会代表着压缩后的长度，这时再使用getContentLength()方法来取出解压后的数据就是错误的了。正确的做法应该是一直调用InputStream.read()方法来读取响应数据，一直到出现-1为止。
我们在Android 2.3版本中还增加了一些HTTPS方面的改进，现在HttpsURLConnection会使用SNI(Server Name Indication)的方式进行连接，使得多个HTTPS主机可以共享同一个IP地址。除此之外，还增加了一些压缩和会话的机制。如果连接失败，它会自动去尝试重新进行连接。这使得HttpsURLConnection可以在不破坏老版本兼容性的前提下，更加高效地连接最新的服务器。
在Android 4.0版本中，我们又添加了一些响应的缓存机制。当缓存被安装后(调用HttpResponseCache的install()方法)，所有的HTTP请求都会满足以下三种情况：
所有的缓存响应都由本地存储来提供。因为没有必要去发起任务的网络连接请求，所有的响应都可以立刻获取到。
视情况而定的缓存响应必须要有服务器来进行更新检查。比如说客户端发起了一条类似于 “如果/foo.png这张图片发生了改变，就将它发送给我” 这样的请求，服务器需要将更新后的数据进行返回，或者返回一个304 Not Modified状态。如果请求的内容没有发生，客户端就不会下载任何数据。
没有缓存的响应都是由服务器直接提供的。这部分响应会在稍后存储到响应缓存中。
由于这个功能是在4.0之后的版本才有的，通常我们就可以使用反射的方式来启动响应缓存功能。下面的示例代码展示了如何在Android 4.0及以后的版本中去启用响应缓存的功能，同时还不会影响到之前的版本：

在当前Android 6.0 版本已经删除了HttpClient相关API，写相应程序时建议大家选择HttpConnection.

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

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

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

下面来看一个典型的例子

[java] view plaincopy
  • 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 plaincopy
  • 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 plaincopy
  • --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 plaincopy
  • --OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp  
  • Content-Disposition: form-data; name="param2"  
  • Content-Type: text/plain; charset=UTF-8  
  • Content-Transfer-Encoding: 8bit  
  •   
  • "nihao"  

    • 然后下一个参数，就是文件了

    虽然指定的内容不一样，但是格式是一样的

    [java] view plaincopy
  • --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 plaincopy
  • /** 
  •  * 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 plaincopy
  • 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();          
  •     }     
  • }  

    • 总结

    以上是生活随笔为你收集整理的android使用HttpURLConnection/HttpClient实现带参数文件上传的全部内容，希望文章能够帮你解决所遇到的问题。

    如果觉得生活随笔网站内容还不错，欢迎将生活随笔推荐给好友。