[Android] HttpURLConnection GET で画像をダウンロードする

ネットにHTTPアクセスしてデーターをダウンロードするためには、非同期のAsyncTaskを使い、HttpURLConnectionにて画像を落とします。
　

Android Studio 3.0.1
Android 8.1.0

HttpURLConnection

　
WebサーバとWebクライアント間でデータ送受信を行うために用いられるプロトコル（規約）をHTTPと言います。データの送受信にはGETとPOSTのメソッドがあり用途により使い分けます。
　
非同期など面倒な処理が必要なのですが、実はPicassoといライブラリーを使うと画像のダウンロードは簡単にできてしまいます。大きい画像をダウンロードする例
　

目次
1.POST & GET
2.AsyncTask
3.サンプルコード
4.サンプル動画

POST & GET

　
基本的には、両方とも送受信が可能
例えばGETでは画像が欲しいというリクエストを送信して画像データを受信する。POSTではデータベースの情報をサーバーに保存するために大量のデータを送るなど。以下は両者のザックリとした相違点

GET
- サーバから情報を取得するケースに有効
- データを送信できるのはテキストのみで少量しか送れない
- https://www.google.co.jp/search?q=http+get&oq=http+get&aqs….のようにURLに付加して送信する
POST
- サーバへ情報を登録するケース
- バイナリーデータの送信
- GETでのデータ送信限度を超えてしまう場合
- 送信データをBODY部分に含めて送信できるので制限はない

今回はこのGETのメソッドを使って、サーバーから画像を受け取るケースを考えてみます。
　
Android6.0からApacheのHTTP Clientが基本的に使えなくなりました。Apache HTTP Client Removal

AsyncTask

　
何も考えずにネットにアクセスしてデーターをダウンロードしようとすると例外が出ます。
android.os.NetworkOnMainThreadException
at android.os.StrictMode$AndroidBlockGuardPolicy.onNetwork (StrictMode.java:1114)

非同期でアクセスしないといけません。
これは Android 3.0より前のバージョンではなかったのですが 3.0 以降で、メインスレッドでネットワーク処理を行うとエラーとなるように変わったようです。
　
基本的な考え方は非同期処理AsyncTaskの使い方にあります。
また付随してカスタムListenerも実装します。カスタム Listener を interface を使って実装してみる
　
AsyncTask<Params, Progress, Result>を継承したクラスを作ります。

Params：　doInBackground() バックグラウンド処理の引数
Progress：進捗度合いを表示したい時に使うパラメータ
Result：　onPostExecute() 処理終了時に受け取る型

doInBackground(String… params)の
(String… params)は可変長引数といいます
呼出す側では任意の数の String を渡すことが可能

サンプルコード

　
Listenerを使って作成しました。
　
MainActivity.java

import android.graphics.Bitmap;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.ImageView;

public class MainActivity extends AppCompatActivity {

    private ImageView imageView;
    private EditText etitText;
    private DownloadTask task;

    String param0;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        etitText = findViewById(R.id.uri);
        imageView = findViewById(R.id.result);

        Button downloadButton = findViewById(R.id.download);
        downloadButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {

                param0 = etitText.getText().toString();

                if(param0.length() != 0){
                    // ボタンをタップして非同期処理を開始
                    task = new DownloadTask();
                    // Listenerを設定
                    task.setListener(createListener());
                    task.execute(param0);
                }
            }
        });
    }

    @Override
    protected void onDestroy() {
        task.setListener(null);
        super.onDestroy();
    }

    private DownloadTask.Listener createListener() {
        return new DownloadTask.Listener() {
            @Override
            public void onSuccess(Bitmap bmp) {
                imageView.setImageBitmap(bmp);
            }
        };
    }
}

import android.graphics.Bitmap;

import android.support.v7.app.AppCompatActivity;

import android.os.Bundle;

import android.view.View;

import android.widget.Button;

import android.widget.EditText;

import android.widget.ImageView;

