[jira] [Updated] (WW-5640) Add WebJars support to Struts core

["Lukasz Lenart (Jira)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/WW-5640?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Lukasz Lenart updated WW-5640:
------------------------------
    Description: 
Add first-class WebJars support to Struts core so client-side libraries packaged as WebJars (shipped under {{META-INF/resources/webjars/<name>/<version>/…}}) can be referenced by a version-less logical path and served through Struts' existing static-content pipeline.

Example: a template references bootstrap/css/bootstrap.min.css; Struts resolves and serves {{META-INF/resources/webjars/bootstrap/5.3.8/css/bootstrap.min.css}}.

Today plugins and apps vendor client-side assets directly on the classpath and re-commit them on every upgrade (the struts2-bootstrap plugin commits ~2000 files by hand each release). WebJars replace this with a dependency bump (auto-updatable via Renovate/Dependabot).

Scope (core only):
- Add {{org.webjars:webjars-locator-lite}} (MIT; one Apache-2.0 transitive dep) for version resolution.
- New {{WebJarUrlProvider}} container bean — the public, injectable seam for plugins.
- Serve {{<staticContentPath>/webjars/**}} via a branch in {{DefaultStaticContentLoader}}, reusing existing caching; extend content-type coverage for fonts/svg/source-maps.
- Thin {{<s:webjar>}} tag + {{<@s.webjar>}} macro emitting the resolved URL string.
- New config: {{struts.webjars.enabled}} (default true), {{struts.webjars.allowlist}} (optional).
- Security: constrain resolution to the webjars root, block .. traversal, fail closed (404 / no URL) on unresolved paths.

  was:
Add first-class WebJars support to Struts core so client-side libraries packaged as WebJars (shipped under {{META-INF/resources/webjars/<name>/<version>/…}}) can be referenced by a version-less logical path and served through Struts' existing static-content pipeline.

Example: a template references bootstrap/css/bootstrap.min.css; Struts resolves and serves {{META-INF/resources/webjars/bootstrap/5.3.8/css/bootstrap.min.css}}.

Today plugins and apps vendor client-side assets directly on the classpath and re-commit them on every upgrade (the struts2-bootstrap plugin commits ~2000 files by hand each release). WebJars replace this with a dependency bump (auto-updatable via Renovate/Dependabot).

Scope (core only):
- Add org.webjars:webjars-locator-lite (MIT; one Apache-2.0 transitive dep) for version resolution.
- New WebJarUrlProvider container bean — the public, injectable seam for plugins.
- Serve <staticContentPath>/webjars/** via a branch in DefaultStaticContentLoader, reusing existing caching; extend content-type coverage for fonts/svg/source-maps.
- Thin <s:webjar> tag + <@s.webjar> macro emitting the resolved URL string.
- New config: struts.webjars.enabled (default true), struts.webjars.allowlist (optional).
- Security: constrain resolution to the webjars root, block .. traversal, fail closed (404 / no URL) on unresolved paths.


> Add WebJars support to Struts core
> ----------------------------------
>
>                 Key: WW-5640
>                 URL: https://issues.apache.org/jira/browse/WW-5640
>             Project: Struts 2
>          Issue Type: New Feature
>          Components: Core
>            Reporter: Lukasz Lenart
>            Priority: Major
>             Fix For: 7.3.0
>
>
> Add first-class WebJars support to Struts core so client-side libraries packaged as WebJars (shipped under {{META-INF/resources/webjars/<name>/<version>/…}}) can be referenced by a version-less logical path and served through Struts' existing static-content pipeline.
> Example: a template references bootstrap/css/bootstrap.min.css; Struts resolves and serves {{META-INF/resources/webjars/bootstrap/5.3.8/css/bootstrap.min.css}}.
> Today plugins and apps vendor client-side assets directly on the classpath and re-commit them on every upgrade (the struts2-bootstrap plugin commits ~2000 files by hand each release). WebJars replace this with a dependency bump (auto-updatable via Renovate/Dependabot).
> Scope (core only):
> - Add {{org.webjars:webjars-locator-lite}} (MIT; one Apache-2.0 transitive dep) for version resolution.
> - New {{WebJarUrlProvider}} container bean — the public, injectable seam for plugins.
> - Serve {{<staticContentPath>/webjars/**}} via a branch in {{DefaultStaticContentLoader}}, reusing existing caching; extend content-type coverage for fonts/svg/source-maps.
> - Thin {{<s:webjar>}} tag + {{<@s.webjar>}} macro emitting the resolved URL string.
> - New config: {{struts.webjars.enabled}} (default true), {{struts.webjars.allowlist}} (optional).
> - Security: constrain resolution to the webjars root, block .. traversal, fail closed (404 / no URL) on unresolved paths.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)