Routable Apps
Le routage dans webforJ est un outil optionnel. Les développeurs peuvent choisir entre la solution de routage webforJ ou un modèle traditionnel avec manipulation de Frame et sans lien profond. Pour activer le routage, l'annotation @Routify doit être appliquée au niveau d'une classe implémentant App. Cela confère à webforJ l'autorité de gérer l'historique du navigateur, de répondre aux événements de navigation et de rendre les composants de l'application en fonction de l'URL.
Pour en savoir plus sur la création d'interfaces utilisateurs à l'aide de cadres, de composants intégrés et personnalisés, consultez la section Building UIs.
Objectif de l'annotation @Routify
@Routify permet au cadre d'enregistrer automatiquement les routes, de gérer la visibilité des cadres et de définir des comportements de routage tels que le débogage et l'initialisation des cadres, permettant un routage dynamique et flexible dans l'application.
Utilisation de @Routify
L'annotation @Routify est appliquée au niveau de la classe de l'application principale. Elle spécifie l'ensemble des paquets à analyser pour les routes et gère d'autres paramètres liés au routage tels que l'initialisation des cadres et la gestion de la visibilité.
Voici un exemple de base :
@Routify(
packages = {"com.myapp.views"},
defaultFrameName = "MainFrame",
initializeFrame = true,
manageFramesVisibility = false,
debug = true
)
public class MyApp extends App {
@Override
public void run() {
// La logique de l'application va ici
}
}
L'annotation @Routify est fournie avec des configurations par défaut raisonnables. Elle suppose que le paquet actuel dans lequel l'application est définie, ainsi que tous ses sous-paquets, doivent être analysés pour les routes. De plus, elle suppose que l'application gère seulement un cadre par défaut. Si votre application suit cette structure, il n'est pas nécessaire de fournir des configurations personnalisées à l'annotation.
Éléments clés de @Routify
1. packages
L'élément packages définit quels paquets doivent être analysés pour les définitions de route. Il permet la découverte automatique des routes sans enregistrement manuel, facilitant le processus d'expansion du système de routage de l'application.
@Routify(packages = {"com.myapp.views"})
Si aucun paquet n'est spécifié, le paquet par défaut de l'application est utilisé.
2. defaultFrameName
Cet élément spécifie le nom du cadre par défaut que l'application initialise. Les cadres représentent des conteneurs UI de haut niveau, et ce paramètre contrôle comment le premier cadre est nommé et géré.
@Routify(defaultFrameName = "MainFrame")
Par défaut, si ce n'est pas explicitement fourni, la valeur est définie sur Routify.DEFAULT_FRAME_NAME.
3. initializeFrame
Le drapeau initializeFrame détermine si le cadre doit être automatiquement initialisé au démarrage de l'application. Le configurer sur true simplifie le paramétrage initial du cadre.
@Routify(initializeFrame = true)
4. manageFramesVisibility
Cet élément contrôle si le cadre doit automatiquement basculer la visibilité des cadres lors de la navigation. Lorsqu'il est activé, la route correspondante affiche automatiquement le cadre correspondant tout en masquant les autres, garantissant une interface utilisateur propre et ciblée. Ce paramètre est uniquement pertinent lorsque votre application gère plusieurs cadres.
@Routify(manageFramesVisibility = true)
5. debug
Le drapeau debug active ou désactive le mode de débogage du routage. Lorsqu'il est activé, les informations et actions de routage sont enregistrées dans la console pour faciliter le débogage lors du développement.
@Routify(debug = true)
Si le mode de débogage du routeur est défini sur true mais que le mode de débogage webforJ est défini sur false, aucune information de débogage ne sera affichée dans la console.