Backend: bounded application cache with expiry and metrics by shai-almog · Pull Request #6107 · codenameone/CodenameOne

shai-almog · 2026-10-26T02:14:18Z

Implements #5996.

com.codename1.backend.Cache: size/weight bounds, expire after write/access, per-entry expiry, atomic deduplicated loads (VT-safe waiting), invalidation, removal listeners run outside the lock, metrics under cache.<name>.*.
JVM tests (CacheTest, controllable clock) and ParparVM self-test checks.
Docs: "Application caches" in Backend-Observability.

🤖 Generated with Claude Code

Typed Cache with size/weight bounds, write/access/per-entry expiry, deduplicated concurrent loads, invalidation, removal listeners and metrics in the backend metrics API. JVM tests use a controllable clock; the ParparVM self-test covers the same API natively. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

github-actions · 2026-10-26T02:26:52Z

Developer Guide build artifacts are available for download from this workflow run:

Developer Guide quality checks:

AsciiDoc linter: No issues found (report)
Vale: No alerts found (report)
Paragraph capitalization: No paragraph capitalization issues (report)
LanguageTool: No grammar matches (report)
Image references: No unused images detected (report)

github-actions · 2026-10-26T02:35:47Z

Cloudflare Preview

URL: https://pr-6107-website-preview.codenameone.pages.dev
Branch: pr-6107-website-preview

shai-almog · 2026-10-26T02:52:51Z

Compared 191 screenshots: 191 matched.

Native Android coverage

📊 Line coverage: 18.90% (48254/255341 lines covered) [HTML preview] (artifact android-coverage-report, jacocoAndroidReport/html/index.html)
- Other counters: instruction 17.65% (229222/1299035), branch 12.04% (16822/139675), complexity 9.68% (12915/133466), method 14.57% (9124/62628), class 25.17% (1775/7052)
- Lowest covered classes
  - kotlin.collections.kotlin.collections.ArraysKt___ArraysKt – 0.00% (0/6367 lines covered)
  - kotlin.collections.unsigned.kotlin.collections.unsigned.UArraysKt___UArraysKt – 0.00% (0/2384 lines covered)
  - org.jacoco.agent.rt.internal_0e20598.asm.org.jacoco.agent.rt.internal_0e20598.asm.ClassReader – 0.00% (0/1524 lines covered)
  - org.jacoco.agent.rt.internal_0e20598.asm.org.jacoco.agent.rt.internal_0e20598.asm.MethodWriter – 0.00% (0/922 lines covered)
  - kotlin.sequences.kotlin.sequences.SequencesKt___SequencesKt – 0.00% (0/736 lines covered)
  - com.google.common.cache.com.google.common.cache.LocalCache$Segment – 0.00% (0/726 lines covered)
  - okio.okio.Buffer – 0.00% (0/687 lines covered)
  - kotlin.text.kotlin.text.StringsKt___StringsKt – 0.00% (0/625 lines covered)
  - com.codename1.androidcompat.rt.com.codename1.androidcompat.rt.TextXmlPullParser – 0.00% (0/623 lines covered)
  - com.codename1.androidcompat.androidx.constraintlayout.core.widgets.com.codename1.androidcompat.androidx.constraintlayout.core.widgets.Flow – 0.00% (0/576 lines covered)

✅ Native Android screenshot tests passed.

Native Android coverage

📊 Line coverage: 18.90% (48254/255341 lines covered) [HTML preview] (artifact android-coverage-report, jacocoAndroidReport/html/index.html)
- Other counters: instruction 17.65% (229222/1299035), branch 12.04% (16822/139675), complexity 9.68% (12915/133466), method 14.57% (9124/62628), class 25.17% (1775/7052)
- Lowest covered classes
  - kotlin.collections.kotlin.collections.ArraysKt___ArraysKt – 0.00% (0/6367 lines covered)
  - kotlin.collections.unsigned.kotlin.collections.unsigned.UArraysKt___UArraysKt – 0.00% (0/2384 lines covered)
  - org.jacoco.agent.rt.internal_0e20598.asm.org.jacoco.agent.rt.internal_0e20598.asm.ClassReader – 0.00% (0/1524 lines covered)
  - org.jacoco.agent.rt.internal_0e20598.asm.org.jacoco.agent.rt.internal_0e20598.asm.MethodWriter – 0.00% (0/922 lines covered)
  - kotlin.sequences.kotlin.sequences.SequencesKt___SequencesKt – 0.00% (0/736 lines covered)
  - com.google.common.cache.com.google.common.cache.LocalCache$Segment – 0.00% (0/726 lines covered)
  - okio.okio.Buffer – 0.00% (0/687 lines covered)
  - kotlin.text.kotlin.text.StringsKt___StringsKt – 0.00% (0/625 lines covered)
  - com.codename1.androidcompat.rt.com.codename1.androidcompat.rt.TextXmlPullParser – 0.00% (0/623 lines covered)
  - com.codename1.androidcompat.androidx.constraintlayout.core.widgets.com.codename1.androidcompat.androidx.constraintlayout.core.widgets.Flow – 0.00% (0/576 lines covered)

