alluxio-master-2.x/core/common/src/test/java/alluxio/underfs/UnderFileSystemTest.java
/*
 * The Alluxio Open Foundation licenses this work under the Apache License, version 2.0
 * (the "License"). You may not use this work except in compliance with the License, which is
 * available at www.apache.org/licenses/LICENSE-2.0
 *
 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
 * either express or implied, as more fully set forth in the License.
 *
 * See the NOTICE file distributed with this work for information regarding copyright ownership.
 */

package alluxio.underfs;

import static org.junit.Assert.assertNull;

import alluxio.conf.AlluxioConfiguration;
import alluxio.conf.Configuration;

import org.junit.Assume;
import org.junit.Test;

/**
 * Unit tests for {@link UnderFileSystem}.
 */
public final class UnderFileSystemTest {

  private final AlluxioConfiguration mConfiguration = Configuration.global();

  /**
   * Tests the
   * {@link UnderFileSystemFactoryRegistry#find(String, alluxio.conf.AlluxioConfiguration)} method
   * when using a core factory.
   */
  @Test
  public void coreFactory() {
    // Supported in core
    UnderFileSystemFactory factory = UnderFileSystemFactoryRegistry.find("/test/path",
        mConfiguration);
    assertNull("An UnderFileSystemFactory should not exist for local file paths", factory);

    factory = UnderFileSystemFactoryRegistry.find("file:///test/path", mConfiguration);
    assertNull("An UnderFileSystemFactory should not exist for local file paths", factory);
  }

  /**
   * Tests the
   * {@link UnderFileSystemFactoryRegistry#find(String, alluxio.conf.AlluxioConfiguration)}
   * method when using an external factory.
   */
  @Test
  public void externalFactory() {
    // As we are going to use some Maven trickery to re-use the test cases as is in the external
    // modules this test needs to assume that only the core implementations are present as otherwise
    // when we try and run it in the external modules it will fail
    // In core there is only one under file system implementation, if there are any more we aren't
    // running in core
    Assume.assumeTrue(UnderFileSystemFactoryRegistry.available().size() == 1);

    // Requires additional modules
    UnderFileSystemFactory factory =
        UnderFileSystemFactoryRegistry.find("hdfs://localhost/test/path", mConfiguration);
    assertNull(
        "No UnderFileSystemFactory should exist for HDFS paths as it requires a separate module",
        factory);

    factory = UnderFileSystemFactoryRegistry.find("oss://localhost/test/path", mConfiguration);
    assertNull(
        "No UnderFileSystemFactory should exist for OSS paths as it requires a separate module",
        factory);

    factory = UnderFileSystemFactoryRegistry.find("s3://localhost/test/path", mConfiguration);
    assertNull(
        "No UnderFileSystemFactory should exist for S3 paths as it requires a separate module",
        factory);

    factory = UnderFileSystemFactoryRegistry.find("s3a://localhost/test/path", mConfiguration);
    assertNull(
        "No UnderFileSystemFactory should exist for S3 paths as it requires a separate module",
        factory);

    factory = UnderFileSystemFactoryRegistry.find("glusterfs://localhost/test/path",
        mConfiguration);
    assertNull("No UnderFileSystemFactory should exist for Gluster FS paths as it requires"
        + " a separate module", factory);
  }
}
