From fa3691c74549ec562987fbc6e5cd7deae223cca3 Mon Sep 17 00:00:00 2001 From: David Mueller Date: Mon, 24 Oct 2022 16:41:12 -0400 Subject: [PATCH 1/2] add pages #5835 --- modules/ROOT/pages/jakarta-ee10-diff.adoc | 48 +++++++++++++++++++++++ 1 file changed, 48 insertions(+) diff --git a/modules/ROOT/pages/jakarta-ee10-diff.adoc b/modules/ROOT/pages/jakarta-ee10-diff.adoc index b3baedba4e..a990d9b19f 100644 --- a/modules/ROOT/pages/jakarta-ee10-diff.adoc +++ b/modules/ROOT/pages/jakarta-ee10-diff.adoc @@ -335,6 +335,54 @@ The `ELResolver ` `getFeatureDescriptors()` method is deprecated in Expression L The deprecated and misspelled `MethodExpression.isParmetersProvided()` method is removed from the API. +For more information, see the https://jakarta.ee/specifications/expression-language/5.0/apidocs/jakarta.el/module-summary.html[Jakarta Expression Language 5.0 Javadoc]. + +== Differences between Jakarta Pages and 3.1 and 3.0 + +The feature:pages-3.1[display=Jakarta Server Pages 3.1] featutre provides support for the Jakarta Server Pages 3.1 and Jakarta Standard Tag Library 3.0 specifications. This release includes updates for Expression Language identifiers and resolvers, new tag URIs, and more. + +=== Finding unknown identifiers + +A new option is added to find unknown Expression Language identifiers. When this option is enabled, a `PropertyNotFoundException` occur sif an unknown identifier is found. Previously, unknown identifiers were rendered as empty strings (""), and where difficult to identify. You can enable this option by using page directives, tag directives, or as a jsp-property-group in the `web.xml` file. + +To enable this option by using page or tag directives, set the `errorOnELNotFound` attribute to `true`, as shown in the following example. + +---- +<%@ page errorOnELNotFound="true" %> +---- + +To enable this option byn using a JSP Property Group in the `web.xml` file, set the `error-on-el-not-found` element to `true`, as shown oin the following example. + +[source,xml] +---- + + *.jsp + true + +---- + +For more information, see https://jakarta.ee/specifications/pages/3.1/jakarta-server-pages-spec-3.1.html#_Unknown_EL_Identifiers[Unknown EL Identifiers] in the Jakarta Server Pages specification + +=== Namespace updates + +The Jakarta Tag URIs now use the `jakarta.tags.*` pattern. Although support for the previous `\http://xmlns.jcp.org/jsp/jstl/*` pattern is maintained for backwards compatibility, it is recommended to update your applications to use these new URIs. The following example shows the `taglib` directive using the new URIs. + +---- +<%@ taglib prefix="c" uri="jakarta.tags.core" %> +<%@ taglib prefix="x" uri="jakarta.tags.xml" %> +<%@ taglib prefix="fmt" uri="jakarta.tags.fmt" %> +<%@ taglib prefix="fn" uri="jakarta.tags.functions" %>" +<%@ taglib prefix="sql" uri="jakarta.tags.sql" %> +---- +For more information, see the https://jakarta.ee/specifications/tags/3.0/tagdocs/[Jakarta Tags doc]. + +=== Deprecations + +The `isThreadSafe` directive is deprecated due to the removal of the `SingleThreadModel` interface in the Servlet 6.0 API. A workaround is implemented, but significant performance impact might occur. Use of the `isThreadSafe` directive in Pages 3.1 is discouraged. + +The `jsp:plugin`, `jsp:params`, and `jsp:fallback` actions are deprecated and are not operational because current browsers no longer support the elements that are generated by the `jsp:plugin` and related actions. + + == See also From e4ca8b4f5c359c6d64cb5cc552532ee221bd068b Mon Sep 17 00:00:00 2001 From: David Mueller Date: Mon, 24 Oct 2022 16:42:39 -0400 Subject: [PATCH 2/2] Update jakarta-ee10-diff.adoc --- modules/ROOT/pages/jakarta-ee10-diff.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/jakarta-ee10-diff.adoc b/modules/ROOT/pages/jakarta-ee10-diff.adoc index a990d9b19f..6d133bbb94 100644 --- a/modules/ROOT/pages/jakarta-ee10-diff.adoc +++ b/modules/ROOT/pages/jakarta-ee10-diff.adoc @@ -16,7 +16,7 @@ :page-type: general = Differences between Jakarta EE 10.0 and 9.1 -If you are updating your application from using Jakarta EE 9.1 features to using Jakarta EE 10.0 features, changes in API behavior might require you to update your application code. These changes apply to the Jakarta Contexts and Dependency Injection (CDI) and Jakarta RESTful Web Services APIs and the Open Liberty features that support them. +If you are updating your application from using Jakarta EE 9.1 features to using Jakarta EE 10.0 features, changes in API behavior might require you to update your application code. These changes apply to several Jakarta EE APIs and the Open Liberty features that support them. The following sections describe updates for different Jakarta EE 10.0 features