[Android] Button のonClickListenerの設定が色々できる件

ButtonのsetOnClickListenerですが、匿名クラスを使ったりと色々やり方があるようです。それぞれ良し悪しが個々の状況によってあると思います。すぐに使えるように確認して見ました。

Android Studio 4.1
API 30

Button onClickListner

　
このサイトでのButton Clickのリスナーは匿名クラスを多用していますが、他にも方法があります。規模が大きなprojectになれば使い方も変えた方がメンテナンスしやすくなります。
　

目次
1. 匿名クラス
2. 変数でまとめる
3. OnClickListener を implementsして onClick を定義
4. カスタムクラスを作成
5. android:onClick
6. 5種類のButton Click

匿名クラス

　
Googleの Button Reference に紹介されているやり方で、メソッド内でクラスを定義する匿名（無名）クラスを使います。ボタンが１、２個であればこれで済ませることが多いですね。

MainActivity.java

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;

public class MainActivity extends AppCompatActivity{

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

        final Button button1 = findViewById(R.id.button_1);
        // lambda式
        button1.setOnClickListener( v -> {
                Log.d("debug", "button1, Perform action on click");
        });

        final Button button2 = findViewById(R.id.button_2);
        // lambda式
        button2.setOnClickListener( v -> {
                Log.d("debug","button2, Perform action on click");
        });

    }
}

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;

import android.util.Log;

import android.view.View;

import android.widget.Button;

public class MainActivity extends AppCompatActivity{

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

final Button button1 = findViewById(R.id.button_1);

// lambda式

button1.setOnClickListener( v -> {

Log.d("debug", "button1, Perform action on click");

});

final Button button2 = findViewById(R.id.button_2);

// lambda式

button2.setOnClickListener( v -> {

Log.d("debug","button2, Perform action on click");

});

}

　
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:gravity="center"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/button_1"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="button 1" />

    <Button
        android:id="@+id/button_2"
        android:layout_margin="10dp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="button 2" />

</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:gravity="center"

tools:context=".MainActivity">

<Button

android:id="@+id/button_1"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:text="button 1" />

<Button

android:id="@+id/button_2"

android:layout_margin="10dp"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:text="button 2" />

</LinearLayout>

変数でまとめる

単純に見やすくするには、これを変数に置き換えてしまうやり方があります
MainActivity.java

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;


public class MainActivity extends AppCompatActivity{

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

        final Button button1 = findViewById(R.id.button_1);
        button1.setOnClickListener(buttonClick);

        final Button button2 = findViewById(R.id.button_2);
        button2.setOnClickListener(buttonClick);

    }

    private View.OnClickListener buttonClick = new View.OnClickListener() {
        @Override
        public void onClick(View view) {
            switch (view.getId()) {
                case R.id.button_1:
                    Log.d("debug","button1, Perform action on click");
                    break;
                case R.id.button_2:
                    Log.d("debug","button2, Perform action on click");
                    break;
            }
        }
    };
}

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;

import android.util.Log;

import android.view.View;

import android.widget.Button;

public class MainActivity extends AppCompatActivity{

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

final Button button1 = findViewById(R.id.button_1);

button1.setOnClickListener(buttonClick);

final Button button2 = findViewById(R.id.button_2);

button2.setOnClickListener(buttonClick);

}

private View.OnClickListener buttonClick = new View.OnClickListener() {

@Override

public void onClick(View view) {

switch (view.getId()) {

case R.id.button_1:

Log.d("debug","button1, Perform action on click");

break;

case R.id.button_2:

Log.d("debug","button2, Perform action on click");

break;

}

};

}

　
レイアウトは同じです。

OnClickListener を implementsして onClick を定義

　
匿名クラスとしない場合はどうするかというと、OnClickListenerをimplementsします。するとpublic void onClick(View view){}というメソッドを作るようにように要求されます。

MainActivity.java

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;

public class MainActivity extends AppCompatActivity implements View.OnClickListener {

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

        final Button button1 = findViewById(R.id.button_1);
        button1.setOnClickListener(this);