public class MainActivity extends AppCompatActivity {

private ImageView imageView;

private EditText etitText;

private DownloadTask task;

String param0;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

etitText = findViewById(R.id.uri);

imageView = findViewById(R.id.result);

Button downloadButton = findViewById(R.id.download);

downloadButton.setOnClickListener(new View.OnClickListener() {

@Override

public void onClick(View v) {

param0 = etitText.getText().toString();

if(param0.length() != 0){

// ボタンをタップして非同期処理を開始

task = new DownloadTask();

// Listenerを設定

task.setListener(createListener());

task.execute(param0);

}

});

}

@Override

protected void onDestroy() {

task.setListener(null);

super.onDestroy();

}

private DownloadTask.Listener createListener() {

return new DownloadTask.Listener() {

@Override

public void onSuccess(Bitmap bmp) {

imageView.setImageBitmap(bmp);

}

};

}

　
AsyncTaskを実行するクラスです
DownloadTask.java

import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.os.AsyncTask;
import android.util.Log;

import java.io.IOException;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;


public class DownloadTask extends AsyncTask<String, Void, Bitmap> {

    private Listener listener;


    // 非同期処理
    @Override
    protected Bitmap doInBackground(String... params) {

        return downloadImage(params[0]) ;
    }

    // 途中経過をメインスレッドに返す
    @Override
    protected void onProgressUpdate(Void... progress) {
        //working cursor を表示させるようにしてもいいでしょう
    }

    // 非同期処理が終了後、結果をメインスレッドに返す
    @Override
    protected void onPostExecute(Bitmap bmp) {
        if (listener != null) {
            listener.onSuccess(bmp);
        }
    }



    private Bitmap downloadImage(String address) {
        Bitmap bmp = null;

        final StringBuilder result = new StringBuilder();

        HttpURLConnection urlConnection = null;

        try {
            URL url = new URL( address );

            // HttpURLConnection インスタンス生成
            urlConnection = (HttpURLConnection) url.openConnection();

            // タイムアウト設定
            urlConnection.setReadTimeout(10000);
            urlConnection.setConnectTimeout(20000);

            // リクエストメソッド
            urlConnection.setRequestMethod("GET");

            // リダイレクトを自動で許可しない設定
            urlConnection.setInstanceFollowRedirects(false);

            // ヘッダーの設定(複数設定可能)
            urlConnection.setRequestProperty("Accept-Language", "jp");

            // 接続
            urlConnection.connect();

            int resp = urlConnection.getResponseCode();

            switch (resp){
                case HttpURLConnection.HTTP_OK:
                    InputStream is = null;
                    try{
                        is = urlConnection.getInputStream();
                        bmp = BitmapFactory.decodeStream(is);
                        is.close();
                    } catch(IOException e){
                        e.printStackTrace();
                    } finally{
                        if(is != null){
                            is.close();
                        }
                    }
                    break;
                case HttpURLConnection.HTTP_UNAUTHORIZED:
                    break;
                default:
                    break;
            }
        } catch (Exception e) {
            Log.d("debug", "downloadImage error");
            e.printStackTrace();
        } finally {
            if (urlConnection != null) {
                urlConnection.disconnect();
            }
        }

        return bmp;
    }


    void setListener(Listener listener) {
        this.listener = listener;
    }

