การนำทางแบบมีเงื่อนไข

เมื่อออกแบบการนําทางสําหรับแอป คุณอาจต้องการไปยังปลายทางหนึ่งเทียบกับอีกปลายทางหนึ่งโดยอิงตามตรรกะแบบมีเงื่อนไข เช่น ผู้ใช้อาจติดตาม Deep Link ไปยังปลายทางที่กำหนดให้ผู้ใช้ต้องเข้าสู่ระบบ หรือคุณอาจมีปลายทางที่แตกต่างกันในเกมสำหรับกรณีที่ผู้เล่นชนะหรือแพ้

การเข้าสู่ระบบของผู้ใช้

ในตัวอย่างนี้ ผู้ใช้พยายามไปยังหน้าจอโปรไฟล์ที่ต้องมีการตรวจสอบสิทธิ์ เนื่องจากการดำเนินการนี้ต้องมีการตรวจสอบสิทธิ์ ระบบจึงควรเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าจอเข้าสู่ระบบหากยังไม่ได้ตรวจสอบสิทธิ์

กราฟการนําทางสําหรับตัวอย่างนี้อาจมีลักษณะดังนี้

ขั้นตอนการเข้าสู่ระบบจะได้รับการจัดการแยกต่างหากจากขั้นตอนการนำทางหลักของแอป
รูปที่ 1 ขั้นตอนการเข้าสู่ระบบจะได้รับการจัดการแยกต่างหากจากขั้นตอนการนำทางหลักของแอป

ในการตรวจสอบสิทธิ์ แอปต้องไปที่ login_fragment ซึ่งผู้ใช้สามารถป้อนชื่อผู้ใช้และรหัสผ่านเพื่อตรวจสอบสิทธิ์ได้ หากยอมรับ ระบบจะส่งผู้ใช้กลับไปที่หน้าจอ profile_fragment หากไม่ยอมรับ ระบบจะแจ้งให้ผู้ใช้ทราบว่าข้อมูลเข้าสู่ระบบไม่ถูกต้องโดยใช้ Snackbar หากผู้ใช้กลับไปที่หน้าจอโปรไฟล์โดยไม่ได้เข้าสู่ระบบ ระบบจะนำผู้ใช้ไปยังหน้าจอ main_fragment

กราฟการนำทางสำหรับแอปนี้มีดังนี้

<navigation xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:app="http://schemas.android.com/apk/res-auto"
        xmlns:tools="http://schemas.android.com/tools"
        android:id="@+id/nav_graph"
        app:startDestination="@id/main_fragment">
    <fragment
            android:id="@+id/main_fragment"
            android:name="com.google.android.conditionalnav.MainFragment"
            android:label="fragment_main"
            tools:layout="@layout/fragment_main">
        <action
                android:id="@+id/navigate_to_profile_fragment"
                app:destination="@id/profile_fragment"/>
    </fragment>
    <fragment
            android:id="@+id/login_fragment"
            android:name="com.google.android.conditionalnav.LoginFragment"
            android:label="login_fragment"
            tools:layout="@layout/login_fragment"/>
    <fragment
            android:id="@+id/profile_fragment"
            android:name="com.google.android.conditionalnav.ProfileFragment"
            android:label="fragment_profile"
            tools:layout="@layout/fragment_profile"/>
</navigation>

MainFragment มีปุ่มที่ผู้ใช้คลิกเพื่อดูโปรไฟล์ของตนได้ หากผู้ใช้ต้องการดูหน้าจอโปรไฟล์ ผู้ใช้ต้องตรวจสอบสิทธิ์ก่อน การโต้ตอบนี้จำลองขึ้นโดยใช้ Fragment 2 รายการที่แยกกัน แต่ขึ้นอยู่กับสถานะผู้ใช้ที่แชร์ ข้อมูลสถานะนี้ไม่ได้อยู่ในความรับผิดชอบของ Fragment ทั้ง 2 รายการนี้ และควรเก็บไว้ใน UserViewModel ที่ใช้ร่วมกันมากกว่า ViewModel นี้จะแชร์ระหว่าง Fragment โดยกำหนดขอบเขตเป็นกิจกรรม ซึ่งใช้ ViewModelStoreOwner ในตัวอย่างต่อไปนี้ requireActivity() จะแปลเป็น MainActivity เนื่องจาก MainActivity โฮสต์ ProfileFragment