        final Button button2 = findViewById(R.id.button_2);
        button2.setOnClickListener(this);
    }

    public void onClick(View view){
        if(view.getId() == R.id.button_1) {
            Log.d("debug","button1, Perform action on click");
        }
        else if(view.getId() == R.id.button_2) {
            Log.d("debug","button2, Perform action on click");
        }
    }
}

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;

import android.util.Log;

import android.view.View;

import android.widget.Button;

public class MainActivity extends AppCompatActivity implements View.OnClickListener {

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

final Button button1 = findViewById(R.id.button_1);

button1.setOnClickListener(this);

final Button button2 = findViewById(R.id.button_2);

button2.setOnClickListener(this);

}

public void onClick(View view){

if(view.getId() == R.id.button_1) {

Log.d("debug","button1, Perform action on click");

}

else if(view.getId() == R.id.button_2) {

Log.d("debug","button2, Perform action on click");

}

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:gravity="center"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/button_1"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="button 1" />

    <Button
        android:id="@+id/button_2"
        android:layout_margin="10dp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="button 2" />

</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:gravity="center"

tools:context=".MainActivity">

<Button

android:id="@+id/button_1"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:text="button 1" />

<Button

android:id="@+id/button_2"

android:layout_margin="10dp"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:text="button 2" />

</LinearLayout>

　
ボタンクリックでの処理を１か所にまとめられるので可読性が上がるかもしれません。
　

カスタムクラスを作成

　
メソッドでクリックを受けていますが、カスタムクラスにしてしまうこともできます。その場合は、OnClickListenerを継承したクラスとします。

MainActivity.java

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;

public class MainActivity extends AppCompatActivity{

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

        final Button button1 = findViewById(R.id.button_1);
        button1.setOnClickListener(new buttonClick());

        final Button button2 = findViewById(R.id.button_2);
        button2.setOnClickListener(new buttonClick());

    }
}

class buttonClick implements View.OnClickListener {
    @Override
    public void onClick(View view) {
        if(view.getId() == R.id.button_1) {
            Log.d("debug","button1, Perform action on click");
        }    
        else if(view.getId() == R.id.button_2) {
            Log.d("debug","button2, Perform action on click");
        } 
    }   
}

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;

import android.util.Log;

import android.view.View;

import android.widget.Button;

public class MainActivity extends AppCompatActivity{

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

final Button button1 = findViewById(R.id.button_1);

button1.setOnClickListener(new buttonClick());

final Button button2 = findViewById(R.id.button_2);

button2.setOnClickListener(new buttonClick());

}

