code style and licence

Author: loushaokun

java/fory-core/src/main/java/org/apache/fory/annotation/NotForAndroid.java

@@ -1,3 +1,22 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
 package org.apache.fory.annotation;
 
 import java.lang.annotation.ElementType;

java/fory-core/src/main/java/org/apache/fory/annotation/PartialAndroidSupport.java

@@ -1,3 +1,22 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
 package org.apache.fory.annotation;
 
 import java.lang.annotation.Documented;
@@ -6,30 +25,14 @@
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
-/**
- * 标注一个方法在 Android 平台上只是部分或条件性支持。
- *
- * <p>这意味着该方法可能在某些 Android API 级别、特定设备或特定执行分支下才能正常工作， 调用者需要仔细阅读说明或源码来确保其使用场景的兼容性。
- */
 @Documented
 @Retention(RetentionPolicy.CLASS)
 @Target({ElementType.METHOD, ElementType.CONSTRUCTOR, ElementType.TYPE})
 public @interface PartialAndroidSupport {
 
-  /**
-   * 在哪个最低 Android API 级别以上才被支持。 默认为 -1，表示未指定或与此无关。
-   *
-   * @return 最低支持的 API level。
-   */
   int minApiLevel() default -1;
 
-  /**
-   * 描述不支持或部分支持的具体原因、条件或分支情况。 例如："仅在硬件加速开启时有效" 或 "在软件渲染路径下会抛出异常"。
-   *
-   * @return 具体原因的描述文字。
-   */
   String reason() default "该方法在 Android 上的所有分支和条件下不保证完全支持，请查阅文档或源码。";
 
-  /** 指向更详细文档或 issue 的链接。 * @return 文档的 URL。 */
   String docUrl() default "";
 }

java/fory-core/src/main/java/org/apache/fory/memory/MemoryBuffer.java