Benchmark Results

Detailed Performance Metrics

Metric	Duration
SIMD kernel backend	scalar fallback (no native SIMD)
SIMD int-add (64K x300)	java 402ms / native 256ms = 1.5x speedup
SIMD float-mul (64K x300)	java 141ms / native 109ms = 1.2x speedup
SIMD kernel correctness	PASS (native result == scalar reference)
Base64 payload size	8192 bytes
Base64 benchmark iterations	6000
Base64 SIMD byte path	gated to scalar (CPU autovectorizes scalar; explicit SIMD not beneficial here)
Base64 CN1 encode	92.000 ms
Base64 CN1 decode	84.000 ms
Base64 native encode	460.000 ms
Base64 encode ratio (CN1/native)	0.200x (80.0% faster)
Base64 native decode	278.000 ms
Base64 decode ratio (CN1/native)	0.302x (69.8% faster)
Image encode benchmark status	skipped (SIMD unsupported)

shai-almog · 2026-10-26T02:58:49Z

Compared 227 screenshots: 227 matched.
✅ JavaScript-port screenshot tests passed.

github-actions · 2026-10-26T03:02:28Z

✅ Continuous Quality Report

Test & Coverage

✅ Tests: 14538 total, 0 failed, 161 skipped
📊 Line coverage: 64.64% [HTML preview] [Download]
- Lowest covered classes
  - com.codename1.io.zip.ZipArchiveOutputStream – 0.00%
  - com.codename1.gaming.level.GameSceneView – 0.00%
  - com.codename1.crash.CrashProtection – 0.00%
  - com.codename1.mapping.JsonValues – 0.00%
  - com.codename1.payment.CommerceManager – 0.00%
  - com.codename1.wearable.WearableMessage – 0.00%
  - com.codename1.ui.plaf.GlassLensBlend – 0.00%
  - com.codename1.vr.VRView – 0.00%
  - com.codename1.appreview.RatingDialog – 0.00%
  - com.codename1.db.ManagedKeys – 0.00%

Static Analysis

SpotBugs [Report archive]
- ✅ ByteCodeTranslator: 0 findings (no issues)
- ✅ android: 0 findings (no issues)
- ✅ android-compat: 0 findings (no issues)
- ✅ android-res-compiler: 0 findings (no issues)
- ✅ backend: 0 findings (no issues)
- ✅ backend-test: 0 findings (no issues)
- ✅ build-engine: 0 findings (no issues)
- ✅ build-hint-catalog: 0 findings (no issues)
- ✅ build-hint-tools: 0 findings (no issues)
- ✅ codenameone-gradle-plugin: 0 findings (no issues)
- ✅ codenameone-maven-plugin: 0 findings (no issues)
- ✅ core-unittests: 0 findings (no issues)
- ✅ desktop-compat-runtime: 0 findings (no issues)
- ✅ fxml-compiler: 0 findings (no issues)
- ✅ ios: 0 findings (no issues)
- ✅ javac: 0 findings (no issues)
- ✅ javafx-compat: 0 findings (no issues)
- ✅ project-model: 0 findings (no issues)
- ✅ swing-compat: 0 findings (no issues)
✅ PMD: 0 findings (no issues) [Report archive]
✅ Checkstyle: 0 findings (no issues) [Report archive]

Generated automatically by the PR CI workflow.

shai-almog · 2026-10-26T03:04:40Z

Compared 206 screenshots: 206 matched.
Native Windows port, REAL shipping pipeline: the hellocodenameone screenshot suite rendered by a binary CROSS-COMPILED on Linux (clang-cl + xwin, WebView2 linked) and RUN on a Windows x64 runner. Compared against the in-repo baseline in scripts/windows/screenshots.

Benchmark Results

Detailed Performance Metrics

