docs: more improvements

Signed-off-by: tison <wander4096@gmail.com>

bindings/java/src/error.rs

@@ -39,7 +39,7 @@ impl Error {
  &self,
  env: &mut JNIEnv<'local>,
  ) -> jni::errors::Result<JThrowable<'local>> {
- let class = env.find_class("org/apache/opendal/exception/OpenDALException")?;
+ let class = env.find_class("org/apache/opendal/OpenDALException")?;
  let code = env.new_string(match self.inner.kind() {
  ErrorKind::Unexpected => "Unexpected",
  ErrorKind::Unsupported => "Unsupported",

bindings/java/src/main/java/org/apache/opendal/BlockingOperator.java

@@ -22,7 +22,7 @@
 import java.util.Map;
 
 /**
- * A {@code BlockingOperator} represents an underneath OpenDAL operator that
+ * BlockingOperator represents an underneath OpenDAL operator that
  * accesses data synchronously.
  */
 public class BlockingOperator extends NativeObject {

bindings/java/src/main/java/org/apache/opendal/Environment.java

@@ -24,6 +24,9 @@
 import java.io.UncheckedIOException;
 import java.util.Properties;
 
+/**
+ * Environment resolves environment-specific project metadata.
+ */
 public enum Environment {
  INSTANCE;
 

bindings/java/src/main/java/org/apache/opendal/NativeObject.java

@@ -23,7 +23,7 @@
 import java.util.concurrent.atomic.AtomicReference;
 
 /**
- * {@code NativeObject} is the base-class of all OpenDAL classes that have
+ * NativeObject is the base-class of all OpenDAL classes that have
  * a pointer to a native object.
  *
  * <p>

bindings/java/src/main/java/org/apache/opendal/exception/OpenDALException.java → bindings/java/src/main/java/org/apache/opendal/OpenDALException.java

@@ -17,10 +17,10 @@
  * under the License.
  */
 
-package org.apache.opendal.exception;
+package org.apache.opendal;
 
 /**
- * A OpenDALException encapsulates the error of an operation. This exception
+ * An OpenDALException encapsulates the error of an operation. This exception
  * type is used to describe an internal error from the native opendal library.
  */
 public class OpenDALException extends RuntimeException {

bindings/java/src/main/java/org/apache/opendal/Operator.java

@@ -25,7 +25,7 @@
 import java.util.concurrent.ConcurrentHashMap;
 
 /**
- * An {@code Operator} represents an underneath OpenDAL operator that
+ * Operator represents an underneath OpenDAL operator that
  * accesses data asynchronously.
  */
 public class Operator extends NativeObject {

bindings/java/src/main/java/org/apache/opendal/package-info.java

@@ -0,0 +1,20 @@
+/*
+ * 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.opendal;

bindings/java/src/test/java/org/apache/opendal/BlockingOperatorTest.java

@@ -23,7 +23,6 @@
 import static org.assertj.core.api.Assertions.assertThatExceptionOfType;
 import java.util.HashMap;
 import java.util.Map;
-import org.apache.opendal.exception.OpenDALException;
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;

bindings/java/src/test/java/org/apache/opendal/OperatorTest.java

@@ -23,7 +23,6 @@
 import java.util.HashMap;
 import java.util.Map;
 import java.util.concurrent.CompletionException;
-import org.apache.opendal.exception.OpenDALException;
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
@@ -49,7 +48,7 @@ public void testCreateAndDelete() {
  assertThat(op.read("testCreateAndDelete").join()).isEqualTo("Odin");
  op.delete("testCreateAndDelete");
  op.stat("testCreateAndDelete")
-  .handle((r, e) -> {
+ .handle((r, e) -> {
  assertThat(r).isNull();
  assertThat(e).isInstanceOf(CompletionException.class).hasCauseInstanceOf(OpenDALException.class);
  OpenDALException.Code code = ((OpenDALException) e.getCause()).getCode();