Overslaan naar hoofdinhoud

Upgrade to 25.00

Openen in ChatGPT

Deze documentatie dient als gids voor het upgraden van webforJ-apps van 24.00 naar 25.00. Hier zijn de wijzigingen die nodig zijn voor bestaande apps om soepel te blijven functioneren. Bekijk zoals altijd de GitHub-releasesamenvatting voor een meer uitgebreide lijst van wijzigingen tussen releases.

Jetty 12 webservers​

webforJ 25.00 en hoger maken gebruik van Jetty 12, met de Jakarta EE10 servletarchitectuur. Als je de Jetty Maven-plugin voor ontwikkeling gebruikt, migreer dan van Jakarta EE8 naar Jakarta EE10. Deze upgrade vereist ook het vervangen van alles wat afhankelijk was van het javax.servlet-pakket door het Jakarta.servlet-pakket.

Wijzigingen in het POM-bestand​

Voor

<plugin>
  <groupId>org.eclipse.jetty.ee8</groupId>
  <artifactId>jetty-ee8-maven-plugin</artifactId>
  <version>10.x.xx</version>

Na

<plugin>
  <groupId>org.eclipse.jetty.ee10</groupId>
  <artifactId>jetty-ee10-maven-plugin</artifactId>
  <version>12.x.xx</version>

API-wijzigingen voor de App-klasse​

Verschillende verouderde App-methoden zijn verwijderd in 25.00. De volgende secties schetsen welke methoden zijn vervangen en de aanbevolen vervangingen.

Console-logging​

De utility-klasse BrowserConsole, die is bedoeld voor het maken van gestileerde logs naar de browserconsole, vervangt de consoleLog() en consoleError() methoden. Verkrijg de BrowserConsole door de console() methode te gebruiken:

public class Application extends App{
  
  @Override
  public void run() throws WebforjException {
    console().log("Logbericht");
    console().error("Foutbericht");
  }
}

Webopslag​

Voor versies vóór webforJ 25.00 heeft de App-klasse de methoden getLocalStorage(), getSessionStorage() en getCookieStorage() om instantiën van de klassen LocalStorage, SessionStorage en CookieStorage te verkrijgen. Voortaan heeft elke klasse een getCurrent()-methode.

Zie Webopslag voor meer informatie.

Request-klasse​

De Request-klasse is nu verantwoordelijk voor het verkrijgen van de URL, poort, host en protocol van een app. Gebruik in plaats van App.getUrl() nu App.getCurrent().getUrl(). De getCurrent()-methode vervangt ook de getRequest()-methode om een instantie van de Request-klasse te verkrijgen.

info

De Request-klasse heeft ook verwijderde methoden, ga naar Request om ze te zien.

Page-klasse​

De getPage()-methode is vervangen door Page.getCurrent() om de huidige pagina-instantie te krijgen.

Optiedialogen​

Gebruik in plaats van de msgbox()-methode OptionDialog.showMessageDialog() om berichtendialogen te maken.

App-terminatie​

De cleanup()-methode is verwijderd. Er zijn nu twee methoden voor beëindiging: onWillTerminate() en onDidTerminate().

Zie Hooks voor beëindiging voor meer informatie.

Tabelsortering​

Voor webforJ 25.00 en hoger gebruiken tabellen standaard sortering op één kolom. Kolommen worden alleen gesorteerd op basis van de meest recent geselecteerde kolomkop. Om een tabel meervoudige sortering te laten gebruiken, roep je de setMultiSorting() methode aan:

table.setMultiSorting(true);

Verborgen TabbedPane-lichaam​

De hideBody()-methode is vervangen door setBodyHidden() om een consistente naamgevingsconventie voor methoden te behouden.

Rendering van HTML binnen componenten​

In webforJ 25.00 en hoger is er een setHtml()-methode om te helpen onderscheiden tussen het instellen van letterlijke en HTML-tekst binnen een component. Het instellen van HTML met de setText()-methode is nog steeds mogelijk, maar vereist nu expliciet om het in <html>-tags te wikkelen.

// Geldige gebruiksvoorbeelden van setText() en setHtml()
Button home = new Button();

home.setText("""
  <html>
    <h1>Home</h1>
  </html>
""");

home.setHtml("<h1>Home</h1>");

home.setText("Home");
// Ongeldige gebruiksvoorbeelden van setText() en setHtml()
Button home = new Button();
home.setText("<h1>Home</h1>");

HTML-containers​

Het com.webforj.component.htmlcontainer-pakket is niet langer beschikbaar in webforJ. Gebruik in plaats daarvan het rijkere com.webforj.component.element-pakket. Voor een lijst van webforJ-klassen voor standaard HTML-elementen, ga naar HTML Element Components.

Wijzigingen in Request​

  • Net als de verwijdering van de getCookieStorage()-methode voor de App-klasse, heeft Request niet langer de getCookie()-methode. Dit versterkt het gebruik van CookieStorgage.getCurrent() om een instantie van de CookieStorage-klasse te verkrijgen.

  • De getQueryParam()-methode is nu getQueryParameter().

Wijzigingen in WebforjBBjBridge​

Een instantie van WebforjBBjBridge verkrijgen​

De Environment-klasse heeft niet langer de getWebforjHelper()-methode, dus gebruik in plaats daarvan getBridge().

De ConfirmDialog-component gebruiken voor de msgbox()-methode​

Eerdere versies van webforJ gebruikten strings en gehele getallen rechtstreeks voor de WebforjBBjBridge msgbox()-methode. Berichten voor WebforjBBjBridge in webforJ 25.00 en hoger gebruiken echter de ConfirmDialog component. Dit biedt meer controle over welke knoppen worden weergegeven en het type bericht.

Voor

Environment environment = Environment.getCurrent();
WebforjBBjBridge bridge = environment.getWebforjHelper();

int msgboxResult = bridge.msgbox("Weet je zeker dat je dit bestand wilt verwijderen?", 1, "Verwijdering");

Na

Environment environment = Environment.getCurrent();
WebforjBBjBridge bridge = environment.getBridge();

ConfirmDialog dialog = new ConfirmDialog(
  "Weet je zeker dat je dit bestand wilt verwijderen?", "Verwijdering",
  ConfirmDialog.OptionType.OK_CANCEL, ConfirmDialog.MessageType.QUESTION);

int msgboxResult = bridge.msgbox(dialog);

Typo-correctie PasswordMediation​

De enum-klasse PasswordMediation, die wordt gebruikt om aan te geven of een gebruiker bij elke bezoek aan een app met een Login-component moet inloggen, bevatte een typefout in eerdere webforJ-versies. SILENT vervangt de typefout SILIENT voor webforJ 25.00 en hoger.

Auto-focus methoden​

Om webforJ consistent te houden, hebben methoden zoals setAutofocus() en isAutofocus() nu een uniforme hoofdlettergebruik, net als de HasAutoFocus-interface. Zo gebruiken componenten zoals Dialog en Drawer setAutoFocus() en isAutoFocus() voor 25.00 en hoger.

BBjWindowAdapter en Panel gemarkeerd als final​

De klassen BBjWindowAdapter en Panel zijn nu als final gedeclareerd, wat betekent dat ze niet langer kunnen worden onderverdeeld. Deze wijziging verbetert de stabiliteit en afdwingt consistente gebruikspatronen.