org.apache.hudi.storage.StoragePathInfo Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of hudi-flink1.17-bundle Show documentation
The newest version!
/*
 * 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.hudi.storage;

import org.apache.hudi.ApiMaturityLevel;
import org.apache.hudi.PublicAPIClass;
import org.apache.hudi.PublicAPIMethod;

import java.io.Serializable;
import java.util.Arrays;

/**
 * Represents the information of a storage path representing a directory or a file.
 * The APIs are mainly based on {@code org.apache.hadoop.fs.FileStatus} class
 * with simplification based on what Hudi needs.
 */
@PublicAPIClass(maturity = ApiMaturityLevel.EVOLVING)
public class StoragePathInfo implements Serializable, Comparable {
  private final StoragePath path;
  private final long length;
  private final boolean isDirectory;
  private final short blockReplication;
  private final long blockSize;
  private final long modificationTime;
  private final String[] locations;

  public StoragePathInfo(StoragePath path,
                         long length,
                         boolean isDirectory,
                         short blockReplication,
                         long blockSize,
                         long modificationTime) {
    this(path, length, isDirectory, blockReplication,
        blockSize, modificationTime, null);
  }

  public StoragePathInfo(StoragePath path,
                         long length,
                         boolean isDirectory,
                         short blockReplication,
                         long blockSize,
                         long modificationTime,
                         String[] locations) {
    this.path = path;
    this.length = length;
    this.isDirectory = isDirectory;
    this.blockReplication = blockReplication;
    this.blockSize = blockSize;
    this.modificationTime = modificationTime;
    this.locations = locations;
  }

  /**
   * @return the path.
   */
  @PublicAPIMethod(maturity = ApiMaturityLevel.EVOLVING)
  public StoragePath getPath() {
    return path;
  }

  /**
   * @return the length of a file in bytes.
   */
  @PublicAPIMethod(maturity = ApiMaturityLevel.EVOLVING)
  public long getLength() {
    return length;
  }

  /**
   * @return whether this is a file.
   */
  @PublicAPIMethod(maturity = ApiMaturityLevel.EVOLVING)
  public boolean isFile() {
    return !isDirectory;
  }

  /**
   * @return whether this is a directory.
   */
  @PublicAPIMethod(maturity = ApiMaturityLevel.EVOLVING)
  public boolean isDirectory() {
    return isDirectory;
  }

  /**
   * @return the block replication if applied.
   */
  @PublicAPIMethod(maturity = ApiMaturityLevel.EVOLVING)
  public short getBlockReplication() {
    return blockReplication;
  }

  /**
   * @return the block size in bytes if applied.
   */
  @PublicAPIMethod(maturity = ApiMaturityLevel.EVOLVING)
  public long getBlockSize() {
    return blockSize;
  }

  /**
   * @return the modification of a file.
   */
  @PublicAPIMethod(maturity = ApiMaturityLevel.EVOLVING)
  public long getModificationTime() {
    return modificationTime;
  }

  /**
   * @return the locations of the file in the file system, possibly null.
   */
  @PublicAPIMethod(maturity = ApiMaturityLevel.EVOLVING)
  public String[] getLocations() {
    return locations;
  }

  @Override
  public int compareTo(StoragePathInfo o) {
    return this.getPath().compareTo(o.getPath());
  }

  @Override
  public boolean equals(Object o) {
    if (this == o) {
      return true;
    }
    if (o == null || getClass() != o.getClass()) {
      return false;
    }
    StoragePathInfo that = (StoragePathInfo) o;
    // PLEASE NOTE that here we follow the same contract hadoop's FileStatus provides,
    // i.e., the equality is purely based on the path.
    return getPath().equals(that.getPath());
  }

  @Override
  public int hashCode() {
    // PLEASE NOTE that here we follow the same contract hadoop's FileStatus provides,
    // i.e., the hash code is purely based on the path.
    return getPath().hashCode();
  }

  @Override
  public String toString() {
    return "StoragePathInfo{"
        + "path=" + path
        + ", length=" + length
        + ", isDirectory=" + isDirectory
        + ", blockReplication=" + blockReplication
        + ", blockSize=" + blockSize
        + ", modificationTime=" + modificationTime
        + ", locations=" + Arrays.toString(locations)
        + '}';
  }
}