DIV CSS 佈局教程網

startActivityForResult 跨 Activity 傳值:請求碼與結果碼的正確用法
編輯:JavaScript綜合知識     

Android 中要在 Activity 之間回傳資料,startActivityForResult() 是最經典的做法。但很多人會遇到「回呼永遠不觸發」或「不知道資料是哪來的」的問題,關鍵就在於兩個碼:requestCode 與 resultCode。

兩個碼的分工

  • requestCode(請求碼):呼叫 startActivityForResult() 時傳入的第二個參數,用來標示「這次請求是誰發出的」。
  • resultCode(結果碼):由被開啟的 Activity 透過 setResult() 設定,用來標示「資料是誰送回來的」。

一、主 Activity 接收回傳值

package com.google_acmer.activitys;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;

public class MainActivity extends Activity {
    private final static String TAG = "MainActivity";

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        Button btnOpen = (Button) this.findViewById(R.id.btnOpen);
        btnOpen.setOnClickListener(new View.OnClickListener() {
            public void onClick(View v) {
                // 第二個參數為請求碼,可依業務需求自行編號
                startActivityForResult(new Intent(MainActivity.this, OtherActivity.class), 1);
            }
        });
    }

    /**
     * 為了取得回傳資料,必須在前一個 Activity(MainActivity)中覆寫 onActivityResult
     * requestCode:呼叫 startActivityForResult() 時傳入的值
     * resultCode:結果碼,用於標識資料來自哪個 Activity
     */
    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        String result = data.getExtras().getString("result");
        Log.i(TAG, result);
    }
}

二、被開啟的 Activity 回傳資料

package com.google_acmer.activitys;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;

public class OtherActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.other);
        Button btnClose = (Button) findViewById(R.id.btnClose);
        btnClose.setOnClickListener(new View.OnClickListener() {
            public void onClick(View v) {
                // 資料透過 Intent 回傳
                Intent intent = new Intent();
                intent.putExtra("result", "My name is gu");
                // setResult 的第一個參數可依業務需要自訂
                setResult(RESULT_OK, intent);
                finish();
            }
        });
    }
}

請求碼解決什麼問題

想像一個 Activity 有兩個按鈕,都會開啟同一個 Activity。新頁面關閉後,系統一律呼叫前頁的 onActivityResult()。若要區分「是哪顆按鈕開的」並做不同處理,就靠請求碼:

@Override
public void onCreate(Bundle savedInstanceState) {
    // ...
    button1.setOnClickListener(new View.OnClickListener() {
        public void onClick(View v) {
            startActivityForResult(new Intent(MainActivity.this, NewActivity.class), 1);
        }
    });
    button2.setOnClickListener(new View.OnClickListener() {
        public void onClick(View v) {
            startActivityForResult(new Intent(MainActivity.this, NewActivity.class), 2);
        }
    });
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    switch (requestCode) {
        case 1:
            // 來自按鈕 1 的請求,做相應處理
            break;
        case 2:
            // 來自按鈕 2 的請求,做相應處理
            break;
    }
}

結果碼解決什麼問題

同一個 Activity 若會開啟多個不同 Activity,回來時也要能分辨來源,這時用結果碼:

public class ResultActivity extends Activity {
    // ...
    ResultActivity.this.setResult(1, intent);
    ResultActivity.this.finish();
}

public class NewActivity extends Activity {
    // ...
    NewActivity.this.setResult(2, intent);
    NewActivity.this.finish();
}

public class MainActivity extends Activity {
    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        switch (resultCode) {
            case 1:
                // ResultActivity 回傳的資料
                break;
            case 2:
                // NewActivity 回傳的資料
                break;
        }
    }
}

回呼「立刻觸發」或「不觸發」怎麼辦

這個問題常讓人卡很久,根因往往在 launchMode 上。實測可歸納為兩種情況:

  • resultCode == 0 時:Activity 的 launchMode 必須設為 singleTask 或 singleInstance,否則會出錯。原因是從 Task 角度看,Android 認為不同 Task 之間的 Activity 無法傳遞資料,因此不能使用 NEW_TASK 標識,但仍需呼叫 forResult 版本的方法。
  • resultCode != 0 時:launchMode 必須為 standard(即不設定 launchMode 屬性),原因同上。

除了 launchMode,實務上另外兩個常見原因是:忘記在子 Activity 呼叫 setResult() 就 finish(此時回傳的是 RESULT_CANCELED),以及在 onActivityResult 中沒有先判斷 resultCode == RESULT_OK 就直接取 data.getExtras(),因而拿到 null。

現代寫法

若你在新專案上開發,AndroidX 提供了 Activity Result API,不再需要自己處理 requestCode 的 if-else:

private final ActivityResultLauncher<Intent> launcher =
    registerForActivityResult(new ActivityResultContracts.StartActivityForResult(), result -> {
        if (result.getResultCode() == Activity.RESULT_OK && result.getData() != null) {
            String value = result.getData().getStringExtra("result");
        }
    });

// 啟動
launcher.launch(new Intent(this, OtherActivity.class));

這種寫法把回呼綁在啟動器上,型別安全、也免去了 switch-case 與 requestCode 常數管理的麻煩。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved