Server-side backend: a native, JVM-free runtime for Codename One handlers

.github/workflows/blog-prose.yml

@@ -131,6 +131,11 @@ jobs:
           cd scripts
           npm init -y 2>/dev/null || true
           npm install playwright
+          # Playwright shells out to apt for the OS-level deps, so the runner
+          # image's third-party sources have to be pruned FIRST -- a broken
+          # vendor mirror makes its apt-get fail as a whole and it reports
+          # only "Failed to install browser dependencies".
+          bash "$GITHUB_WORKSPACE/scripts/ci/apt-get-update.sh"
           npx playwright install-deps chromium
           npx playwright install chromium
 

.github/workflows/developer-guide-docs.yml

@@ -133,7 +133,7 @@ jobs:
         run: |
           set -euo pipefail
           xvfb-run -a mvn -B -ntp -f maven/pom.xml \
-            -pl core,javase,android,css-compiler,codenameone-maven-plugin \
+            -pl core,javase,android,css-compiler,codenameone-maven-plugin,backend \
             -am install \
             -Plocal-dev-javase \
             -DskipTests \

.github/workflows/port-status-nightly.yml

@@ -82,6 +82,11 @@ jobs:
         run: |
           npm init -y 2>/dev/null || true
           npm install playwright
+          # Playwright shells out to apt for the OS-level deps, so the runner
+          # image's third-party sources have to be pruned FIRST -- a broken
+          # vendor mirror makes its apt-get fail as a whole and it reports
+          # only "Failed to install browser dependencies".
+          bash "$GITHUB_WORKSPACE/scripts/ci/apt-get-update.sh"
           npx playwright install --with-deps "${{ matrix.browser }}"
       - name: Run lifecycle validation
         env:

.github/workflows/pr.yml

@@ -27,6 +27,7 @@ on:
       - 'scripts/ci/retry.sh'
       - 'scripts/ci/apt-get-update.sh'
       - 'scripts/ci/apt-get-install.sh'
+      - 'scripts/ci/tests/apt-get-update-test.sh'
       # The native warning gate's parser self-test runs from this workflow and nowhere
       # else -- the legs that run the gate itself need a compiler. Ignoring these meant a
       # change to the parser, its fixture or a baseline could merge without the one check
@@ -85,6 +86,7 @@ on:
       - 'scripts/ci/retry.sh'
       - 'scripts/ci/apt-get-update.sh'
       - 'scripts/ci/apt-get-install.sh'
+      - 'scripts/ci/tests/apt-get-update-test.sh'
       # The native warning gate's parser self-test runs from this workflow and nowhere
       # else -- the legs that run the gate itself need a compiler. Ignoring these meant a
       # change to the parser, its fixture or a baseline could merge without the one check
@@ -482,6 +484,12 @@ jobs:
       - name: Check build hint catalog
         if: ${{ matrix.java-version == 8 }}
         run: scripts/check-build-hint-catalog.sh
+      - name: Check the apt source prune keeps Ubuntu's own sources
+        if: ${{ matrix.java-version == 8 }}
+        # Cheap, and the rule it covers is only ever exercised on a runner whose
+        # apt is already broken -- so without this it would be tested by a red
+        # build and nothing else.
+        run: bash scripts/ci/tests/apt-get-update-test.sh
       - name: Check the build hint data file can be rendered
         if: ${{ matrix.java-version == 8 }}
         # Not a drift check: nothing is committed to drift from, because every

.github/workflows/scripts-javascript.yml

@@ -210,6 +210,11 @@ jobs:
           npm init -y 2>/dev/null || true
           npm install playwright
           # OS-level deps (apt packages) aren't cached so always install them.
+          # Playwright shells out to apt for the OS-level deps, so the runner
+          # image's third-party sources have to be pruned FIRST -- a broken
+          # vendor mirror makes its apt-get fail as a whole and it reports
+          # only "Failed to install browser dependencies".
+          bash "$GITHUB_WORKSPACE/scripts/ci/apt-get-update.sh"
           npx playwright install-deps chromium
           # `npm install playwright` resolves the floating version, so the
           # cached browser binary can drift away from what the freshly

