The Apache Struts 7.5.0 test build is available. This release contains breaking changes alongside new features, improvements, bug fixes and dependency upgrades:
Breaking changes - Action mapping uses the servlet path and path info reported by the container, so the REST plugin's ;edit URL form is gone (use /edit) and tests that drive Struts with a mock request must set the servlet path, not only the request URI [WW-5842]. - The Fetch Metadata check rejects cross-site POST navigations (for example SAML or OIDC form_post responses and payment-provider returns) with a 403, while cross-site HEAD navigations are accepted; exemptedPaths or fetchMetadata.disabled are the opt-outs [WW-5753, WW-5754]. - exemptedPaths on the fetchMetadata, coop and coep interceptors is compared with the request path inside the application, extension included (/saml/acs.action), and an entry equal to the context path no longer disables the interceptor app-wide; use the disabled parameter for that [WW-5846]. - Method-level HTTP method annotations (@HttpGet, @HttpPost, …) are enforced on the implicit execute() method and are inherited from superclasses and interfaces, and the REST plugin's restDefaultStack and the Bean Validation plugin's beanValidationDefaultStack now contain the httpMethod interceptor [WW-5844]. - The httpMethod interceptor checks the HTTP method of the request itself, so a REST update() or destroy() reached from a POST form through _method needs @HttpPost next to @HttpPut or @HttpDelete [WW-5844]. - A request rejected by the httpMethod interceptor with no resolvable bad-request result receives 405 Method Not Allowed with an Allow header instead of a "No result defined" error, and unit tests that run the interceptor by hand must give MockActionProxy an ActionConfig [WW-3717]. - java.beans, java.lang.reflect and java.lang.invoke are part of the default struts.excludedPackageNames (and of the devMode list); an application that reads such objects in expressions re-allows them through struts.excludedPackageExemptClasses [WW-5838]. - OGNL 3.4.17 matches property names exactly, so an expression relying on a mis-cased name (URANGE for setuRange()) throws NoSuchPropertyException instead of binding [WW-5837]. - @StrutsParameter accessors are resolved the way OGNL resolves them (setuRange for uRange, getURL() for both uRL.x and URL.x), and case variants of an accessor name bind nothing [WW-5759]. - With struts.parameters.requireAnnotations=true, the AliasInterceptor request-parameter fallback requires @StrutsParameter on the target property, and a value copied from the value stack follows struts.chaining.requireAnnotations [WW-5758]. - The parameter authorizer judges the first object in the value stack that would take the write, so a ModelDriven request no longer binds settable properties of objects below the action, such as the system TextProvider, and a ModelDriven to ModelDriven chain stops binding the previous model's unannotated properties [WW-5820]. - Parameter value filters (excludedValuePatterns, acceptedValuePatterns and ParameterValueAware) check every value of a repeated parameter, not only the first [WW-5829]. - REST plugin: @StrutsParameter depth is counted per nested container level for request bodies, as for request parameters, so List<List<Bean>>, Map<String, List<Bean>> or Bean[][] properties may need a depth one higher [WW-5833]. - REST plugin: the two-phase body copy no longer overwrites a value bound from request parameters with a constructor default, so a body value equal to the constructor default is not applied [WW-5790]. - NumberConverter rejects a numeric string longer than 1000 characters as a conversion error [WW-5834]. - A BigDecimal with more than 340 integer digits is rendered in scientific notation by String conversion, the number tag and message arguments, and such a value no longer round-trips through a form [WW-5828, WW-5836]. - execAndWait re-stores only a transaction token validated through TokenHelper in the same request [WW-5765]. - String input is trimmed before conversion to a non-String type: " true " converts to true, " x" to 'x', and blank input becomes null for boxed Boolean, numbers, enums and java.time types, so the required validator now reports it [WW-3666]. - A date input with text after the value is rejected instead of being truncated to midnight, and the protected DateConverter#selectFormat lost its lenient fallback [WW-5812]. - A date-time value under a date-only global format keeps its time [WW-5813]. - With HTML5 constraints enabled, type="date" controls get min/max from the date and localdate validators, temporal controls get required, and a field with its own step no longer gets a derived min on any control [WW-5811]. - A StrutsHtmlConstraintProvider subclass overriding the four-argument constraintsFor is bypassed; override the five-argument overload [WW-5811]. - A UIBean component built without the container must have setScopedConstantProvider(...) called, like setCspNonceReader [WW-5768]. - ScopedConstantProvider gains getValue(String, PackageConfig), ConventionUnknownHandler.determinePath changed its signature, and ConventionsServiceImpl subclasses overriding the one-argument determineResultPath must override the two-argument forms [WW-5770]. - The actionExtension interceptor joins basicStack, paramsPrepareParamsStack and defaultStack, and a hand-built Component, ServletActionRedirectResult or PostbackResult needs an ActionExtensionResolver injected [WW-4164]. - The transfer-select, updownselect and combobox tags no longer render inline event handlers: an application serving its own static files must update optiontransferselect.js and inputtransferselect.js together with the templates, and button.onclick() no longer triggers the framework action [WW-5772]. - The page-global autoPopulate_<id>() function of the combobox tag is gone; dispatch a change event on the select instead [WW-5774]. - The JavaTemplates plugin HTML-escapes dynamic attributes and evaluates them as expressions only for lazy-evaluation components, as the simple theme does [WW-5823]. - A JSONP callback name that is not a dotted identifier of at most 128 characters is logged and the response is sent as plain JSON, unwrapped [WW-5845]. Deprecations - The UIBean fields defaultTemplateDir and defaultUITheme and their setters are deprecated and no longer read; set struts.ui.templateDir and struts.ui.theme globally or per package with <scoped-constant>. Removal is WW-5769 [WW-5768]. - SessionMap.entries is deprecated and no longer read or written; entrySet() builds a fresh set on every call. Removal is WW-5788 [WW-3576]. - RestActionMapper.setEditMethodName is deprecated as a no-op; struts.mapper.editMethodName is still read by RestWorkflowInterceptor. Removal is WW-5843 [WW-5842]. Rejected requests Fifteen tickets were closed against this release without a change to shipped code. They are listed here so the decision is visible rather than silent. [WW-3452] - let struts.custom.i18n.resources supports wildcard - will not be implemented; classpath-scan order varies between containers, so the message shown could change between deployments, and a custom LocalizedTextProvider can expand patterns itself. [WW-3516] - Add <div> tag to <s:checkboxlist> UI Tag - will not be implemented; every theme now applies cssClass/cssStyle to each checkbox, and per-item styling is available through listCssClass, listCssStyle and listTitle. [WW-3526] - Augment JakartaMultiPartRequest to include optional progress listener - will not be implemented; upload progress is provided client-side by XMLHttpRequest.upload events, and a server-side listener can be set by subclassing the multipart request and overriding prepareServletFileUpload. [WW-3541] - Request Parameter to Action Object Mapping Plugin for Insecure Direct Object References - will not be implemented; the contributed code was never donated and its upstream no longer exists, and AliasInterceptor with @StrutsParameter covers the mapping part. [WW-3630] - Add global Failure result - will not be implemented. [WW-3655] - Freemarker result loads request uri as template - closed as Duplicate; resolved by WW-4169 in Struts 2.3.17, where FreemarkerResult resolves a relative location against the action namespace. [WW-3680] - recursive iterator options - will not be implemented; templates render recursive structures by calling themselves (a JSP tag file, a FreeMarker macro or <s:include> around <s:iterator>). [WW-3720] - Support collection-based properties in .xml - will not be implemented; a comma-delimited value can already be split across lines inside a single param, because both the XML reader and the list parser trim whitespace. [WW-3792] - s:checkbox (org.apache.struts2.components.Checkbox) generates span instead of div when using labelposition="left" - closed as Not A Problem; under the css_xhtml theme every control wraps label and control in <div> only for labelPosition="top" and in <span> otherwise. [WW-3933] - Provide web-fragment.xml for easier deployment on Servlet 3.0 compliant containers - will not be implemented; a fragment cannot detect a filter already declared in web.xml and cannot be switched off selectively, so the usual setup would register the filter twice. [WW-4147] - Have StrutsPrepareAndExecuteFilter initialize Freemarker rather than first actual Request - will not be implemented; the protected postInit(Dispatcher, FilterConfig) hook already runs once the Dispatcher is initialised and can warm FreeMarker up. [WW-4323] - Ability to accept params purely by implementing ParamNameAware is broken - will not be implemented; since 2.3.16.1 a parameter is set only when both the interceptor's global name checks and ParameterNameAware accept it, and that is intentional. [WW-5750] - Bump org.hibernate:hibernate-core from 5.6.15.Final to 6.6.58.Final - will not be implemented on the 7.x line; the Hibernate upgrade is tracked for 8.0.0 under WW-5722. [WW-5756] - Reject javascript:/vbscript:/data: schemes in <s:a> href values - closed as working as intended; the href of the anchor tag is chosen by the template author, and checking request-derived data placed in it is the application's job. [WW-5771] - StrutsParameterAuthorizer only matches naively capitalized setters, rejecting annotated JavaBeans-compliant setters like seteMail - closed as Duplicate of WW-5759, which ships in this release. Bug [WW-3447] - Cover convention plugin action-mapping flags with no tests [WW-3464] - Wildcard Mappings, Last one loses. [WW-3576] - SessionMap is not thread-safe [WW-5751] - null can no longer be passed as parameter to interceptor [WW-5752] - Normalize request-derived values in log messages [WW-5753] - Reject cross-site non-GET navigations and cross-site GET subresource requests in the Fetch Metadata policy [WW-5754] - Fetch Metadata policy rejects cross-site POST and HEAD navigations since WW-5753 [WW-5757] - BeanValidationInterceptor resolves the interpolated constraint message as a text key instead of the message template [WW-5758] - Enforce @StrutsParameter authorization in AliasInterceptor's raw-parameter fallback [WW-5765] - ExecuteAndWaitInterceptor re-stores the transaction token from request parameters instead of the token validated in the request [WW-5780] - html5 theme checkboxlist never closes the checkbox input element [WW-5781] - checkboxlist and radio render class and style attributes twice, cssErrorClass/cssErrorStyle never apply [WW-5782] - Anchor tag silently drops nested param tags when href is set [WW-5789] - default values are restored for some properties on ModelDriven bean [WW-5790] - REST two-phase body copy writes constructor defaults over values already set on the target [WW-5792] - XmlDocConfigurationProvider#verifyAction does not fail startup for a non-public action class [WW-5812] - DateConverter rejects valid ISO yyyy-MM-dd dates when a lenient-only format matches first [WW-5813] - DateConverter silently drops the time when the date-time separator does not match the locale pattern [WW-5814] - DateConverter reads a trailing Z in an ISO date-time as server-local time instead of UTC [WW-5823] - Javatemplates plugin renders dynamic attributes differently from the simple theme: values are not HTML-escaped and are evaluated a second time [WW-5824] - Radio tag renders its name attribute without HTML escaping, unlike every other form tag [WW-5825] - DateTextFieldInterceptor logs the rejected parameter name and value unchanged [WW-5828] - StringConverter does not bound integer digits when formatting BigDecimal [WW-5829] - ParametersInterceptor value filters only check the first value of a repeated parameter [WW-5832] - FreeMarker template cache is not bounded by default and is keyed on the request-derived locale [WW-5833] - REST plugin authorizes nested container members one @StrutsParameter depth level short of ParametersInterceptor [WW-5834] - NumberConverter parses numeric strings of any length [WW-5836] - Number tag and localized text arguments do not bound integer digits when formatting BigDecimal [WW-5842] - Action mapping should rely on the servlet path and path info reported by the container [WW-5844] - HttpMethodInterceptor fails open for the implicit execute() method [WW-5845] - JSONP callback parameter is concatenated into the response with no identifier validation [WW-5846] - FetchMetadata, COOP and COEP interceptors match exemptedPaths against the context path instead of the request path [WW-5847] - doubleselect: preselection in the second list with doubleMultiple has never worked New Feature [WW-3476] - Allow overwriting of constants for each package [WW-3624] - allow regex matching on fielderror tag [WW-3717] - Allow restricting an action to HTTP methods via an http-method attribute in struts.xml [WW-5791] - Struts Boot: run a Struts application from main() with an embedded container and programmatic action registration [WW-5816] - Add a range validator for java.time.LocalDate properties Improvement [WW-3364] - Using convertors in JSON serialization [WW-3666] - TypeConverter should trim before conversion to things that are not Strings [WW-4164] - Improve support for multiple extensions [WW-5766] - Support struts.scopedConstantProvider in Java-based configuration (ConstantConfig) [WW-5767] - Apply value substitution to scoped-constant values, as for constant [WW-5768] - Make struts.ui.theme and struts.ui.templateDir scopable per package [WW-5770] - Make struts.convention.result.path scopable per package [WW-5772] - Remove framework-generated inline event handlers from transfer-select, updownselect and combobox tags (CSP) [WW-5774] - Move combobox change handling into a static script with a delegated listener [WW-5810] - Support java.time types in the datetextfield tag [WW-5811] - Derive HTML5 min/max and required constraints for temporal controls [WW-5819] - Log a validator param that fails type conversion instead of ignoring it silently [WW-5826] - Make ScopeInterceptor lock table thread-safe [WW-5831] - Make XSLT BeanAdapter property descriptor cache thread-safe [WW-5838] - Exclude java.beans, java.lang.reflect and java.lang.invoke from OGNL member access by default [WW-5841] - Struts Boot accepts a session id via URL ;jsessionid= with no cookie and no SameSite Task [WW-3472] - SiteMesh Plugin document improvements [WW-5759] - @StrutsParameter enforcement resolves accessor names differently from OGNL [WW-5778] - Support datetextfield tag in the html5 theme [WW-5786] - Verify HTTP method restrictions for Convention plugin actions [WW-5820] - StrutsParameterAuthorizer's declared-on-neither fallback lets a parameter bind to an object below the action in the value stack Dependency [WW-5760] - Upgrade OGNL to version 3.4.15 [WW-5763] - Bump org.apache.commons:commons-lang3 from 3.20.0 to 3.21.0 [WW-5764] - Bump com.github.ben-manes.caffeine:caffeine from 3.2.4 to 3.3.0 [WW-5779] - Bump asm.version from 9.10.1 to 9.11 [WW-5837] - Upgrade OGNL to version 3.4.17 Release notes: * https://cwiki.apache.org/confluence/display/WW/Version%2BNotes%2B7.5.0 Github release * https://github.com/apache/struts/releases/tag/STRUTS_7_5_0 Distribution: * https://dist.apache.org/repos/dist/dev/struts/7.5.0/ Maven 2 staging repository: * https://repository.apache.org/content/groups/staging/ Once you have had a chance to review the test build, please respond with a vote on its quality: [ ] Leave at test build [ ] Alpha [ ] Beta [ ] General Availability (GA) Everyone who has tested the build is invited to vote. Votes by PMC members are considered binding. A vote passes if there are at least three binding +1s and more +1s than -1s. The vote will remain open for at least 72 hours, longer upon request. A vote can be amended at any time to upgrade or downgrade the quality of the release based on future experience. If an initial vote designates the build as "Beta", the release will be submitted for mirroring and announced to the user list. Once released as a public beta, subsequent quality votes on a build may be held on the user list. As always, the act of voting carries certain obligations. A binding vote not only states an opinion, but means that the voter is agreeing to help do the work. On behalf of the Apache Struts project Łukasz