class buttonClick implements View.OnClickListener {

@Override

public void onClick(View view) {

if(view.getId() == R.id.button_1) {

Log.d("debug","button1, Perform action on click");

}

else if(view.getId() == R.id.button_2) {

Log.d("debug","button2, Perform action on click");

}

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:gravity="center"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/button_1"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="button 1" />

    <Button
        android:id="@+id/button_2"
        android:layout_margin="10dp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="button 2" />

</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:gravity="center"

tools:context=".MainActivity">

<Button

android:id="@+id/button_1"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:text="button 1" />

<Button

android:id="@+id/button_2"

android:layout_margin="10dp"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:text="button 2" />

</LinearLayout>

android:onClick

　
XMLレイアウトの中でandroid:onClickを定義してメソッドを実行させるケースです。これもGoogleのReferenceで紹介されています。
　

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;
import android.view.View;

public class MainActivity extends AppCompatActivity{

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

    public void selfDestruct(View view) {
        if(view.getId() == R.id.button_1) {
            Log.d("debug","button1, Perform action on click");
        }
        else if(view.getId() == R.id.button_2) {
            Log.d("debug","button2, Perform action on click");
        }
    }
}

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;

import android.util.Log;

import android.view.View;

public class MainActivity extends AppCompatActivity{

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

}

public void selfDestruct(View view) {

if(view.getId() == R.id.button_1) {

Log.d("debug","button1, Perform action on click");

}

else if(view.getId() == R.id.button_2) {

Log.d("debug","button2, Perform action on click");

}

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:gravity="center"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/button_1"
        android:onClick="selfDestruct"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="button 1" />

    <Button
        android:id="@+id/button_2"
        android:onClick="selfDestruct"
        android:layout_margin="10dp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="button 2" />

</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:gravity="center"

tools:context=".MainActivity">

<Button

android:id="@+id/button_1"

android:onClick="selfDestruct"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:text="button 1" />

<Button

android:id="@+id/button_2"

android:onClick="selfDestruct"

android:layout_margin="10dp"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:text="button 2" />

</LinearLayout>

　
ActivityのコードにはButtonのインスタンスもありません、これが気持ち悪いと感じるかどうかです。Fragmentではうまくつかえるのでしょうか…

5種類のButton Click

　
この５種類をテストするコードを書いてみました。
MainActivity.java

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;

public class MainActivity extends AppCompatActivity implements View.OnClickListener {

    private TextView textView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        textView = findViewById(R.id.text_view);

        // 匿名クラス
        final Button button0 = findViewById(R.id.button_0);
        button0.setOnClickListener( v -> {
                String str = getString(R.string.bt0);
                textView.setText(str);
        });
        // 変数でまとめる
        final Button button1 = findViewById(R.id.button_1);
        button1.setOnClickListener(buttonClick);

        // OnClickListener を implementsして onClick を定義
        final Button button2 = findViewById(R.id.button_2);
        button2.setOnClickListener(this);

        // カスタムクラス
        final Button button3 = findViewById(R.id.button_3);
        button3.setOnClickListener(new BtClick());

    }


    // 変数でまとめる
    private View.OnClickListener buttonClick = new View.OnClickListener() {
        @Override
        public void onClick(View view) {
            if (view.getId() == R.id.button_1) {
                String str = getString(R.string.bt1);
                textView.setText(str);
            }
        }
    };

    // OnClickListener を implementsして onClick を定義
    public void onClick(View view){
        if (view.getId() ==  R.id.button_2) {
            String str = getString(R.string.bt2);
            textView.setText(str);
        }
    }

    // カスタムクラス
    class BtClick implements View.OnClickListener {
        @Override
        public void onClick(View view) {
            if (view.getId() == R.id.button_3) {
                String str = getString(R.string.bt3);
                textView.setText(str);
            }
        }
    }

    // android:onClick
    public void selfDestruct(View view) {
        String str = getString(R.string.bt4);
        textView.setText(str);
    }
}

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;

import android.view.View;

import android.widget.Button;

import android.widget.TextView;

public class MainActivity extends AppCompatActivity implements View.OnClickListener {

private TextView textView;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

textView = findViewById(R.id.text_view);

// 匿名クラス

final Button button0 = findViewById(R.id.button_0);

button0.setOnClickListener( v -> {

String str = getString(R.string.bt0);

textView.setText(str);

});

// 変数でまとめる

final Button button1 = findViewById(R.id.button_1);

button1.setOnClickListener(buttonClick);

// OnClickListener を implementsして onClick を定義

final Button button2 = findViewById(R.id.button_2);

button2.setOnClickListener(this);

// カスタムクラス

final Button button3 = findViewById(R.id.button_3);

button3.setOnClickListener(new BtClick());

}

// 変数でまとめる

private View.OnClickListener buttonClick = new View.OnClickListener() {

@Override

public void onClick(View view) {

if (view.getId() == R.id.button_1) {

String str = getString(R.string.bt1);

textView.setText(str);

}

};

// OnClickListener を implementsして onClick を定義

public void onClick(View view){

if (view.getId() == R.id.button_2) {

String str = getString(R.string.bt2);

textView.setText(str);

}

// カスタムクラス

class BtClick implements View.OnClickListener {

@Override

public void onClick(View view) {

if (view.getId() == R.id.button_3) {

String str = getString(R.string.bt3);

textView.setText(str);

}

// android:onClick

public void selfDestruct(View view) {

String str = getString(R.string.bt4);

textView.setText(str);

}

　
リソース
strings.xml

<resources>
    <string name="app_name">Your App Name</string>
    <string name="bt0">Button 0</string>
    <string name="bt1">Button 1</string>
    <string name="bt2">Button 2</string>
    <string name="bt3">Button 3</string>
    <string name="bt4">Button 4</string>
</resources>

<string name="bt0">Button 0</string>

<string name="bt1">Button 1</string>

<string name="bt2">Button 2</string>

<string name="bt3">Button 3</string>

<string name="bt4">Button 4</string>

</resources>

　
　
References:
Button