Kotlin

class ProfileFragment : Fragment() {
    private val userViewModel: UserViewModel by activityViewModels()
    ...
}

Java

public class ProfileFragment extends Fragment {
    private UserViewModel userViewModel;
    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);
        userViewModel = new ViewModelProvider(requireActivity()).get(UserViewModel.class);
        ...
    }
    ...
}

ข้อมูลผู้ใช้ใน UserViewModel จะแสดงโดยใช้ LiveData ดังนั้นหากต้องการตัดสินใจว่าจะไปยังส่วนใด คุณควรสังเกตข้อมูลนี้ เมื่อไปยัง ProfileFragment แอปจะแสดงข้อความต้อนรับหากมีข้อมูลผู้ใช้ หากข้อมูลผู้ใช้เป็น null คุณจะไปยัง LoginFragment เนื่องจากผู้ใช้ต้องตรวจสอบสิทธิ์ก่อนดูโปรไฟล์ของตนเอง กำหนดตรรกะการตัดสินใจใน ProfileFragment ดังที่แสดงในตัวอย่างต่อไปนี้

Kotlin

class ProfileFragment : Fragment() {
    private val userViewModel: UserViewModel by activityViewModels()

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        val navController = findNavController()
        userViewModel.user.observe(viewLifecycleOwner, Observer { user ->
            if (user != null) {
                showWelcomeMessage()
            } else {
                navController.navigate(R.id.login_fragment)
            }
        })
    }

    private fun showWelcomeMessage() {
        ...
    }
}

Java

public class ProfileFragment extends Fragment {
    private UserViewModel userViewModel;

    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);
        userViewModel = new ViewModelProvider(requireActivity()).get(UserViewModel.class);
        final NavController navController = Navigation.findNavController(view);
        userViewModel.user.observe(getViewLifecycleOwner(), (Observer<User>) user -> {
            if (user != null) {
                showWelcomeMessage();
            } else {
                navController.navigate(R.id.login_fragment);
            }
        });
    }

    private void showWelcomeMessage() {
        ...
    }
}

หากข้อมูลผู้ใช้เป็น null เมื่อผู้ใช้เข้าถึง ProfileFragment ระบบจะเปลี่ยนเส้นทางผู้ใช้ไปยัง LoginFragment

คุณสามารถใช้ NavController.getPreviousBackStackEntry เพื่อดึงข้อมูล NavBackStackEntry สำหรับปลายทางก่อนหน้า ซึ่งจะรวมสถานะเฉพาะ NavController สำหรับปลายทางไว้ LoginFragment ใช้ SavedStateHandle ของ NavBackStackEntry ก่อนหน้าเพื่อตั้งค่าเริ่มต้นที่ระบุว่าผู้ใช้เข้าสู่ระบบสำเร็จหรือไม่ นี่คือสถานะที่คุณต้องการแสดงหากผู้ใช้กดปุ่มย้อนกลับของระบบทันที การตั้งค่าสถานะนี้โดยใช้ SavedStateHandle จะช่วยให้มั่นใจได้ว่าสถานะจะยังคงอยู่ตลอดการสิ้นสุดการประมวลผล

Kotlin

class LoginFragment : Fragment() {
    companion object {
        const val LOGIN_SUCCESSFUL: String = "LOGIN_SUCCESSFUL"
    }

    private val userViewModel: UserViewModel by activityViewModels()
    private lateinit var savedStateHandle: SavedStateHandle

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        savedStateHandle = findNavController().previousBackStackEntry!!.savedStateHandle
        savedStateHandle.set(LOGIN_SUCCESSFUL, false)
    }
}

Java

