[Android] HttpURLConnection POST でデータを送信する

サーバーにデーターを送信するため非同期でHttpURLConnection のPOSTを使って送信できます。
　

Android Studio 2.3.3
Android 7.1.1

HttpURLConnection

　
WebサーバとWebクライアント間でデータ送受信を行うために用いられるプロトコル（規約）をHTTPと言います。データの送受信にはGETとPOSTのメソッドがあり用途により使い分けます。

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

GET
- サーバから情報を取得するケースに使うことが多い
- データを送信できるのはテキストのみで少量しか送れない
- URLに付加して送信するので簡単
POST
- サーバへ情報を登録するケース
- バイナリーデータの送信
- GETでのデータ送信限度を超えてしまう場合
- 送信データをBODY部分に含めて送信できるので制限はない

今回はこのPOSTのメソッドを使って、サーバーへデータ送信するケースを考えてみます。
　
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より前のバージョンではなかったのですがAndroid 3.0 以降で、メインスレッドでネットワーク処理を行うとエラーとなるように変わったようです。
　
基本的な考え方は非同期処理AsyncTaskの使い方にあります。
　
AsyncTask<Params, Progress, Result>を継承したクラスを作ります。このジェネリックの意味はそれぞれ

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

doInBackground(String… params)の
(String… params)は可変長引数といいます
呼出す側では任意の数の String を渡すことが可能
　
サーバー側で例えばパスワードのような文字列を受け取りhtmlを生成してそのデータを表示させてみたいと思います。
　
phpファイルで’PassWord’というキーワードで受け取った文字列をそれを含めたhtmlファイルを生成させるコードを作りサーバーに置きます。
pass_check.php

<?php
// バッファリング開始
ob_start();
?>
 
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title></title>
</head>
<body>
<br>
<br>
PassWord =
<?php
echo $_POST['PassWord'];
?>
<br><br><br><br>
</body>
</html>
 
<?php
// 同階層の pass_check.html にphp実行結果を出力
file_put_contents( 'pass_check.html', ob_get_contents() );
 
// 出力用バッファをクリアしてオフ
ob_end_clean();
?>

<?php

// バッファリング開始

ob_start();

<html>

<head>

</head>

<body>

<br>

PassWord =

<?php

echo $_POST['PassWord'];

</body>

</html>

<?php

// 同階層の pass_check.html にphp実行結果を出力

file_put_contents( 'pass_check.html', ob_get_contents() );

// 出力用バッファをクリアしてオフ

ob_end_clean();

　
POST DATAでEditTextで入力した文字列を送信し、BROWSERボタンでChromeなどに飛ばして生成されたhtmlを開いてパスワード文字列を確認する流れで作って見ます。
　
MainActivity.java

import android.content.Intent;
import android.net.Uri;
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.TextView;

public class MainActivity extends AppCompatActivity {

    private TextView textView;
    // passwordを入れる
    private EditText editText;
    // phpがPOSTで受け取ったpasswordを入れて作成するHTMLページ(適宜合わせてください)
    String url = "https://hoge-hoge.com/pass_check.html";

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

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

        Button post = (Button) findViewById(R.id.post);
        post.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                String url = editText.getText().toString();
                // ボタンをタップして非同期処理を開始
                startAsync(url);
            }
        });

        Button browser = (Button) findViewById(R.id.browser);
        browser.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                // phpで作成されたhtmlファイルへアクセス
                Uri uri = Uri.parse(url);
                Intent intent = new Intent(Intent.ACTION_VIEW,uri);
                startActivity(intent);

                // text clear
                textView.setText("");
            }
        });

        textView = (TextView) findViewById(R.id.text_view);
    }

    private void startAsync(String str) {
        TestTask testTask = new TestTask(this);
        // executeを呼んでAsyncTaskを実行する、パラメータは１番目
        testTask.execute(str);
    }

    void setTextView(String str) {
        textView.setText(str);
    }
}

import android.content.Intent;

import android.net.Uri;

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.TextView;

public class MainActivity extends AppCompatActivity {

private TextView textView;

// passwordを入れる

private EditText editText;

// phpがPOSTで受け取ったpasswordを入れて作成するHTMLページ(適宜合わせてください)

String url = "https://hoge-hoge.com/pass_check.html";

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

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

Button post = (Button) findViewById(R.id.post);

post.setOnClickListener(new View.OnClickListener() {

@Override

public void onClick(View v) {

String url = editText.getText().toString();

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

startAsync(url);

}

});

Button browser = (Button) findViewById(R.id.browser);

browser.setOnClickListener(new View.OnClickListener() {

@Override

public void onClick(View v) {

// phpで作成されたhtmlファイルへアクセス

Uri uri = Uri.parse(url);

Intent intent = new Intent(Intent.ACTION_VIEW,uri);

startActivity(intent);

// text clear

textView.setText("");

}

});

textView = (TextView) findViewById(R.id.text_view);

}

private void startAsync(String str) {

TestTask testTask = new TestTask(this);

// executeを呼んでAsyncTaskを実行する、パラメータは１番目

testTask.execute(str);

}

void setTextView(String str) {

textView.setText(str);

}

　
AsyncTaskを継承したクラスでPOSTを実行する部分です
TestTask.java

