feat: DownloadAction for the action trigger framework#24432
Draft
Artur- wants to merge 3 commits into
Draft
Conversation
Addresses the design suggestion from PR #24397 review: lift the payload type into the PromiseAction class signature so subclasses don't have to write per-action adapters and JsonNode no longer leaks through Success.value(). PromiseAction<T> takes the payload type in its with-outcome constructor and Jackson-decodes the resolved value once before invoking onSuccess. The public Success<JsonNode> wrapper is gone — onSuccess is SerializableConsumer<@nullable T> directly. The wire shape (Outcome{ok, value, error}) is unchanged; only the dispatch seam moves. Subclasses become trivial: - CopyTextToClipboardAction extends PromiseAction<String> — drops adaptOnCopied / asString; onCopied receives the decoded String. - RequestFullscreenAction extends PromiseAction<Void> — keeps the SerializableRunnable convenience via a one-line adapter to Consumer<@nullable Void>. - ClipboardReadAction extends PromiseAction<ClipboardPayload> — was a direct Action subclass with a single-handler-null-on-failure API; now adopts the two-handler shape so callers can distinguish "empty clipboard" (onPayload(null)) from "permission denied" (onError). JsBuilder.callback(Class<T>, …) / callback(TypeReference<T>, …) were added in step3 to support ClipboardReadAction's direct-Action shape. With ClipboardReadAction folded into PromiseAction<T>, no consumer remains, so they're removed — keeping the primitive surface tight. The IT view's onError branch sets "error=" + err.name(); the rejecting-shim IT case is renamed to assert that path instead of the former "null" propagation.
Replace appendStatement(JsBuilder, StringBuilder) on Action with render(JsBuilder): JsFunction. Replace Input.appendExpression with Input.toJs(JsBuilder): JsFunction returning the input's value when invoked. Each Action ships as its own JsFunction (body + captures); Trigger composes them as captures of a tiny parent JsFunction whose body is just $0(event);$1(event);... PromiseAction wraps the subclass JsFunction with OBSERVE_PROMISE via captures instead of string concatenation. Eliminates hand-escaped JS literals in action bodies — strings and Element refs go through JsFunction's capture mechanism, which Jackson- encodes on the wire. Removes the "this" special-case for the host element: the host is captured the same way as any other Element. JsBuilder shrinks to just the render-time context (trigger() accessor) plus a static json() helper kept for Trigger.installJs() (a raw String, not a JsFunction).
Starts a file download in the browser when a trigger fires, using a synthesised <a href download> click inside the gesture. Three flavours: a static URL (optionally with a filename), a DownloadHandler whose stream resource is wired through Element.setAttribute (same lifecycle as Image.setSrc / Anchor.setHref), and an Action.Input<String> for URLs resolved on the client at fire time. No outcome callback — browsers do not report download completion.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Starts a file download in the browser when a trigger fires, using a
synthesised click inside the gesture. Three flavours:
a static URL (optionally with a filename), a DownloadHandler whose
stream resource is wired through Element.setAttribute (same lifecycle
as Image.setSrc / Anchor.setHref), and an Action.Input for URLs
resolved on the client at fire time. No outcome callback — browsers do
not report download completion.