Ga naar hoofdinhoud

Defining Routes

Open in ChatGPT

Definiëren van routes is essentieel voor het koppelen van URL's aan specifieke componenten. Dit stelt je in staat om te bepalen hoe verschillende onderdelen van je UI worden weergegeven op basis van de URL-structuur. Het framework gebruikt de @Route annotatie om dit proces declaratief en eenvoudig te maken, waardoor de behoefte aan handmatige configuratie wordt verminderd.

Routes Registratie

Routes kunnen statisch worden geregistreerd met behulp van de @Route annotatie of dynamisch via de RouteRegistry API. Voor meer informatie, zie de Routes Registratie documentatie.

Een route definiëren met @Route​

De @Route annotatie wordt gebruikt om een URL-pad aan een specifieke component te binden. Dit stelt de component in staat om te worden weergegeven wanneer de app naar die URL navigeert. Hier is een eenvoudig voorbeeld:

@Route(value = "dashboard")
public class DashboardView extends Composite<Div> {
  // Component logica hier
}

In dit voorbeeld:

  • De DashboardView component is gebonden aan de /dashboard URL.
  • Wanneer een gebruiker naar /dashboard navigeert, zal de DashboardView dynamisch worden weergegeven door het framework.

De value parameter​

De value parameter in de @Route annotatie definieert het URL-pad. Dit kan een statisch pad zijn zoals "dashboard" of meer dynamisch, waardoor flexibele routing mogelijk is.

@Route(value = "user/:id")
public class UserView extends Composite<Div> {
  // Component logica hier
}

In dit geval zal navigeren naar /user/123 de UserView weergeven.

Route Patronen

De user/:id staat bekend als een routepatroon. De router kan zowel eenvoudige patronen aan, die een enkele statische segment matchen, als complexe patronen, die meerdere statische, vereiste en optionele segmenten kunnen matchen. Voor meer informatie over het configureren van patronen, zie de diepgaande uitleg over route patronen.

Route-aliases definiëren​

In sommige gevallen wil je misschien meerdere URL's toestaan die naar dezelfde component verwijzen. Bijvoorbeeld, je wilt gebruikers mogelijk maken om hun profiel te bereiken via zowel /profile als /user/me. webforJ staat dit toe via de @RouteAlias annotatie, waarmee je meerdere aliassen voor een enkele route kunt definiëren.

Hier is een voorbeeld waarin de component toegankelijk is via zowel /profile als /user/me:

@Route(value = "profile")
@RouteAlias("user/me")
public class UserProfileView extends Composite<Div> {
  // Component logica hier
}

Het definiëren van route-aliases vergroot de flexibiliteit in je navigatieontwerp, waardoor gebruikers dezelfde inhoud via verschillende URL's kunnen bereiken.