Ports/Android/src/com/codename1/impl/android/AndroidImplementation.java

@@ -10245,8 +10245,18 @@ public void onReceive(Context ctx, Intent intent) {
                 }
                 String pkg = null;
                 try {
-                    android.content.ComponentName cn = intent.getParcelableExtra(Intent.EXTRA_CHOSEN_COMPONENT);
-                    if (cn != null) pkg = cn.getPackageName();
+                    // Taken as a Parcelable and tested, rather than assigned straight
+                    // to ComponentName: that assignment compiles to a CHECKCAST whose
+                    // failure this catch would have to handle, and the extra is
+                    // whatever the SENDING application chose to put there, so the
+                    // failure is not hypothetical. (The cast-semantics gate no longer
+                    // scans this port, since ParparVM does not translate it -- this
+                    // stands on its own terms.)
+                    android.os.Parcelable chosen =
+                            intent.getParcelableExtra(Intent.EXTRA_CHOSEN_COMPONENT);
+                    if (chosen instanceof android.content.ComponentName) {
+                        pkg = ((android.content.ComponentName) chosen).getPackageName();
+                    }
                 } catch (Throwable ignore) {}
                 target.onResult(com.codename1.share.ShareResult.sharedTo(pkg));
             }

docs/demos/backend/pom.xml

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>com.codenameone.developerguide</groupId>
+    <artifactId>democode</artifactId>
+    <version>1.0-SNAPSHOT</version>
+  </parent>
+  <artifactId>backendsnippets</artifactId>
+  <name>backendsnippets</name>
+  <!--
+       Compiles the Backend chapter's snippets. The guide includes them from here by
+       tag rather than quoting them inline, so a snippet that stops matching the API
+       fails this build instead of sitting wrong in the docs until someone tries it.
+
+       Separate from the common module because that one is the CLIENT: it builds for
+       iOS, Android and the browser, and codenameone-backend is a server library that
+       has no business on those classpaths.
+  -->
+  <dependencies>
+    <dependency>
+      <groupId>com.codenameone</groupId>
+      <artifactId>codenameone-backend</artifactId>
+      <version>${cn1.version}</version>
+    </dependency>
+    <!-- For the REST contract annotations, which the client half of the guide's
+         shared-contract example uses. -->
+    <dependency>
+      <groupId>com.codenameone</groupId>
+      <artifactId>codenameone-core</artifactId>
+      <version>${cn1.version}</version>
+    </dependency>
+  </dependencies>
+</project>

docs/demos/backend/src/main/java/com/codenameone/developerguide/backend/DatabaseSnippets.java

@@ -0,0 +1,46 @@
+/*
+ * Copyright (c) 2012, Codename One and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.  Codename One designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Codename One through http://www.codenameone.com/ if you
+ * need additional information or have any questions.
+ */
+package com.codenameone.developerguide.backend;
+
+import com.codename1.backend.Database;
+import java.io.IOException;
+import java.util.List;
+
+/** The Backend chapter's database examples, compiled so they cannot drift. */
+public final class DatabaseSnippets {
+
+    private DatabaseSnippets() {
+    }
+
+    public static List open() throws IOException {
+// tag::backend-database[]
+Database db = Database.open(System.getenv("DATABASE_URL"));   // or ":memory:"
+db.execute("CREATE TABLE IF NOT EXISTS note (id INTEGER PRIMARY KEY, body TEXT)",
+           null);
+
+List rows = db.query("SELECT id, body FROM note WHERE id > ?",
+                     new Object[] { Integer.valueOf(10) });
+// end::backend-database[]
+        return rows;
+    }
+}

docs/demos/backend/src/main/java/com/codenameone/developerguide/backend/Note.java

@@ -0,0 +1,32 @@
+/*
+ * Copyright (c) 2012, Codename One and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.  Codename One designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Codename One through http://www.codenameone.com/ if you
+ * need additional information or have any questions.
+ */
+package com.codenameone.developerguide.backend;
+
+/** The data transfer object both ends of {@link NotesApi} share. */
+public class Note {
+    public long id;
+    public String body;
+
+    public Note() {
+    }
+}

