Back to Repositories

Testing SimpleCacheSpan Implementation in SmartTube ExoPlayer Cache System

A comprehensive test suite for SimpleCacheSpan functionality in ExoPlayer’s caching system, focusing on cache file management and validation. The tests verify cache span creation, file naming conventions, and version upgrade mechanisms for Android media caching.

Test Coverage Overview

The test suite provides extensive coverage of SimpleCacheSpan functionality:
  • Cache file creation and validation
  • File naming pattern verification
  • Version upgrade compatibility testing
  • Edge case handling for invalid file names and special characters
  • Cache span creation with various offsets and timestamps

Implementation Analysis

The testing approach employs JUnit4 with AndroidJUnit4 runner for Android-specific testing context. The implementation uses a systematic pattern of creating test files and validating cache span properties, with careful attention to file system operations and cache index management.
  • Uses setUp/tearDown pattern for test isolation
  • Implements helper methods for test file creation
  • Employs Truth assertion library for detailed verification

Technical Details

Testing infrastructure includes:
  • AndroidJUnit4 test runner
  • Google Truth assertion library
  • TestUtil for database provider setup
  • Temporary file system management
  • CachedContentIndex for cache management
  • File I/O operations for test file creation

Best Practices Demonstrated

The test suite exemplifies several testing best practices:
  • Proper test cleanup and resource management
  • Comprehensive error case handling
  • Systematic test method organization
  • Clear test naming conventions
  • Detailed assertion messages for debugging
  • Isolation of test cases through setUp/tearDown methods

yuliskov/smarttube

exoplayer-amzn-2.10.6/library/core/src/test/java/com/google/android/exoplayer2/upstream/cache/SimpleCacheSpanTest.java

            
/*
 * Copyright (C) 2016 The Android Open Source Project
 *
 * Licensed 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 com.google.android.exoplayer2.upstream.cache;

import static com.google.common.truth.Truth.assertThat;
import static com.google.common.truth.Truth.assertWithMessage;

import android.util.LongSparseArray;
import androidx.test.core.app.ApplicationProvider;
import androidx.test.ext.junit.runners.AndroidJUnit4;
import com.google.android.exoplayer2.testutil.TestUtil;
import com.google.android.exoplayer2.util.Util;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.Set;
import java.util.TreeSet;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;

/** Unit tests for {@link SimpleCacheSpan}. */
@RunWith(AndroidJUnit4.class)
public class SimpleCacheSpanTest {

  public static File createCacheSpanFile(
      File cacheDir, int id, long offset, long length, long lastTouchTimestamp) throws IOException {
    File cacheFile = SimpleCacheSpan.getCacheFile(cacheDir, id, offset, lastTouchTimestamp);
    createTestFile(cacheFile, length);
    return cacheFile;
  }

  private CachedContentIndex index;
  private File cacheDir;

  @Before
  public void setUp() throws Exception {
    cacheDir =
        Util.createTempDirectory(ApplicationProvider.getApplicationContext(), "ExoPlayerTest");
    index = new CachedContentIndex(TestUtil.getTestDatabaseProvider());
  }

  @After
  public void tearDown() {
    Util.recursiveDelete(cacheDir);
  }

  @Test
  public void testCacheFile() throws Exception {
    assertCacheSpan("key1", 0, 0);
    assertCacheSpan("key2", 1, 2);
    assertCacheSpan("<>:\"/\\|?*%", 1, 2);
    assertCacheSpan("key3", 1, 2);

    assertNullCacheSpan(new File("parent"), "key4", -1, 2);
    assertNullCacheSpan(new File("parent"), "key5", 1, -2);

    assertCacheSpan(
        "A newline (line feed) character \n"
            + "A carriage-return character followed immediately by a newline character \r\n"
            + "A standalone carriage-return character \r"
            + "A next-line character \u0085"
            + "A line-separator character \u2028"
            + "A paragraph-separator character \u2029", 1, 2);
  }