public class LoginFragment extends Fragment {
    public static String LOGIN_SUCCESSFUL = "LOGIN_SUCCESSFUL"

    private UserViewModel userViewModel;
    private SavedStateHandle savedStateHandle;

    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        userViewModel = new ViewModelProvider(requireActivity()).get(UserViewModel.class);

        savedStateHandle = Navigation.findNavController(view)
                .getPreviousBackStackEntry()
                .getSavedStateHandle();
        savedStateHandle.set(LOGIN_SUCCESSFUL, false);
    }
}

เมื่อผู้ใช้ป้อนชื่อผู้ใช้และรหัสผ่าน ระบบจะส่งข้อมูลดังกล่าวไปยัง UserViewModel เพื่อตรวจสอบสิทธิ์ หากการตรวจสอบสิทธิ์สำเร็จ UserViewModel จะจัดเก็บข้อมูลผู้ใช้ จากนั้น LoginFragment จะอัปเดตค่า LOGIN_SUCCESSFUL ใน SavedStateHandle และนำตัวเองออกจาก Back Stack

Kotlin

class LoginFragment : Fragment() {
    companion object {
        const val LOGIN_SUCCESSFUL: String = "LOGIN_SUCCESSFUL"
    }

    private val userViewModel: UserViewModel by activityViewModels()
    private lateinit var savedStateHandle: SavedStateHandle

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        savedStateHandle = findNavController().previousBackStackEntry!!.savedStateHandle
        savedStateHandle.set(LOGIN_SUCCESSFUL, false)

        val usernameEditText = view.findViewById(R.id.username_edit_text)
        val passwordEditText = view.findViewById(R.id.password_edit_text)
        val loginButton = view.findViewById(R.id.login_button)

        loginButton.setOnClickListener {
            val username = usernameEditText.text.toString()
            val password = passwordEditText.text.toString()
            login(username, password)
        }
    }

    fun login(username: String, password: String) {
        userViewModel.login(username, password).observe(viewLifecycleOwner, Observer { result ->
            if (result.success) {
                savedStateHandle.set(LOGIN_SUCCESSFUL, true)
                findNavController().popBackStack()
            } else {
                showErrorMessage()
            }
        })
    }

    fun showErrorMessage() {
        // Display a snackbar error message
    }
}

Java

public class LoginFragment extends Fragment {
    public static String LOGIN_SUCCESSFUL = "LOGIN_SUCCESSFUL"

    private UserViewModel userViewModel;
    private SavedStateHandle savedStateHandle;

    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        userViewModel = new ViewModelProvider(requireActivity()).get(UserViewModel.class);

        savedStateHandle = Navigation.findNavController(view)
                .getPreviousBackStackEntry()
                .getSavedStateHandle();
        savedStateHandle.set(LOGIN_SUCCESSFUL, false);

        EditText usernameEditText = view.findViewById(R.id.username_edit_text);
        EditText passwordEditText = view.findViewById(R.id.password_edit_text);
        Button loginButton = view.findViewById(R.id.login_button);

        loginButton.setOnClickListener(v -> {
            String username = usernameEditText.getText().toString();
            String password = passwordEditText.getText().toString();
            login(username, password);
        });
    }

    private void login(String username, String password) {
        userViewModel.login(username, password).observe(viewLifecycleOwner, (Observer<LoginResult>) result -> {
            if (result.success) {
                savedStateHandle.set(LOGIN_SUCCESSFUL, true);
                NavHostFragment.findNavController(this).popBackStack();
            } else {
                showErrorMessage();
            }
        });
    }

    private void showErrorMessage() {
        // Display a snackbar error message
    }
}