import android.os.AsyncTask;
import android.util.Log;
import java.io.IOException;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;


public class TestTask extends AsyncTask<String, Void, String> {
    private MainActivity mainActivity;

    // コンストラクター
    public TestTask(MainActivity activity){
        mainActivity = activity;
    }


    // 非同期処理
    @Override
    protected String doInBackground(String... params) {
        // サーバー上のphpのURL(適宜合わせてください)
        String urlSt = "https://hoge-hoge.com/pass_check.php";

        HttpURLConnection con = null;
        String result = null;
        String pass = "PassWord="+params[0];

        try {
            // URL設定
            URL url = new URL(urlSt);

            // HttpURLConnection
            con = (HttpURLConnection) url.openConnection();

            // request POST
            con.setRequestMethod("POST");

            // no Redirects
            con.setInstanceFollowRedirects(false);

            // データを書き込む
            con.setDoOutput(true);

            // 時間制限
            con.setReadTimeout(10000);
            con.setConnectTimeout(20000);

            // 接続
            con.connect();

            // POSTデータ送信処理
            OutputStream out = null;
            try {
                out = con.getOutputStream();
                out.write( pass.getBytes("UTF-8") );
                out.flush();
                Log.d("debug","flush");
            } catch (IOException e) {
                // POST送信エラー
                e.printStackTrace();
                result="POST送信エラー";
            } finally {
                if (out != null) {
                    out.close();
                }
            }

            final int status = con.getResponseCode();
            if (status == HttpURLConnection.HTTP_OK) {
                // レスポンスを受け取る処理等
                result="HTTP_OK";
            }
            else{
                result="status="+String.valueOf(status);
            }

        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            if (con != null) {
                con.disconnect();
            }
        }
        return result;
    }

    // 非同期処理が終了後、結果をメインスレッドに返す
    @Override
    protected void onPostExecute(String result) {
        super.onPostExecute(result);

        mainActivity.setTextView(result);
    }
}

import android.os.AsyncTask;

import android.util.Log;

import java.io.IOException;

import java.io.OutputStream;

import java.net.HttpURLConnection;

import java.net.URL;

public class TestTask extends AsyncTask<String, Void, String> {

private MainActivity mainActivity;

// コンストラクター

public TestTask(MainActivity activity){

mainActivity = activity;

}

// 非同期処理

@Override

protected String doInBackground(String... params) {

// サーバー上のphpのURL(適宜合わせてください)

String urlSt = "https://hoge-hoge.com/pass_check.php";

HttpURLConnection con = null;

String result = null;

String pass = "PassWord="+params[0];

try {

// URL設定

URL url = new URL(urlSt);

// HttpURLConnection

con = (HttpURLConnection) url.openConnection();

// request POST

con.setRequestMethod("POST");

// no Redirects

con.setInstanceFollowRedirects(false);

// データを書き込む

con.setDoOutput(true);

// 時間制限

con.setReadTimeout(10000);

con.setConnectTimeout(20000);

// 接続

con.connect();

// POSTデータ送信処理

OutputStream out = null;

try {

out = con.getOutputStream();

out.write( pass.getBytes("UTF-8") );

out.flush();

Log.d("debug","flush");

} catch (IOException e) {

// POST送信エラー

e.printStackTrace();

result="POST送信エラー";

} finally {

if (out != null) {

out.close();

}

final int status = con.getResponseCode();

if (status == HttpURLConnection.HTTP_OK) {

// レスポンスを受け取る処理等

result="HTTP_OK";

}

else{

result="status="+String.valueOf(status);

}

} catch (IOException e) {

e.printStackTrace();

} finally {

if (con != null) {

con.disconnect();

}

return result;

}

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

@Override

protected void onPostExecute(String result) {

super.onPostExecute(result);

mainActivity.setTextView(result);

}

　
レイアウトファイル
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">

    <LinearLayout
        android:orientation="horizontal"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:gravity="center_horizontal" >
        <TextView
            android:text="@string/pass"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content" />

        <EditText
            android:id="@+id/uri"
            android:inputType="text"
            android:hint="@string/hint"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content" />
    </LinearLayout>

    <LinearLayout
        android:orientation="horizontal"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:gravity="center_horizontal" >
        <Button
            android:id="@+id/post"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_margin="10dp"
            android:text="@string/post" />

        <Button
            android:id="@+id/browser"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_margin="10dp"
            android:text="@string/browser" />

    </LinearLayout>

    <TextView
        android:id="@+id/text_view"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

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

<LinearLayout

android:orientation="horizontal"

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:gravity="center_horizontal" >

<TextView

android:text="@string/pass"

android:layout_width="wrap_content"

android:layout_height="wrap_content" />

<EditText

android:id="@+id/uri"

android:inputType="text"

android:hint="@string/hint"

android:layout_width="wrap_content"

android:layout_height="wrap_content" />

</LinearLayout>

<LinearLayout

android:orientation="horizontal"

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:gravity="center_horizontal" >

<Button

android:id="@+id/post"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:layout_margin="10dp"

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

<Button

android:id="@+id/browser"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:layout_margin="10dp"

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

</LinearLayout>

<TextView

android:id="@+id/text_view"

android:layout_width="wrap_content"

android:layout_height="wrap_content" />

</LinearLayout>

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

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

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

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        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>