  @Test
  public void testUpgradeFileName() throws Exception {
    String key = "abc%def";
    int id = index.assignIdForKey(key);
    File v3file = createTestFile(id + ".0.1.v3.exo");
    File v2file = createTestFile("abc%25def.1.2.v2.exo"); // %25 is '%' after escaping
    File wrongEscapedV2file = createTestFile("abc%2Gdef.3.4.v2.exo"); // 2G is invalid hex
    File v1File = createTestFile("abc%def.5.6.v1.exo"); // V1 did not escape

    for (File file : cacheDir.listFiles()) {
      SimpleCacheSpan cacheEntry = SimpleCacheSpan.createCacheEntry(file, file.length(), index);
      if (file.equals(wrongEscapedV2file)) {
        assertThat(cacheEntry).isNull();
      } else {
        assertThat(cacheEntry).isNotNull();
      }
    }

    assertThat(v3file.exists()).isTrue();
    assertThat(v2file.exists()).isFalse();
    assertThat(wrongEscapedV2file.exists()).isTrue();
    assertThat(v1File.exists()).isFalse();

    File[] files = cacheDir.listFiles();
    assertThat(files).hasLength(4);

    Set<String> keys = index.getKeys();
    assertWithMessage("There should be only one key for all files.").that(keys).hasSize(1);
    assertThat(keys).contains(key);

    TreeSet<SimpleCacheSpan> spans = index.get(key).getSpans();
    assertWithMessage("upgradeOldFiles() shouldn't add any spans.").that(spans.isEmpty()).isTrue();

    LongSparseArray<Long> cachedPositions = new LongSparseArray<>();
    for (File file : files) {
      SimpleCacheSpan cacheSpan = SimpleCacheSpan.createCacheEntry(file, file.length(), index);
      if (cacheSpan != null) {
        assertThat(cacheSpan.key).isEqualTo(key);
        cachedPositions.put(cacheSpan.position, cacheSpan.lastTouchTimestamp);
      }
    }

    assertThat(cachedPositions.get(0)).isEqualTo(1);
    assertThat(cachedPositions.get(1)).isEqualTo(2);
    assertThat(cachedPositions.get(5)).isEqualTo(6);
  }

  private static void createTestFile(File file, long length) throws IOException {
    FileOutputStream output = new FileOutputStream(file);
    for (int i = 0; i < length; i++) {
      output.write(i);
    }
    output.close();
  }

  private File createTestFile(String name) throws IOException {
    File file = new File(cacheDir, name);
    createTestFile(file, 1);
    return file;
  }

  private void assertCacheSpan(String key, long offset, long lastTouchTimestamp)
      throws IOException {
    int id = index.assignIdForKey(key);
    long cacheFileLength = 1;
    File cacheFile = createCacheSpanFile(cacheDir, id, offset, cacheFileLength, lastTouchTimestamp);
    SimpleCacheSpan cacheSpan = SimpleCacheSpan.createCacheEntry(cacheFile, cacheFileLength, index);
    String message = cacheFile.toString();
    assertWithMessage(message).that(cacheSpan).isNotNull();
    assertWithMessage(message).that(cacheFile.getParentFile()).isEqualTo(cacheDir);
    assertWithMessage(message).that(cacheSpan.key).isEqualTo(key);
    assertWithMessage(message).that(cacheSpan.position).isEqualTo(offset);
    assertWithMessage(message).that(cacheSpan.length).isEqualTo(1);
    assertWithMessage(message).that(cacheSpan.isCached).isTrue();
    assertWithMessage(message).that(cacheSpan.file).isEqualTo(cacheFile);
    assertWithMessage(message).that(cacheSpan.lastTouchTimestamp).isEqualTo(lastTouchTimestamp);
  }

  private void assertNullCacheSpan(File parent, String key, long offset, long lastTouchTimestamp) {
    long cacheFileLength = 0;
    File cacheFile =
        SimpleCacheSpan.getCacheFile(parent, index.assignIdForKey(key), offset, lastTouchTimestamp);
    CacheSpan cacheSpan = SimpleCacheSpan.createCacheEntry(cacheFile, cacheFileLength, index);
    assertWithMessage(cacheFile.toString()).that(cacheSpan).isNull();
  }

}