नेविगेशन को किसी controller में केंद्रीकृत कैसे करें

उद्देश्य. स्क्रीनों में new X().show() और hide() बिखेरना UI को नेविगेशन ग्राफ़ से जोड़ देता है। एक controller push/pop को केंद्रित करता है, logging/गार्ड के लिए एकल बिंदु देता है और “जड़ तक बंद करने” की अनुमति देता है। यह केवल EventsProcessor के वास्तविक स्टैक को समन्वित करता है।

उपयोग की गई APIs

• Window.show() / Window.hide() — स्टैक पर push/pop (controller केवल इन्हें सौंपता है)।
• EventsProcessor.topWindow() — स्थैतिक मेथड जो शीर्ष की विंडो लौटाता है (instance.windows.peek())।
• EventsProcessor.instance.getLastWindow() — इंस्टेंस मेथड; स्टैक का वास्तविक शीर्ष लौटाता है (या यदि खाली हो तो null)। तब उपयोग करें जब बिना अपवाद फेंके यह जाँचना हो कि कुछ स्टैक पर है या नहीं।

EventsProcessor के स्रोत में पुष्टि किए गए नाम: topWindow() (स्थैतिक) और getLastWindow() (इंस्टेंस)। topWindow() windows.peek() करता है और यदि स्टैक खाली हो तो अपवाद फेंकता है; getLastWindow() उस स्थिति में null लौटाता है — रक्षात्मक जाँच के लिए इसे प्राथमिकता दें।

पूर्ण उदाहरण (कॉपी करें, पेस्ट करें और चलाएँ)

package com.exemplo;

import dev.crossfly.ui.*;
import dev.crossfly.ui.layout.*;

/** मुख्य निष्पादन योग्य स्क्रीन: स्क्रीन स्टैक/अनस्टैक करने के लिए Nav controller का उपयोग करती है। */
public class MainWindow extends Window
{
   @Override
   public void onShow() throws Exception
   {
      super.onShow();
      setLayout(new VerticalLayout());

      add(new Label("Tela raiz"));
      add(new Button("Abrir detalhe").onAction(e -> Nav.push(new OutraTela())));  // controller के जरिए push
   }
}

/** स्टैक की गई स्क्रीन: controller (pop) के जरिए बंद होती है। */
class OutraTela extends Window
{
   @Override
   public void onShow() throws Exception
   {
      super.onShow();
      setLayout(new VerticalLayout());

      add(new Label("Detalhe"));
      add(new Button("Voltar").onAction(e -> Nav.pop()));  // controller के जरिए pop
   }
}

/** Controller: EventsProcessor के असली स्टैक के ऊपर एक पतला मुखौटा। */
final class Nav
{
   private Nav() {}

   /** push: स्टैक करता है और दिखाता है। */
   public static void push(Window w)
   {
      w.show();
   }

   /** pop: यदि कोई हो तो सबसे ऊपर की विंडो बंद करता है। */
   public static void pop()
   {
      Window top = EventsProcessor.instance.getLastWindow();  // null-safe
      if (top != null)
         top.hide();
   }

   /** वर्तमान में सबसे ऊपर की विंडो (null हो सकती है)। */
   public static Window current()
   {
      return EventsProcessor.instance.getLastWindow();
   }
}

नीचे का अंश केवल मुख्य भाग दिखाता है। इसे चलाने के लिए, इसे ऊपर दिए MainWindow ढाँचे में रखें।

न्यूनतम अंश

// स्रोत में सत्यापित: EventsProcessor.topWindow() (static) और instance.getLastWindow() (खाली होने पर null लौटाता है)
public final class Nav
{
   private Nav() {}

   /** push: स्टैक करता है और दिखाता है। */
   public static void push(Window w)
   {
      w.show();
   }

   /** pop: यदि कोई हो तो सबसे ऊपर की विंडो बंद करता है। */
   public static void pop()
   {
      Window top = EventsProcessor.instance.getLastWindow();  // null-safe
      if (top != null)
         top.hide();
   }

   /** केवल 1 विंडो (मूल) बचने तक pop दोहराता है। */
   public static void popToRoot()
   {
      Window top;
      // जब तक एक से अधिक विंडो स्टैक में हों, टॉप को हटाते रहें
      while ((top = EventsProcessor.instance.getLastWindow()) != null
             && top != EventsProcessor.topWindow()) { top.hide(); }
      // ("मूल पर लौटने" के लिए, प्रत्येक hide() एक को अनस्टैक करता है; रुकने की शर्त अपने ऐप के अनुसार समायोजित करें)
   }

   /** वर्तमान में सबसे ऊपर की विंडो (null हो सकती है)। */
   public static Window current()
   {
      return EventsProcessor.instance.getLastWindow();
   }
}

// स्क्रीन में उपयोग:
Nav.push(new DetalheTela());
// ...
Nav.pop();

सर्वोत्तम अभ्यास:

• स्टैक को दोबारा लागू न करें: EventsProcessor पहले से सत्य का स्रोत है। controller show()/hide() पर एक पतला मुखौटा है।
• नेविगेशन गार्ड (जैसे: “क्या असहेजे गए बदलाव हैं?”) यहाँ स्वाभाविक होते हैं: pop() से पहले जाँचें और यदि जरूरी हो तो एक पुष्टिकरण Alert ट्रिगर करें।
• जब स्टैक खाली हो सकता हो तब topWindow() से सावधान रहें — यह peek() करता है और अपवाद फेंकता है। रक्षात्मक कोड के लिए getLastWindow() का उपयोग करें।

और गहराई में जाएँ

• विंडो स्टैक · स्क्रीनों के बीच नेविगेट करें
• सहोदर रेसिपी: किसी स्क्रीन को खोलें और बंद करें