René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Stream blob uploads when digest/size are already known (no temp files)","articleBody":"### What would you like to be added?\n\nCurrent `OCI.pushBlob(ref, InputStream)` spools to a temp file first (`src/main/java/land/oras/OCI.java:109`).\n\nAdd a streaming upload overload for the remote registry path, scoped to the \"digest already known\" case:\n\n- New API (Registry):\n  `Layer pushBlob(ContainerRef refWithDigest, long size, Supplier\u003cInputStream\u003e stream, Map\u003cString,String\u003e annotations)`\n\nConstraints / behavior:\n- `refWithDigest.getDigest()` is required; otherwise throw.\n- Implement upload as distribution-spec two-step: `POST /blobs/uploads/` (no body) -\u003e `PUT \u003clocation\u003e?digest=...` (single streamed body).\n- Use `BodyPublishers.ofInputStream(stream)` so auth/redirect retries can reopen the stream (no temp files).\n\nCopy usage:\n- Update `src/main/java/land/oras/CopyUtils.java` to call the new overload and pass known `layer.getSize()` + a stream supplier.\n\nNon-goals:\n- Streaming when digest is not known (no \"compute digest while uploading\" in this change).\n- Changing existing `pushBlob(Path|byte[])` behavior.\n\n### Why is this needed for ORAS?\n\n- Performance: avoid extra disk I/O and temp space for every copied blob.\n- Resource limits: works in constrained environments (CI runners, k8s, serverless).\n\n### Are you willing to submit PRs to contribute to this feature?\n\n- [x] Yes, I am willing to implement it.","author":{"url":"https://github.com/h2cone","@type":"Person","name":"h2cone"},"datePublished":"2026-01-26T08:16:01.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/508/oras-java/issues/508"}