Add support for mirrors on registries.conf

[jonesbusy]

Description

Add support for mirrors on registries.conf

Related to #603 (partial fix)

Testing done

Added tests

Submitter checklist

• I have read and understood the CONTRIBUTING guide
• I have run mvn license:update-file-header, mvn spotless:apply, pre-commit run -a, mvn clean install before opening the PR

[codecov]

Codecov Report

❌ Patch coverage is 83.72093% with 21 lines in your changes missing coverage. Please review.
✅ Project coverage is 87.86%. Comparing base (df87bc6) to head (88f1305).

Files with missing lines	Patch %	Lines
src/main/java/land/oras/Registry.java	86.86%	5 Missing and 8 partials ⚠️
src/main/java/land/oras/auth/RegistriesConf.java	71.42%	2 Missing and 6 partials ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##               main     #745      +/-   ##
============================================
+ Coverage     87.22%   87.86%   +0.63%     
- Complexity     1015     1081      +66     
============================================
  Files            45       45              
  Lines          3225     3345     +120     
  Branches        409      447      +38     
============================================
+ Hits           2813     2939     +126     
+ Misses          244      234      -10     
- Partials        168      172       +4     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Copilot]

Pull request overview

Adds [[registry.mirror]] support to registries.conf so the SDK can try configured mirror registries (in order) before falling back to the original registry when pulling artifacts / fetching manifests & blobs.

Changes:

• Extend RegistriesConf to parse and expose an ordered list of mirror entries, plus mirror-based ref rewriting.
• Add mirror fallback logic in Registry for manifest/blob retrieval and artifact pulling.
• Add unit tests for TOML mirror parsing/ref rewriting and a new Testcontainers-based integration test validating mirror failover behavior.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
src/main/java/land/oras/Registry.java	Introduces mirror fallback wrapper and routes key pull/blob/manifest operations through it.
src/main/java/land/oras/auth/RegistriesConf.java	Adds mirror config model + APIs to fetch mirrors and rewrite refs for a mirror.
src/test/java/land/oras/auth/RegistryConfTest.java	Updates tests for new RegistryConfig signature and adds mirror parsing/rewriting tests.
src/test/java/land/oras/RegistryMirrorTest.java	New integration test validating mirror ordering and fallback behavior via Docker/Testcontainers.
src/test/java/land/oras/ClassAnnotationsTest.java	Updates expected annotated-model counts to account for the new mirror model.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.