Android Fragment 中實現接口回調：正確實例化 OnConnectingToInternet 避免空指針

問題場景

FragmentActivity 定義接口 OnConnectingToInternet，Fragment 需調用該接口顯示/隱藏 ProgressBar。直接強轉 Activity 導致崩潰或 NPE。

錯誤代碼分析

// Fragment 中
private OnConnectingToInternet onConnectingToInternet;

@Override
public void onAttach(Activity activity) {
    super.onAttach(activity);
    // 錯誤1：Activity 未實現接口 → ClassCastException
    // 錯誤2：未賦值 → 後續調用 NPE
    onConnectingToInternet = (OnConnectingToInternet) activity; 
}

標準解決方案：Fragment 實現接口，Activity 作為中介

步驟 1：定義接口

public interface OnNetworkListener {
    void showProgress(boolean show);
}

步驟 2：Fragment 定義回調接口，持有 Listener 引用

public class TopRecipesFragment extends Fragment {
    private OnNetworkListener networkListener;

    // 標準回調設置方法
    public void setNetworkListener(OnNetworkListener listener) {
        this.networkListener = listener;
    }

    private class MyAsyncTask extends AsyncTask<Void, Void, Boolean> {
        @Override
        protected void onPreExecute() {
            if (networkListener != null) {
                networkListener.showProgress(true);
            }
        }
        // ... doInBackground / onPostExecute 同理
    }
}

步驟 3：Activity 實現接口並註冊給 Fragment

public class MainScreen extends FragmentActivity implements OnNetworkListener {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 獲取 Fragment 實例 (從 FragmentManager 或 ViewPager)
        TopRecipesFragment fragment = (TopRecipesFragment) getSupportFragmentManager()
            .findFragmentById(R.id.fragment_container);
        if (fragment != null) {
            fragment.setNetworkListener(this); // 關鍵：註冊回調
        }
    }

    @Override
    public void showProgress(boolean show) {
        if (show) progressBar.setVisibility(View.VISIBLE);
        else progressBar.setVisibility(View.GONE);
    }
}

進階方案：共享 ViewModel (推薦現代架構)

// SharedViewModel.kt
class SharedViewModel : ViewModel() {
    val networkState = MutableLiveData<Boolean>()
}

// Activity
val model = ViewModelProvider(this).get(SharedViewModel::class.java)
model.networkState.observe(this) { show ->
    progressBar.visibility = if (show) View.VISIBLE else View.GONE
}

// Fragment
val model = ViewModelProvider(requireActivity()).get(SharedViewModel::class.java)
// 需顯示時
model.networkState.postValue(true)

優點：生命周期感知、無記憶體洩漏、跨 Fragment 通訊、配置變更存活。

另一種模式：Fragment 直接實現接口 (適用簡單場景)

若接口邏輯極簡且只在 Fragment 內部用：

public class TopRecipesFragment extends Fragment implements OnNetworkListener {
    @Override
    public void showProgress(boolean flag) {
        // 直接操作 Fragment 視圖或通過 getActivity() 找 Activity 控件
        if (getActivity() instanceof MainScreen) {
            ((MainScreen) getActivity()).updateProgress(flag);
        }
    }
}

核心原則總結

1. 不要在 onAttach 中強轉 Activity 為接口：耦合度高、易崩潰、違反職責分離
2. Fragment 定義 Listener 接口，Activity 實現並註冊：標準回調模式
3. 新專案優先用 Shared ViewModel + LiveData：解耦、響應式、生命周期安全
4. 設置 Listener 時檢查非空：if (listener != null) 防禦性編程