Converters: add more details to class docs, note default usage

Author: greenrobot-team

objectbox-java/src/main/java/io/objectbox/converter/IntegerFlexMapConverter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2020-2021 ObjectBox Ltd. All rights reserved.
+ * Copyright 2020-2024 ObjectBox Ltd. All rights reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -17,7 +17,9 @@
 package io.objectbox.converter;
 
 /**
- * Used to automatically convert {@code Map<Integer, V>}.
+ * A {@link FlexObjectConverter} that uses {@link Integer} as map keys.
+ * <p>
+ * Used by default to convert {@code Map<Integer, V>}.
  */
 public class IntegerFlexMapConverter extends FlexObjectConverter {
 

objectbox-java/src/main/java/io/objectbox/converter/IntegerLongMapConverter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2020-2021 ObjectBox Ltd. All rights reserved.
+ * Copyright 2020-2024 ObjectBox Ltd. All rights reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -19,9 +19,9 @@
 import io.objectbox.flatbuffers.FlexBuffers;
 
 /**
- * Used to automatically convert {@code Map<Integer, Long>}.
+ * Like {@link IntegerFlexMapConverter}, but always restores integer map values as {@link Long}.
  * <p>
- * Unlike {@link FlexObjectConverter} always restores integer map values as {@link Long}.
+ * Used by default to convert {@code Map<Integer, Long>}.
  */
 public class IntegerLongMapConverter extends IntegerFlexMapConverter {
     @Override

objectbox-java/src/main/java/io/objectbox/converter/LongFlexMapConverter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2020-2021 ObjectBox Ltd. All rights reserved.
+ * Copyright 2020-2024 ObjectBox Ltd. All rights reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -17,7 +17,9 @@
 package io.objectbox.converter;
 
 /**
- * Used to automatically convert {@code Map<Long, V>}.
+ * A {@link FlexObjectConverter} that uses {@link Long} as map keys.
+ * <p>
+ * Used by default to convert {@code Map<Long, V>}.
  */
 public class LongFlexMapConverter extends FlexObjectConverter {
 

objectbox-java/src/main/java/io/objectbox/converter/LongLongMapConverter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2020-2021 ObjectBox Ltd. All rights reserved.
+ * Copyright 2020-2024 ObjectBox Ltd. All rights reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -19,9 +19,9 @@
 import io.objectbox.flatbuffers.FlexBuffers;
 
 /**
- * Used to automatically convert {@code Map<Long, Long>}.
+ * Like {@link LongFlexMapConverter}, but always restores integer map values as {@link Long}.
  * <p>
- * Unlike {@link FlexObjectConverter} always restores integer map values as {@link Long}.
+ * Used by default to convert {@code Map<Long, Long>}.
  */
 public class LongLongMapConverter extends LongFlexMapConverter {
     @Override

objectbox-java/src/main/java/io/objectbox/converter/StringFlexMapConverter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2020-2021 ObjectBox Ltd. All rights reserved.
+ * Copyright 2020-2024 ObjectBox Ltd. All rights reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -17,7 +17,9 @@
 package io.objectbox.converter;
 
 /**
- * Used to automatically convert {@code Map<String, V>}.
+ * A {@link FlexObjectConverter}.
+ * <p>
+ * Used by default to convert {@code Map<String, V>}.
  */
 public class StringFlexMapConverter extends FlexObjectConverter {
 }

objectbox-java/src/main/java/io/objectbox/converter/StringLongMapConverter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2020-2021 ObjectBox Ltd. All rights reserved.
+ * Copyright 2020-2024 ObjectBox Ltd. All rights reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -19,7 +19,9 @@
 import io.objectbox.flatbuffers.FlexBuffers;
 
 /**
- * Used to automatically convert {@code Map<String, Long>}.
+ * Like {@link StringFlexMapConverter}, but always restores integer map values as {@link Long}.
+ * <p>
+ * Used by default to convert {@code Map<String, Long>}.
  */
 public class StringLongMapConverter extends StringFlexMapConverter {
     @Override