Metric	Duration
SIMD kernel backend	SSE2 (x64) / NEON (arm64) native kernels
SIMD int-add (64K x300)	java 64ms / native 4ms = 16.0x speedup
SIMD float-mul (64K x300)	java 62ms / native 3ms = 20.6x speedup
SIMD kernel correctness	PASS (native result == scalar reference)
Base64 native bridge	unavailable (CN1 + SIMD + image benchmarks only)
Base64 payload size	8192 bytes
Base64 benchmark iterations	6000
Base64 SIMD byte path	gated to scalar (CPU autovectorizes scalar; explicit SIMD not beneficial here)
Base64 CN1 encode	74.000 ms
Base64 CN1 decode	87.000 ms
Base64 SIMD encode	103.000 ms
Base64 encode ratio (SIMD/CN1)	1.392x (39.2% slower)
Base64 SIMD decode	97.000 ms
Base64 decode ratio (SIMD/CN1)	1.115x (11.5% slower)
Image encode benchmark iterations	100
Image createMask (SIMD off)	7.000 ms
Image createMask (SIMD on)	5.000 ms
Image createMask ratio (SIMD on/off)	0.714x (28.6% faster)
Image applyMask (SIMD off)	32.000 ms
Image applyMask (SIMD on)	26.000 ms
Image applyMask ratio (SIMD on/off)	0.813x (18.8% faster)
Image modifyAlpha (SIMD off)	32.000 ms
Image modifyAlpha (SIMD on)	21.000 ms
Image modifyAlpha ratio (SIMD on/off)	0.656x (34.4% faster)
Image modifyAlpha removeColor (SIMD off)	36.000 ms
Image modifyAlpha removeColor (SIMD on)	53.000 ms
Image modifyAlpha removeColor ratio (SIMD on/off)	1.472x (47.2% slower)

shai-almog · 2026-10-26T03:20:03Z

Compared 206 screenshots: 206 matched.
Native Windows port (x64 / Intel-AMD): full hellocodenameone screenshot suite rendered offscreen with Direct2D/DirectWrite, plus the real benchmarks (base64 native/CN1/SIMD, image createMask/applyMask/modifyAlpha/PNG/JPEG, SSE2 SIMD kernels). Compared against the in-repo baseline in scripts/windows/screenshots.

Benchmark Results

Detailed Performance Metrics

Metric	Duration
SIMD kernel backend	SSE2 (x64) / NEON (arm64) native kernels
SIMD int-add (64K x300)	java 53ms / native 4ms = 13.2x speedup
SIMD float-mul (64K x300)	java 52ms / native 3ms = 17.3x speedup
SIMD kernel correctness	PASS (native result == scalar reference)
Base64 native bridge	unavailable (CN1 + SIMD + image benchmarks only)
Base64 payload size	8192 bytes
Base64 benchmark iterations	6000
Base64 SIMD byte path	gated to scalar (CPU autovectorizes scalar; explicit SIMD not beneficial here)
Base64 CN1 encode	69.000 ms
Base64 CN1 decode	87.000 ms
Base64 SIMD encode	96.000 ms
Base64 encode ratio (SIMD/CN1)	1.391x (39.1% slower)
Base64 SIMD decode	92.000 ms
Base64 decode ratio (SIMD/CN1)	1.057x (5.7% slower)
Image encode benchmark iterations	100
Image createMask (SIMD off)	10.000 ms
Image createMask (SIMD on)	7.000 ms
Image createMask ratio (SIMD on/off)	0.700x (30.0% faster)
Image applyMask (SIMD off)	41.000 ms
Image applyMask (SIMD on)	49.000 ms
Image applyMask ratio (SIMD on/off)	1.195x (19.5% slower)
Image modifyAlpha (SIMD off)	52.000 ms
Image modifyAlpha (SIMD on)	32.000 ms
Image modifyAlpha ratio (SIMD on/off)	0.615x (38.5% faster)
Image modifyAlpha removeColor (SIMD off)	26.000 ms
Image modifyAlpha removeColor (SIMD on)	14.000 ms
Image modifyAlpha removeColor ratio (SIMD on/off)	0.538x (46.2% faster)

ParparVM vs HotSpot (JDK 25): Windows x64

Runner CPU: Intel64 Family 6 Model 207 Stepping 2, GenuineIntel (baseline windows-x64@intel64-family-6-model-207-genuineintel)

2 improvements past the baseline (not a failure; rebaseline to lock them in):

hello (WinHelloMain) on all 4 CPUs: RAM 0.55x against a 0.86x baseline (-36.3%, tolerance 35%)
recursion on all 4 CPUs: time 0.94x against a 1.20x baseline (-21.9%, tolerance 20%)