@@ -367,15 +367,18 @@ public void get(int offset, ByteBuffer target, int numBytes) {
     final int targetPos = target.position();
     if (target.isDirect()) {
       final long sourceOffset = address + offset;
-      if (sourceOffset > addressLimit - numBytes) throwOOBException();
+      if (sourceOffset > addressLimit - numBytes) {
+        throwOOBException();
+      }
       final long targetAddr = ByteBufferUtil.getAddress(target) + targetPos;
       if (Platform.IS_ANDROID) {
         if (onHeap) {
           target.put(heapMemory, memoryOffset + offset, numBytes); // 此操作会改变target的position，无需再调整了
           return;
+        } else {
+          // Android只支持这个三个参数的copyMemory
+          Platform.UNSAFE.copyMemory(sourceOffset, targetAddr, numBytes);
         }
-        // Android只支持这个三个参数的copyMemory
-        else Platform.UNSAFE.copyMemory(sourceOffset, targetAddr, numBytes);
       } else {
         Platform.copyMemory(heapMemory, sourceOffset, null, targetAddr, numBytes);
       }
@@ -395,7 +398,9 @@ public void put(int offset, ByteBuffer source, int numBytes) {
     if (source.isDirect()) {
       final long sourceAddr = ByteBufferUtil.getAddress(source) + sourcePos;
       final long targetAddr = address + offset;
-      if (targetAddr > addressLimit - numBytes) throwOOBException();
+      if (targetAddr > addressLimit - numBytes) {
+        throwOOBException();
+      }
       if (Platform.IS_ANDROID) {
         if (onHeap) {
           source.get(heapMemory, memoryOffset + offset, numBytes); // 此操作会改变source的position，无需再调整了
@@ -1287,7 +1292,9 @@ public void coverMemoryWithArray(
       Types.JavaArray eleType,
       boolean autoFill) {
     boolean writeMode = bufOffset < 0;
-    if (writeMode) bufOffset = writerIndex;
+    if (writeMode) {
+      bufOffset = writerIndex;
+    }
     int numBytes = length * eleType.bytesPerEle;
     if (autoFill) {
       ensure(bufOffset + numBytes);
@@ -1329,10 +1336,14 @@ public void coverMemoryWithArray(
           case DOUBLE:
             buffer.asDoubleBuffer().put((double[]) arr, offset, length);
             break;
+          default:
+            throw new IllegalStateException("Unexpected value: " + eleType);
         }
       }
     }
-    if (writeMode) writerIndex += numBytes;
+    if (writeMode) {
+      writerIndex += numBytes;
+    }
   }
 
   public void writeArray(
@@ -2554,7 +2565,9 @@ public void copyTo(
       Types.JavaArray eleType,
       boolean checkSize) {
     boolean readMode = bufOffset < 0;
-    if (readMode) bufOffset = readerIndex;
+    if (readMode) {
+      bufOffset = readerIndex;
+    }
     int numBytes = length * eleType.bytesPerEle;
     if (checkSize) {
       int remaining = size - bufOffset;
@@ -2599,10 +2612,39 @@ public void copyTo(
           case DOUBLE:
             buffer.asDoubleBuffer().get((double[]) target, offset, length);
             break;
+          default:
+            throw new IllegalStateException("Unsupported element type: " + eleType);
         }
       }
     }
-    if (readMode) readerIndex += numBytes;
+    if (readMode) {
+      readerIndex += numBytes;
+    }
+  }
+
+  public void copyTo(int offset, MemoryBuffer target, int targetOffset, int numBytes) {
+    final long thisPointer = this.address + offset;
+    final long otherPointer = target.address + targetOffset;
+    if ((numBytes | offset | targetOffset) >= 0
+        && thisPointer <= this.addressLimit - numBytes
+        && otherPointer <= target.addressLimit - numBytes) {
+      if (Platform.IS_ANDROID) {
+        int thisOldLimit = this.buffer.limit();
+        this.buffer.position(offset);
+        this.buffer.limit(offset + numBytes);
+        target.buffer.position(targetOffset);
+        target.buffer.put(this.buffer);
+        this.buffer.limit(thisOldLimit);
+      } else {
+        Platform.copyMemory(
+            this.heapMemory, thisPointer, target.heapMemory, otherPointer, numBytes);
+      }
+    } else {
+      throw new IndexOutOfBoundsException(
+          String.format(
+              "offset=%d, targetOffset=%d, numBytes=%d, address=%d, targetAddress=%d",
+              offset, targetOffset, numBytes, this.address, target.address));
+    }
   }
 
   public void readTo(Object target, int offset, int length, Types.JavaArray eleType) {
@@ -2685,31 +2727,6 @@ public void copyFromDirectUnsafe(long offset, long sourcePointer, long numBytes)
     Platform.copyMemory(null, sourcePointer, this.heapMemory, thisPointer, numBytes);
   }
 
-  public void copyTo(int offset, MemoryBuffer target, int targetOffset, int numBytes) {
-    final long thisPointer = this.address + offset;
-    final long otherPointer = target.address + targetOffset;
-    if ((numBytes | offset | targetOffset) >= 0
-        && thisPointer <= this.addressLimit - numBytes
-        && otherPointer <= target.addressLimit - numBytes) {
-      if (Platform.IS_ANDROID) {
-        int thisOldLimit = this.buffer.limit();
-        this.buffer.position(offset);
-        this.buffer.limit(offset + numBytes);
-        target.buffer.position(targetOffset);
-        target.buffer.put(this.buffer);
-        this.buffer.limit(thisOldLimit);
-      } else {
-        Platform.copyMemory(
-            this.heapMemory, thisPointer, target.heapMemory, otherPointer, numBytes);
-      }
-    } else {
-      throw new IndexOutOfBoundsException(
-          String.format(
-              "offset=%d, targetOffset=%d, numBytes=%d, address=%d, targetAddress=%d",
-              offset, targetOffset, numBytes, this.address, target.address));
-    }
-  }
-
   public void copyFrom(int offset, MemoryBuffer source, int sourcePointer, int numBytes) {
     source.copyTo(sourcePointer, this, offset, numBytes);
   }
@@ -2826,9 +2843,10 @@ public void pointTo(byte[] buffer, int offset, int length) {
   // TODO: support android
   @NotForAndroid(reason = "Android does not support support off-heap memory only by address")
   public static MemoryBuffer fromNativeAddress(long address, int size) {
-    if (Platform.IS_ANDROID)
+    if (Platform.IS_ANDROID) {
       throw new UnsupportedOperationException(
           "Android does not support support off-heap memory only by address");
+    }
     return new MemoryBuffer(address, null, size, null, false);
   }
 
@@ -2839,6 +2857,16 @@ public static MemoryBuffer wrap(byte[] buffer) {
     return new MemoryBuffer(buffer, 0, buffer.length);
   }
 
+  /**
+   * Creates a new memory segment that represents the memory backing the given byte buffer section
+   * of [buffer.position(), buffer,limit()].
+   *
+   * @param byteBuffer a direct buffer or heap buffer
+   */
+  public static MemoryBuffer wrap(ByteBuffer byteBuffer) {
+    return fromByteBuffer(byteBuffer, byteBuffer.remaining());
+  }
+
   public static MemoryBuffer buffer(int size) {
     return newHeapBuffer(size);
   }
@@ -2855,16 +2883,6 @@ public static MemoryBuffer bufferDirect(int size) {
     return new MemoryBuffer(-1, ByteBuffer.allocateDirect(size), size, null, true);
   }
 
-  /**
-   * Creates a new memory segment that represents the memory backing the given byte buffer section
-   * of [buffer.position(), buffer,limit()].
-   *
-   * @param byteBuffer a direct buffer or heap buffer
-   */
-  public static MemoryBuffer wrap(ByteBuffer byteBuffer) {
-    return fromByteBuffer(byteBuffer, byteBuffer.remaining());
-  }
-
   /**
    * Creates a new memory buffer that represents the native memory at the absolute address given by
    * the pointer.

java/fory-core/src/main/java/org/apache/fory/resolver/ClassResolver.java

@@ -347,8 +347,8 @@ private void addDefaultSerializers() {
     addDefaultSerializer(Locale.class, new LocaleSerializer(fory));
     if (!Platform.IS_ANDROID) {
       addDefaultSerializer(
-        LambdaSerializer.ReplaceStub.class,
-        new LambdaSerializer(fory, LambdaSerializer.ReplaceStub.class));
+          LambdaSerializer.ReplaceStub.class,
+          new LambdaSerializer(fory, LambdaSerializer.ReplaceStub.class));
     }
     addDefaultSerializer(
         JdkProxySerializer.ReplaceStub.class,

java/fory-core/src/main/java/org/apache/fory/serializer/Serializers.java

@@ -215,7 +215,7 @@ public abstract static class AbstractStringBuilderSerializer<T extends CharSeque
       if (RESTRICTED_STRING_BUILDER) {
         GET_CODER = null;
         GET_VALUE = null;
-      }else {
+      } else {
         GET_VALUE = (Function) makeGetterFunction(StringBuilder.class.getSuperclass(), "getValue");
         ToIntFunction<CharSequence> getCoder;
         try {