升级到 25.00
本文件作为将 webforJ 应用从 24.00 升级到 25.00 的指南。这里列出了现有应用程序所需的更改，以继续顺利运行。与往常一样，请参阅 GitHub 发布概述 以获取版本间更改的更全面列表。
Jetty 12 web 服务器
webforJ 25.00 及更高版本使用 Jetty 12，采用 Jakarta EE10 servlet 架构。如果您在开发中使用 Jetty Maven 插件，请从 Jakarta EE8 迁移到 Jakarta EE10。此升级还需要将所有依赖 javax.servlet 包的内容替换为 Jakarta.servlet 包。
POM 文件更改
之前
<plugin>
<groupId>org.eclipse.jetty.ee8</groupId>
<artifactId>jetty-ee8-maven-plugin</artifactId>
<version>10.x.xx</version>
之后
<plugin>
<groupId>org.eclipse.jetty.ee10</groupId>
<artifactId>jetty-ee10-maven-plugin</artifactId>
<version>12.x.xx</version>
App 类的 API 更改
在 25.00 中，几个已弃用的 App 方法被移除。以下部分概述了被替换的方法和推荐的替代方案。
控制台日志记录
专门用于创建样式化日志到浏览器控制台的工具类 BrowserConsole 替换了 consoleLog() 和 consoleError() 方法。通过使用 console() 方法获取 BrowserConsole：
public class Application extends App{
@Override
public void run() throws WebforjException {
console().log("日志信息");
console().error("错误信息");
}
}
Web 存储
对于 webforJ 25.00 之前的版本，App 类具有方法 getLocalStorage()、getSessionStorage() 和 getCookieStorage()，分别用于获取 LocalStorage、SessionStorage 和 CookieStorage 类的实例。从现在开始，每个类都有一个 getCurrent() 方法。
有关更多信息，请参见 Web Storage。
Request 类
Request 类现在负责获取应用程序的 URL、端口、主机和协议。因此，使用 App.getUrl() 的地方请改为使用 App.getCurrent().getUrl()。getCurrent() 方法还替代 getRequest() 方法以获取 Request 类的实例。
Request 类也已移除的方法，请跳转到 Request 查看。
Page 类
getPage() 方法被 Page.getCurrent() 替代，以获取当前页面实例。
选项对话框
请使用 OptionDialog.showMessageDialog() 创建消息对话框，而不是使用 msgbox() 方法。
应用程序终止
cleanup() 方法已被移除。现在有两个终止方法 onWillTerminate() 和 onDidTerminate()。
有关更多信息，请参见 Hooks for termination。
表格排序
对于 webforJ 25.00 及更高版本，表格默认使用单列排序。列将仅按最近选定的列标题进行排序。要使表格使用多列排序，请调用 setMultiSorting() 方法：
table.setMultiSorting(true);
隐藏的 TabbedPane 主体
hideBody() 方法被 setBodyHidden() 替代，以保持方法命名的一致性。
在组件内渲染 HTML
在 webforJ 25.00 及更高版本中，有一个 setHtml() 方法，以帮助区分在组件内设置文本和 HTML 文本。仍然可以使用 setText() 方法设置 HTML，但现在需要明确用 <html> 标签来包裹。
// setText() 和 setHtml() 的有效用法
Button home = new Button();
home.setText("""
<html>
<h1>首页</h1>
</html>
""");
home.setHtml("<h1>首页</h1>");
home.setText("首页");
// setText() 和 setHtml() 的无效用法
Button home = new Button();
home.setText("<h1>首页</h1>");
HTML 容器
com.webforj.component.htmlcontainer 包在 webforJ 中不再使用。请改用功能更丰富的 com.webforj.component.element 包。有关标准 HTML 元素的 webforJ 类列表，请访问 HTML Element Components。
Request 更改
-
就像
App类中getCookieStorage()方法的移除一样，Request也不再有getCookie()方法。这加强了使用CookieStorage.getCurrent()获取CookieStorage类实例的做法。 -
getQueryParam()方法现在改为getQueryParameter()。
WebforjBBjBridge 更改
获取 WebforjBBjBridge 实例
Environment 类不再具有 getWebforjHelper() 方法，因此请改用 getBridge()。
使用 ConfirmDialog 组件替代 msgbox() 方法
以前版本的 webforJ 直接使用字符串和整数来调用 WebforjBBjBridge 的 msgbox() 方法。然而，在 webforJ 25.00 及更高版本中，WebforjBBjBridge 的消息使用 ConfirmDialog 组件。这提供了更大的控制权来选择显示哪些按钮和消息类型。
之前
Environment environment = Environment.getCurrent();
WebforjBBjBridge bridge = environment.getWebforjHelper();
int msgboxResult = bridge.msgbox("您确定要删除此文件吗？", 1, "删除");
之后
Environment environment = Environment.getCurrent();
WebforjBBjBridge bridge = environment.getBridge();
ConfirmDialog dialog = new ConfirmDialog(
"您确定要删除此文件吗？", "删除",
ConfirmDialog.OptionType.OK_CANCEL, ConfirmDialog.MessageType.QUESTION);
int msgboxResult = bridge.msgbox(dialog);
PasswordMediation 拼写修正
枚举类 PasswordMediation 用于指示用户是否在每次访问应用程序时都需登录，之前的 webforJ 版本中存在拼写错误。SILENT 替代了拼写错误的 SILIENT，适用于 webforJ 25.00 及更高版本。
自动聚焦方法
为了保持 webforJ 的一致性，setAutofocus() 和 isAutofocus() 等方法现在具有与 HasAutoFocus 接口一致的大小写。因此，像 Dialog 和 Drawer 等组件在 25.00 及更高版本中使用 setAutoFocus() 和 isAutoFocus()。
BBjWindowAdapter 和 Panel 被标记为 final
BBjWindowAdapter 和 Panel 类现在被声明为 final，这意味着它们不再能够被子类化。此更改提高了稳定性并强化了一致的使用模式。