    interface Listener {
        void onSuccess(Bitmap bmp);
    }
}

100

101

102

103

104

105

106

107

108

109

110

111

import android.graphics.Bitmap;

import android.graphics.BitmapFactory;

import android.os.AsyncTask;

import android.util.Log;

import java.io.IOException;

import java.io.InputStream;

import java.net.HttpURLConnection;

import java.net.URL;

public class DownloadTask extends AsyncTask<String, Void, Bitmap> {

private Listener listener;

// 非同期処理

@Override

protected Bitmap doInBackground(String... params) {

return downloadImage(params[0]) ;

}

// 途中経過をメインスレッドに返す

@Override

protected void onProgressUpdate(Void... progress) {

//working cursor を表示させるようにしてもいいでしょう

}

// 非同期処理が終了後、結果をメインスレッドに返す

@Override

protected void onPostExecute(Bitmap bmp) {

if (listener != null) {

listener.onSuccess(bmp);

}

private Bitmap downloadImage(String address) {

Bitmap bmp = null;

final StringBuilder result = new StringBuilder();

HttpURLConnection urlConnection = null;

try {

URL url = new URL( address );

// HttpURLConnection インスタンス生成

urlConnection = (HttpURLConnection) url.openConnection();

// タイムアウト設定

urlConnection.setReadTimeout(10000);

urlConnection.setConnectTimeout(20000);

// リクエストメソッド

urlConnection.setRequestMethod("GET");

// リダイレクトを自動で許可しない設定

urlConnection.setInstanceFollowRedirects(false);

// ヘッダーの設定(複数設定可能)

urlConnection.setRequestProperty("Accept-Language", "jp");

// 接続

urlConnection.connect();

int resp = urlConnection.getResponseCode();

switch (resp){

case HttpURLConnection.HTTP_OK:

InputStream is = null;

try{

is = urlConnection.getInputStream();

bmp = BitmapFactory.decodeStream(is);

is.close();

} catch(IOException e){

e.printStackTrace();

} finally{

if(is != null){

is.close();

}

break;

case HttpURLConnection.HTTP_UNAUTHORIZED:

break;

default:

break;

}

} catch (Exception e) {

Log.d("debug", "downloadImage error");

e.printStackTrace();

} finally {

if (urlConnection != null) {

urlConnection.disconnect();

}

return bmp;

}

void setListener(Listener listener) {

this.listener = listener;

}

interface Listener {

void onSuccess(Bitmap bmp);

}

　
activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:background="#ffaa88"
    tools:context=".MainActivity">

    <EditText
        android:id="@+id/uri"
        android:inputType="textUri"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="@string/hint"
        android:layout_gravity="center_horizontal" />


    <Button
        android:id="@+id/download"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_horizontal"
        android:text="@string/download" />

    <ImageView
        android:id="@+id/result"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1"
        android:gravity="center"
        android:contentDescription="@string/description"/>

</LinearLayout>

<?xml version="1.0" encoding="utf-8"?>

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

xmlns:tools="http://schemas.android.com/tools"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:orientation="vertical"

android:background="#ffaa88"

tools:context=".MainActivity">

<EditText

android:id="@+id/uri"

android:inputType="textUri"

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:hint="@string/hint"

android:layout_gravity="center_horizontal" />

<Button

android:id="@+id/download"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:layout_gravity="center_horizontal"

android:text="@string/download" />

<ImageView

android:id="@+id/result"

android:layout_width="match_parent"

android:layout_height="0dp"

android:layout_weight="1"

android:gravity="center"

android:contentDescription="@string/description"/>

</LinearLayout>

　
リソースです
strings.xml

<resources>
    <string name="app_name">TestHttpURLConnectionGet</string>
    <string name="hint">input a image url</string>
    <string name="download">download</string>
    <string name="description">image</string>
</resources>

<string name="app_name">TestHttpURLConnectionGet</string>

<string name="hint">input a image url</string>

<string name="download">download</string>

<string name="description">image</string>

</resources>

　
マニフェストに INTERNET のパーミッションを入れるのを忘れずに
AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.testhttpurlconnection">

    <uses-permission android:name="android.permission.INTERNET" >
    </uses-permission>

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

<?xml version="1.0" encoding="utf-8"?>

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

package="com.example.testhttpurlconnection">

<uses-permission android:name="android.permission.INTERNET" >

</uses-permission>

<application

android:allowBackup="true"

android:icon="@mipmap/ic_launcher"

android:label="@string/app_name"

android:supportsRtl="true"

android:theme="@style/AppTheme">

<intent-filter>

</intent-filter>

</activity>

</application>

</manifest>

サンプル動画

例えばここにアクセスするとドロイド君を呼び出せます。https://developer.android.com/_static/0d76052693/images/android/touchicon-180.png?hl=ja

param0 ="https://developer.android.com/_static/0d76052693/images/android/touchicon-180.png?hl=ja";

1	param0 ="https://developer.android.com/_static/0d76052693/images/android/touchicon-180.png?hl=ja";

touchicon 180 - [Android] HttpURLConnection GET で画像をダウンロードする

　
関連ページ：