docs/demos/backend/src/main/java/com/codenameone/developerguide/backend/Notes.java

@@ -0,0 +1,86 @@
+/*
+ * Copyright (c) 2012, Codename One and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.  Codename One designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Codename One through http://www.codenameone.com/ if you
+ * need additional information or have any questions.
+ */
+package com.codenameone.developerguide.backend;
+
+import com.codename1.backend.annotations.DeleteMapping;
+import com.codename1.backend.annotations.GetMapping;
+import com.codename1.backend.annotations.PathVariable;
+import com.codename1.backend.annotations.PostMapping;
+import com.codename1.backend.annotations.RequestBody;
+import com.codename1.backend.annotations.RequestMapping;
+import com.codename1.backend.annotations.RequestParam;
+import com.codename1.backend.annotations.ResponseStatus;
+import com.codename1.backend.annotations.RestController;
+import java.util.ArrayList;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.atomic.AtomicLong;
+
+// tag::backend-first-server[]
+@RestController
+@RequestMapping("/notes")
+public class Notes {
+    private final Map<Long, Map> store = new ConcurrentHashMap<Long, Map>();
+    private final AtomicLong nextId = new AtomicLong(1);
+
+    @GetMapping("/healthz")
+    public String health() {
+        return "ok";
+    }
+
+    @GetMapping("/{id}")
+    public Map read(@PathVariable("id") long id) {
+        return store.get(Long.valueOf(id));      // null becomes a 404
+    }
+
+    @GetMapping
+    public List list(@RequestParam(value = "limit", defaultValue = "20") int limit) {
+        List page = new ArrayList();
+        for (Map note : store.values()) {
+            if (page.size() >= limit) {
+                break;
+            }
+            page.add(note);
+        }
+        return page;
+    }
+
+    @PostMapping
+    @ResponseStatus(201)
+    public Map create(@RequestBody Map note) {
+        long id = nextId.getAndIncrement();
+        Map stored = new LinkedHashMap(note);
+        stored.put("id", Long.valueOf(id));
+        store.put(Long.valueOf(id), stored);
+        return stored;
+    }
+
+    @DeleteMapping("/{id}")
+    @ResponseStatus(204)
+    public void delete(@PathVariable("id") long id) {
+        store.remove(Long.valueOf(id));
+    }
+}
+// end::backend-first-server[]

docs/demos/backend/src/main/java/com/codenameone/developerguide/backend/NotesApi.java

@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2012, Codename One and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.  Codename One designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Codename One through http://www.codenameone.com/ if you
+ * need additional information or have any questions.
+ */
+package com.codenameone.developerguide.backend;
+
+import com.codename1.annotations.rest.Body;
+import com.codename1.annotations.rest.GET;
+import com.codename1.annotations.rest.POST;
+import com.codename1.annotations.rest.Path;
+import com.codename1.annotations.rest.RestClient;
+import com.codename1.io.rest.Response;
+import com.codename1.util.OnComplete;
+
+// tag::backend-contract[]
+@RestClient
+public interface NotesApi {
+    @GET("/notes/{id}")
+    void note(@Path("id") String id, OnComplete<Response<Note>> callback);
+
+    @POST("/notes")
+    void create(@Body Note note, OnComplete<Response<Note>> callback);
+}
+// end::backend-contract[]

docs/demos/backend/src/main/java/com/codenameone/developerguide/backend/NotesApiServer.java

@@ -0,0 +1,37 @@
+/*
+ * Copyright (c) 2012, Codename One and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.  Codename One designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Codename One through http://www.codenameone.com/ if you
+ * need additional information or have any questions.
+ */
+package com.codenameone.developerguide.backend;
+
+/**
+ * What the build emits from {@link NotesApi} for the server side.
+ *
+ * Reproduced here rather than generated: the generator runs after this module
+ * compiles, and the point of these files is that the guide's examples compile at
+ * all. A real project never writes this -- it comes out of the same annotated
+ * contract the app's client comes out of, method for method.
+ */
+interface NotesApiServer {
+    Note note(String id) throws Exception;
+
+    Note create(Note note) throws Exception;
+}