Android Record Module doc updates

android-record/README.md

@@ -1,14 +1,26 @@
-Module that allows deserialization into records on Android, 
-where java records are supported through desugaring, 
-and Jackson's built-in support for records doesn't work, 
-since the desugared classes have a non-standard super class, 
+Module that allows (de)serialization of records using the canonical constructor and accessors on Android,
+where java records are supported through desugaring, and Jackson's built-in support for records doesn't work,
+since the desugared classes have a non-standard super class,
 and record component-related reflection methods are missing.
 
 See [Android Developers Blog article](https://android-developers.googleblog.com/2023/06/records-in-android-studio-flamingo.html)
 
-Note: this module is a no-op when no Android-desugared records are being deserialized,
+An attempt was made to make this module as consistent with Jackson's built-in support for records as possible,
+but gaps exist when using some of Jackson's advanced mapping features.
+
+Note: this module is a no-op when no Android-desugared records are being (de)serialized,
 so it is safe to use in code shared between Android and non-Android platforms.
 
+Note: the canonical record constructor is identified through matching of parameter names and types with fields.
+Therefore, this module doesn't allow a deserialized desugared record to have a custom constructor
+with the same set of parameter names and types as the canonical one.
+For the same reason, this module requires that desugared canonical record constructor parameter names
+be stored in class files. Apparently, with Android SDK 34 tooling, that is the case by default.
+If that ever changes, it may require an explicit setting in build files.
+
+Known limitation: this module replaces the default `ClassIntrospector`, 
+so it cannot be used together with any other module that does the same.
+
 ## Usage
 
 Functionality can be used by registering the module and then just deserializing things

android-record/src/main/java/com/fasterxml/jackson/module/androidrecord/AndroidRecordModule.java

@@ -44,17 +44,16 @@
  *   Android Developers Blog article</a>
  *
  * <p>
- * An attempt was made to make this module as consistent with Jackson's built-in support for records as possible,
- * but gaps exist when using some of Jackson's advanced mapping features.
- *
- * <p>
  * Note: this module is a no-op when no Android-desugared records are being (de)serialized,
  * so it is safe to use in code shared between Android and non-Android platforms.
  *
  * <p>
- * Note: the canonical record constructor is found through matching of parameter names and types with fields.
+ * Note: the canonical record constructor is identified through matching of parameter names and types with fields.
  * Therefore, this module doesn't allow a deserialized desugared record to have a custom constructor
  * with the same set of parameter names and types as the canonical one.
+ * For the same reason, this module requires that desugared canonical record constructor parameter names
+ * be stored in class files. Apparently, with Android SDK 34 tooling, that is the case by default.
+ * If that ever changes, it may require an explicit setting in build files.
  *
  * @author Eran Leshem
  **/

android-record/src/test/java/com/fasterxml/jackson/module/androidrecord/AndroidRecordTest.java

@@ -99,6 +99,10 @@ private MultipleConstructors(List<Integer> l, int i) {
     int i() {
       return i;
     }
+
+    List<String> l() {
+      return l;
+    }
   }