เมื่อออกแบบการนําทางสําหรับแอป คุณอาจต้องการไปยังปลายทางหนึ่งเทียบกับอีกปลายทางหนึ่งโดยอิงตามตรรกะแบบมีเงื่อนไข เช่น ผู้ใช้อาจติดตาม Deep Link ไปยังปลายทางที่กำหนดให้ผู้ใช้ต้องเข้าสู่ระบบ หรือคุณอาจมีปลายทางที่แตกต่างกันในเกมสำหรับกรณีที่ผู้เล่นชนะหรือแพ้
การเข้าสู่ระบบของผู้ใช้
ในตัวอย่างนี้ ผู้ใช้พยายามไปยังหน้าจอโปรไฟล์ที่ต้องมีการตรวจสอบสิทธิ์ เนื่องจากการดำเนินการนี้ต้องมีการตรวจสอบสิทธิ์ ระบบจึงควรเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าจอเข้าสู่ระบบหากยังไม่ได้ตรวจสอบสิทธิ์
กราฟการนําทางสําหรับตัวอย่างนี้อาจมีลักษณะดังนี้
ในการตรวจสอบสิทธิ์ แอปต้องไปที่ 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)
การแยกกรณีการใช้งานเหล่านี้จะช่วยให้คุณไม่ต้องขอให้ผู้ใช้เข้าสู่ระบบซ้ำๆ คุณเป็นผู้กำหนดตรรกะทางธุรกิจสำหรับการจัดการกรณีที่ดำเนินการไม่สำเร็จ ซึ่งอาจรวมถึงการแสดงการวางซ้อนที่อธิบายเหตุผลที่ผู้ใช้ต้องเข้าสู่ระบบ การทำกิจกรรมทั้งหมดให้เสร็จสมบูรณ์ หรือการเปลี่ยนเส้นทางผู้ใช้ไปยังปลายทางที่ไม่ต้องเข้าสู่ระบบ ดังเช่นในตัวอย่างโค้ดก่อนหน้านี้