[#7332] feat(api): Support statistic interfaces

Author: jerqi

api/src/main/java/org/apache/gravitino/exceptions/IllegalStatisticNameException.java

@@ -0,0 +1,49 @@
+/*
+ * 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.gravitino.exceptions;
+
+import com.google.errorprone.annotations.FormatMethod;
+import com.google.errorprone.annotations.FormatString;
+
+/** An exception thrown when statistic has an illegal name */
+public class IllegalStatisticNameException extends GravitinoRuntimeException {
+  /**
+   * Constructs a new exception with the specified detail message.
+   *
+   * @param message the detail message.
+   * @param args the arguments to the message.
+   */
+  @FormatMethod
+  public IllegalStatisticNameException(@FormatString String message, Object... args) {
+    super(message, args);
+  }
+
+  /**
+   * Constructs a new exception with the specified detail message and cause.
+   *
+   * @param cause the cause.
+   * @param message the detail message.
+   * @param args the arguments to the message.
+   */
+  @FormatMethod
+  public IllegalStatisticNameException(
+      Throwable cause, @FormatString String message, Object... args) {
+    super(cause, message, args);
+  }
+}

api/src/main/java/org/apache/gravitino/exceptions/UnmodifiableStatisticException.java

@@ -0,0 +1,49 @@
+/*
+ * 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.gravitino.exceptions;
+
+import com.google.errorprone.annotations.FormatMethod;
+import com.google.errorprone.annotations.FormatString;
+
+/** An exception thrown when users modify an unmodifiable statistic */
+public class UnmodifiableStatisticException extends GravitinoRuntimeException {
+  /**
+   * Constructs a new exception with the specified detail message.
+   *
+   * @param message the detail message.
+   * @param args the arguments to the message.
+   */
+  @FormatMethod
+  public UnmodifiableStatisticException(@FormatString String message, Object... args) {
+    super(message, args);
+  }
+
+  /**
+   * Constructs a new exception with the specified detail message and cause.
+   *
+   * @param cause the cause.
+   * @param message the detail message.
+   * @param args the arguments to the message.
+   */
+  @FormatMethod
+  public UnmodifiableStatisticException(
+      Throwable cause, @FormatString String message, Object... args) {
+    super(cause, message, args);
+  }
+}

api/src/main/java/org/apache/gravitino/stats/BooleanValue.java

@@ -0,0 +1,64 @@
+/*
+ * 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.gravitino.stats;
+
+import java.util.Objects;
+
+/** Represents a boolean value in statistics. */
+public class BooleanValue implements StatisticValue<Boolean> {
+  private final Boolean value;
+
+  /**
+   * Constructor for BooleanValue.
+   *
+   * @param value the boolean value to be represented
+   */
+  public BooleanValue(Boolean value) {
+    this.value = value;
+  }
+
+  @Override
+  public Type type() {
+    return Type.BOOLEAN;
+  }
+
+  @Override
+  public Boolean value() {
+    return value;
+  }
+
+  @Override
+  public String toString() {
+    return "BooleanValue{" + "value=" + value + '}';
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(value);
+  }
+
+  @Override
+  public boolean equals(Object obj) {
+    if (!(obj instanceof BooleanValue)) {
+      return false;
+    }
+    BooleanValue that = (BooleanValue) obj;
+    return Objects.equals(value, that.value);
+  }
+}

api/src/main/java/org/apache/gravitino/stats/DecimalValue.java

@@ -0,0 +1,65 @@
+/*
+ * 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.gravitino.stats;
+
+import java.util.Objects;
+
+/** Represents a decimal value in statistics. */
+public class DecimalValue implements StatisticValue<Double> {
+  private final Double value;
+
+  /**
+   * Constructor for DecimalValue.
+   *
+   * @param value the decimal value to be represented
+   */
+  public DecimalValue(Double value) {
+    this.value = value;
+  }
+
+  @Override
+  public Type type() {
+    return Type.DECIMAL;
+  }
+
+  @Override
+  public Double value() {
+    return value;
+  }
+
+  @Override
+  public String toString() {
+    return "DecimalValue{" + "value=" + value + '}';
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(value);
+  }
+
+  @Override
+  public boolean equals(Object obj) {
+    if (!(obj instanceof DecimalValue)) {
+      return false;
+    }
+    DecimalValue that = (DecimalValue) obj;
+
+    return Objects.equals(value, that.value);
+  }
+}

api/src/main/java/org/apache/gravitino/stats/ListValue.java

@@ -0,0 +1,65 @@
+/*
+ * 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.gravitino.stats;
+
+import java.util.List;
+import java.util.Objects;
+
+/** Represents a list of statistic values in statistics. */
+public class ListValue implements StatisticValue<List<StatisticValue>> {
+  private final List<StatisticValue> values;
+
+  /**
+   * Constructs a ListValue with the given list of statistic values.
+   *
+   * @param values a list of StatisticValue objects
+   */
+  public ListValue(List<StatisticValue> values) {
+    this.values = values;
+  }
+
+  @Override
+  public Type type() {
+    return Type.LIST;
+  }
+
+  @Override
+  public List<StatisticValue> value() {
+    return values;
+  }
+
+  @Override
+  public String toString() {
+    return "ArrayValue{" + "value=" + values + '}';
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hashCode(values);
+  }
+
+  @Override
+  public boolean equals(Object obj) {
+    if (!(obj instanceof ListValue)) {
+      return false;
+    }
+    ListValue that = (ListValue) obj;
+    return Objects.equals(values, that.values);
+  }
+}

api/src/main/java/org/apache/gravitino/stats/LongValue.java

@@ -0,0 +1,67 @@
+/*
+ * 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.gravitino.stats;
+
+import java.util.Objects;
+
+/** Represents a long value in statistics. */
+public class LongValue implements StatisticValue<Long> {
+
+  private final Long value;
+
+  /**
+   * Constructor for LongValue.
+   *
+   * @param value the long value to be represented
+   */
+  public LongValue(Long value) {
+    this.value = value;
+  }
+
+  @Override
+  public Type type() {
+    return Type.LONG;
+  }
+
+  @Override
+  public Long value() {
+    return value;
+  }
+
+  @Override
+  public String toString() {
+    return "LongValue{" + "value=" + value + '}';
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(value);
+  }
+
+  @Override
+  public boolean equals(Object obj) {
+    if (!(obj instanceof LongValue)) {
+      return false;
+    }
+
+    LongValue that = (LongValue) obj;
+
+    return Objects.equals(this.value, that.value);
+  }
+}