Ratios are ParparVM / JDK 25: below 1.00x ParparVM is faster (time) or smaller (RAM). Median of 5 interleaved, paired rounds; every run's output was verified. A ratio more than 20% (time) / 25% (RAM) above its baseline in vm/selfhost/perf-baseline/ is a regression and fails; one that far below is an improvement, reported but not failed (a row whose calibration runs were noisier carries a wider tolerance), and for RAM the change must also exceed 0.05x in absolute terms. Both run unpinned on all of the runner's CPUs, with their own default thread counts.

Benchmark	Cores	Time	RAM	Status
hello (WinHelloMain)	4	1.27x (base 1.07x, +18.8%)	0.55x (base 0.86x, -36.3%)	improved: rebaseline to lock in (RAM -36.3%)
translator (self)	4	0.77x (base 0.79x, -1.8%)	0.51x (base 0.53x, -2.2%)	ok
intArithmetic	4	1.02x (base 1.02x, -0.1%)	0.06x (base 0.06x, +2.0%)	ok
longArithmetic	4	0.97x (base 0.97x, -0.4%)	0.06x (base 0.05x, +3.0%)	ok
mathTranscendental	4	0.89x (base 0.89x, +0.5%)	0.06x (base 0.06x, +2.6%)	ok
arraySequential	4	1.61x (base 1.98x, -18.9%)	0.38x (base 0.38x, +0.1%)	ok
arrayRandom	4	1.01x (base 1.01x, -0.1%)	0.23x (base 0.23x, +0.7%)	ok
objectAllocation	4	1.22x (base 1.22x, +0.4%)	0.31x (base 0.37x, -16.4%)	ok
valueEscape	4	0.13x (base 0.13x, +2.1%)	0.05x (base 0.04x, +3.8%)	ok
hashMapChurn	4	1.34x (base 1.14x, +17.0%)	0.10x (base 0.10x, -1.0%)	ok
stringBuilding	4	1.50x (base 1.42x, +5.8%)	0.27x (base 0.22x, +20.2%)	ok
recursion	4	0.94x (base 1.20x, -21.9%)	0.06x (base 0.06x, +3.2%)	improved: rebaseline to lock in (time -21.9%)
quicksort	4	1.03x (base 1.07x, -3.6%)	0.12x (base 0.12x, +1.5%)	ok

A change that moves performance ON PURPOSE records the new baseline in vm/selfhost/perf-baseline/pr/6107.json, with the reason, from this job's perf-results.json. The rebaseline is then part of this pull request's diff:

python3 vm/selfhost/calibrate-perf-baseline.py --pr 6107 --reason "<why these benchmarks moved>" perf-results.json

Result: no regression (improved past the baseline: consider rebaselining)

shai-almog merged commit 2105546 into master Oct 26, 2026
85 of 95 checks passed

shai-almog deleted the backend-bounded-cache branch October 26, 2026 03:23

Navigation Menu

Repository navigation

Backend: bounded application cache with expiry and metrics - #6107

Backend: bounded application cache with expiry and metrics#6107
shai-almog merged 1 commit into
masterfrom
backend-bounded-cache

shai-almog commented Oct 26, 2026

Uh oh!

github-actions Bot commented Oct 26, 2026

Uh oh!

github-actions Bot commented Oct 26, 2026

Uh oh!

shai-almog commented Oct 26, 2026 •

edited

Loading

Uh oh!

shai-almog commented Oct 26, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Oct 26, 2026

Uh oh!

shai-almog commented Oct 26, 2026 •

edited

Loading

Uh oh!

shai-almog commented Oct 26, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

shai-almog commented Oct 26, 2026

Uh oh!

github-actions Bot commented Oct 26, 2026

Uh oh!

github-actions Bot commented Oct 26, 2026

Cloudflare Preview

Uh oh!

shai-almog commented Oct 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Native Android coverage

Native Android coverage

Benchmark Results

Detailed Performance Metrics

Uh oh!

shai-almog commented Oct 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Oct 26, 2026

✅ Continuous Quality Report

Test & Coverage

Static Analysis

Uh oh!

shai-almog commented Oct 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Benchmark Results

Detailed Performance Metrics

Uh oh!

shai-almog commented Oct 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Benchmark Results

Detailed Performance Metrics

ParparVM vs HotSpot (JDK 25): Windows x64

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

shai-almog commented Oct 26, 2026 •

edited

Loading

shai-almog commented Oct 26, 2026 •

edited

Loading

shai-almog commented Oct 26, 2026 •

edited

Loading

shai-almog commented Oct 26, 2026 •

edited

Loading