Kotlin实现网络图片下载和保存
Posted 振华OPPO
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Kotlin实现网络图片下载和保存相关的知识，希望对你有一定的参考价值。
一、理论基础
- 掌握Kotlin面向对象的软件开发方面的基础知识。
- 巩固前期Activity、UI控件的使用。
- 掌握Handler和Http请求的特点及用法。
二、实验目的
根据android多线程和网络编程的知识讲解和案例使用，使用Handler消息机制实现网络图片下载，并且保存到模拟器中，强化对Android多线程编程、网络编程和文件读写的理解。要求：
- 巩固Android应用开发工具（Android Studio）的常规用法；
- 巩固Activity、UI控件的常规用法；
- 掌握Handler的编程要点；
- 掌握HTTP获取网络资源的方法。
- 掌握文件输入输出流的写法。
三、实验步骤
1、新建工程文件
首先打开Android Studio，新建Project，命名为WebDownload，Language为Kotlin，Minimum SDK选择API 22，然后包名就是com.android.webdownload，回车创建成功，等待下载依赖进行build。
2、引入布局管理
首先在模块的build.gradle中加上下面的闭包，然后同步
buildFeatures
viewBinding true
在MainActivity里面先定义变量，
private lateinit var binding: ActivityMainBinding
在onCreate()方法中，添加如下代码：
binding = ActivityMainBinding.inflate(layoutInflater)
setContentView(binding.root)
这下，我们想访问某个控件，直接通过binding对象获取即可，比如：
binding.tvShow.text = "下载成功！"
3、创建布局
外层父容器选择LinearLayout，内部元素对齐方式选择vertical，从上至下放了一个ProgressBar，设置了max为100，进度条显示下载进度。接着是一个TextView，显示下载信息；ImageView是图片框，显示图片。还有下载图片和终止下载两个按钮在最底下。里面的textSize和textColor这些属性就自定义设置，没什么可讲的。
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity"
android:orientation="vertical">
<ProgressBar
android:id="@+id/progress"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:max="100"
android:layout_marginBottom="20dp"
style="@style/Widget.AppCompat.ProgressBar.Horizontal"/>
<TextView
android:id="@+id/tv_show"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:textSize="20sp"
android:layout_margin="10dp"
android:gravity="center" />
<ImageView
android:id="@+id/iv_show"
android:layout_width="400dp"
android:layout_height="400dp"
android:layout_gravity="center"
android:background="@mipmap/ic_launcher"/>
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal">
<Button
android:id="@+id/btn_download"
android:layout_width="0dp"
android:text="下载图片"
android:layout_margin="10dp"
android:textSize="20sp"
android:padding="10dp"
android:layout_height="match_parent"
android:layout_weight="1"/>
<Button
android:id="@+id/btn_stop"
android:layout_width="0dp"
android:text="终止下载"
android:layout_margin="10dp"
android:textSize="20sp"
android:padding="10dp"
android:layout_height="match_parent"
android:layout_weight="1"/>
</LinearLayout>
</LinearLayout>
来看下简单的布局，实现效果就是点击下载，开始下载网络图片，下载好后显示在图片框上，而且保存到模拟器的存储空间中，下载过程中可以停止下载（如果你的手速比网速快的前提）：
4、访问权限
因为要发送网络请求，所以需要访问网络，因为要保持图片到模拟器，所以要文件读取，还要有向SD卡中创建或者删除的权限。网络是不需要动态申请的，但后面两个权限需要。
<!-- 访问网络的权限 -->
<uses-permission android:name="android.permission.INTERNET"/>
<!-- 文件读取的权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<!-- 向SD卡中创建或者删除的权限。 -->
<uses-permission android:name="andorid.permission.MONUN_UNMOUNT_FILESYSTEMS"/>
动态申请权限的代码：
if (ContextCompat.checkSelfPermission(this, android.Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED)
ActivityCompat.requestPermissions(this, arrayOf(android.Manifest.permission.WRITE_EXTERNAL_STORAGE), 1)
在弹出对话框用户操作之后，返回应用权限请求的结果。requestCode是请求码，permissions是权限列表，grantResults是允许的结果数组。运用if-else分支完成同意权限和不同意的逻辑。
override fun onRequestPermissionsResult(
requestCode: Int,
permissions: Array<out String>,
grantResults: IntArray
)
super.onRequestPermissionsResult(requestCode, permissions, grantResults)
when(requestCode)
1->
if (grantResults.isNotEmpty() &&
grantResults[0] == PackageManager.PERMISSION_GRANTED)
Toast.makeText(this, "你可以正常使用app", Toast.LENGTH_SHORT).show()
else
Toast.makeText(this, "你拒绝了权限，无法正常保存图片", Toast.LENGTH_SHORT).show()
5、实现逻辑
首先也是最核心的就是从网络上下载图片，显然可以用HttpURLConnection或者OkHttp或者其他更好的网络框架，总之就是和url地址创建输入流，读取文件，保存为bitmap格式返回，然后关闭输入流。
// 下载图片，转为位图
fun getImage(imageUrl: String): Bitmap?
var myBitmap:Bitmap? = null
var connection:HttpURLConnection
try
var url = URL(imageUrl)
connection = url.openConnection() as HttpURLConnection
connection.connectTimeout = 8000
connection.doInput = true
connection.useCaches = false
val myInput = connection.inputStream
myBitmap = BitmapFactory.decodeStream(myInput)
myInput.close()
catch (e:Exception)
e.printStackTrace()
return myBitmap;
接下来是保存图片到模拟器外部存储，这一点就是文件的IO流，Java中流的知识太常用了。先定义目录，如果不存在则创建目录。try-catch包围圈里面创建输出流，保存的地址就是在之前的文件夹路径基础上加上了文件名和后缀，然后bitmap按照指定图像格式进行压缩，最后关闭输出流。
// 保存位图到本地路径
private fun saveImage(bitmap:Bitmap?)
var file = File(saveDirs)
// 如果文件不存在则创建目录
if (!file.exists())
if (file.mkdir())
Log.d("test", "mkdir")
else
Log.d("test", "failed")
try
val fileOutputStream = FileOutputStream(savePath)
bitmap?.compress(Bitmap.CompressFormat.PNG, 100, fileOutputStream)
fileOutputStream.close()
catch (e: Exception)
e.printStackTrace()
这里的saveImage和savePath要着重讲下，不然很容易运行后图片无法保存到本地，原来都是路径没有搞清楚的问题。var file = File(saveDirs)是创建文件夹。savePath才是图片的保存路径，如果savePath写的是"\\android\\scared\\0\\storage之类的"那是怎么也访问不了存储空间的。
private val saveDirs:String = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES).toString()
private val savePath:String = saveDirs + File.separator + System.currentTimeMillis() + ".png"
最后就是在子线程中下载网络图片并使用Handler发送message消息了，这段逻辑反而是最简单的部分。可以看到准备下载前和下载完成后都发送message。what分别是0和1。
// 创建下载图片的子线程，准备下载前和下载完成后都发送message
val thread1 = Thread
val message = Message()
message.what = 0
handler.sendMessage(message)
bitmap = getImage(url)
val message2 = Message()
message2.what = 1
handler.sendMessage(message2)
定义全局变量handler来接收自己发给自己的消息，0那就模拟进度条下载进度（因为网络图片的进度无法通过子线程预先获取到，这是后验的）。1就是binding.ivShow.setImageBitmap(bitmap)设置位图，文本为"下载成功！"，提示消息也为"下载已完成"。
val handler:Handler = Handler
when(it.what)
0->
for (i in 0..100) binding.progress.progress = i
1 ->
binding.ivShow.background = null
binding.ivShow.setImageBitmap(bitmap)
saveImage(bitmap)
binding.tvShow.text = "下载成功！"
Toast.makeText(this, "下载已完成", Toast.LENGTH_SHORT).show()
else -> Log.d("Test", "else")
false
;
开始下载按钮就是开启线程，停止下载按钮就是终止线程。
binding.btnDownload.setOnClickListener(
try
thread1.start()
catch (e:Exception)
e.printStackTrace()
)
binding.btnStop.setOnClickListener(
if (thread1.isAlive)
thread1.interrupt()
Toast.makeText(this, "interrupt()", Toast.LENGTH_SHORT).show()
if (!thread1.isAlive)
binding.tvShow.text = "下载终止！"
Toast.makeText(this, "下载已终止", Toast.LENGTH_SHORT).show()
)
完整的MainActivity代码如下：
package com.android.webdownload
import android.content.Context
import android.content.pm.PackageManager
import android.graphics.Bitmap
import android.graphics.BitmapFactory
import android.os.*
import androidx.appcompat.app.AppCompatActivity
import android.util.Log
import android.widget.Toast
import androidx.core.app.ActivityCompat
import androidx.core.content.ContextCompat
import com.android.webdownload.databinding.ActivityMainBinding
import java.io.File
import java.io.FileOutputStream
import java.lang.Exception
import java.lang.ref.WeakReference
import java.net.HttpURLConnection
import java.net.URL
import java.util.jar.Manifest
class MainActivity : AppCompatActivity()
private var bitmap:Bitmap? = null
private lateinit var binding: ActivityMainBinding
private val url:String = "http://e.hiphotos.baidu.com/image/pic/item/4e4a20a4462309f7e41f5cfe760e0cf3d6cad6ee.jpg"
private val saveDirs:String = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES).toString()
private val savePath:String = saveDirs + File.separator + System.currentTimeMillis() + ".png"
val handler:Handler = Handler
when(it.what)
0->
for (i in 0..100) binding.progress.progress = i
1 ->
binding.ivShow.background = null
binding.ivShow.setImageBitmap(bitmap)
saveImage(bitmap)
binding.tvShow.text = "下载成功！"
Toast.makeText(this, "下载已完成", Toast.LENGTH_SHORT).show()
else -> Log.d("Test", "else")
false
;
override fun onCreate(savedInstanceState: Bundle?)
super.onCreate(savedInstanceState)
binding = ActivityMainBinding.inflate(layoutInflater)
setContentView(binding.root)
if (ContextCompat.checkSelfPermission(this, android.Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED)
ActivityCompat.requestPermissions(this, arrayOf(android.Manifest.permission.WRITE_EXTERNAL_STORAGE), 1)
binding.btnDownload.setOnClickListener(
try
thread1.start()
catch (e:Exception)
e.printStackTrace()
)
binding.btnStop.setOnClickListener(
if (thread1.isAlive)
thread1.interrupt()
Toast.makeText(this, "interrupt()", Toast.LENGTH_SHORT).show()
if (!thread1.isAlive)
binding.tvShow.text = "下载终止！"
Toast.makeText(this, "下载已终止", Toast.LENGTH_SHORT).show()
)
override fun onRequestPermissionsResult(
requestCode: Int,
permissions: Array<out String>,
grantResults: IntArray
)
super.onRequestPermissionsResult(requestCode, permissions, grantResults)
when(requestCode)
1->
if (grantResults.isNotEmpty() &&
grantResults[0] == PackageManager.PERMISSION_GRANTED)
Toast.makeText(this, "你可以正常使用app", Toast.LENGTH_SHORT).show()
else
Toast.makeText(this, "你拒绝了权限，无法正常保存图片", Toast.LENGTH_SHORT).show()
// 创建下载图片的子线程，准备下载前和下载完成后都发送message
val thread1 = Thread
val message = Message()
message.what = 0
handler.sendMessage(message)
bitmap = getImage(url)
val message2 = Message(AI开发利器——深度学习框架Caffe-MPI加速比最好
Kotlin 用Retrofit+OkHttp+协程+LiveData搭建MVVM(Jetpack)来实现网络请求(网络数据JSON解析)显示在RecyclerView（更新中）
kotlin 使用CameraX录制视频点击对焦，保存至相册中