Add managed ORM sessions and relationships to client and backend

.github/workflows/pr.yml

@@ -156,6 +156,10 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 60
     container: ghcr.io/codenameone/codenameone/pr-ci-container:latest
+    env:
+      # Java 8 uses the native locale for class-file names containing Unicode.
+      LANG: C.UTF-8
+      LC_ALL: C.UTF-8
     defaults:
       run:
         shell: bash

CodenameOne/src/com/codename1/annotations/Column.java

@@ -41,6 +41,9 @@
     /// When false the column gets a `NOT NULL` constraint at table-create time.
     boolean nullable() default true;
 
+    /// Creates a unique index when the managed schema is created.
+    boolean unique() default false;
+
     /// Optional explicit SQL type. Use the SQLite type names (`TEXT`,
     /// `INTEGER`, `REAL`, `BLOB`, `NUMERIC`). When blank the processor infers
     /// the type from the field's Java type.

CodenameOne/src/com/codename1/annotations/Entity.java

@@ -22,6 +22,7 @@
  */
 package com.codename1.annotations;
 
+import com.codename1.annotations.db.Index;
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
@@ -57,4 +58,7 @@
 public @interface Entity {
     /// SQL table name. Defaults to the simple class name when blank.
     String table() default "";
+    /// Additional indexes created with the entity table.
+    /// @return index declarations, empty by default
+    Index[] indexes() default {};
 }

CodenameOne/src/com/codename1/annotations/db/CascadeType.java

@@ -0,0 +1,39 @@
+/*
+ * Copyright (c) 2026, 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.codename1.annotations.db;
+
+/// Operations propagated from an entity to its related entities.
+public enum CascadeType {
+    /// Propagates all supported cascade operations.
+    ALL,
+    /// Persists new related entities.
+    PERSIST,
+    /// Merges related entity state.
+    MERGE,
+    /// Removes related entities.
+    REMOVE,
+    /// Reloads related entities from storage.
+    REFRESH,
+    /// Detaches already loaded related entities.
+    DETACH
+}

CodenameOne/src/com/codename1/annotations/db/Convert.java

@@ -0,0 +1,37 @@
+/*
+ * Copyright (c) 2026, 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.codename1.annotations.db;
+import java.lang.annotation.*;
+import com.codename1.orm.session.AttributeConverter;
+/// A public no-arg converter for a basic field; converters also receive null values.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.FIELD)
+public @interface Convert {
+    /// Selects the domain converter. It must be public with a public no-argument constructor.
+    /// Converters receive null values in both directions.
+    /// @return converter class
+    Class<? extends AttributeConverter> converter();
+    /// Declares the SQL scalar type returned by the converter.
+    /// @return storage class; String by default
+    Class<?> storageType() default String.class;
+}

CodenameOne/src/com/codename1/annotations/db/DiscriminatorValue.java

@@ -0,0 +1,32 @@
+/*
+ * Copyright (c) 2026, 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.codename1.annotations.db;
+import java.lang.annotation.*;
+/// The persistent discriminator for a concrete class in an entity hierarchy.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.TYPE)
+public @interface DiscriminatorValue {
+    /// Names the unique discriminator stored for this concrete entity class.
+    /// @return persistent discriminator value
+    String value();
+}

CodenameOne/src/com/codename1/annotations/db/ElementCollection.java

@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2026, 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.codename1.annotations.db;
+import java.lang.annotation.*;
+/// Mapping for an owned collection of scalar values.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.FIELD)
+public @interface ElementCollection {
+    /// Controls relationship initialization.
+    /// @return fetch policy; EAGER for to-one and LAZY for collections by default
+    FetchType fetch() default FetchType.LAZY;
+    /// Names the scalar value column in the collection table.
+    /// @return column name; element_value by default
+    String column() default "element_value";
+}

CodenameOne/src/com/codename1/annotations/db/Embeddable.java

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2026, 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.codename1.annotations.db;
+import java.lang.annotation.*;
+/// A reusable value object whose scalar fields are stored in its owner table.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.TYPE)
+public @interface Embeddable {
+}

CodenameOne/src/com/codename1/annotations/db/Embedded.java

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2026, 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.codename1.annotations.db;
+import java.lang.annotation.*;
+/// Flattens an embeddable value into the owner table using a field-name prefix.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.FIELD)
+public @interface Embedded {
+}

CodenameOne/src/com/codename1/annotations/db/EmbeddedId.java

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2026, 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.codename1.annotations.db;
+import java.lang.annotation.*;
+/// Flattens an embeddable identifier into the owner table using a field-name prefix.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.FIELD)
+public @interface EmbeddedId {
+}

CodenameOne/src/com/codename1/annotations/db/FetchType.java

@@ -0,0 +1,31 @@
+/*
+ * Copyright (c) 2026, 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.codename1.annotations.db;
+
+/// Controls when a mapped relationship is loaded.
+public enum FetchType {
+    /// Initializes the relationship when its owner is loaded.
+    EAGER,
+    /// Defers loading until enhanced field access or explicit session initialization.
+    LAZY
+}

CodenameOne/src/com/codename1/annotations/db/GeneratedValue.java

@@ -0,0 +1,36 @@
+/*
+ * Copyright (c) 2026, 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.codename1.annotations.db;
+import java.lang.annotation.*;
+/// Overrides the legacy Id.autoIncrement strategy for this identifier.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.FIELD)
+public @interface GeneratedValue {
+    /// Chooses identifier generation, overriding Id.autoIncrement.
+    /// Generated composite identifiers are not supported.
+    /// @return generation strategy; IDENTITY by default
+    GenerationType strategy() default GenerationType.IDENTITY;
+    /// Names the counter used by SEQUENCE or TABLE generation.
+    /// @return counter name; empty derives a name from the table and key column
+    String generator() default "";
+}

CodenameOne/src/com/codename1/annotations/db/GenerationType.java

@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2026, 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.codename1.annotations.db;
+
+/// Identifier generation strategies for a single identifier field.
+public enum GenerationType {
+    /// Uses a database-generated integral identity.
+    IDENTITY,
+    /// Assigns a generated UUID string.
+    UUID,
+    /// Uses a native PostgreSQL sequence, or the portable sequence table on other backends.
+    SEQUENCE,
+    /// Allocates integral identifiers using the portable sequence table.
+    TABLE
+}