โปรดทราบว่าตรรกะทั้งหมดที่เกี่ยวข้องกับการตรวจสอบสิทธิ์จะอยู่ใน UserViewModel ซึ่งเป็นสิ่งสำคัญ เนื่องจากไม่ใช่ความรับผิดชอบของ LoginFragment หรือ ProfileFragment ในการกำหนดวิธีตรวจสอบสิทธิ์ผู้ใช้ การรวมตรรกะไว้ใน ViewModel ไม่เพียงช่วยให้แชร์ได้ง่ายขึ้น แต่ยังช่วยให้ทดสอบได้ง่ายขึ้นด้วย หากตรรกะการนําทางซับซ้อน คุณควรยืนยันตรรกะนี้ผ่านการทดสอบเป็นพิเศษ ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดโครงสร้างสถาปัตยกรรมของแอปตามคอมโพเนนต์ที่ทดสอบได้ที่คำแนะนำเกี่ยวกับสถาปัตยกรรมของแอป

เมื่อกลับมาที่ ProfileFragment คุณจะเห็นค่า LOGIN_SUCCESSFUL ที่จัดเก็บไว้ใน SavedStateHandle ได้ในเมธอด onCreate() เมื่อผู้ใช้กลับมาที่ ProfileFragment ระบบจะตรวจสอบค่า LOGIN_SUCCESSFUL หากค่าเป็น false ระบบจะเปลี่ยนเส้นทางผู้ใช้กลับไปยัง MainFragment ได้

Kotlin

class ProfileFragment : Fragment() {
    ...

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        val navController = findNavController()

        val currentBackStackEntry = navController.currentBackStackEntry!!
        val savedStateHandle = currentBackStackEntry.savedStateHandle
        savedStateHandle.getLiveData<Boolean>(LoginFragment.LOGIN_SUCCESSFUL)
                .observe(currentBackStackEntry, Observer { success ->
                    if (!success) {
                        val startDestination = navController.graph.startDestination
                        val navOptions = NavOptions.Builder()
                                .setPopUpTo(startDestination, true)
                                .build()
                        navController.navigate(startDestination, null, navOptions)
                    }
                })
    }

    ...
}

Java

public class ProfileFragment extends Fragment {
    ...

    @Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        NavController navController = NavHostFragment.findNavController(this);

        NavBackStackEntry navBackStackEntry = navController.getCurrentBackStackEntry();
        SavedStateHandle savedStateHandle = navBackStackEntry.getSavedStateHandle();
        savedStateHandle.getLiveData(LoginFragment.LOGIN_SUCCESSFUL)
                .observe(navBackStackEntry, (Observer<Boolean>) success -> {
                    if (!success) {
                        int startDestination = navController.getGraph().getStartDestination();
                        NavOptions navOptions = new NavOptions.Builder()
                                .setPopUpTo(startDestination, true)
                                .build();
                        navController.navigate(startDestination, null, navOptions);
                    }
                });
    }

    ...
}

หากผู้ใช้เข้าสู่ระบบสำเร็จ ProfileFragment จะแสดงข้อความต้อนรับ

เทคนิคที่ใช้ที่นี่ในการตรวจสอบผลลัพธ์ช่วยให้คุณแยกความแตกต่างระหว่าง 2 กรณีที่แตกต่างกันได้ ดังนี้

  • กรณีเริ่มต้นที่ผู้ใช้ไม่ได้เข้าสู่ระบบและควรได้รับข้อความแจ้งให้เข้าสู่ระบบ
  • ผู้ใช้ไม่ได้เข้าสู่ระบบเนื่องจากเลือกที่จะไม่เข้าสู่ระบบ (ผลลัพธ์ของ false)

การแยกกรณีการใช้งานเหล่านี้จะช่วยให้คุณไม่ต้องขอให้ผู้ใช้เข้าสู่ระบบซ้ำๆ คุณเป็นผู้กำหนดตรรกะทางธุรกิจสำหรับการจัดการกรณีที่ดำเนินการไม่สำเร็จ ซึ่งอาจรวมถึงการแสดงการวางซ้อนที่อธิบายเหตุผลที่ผู้ใช้ต้องเข้าสู่ระบบ การทำกิจกรรมทั้งหมดให้เสร็จสมบูรณ์ หรือการเปลี่ยนเส้นทางผู้ใช้ไปยังปลายทางที่ไม่ต้องเข้าสู่ระบบ ดังเช่นในตัวอย่างโค้ดก่อนหน้านี้