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

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

Android Studio 2.3.3
Android 7.1.1

HttpURLConnection

　
WebサーバとWebクライアント間でデータ送受信を行うために用いられるプロトコル（規約）をHTTPと言います。データの送受信にはGETとPOSTのメソッドがあり用途により使い分けます。
基本的には、両方とも送受信が可能
例えば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

　
基本的な考えたは非同期処理AsyncTaskの使い方にあります。
　
何も考えずにネットにアクセスしてデーターをダウンロードすると例外がでます。
android.os.NetworkOnMainThreadException
at android.os.StrictMode$AndroidBlockGuardPolicy.onNetwork(StrictMode.java:1114)
非同期でアクセスしないといけません。
　
これは android 3.0より前のバージョンではなかったのですがAndroid 3.0 以降で、メインスレッドでネットワーク処理を行うとエラーとなるように変わったようです。
　
基本的な考え方は非同期処理AsyncTaskの使い方にあります。
　
AsyncTask<Params, Progress, Result>を継承したクラスを作っています。このジェネリックの意味は

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

doInBackground(String… params)の
(String… params)は可変長引数といいます
呼出す側では任意の数の String を渡すことが可能
　
ここでは、非同期タスクを別クラスとした冗長的なやり方を少し変えてパラメータをfinalにして、AsyncTask<Void,Void,Void>とする方法でコードをすっきりさせます。
　
MainActivity.java

import android.app.Activity;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.os.AsyncTask;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.ImageView;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;

public class MainActivity extends Activity {

    private ImageView imageView;
    private EditText editText;
    private Button downloadButton;
    private static final String TAG = "MainActivity";

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

        editText = (EditText) findViewById(R.id.uri);
        imageView = (ImageView) findViewById(R.id.result);
        downloadButton = (Button) findViewById(R.id.download);
        downloadButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                taskExe();
            }
        });
    }


    private void taskExe(){
        final String param0 = editText.getText().toString();

        AsyncTask<Void, Void, Void> task = new AsyncTask<Void, Void, Void>(){
            Bitmap bmp;

            @Override
            protected Void doInBackground(Void... params) {
                bmp = downloadImage(param0);
                return null;
            }

            @Override
            protected void onPostExecute(Void result){
                imageView.setImageBitmap(bmp);
            }
        };
        task.execute();
    }

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

        try {
            URL url = new URL( address );

            // HttpURLConnection インスタンス生成
            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 = urlConnection.getInputStream();
                    bmp = BitmapFactory.decodeStream(is);
                    is.close();
                    break;
                case HttpURLConnection.HTTP_UNAUTHORIZED:
                    break;
                default:
                    break;
            }
        } catch (Exception e) {
            Log.d(TAG, "downloadImage error");
            e.printStackTrace();
        }

        return bmp;
    }
}

100

101

102

103

104

import android.app.Activity;

import android.graphics.Bitmap;

import android.graphics.BitmapFactory;

import android.os.AsyncTask;

import android.os.Bundle;

import android.util.Log;

import android.view.View;

import android.widget.Button;

import android.widget.EditText;

import android.widget.ImageView;

import java.io.InputStream;

import java.net.HttpURLConnection;

import java.net.URL;

public class MainActivity extends Activity {

private ImageView imageView;

private EditText editText;

private Button downloadButton;

private static final String TAG = "MainActivity";

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

editText = (EditText) findViewById(R.id.uri);

imageView = (ImageView) findViewById(R.id.result);

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

downloadButton.setOnClickListener(new View.OnClickListener() {

@Override

public void onClick(View v) {

taskExe();

}

});

}

private void taskExe(){

final String param0 = editText.getText().toString();

AsyncTask<Void, Void, Void> task = new AsyncTask<Void, Void, Void>(){

Bitmap bmp;

@Override

protected Void doInBackground(Void... params) {

bmp = downloadImage(param0);

return null;

}

@Override

protected void onPostExecute(Void result){

imageView.setImageBitmap(bmp);

}

};

task.execute();

}

private Bitmap downloadImage(String address) {

Bitmap bmp = null;

try {

URL url = new URL( address );

// HttpURLConnection インスタンス生成

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 = urlConnection.getInputStream();

bmp = BitmapFactory.decodeStream(is);

is.close();

break;

case HttpURLConnection.HTTP_UNAUTHORIZED:

break;

default:

break;

}

} catch (Exception e) {

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

e.printStackTrace();

}

return 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:layout_width="match_parent"
        android:layout_height="wrap_content"
        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="Download" />

    <ImageView
        android:id="@+id/result"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:gravity="center" />

</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:layout_width="match_parent"

android:layout_height="wrap_content"

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="Download" />

<ImageView

android:id="@+id/result"

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:layout_weight="1"

android:gravity="center" />

</LinearLayout>

　
マニフェストに 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>