Back to Repositories

Testing Release Key Generation Workflow in Apollo Config

This test suite validates the ReleaseKeyGenerator functionality in Apollo, focusing on unique key generation and message processing for release management. The tests ensure thread-safe generation of unique release keys and proper message parsing capabilities.

Test Coverage Overview

The test suite provides comprehensive coverage of the ReleaseKeyGenerator utility class.

Key areas tested include:
  • Concurrent generation of unique release keys across different namespaces
  • Message parsing functionality for release key components
  • Thread safety validation with multiple executors
  • Edge cases for message format handling

Implementation Analysis

The testing approach employs concurrent execution patterns to validate key generation uniqueness.

Technical implementation features:
  • Uses ExecutorService for parallel testing
  • Implements CountDownLatch for synchronized test execution
  • Leverages ConcurrentHashSet for thread-safe result validation
  • Utilizes MockBeanFactory for test data generation

Technical Details

Testing infrastructure includes:
  • JUnit 4 testing framework
  • Google Guava Collections library
  • Mock objects for Namespace entities
  • Concurrent execution utilities
  • Custom MockBeanFactory for test data

Best Practices Demonstrated

The test suite exemplifies several testing best practices:

  • Proper isolation of test cases
  • Thorough concurrent execution testing
  • Clear test method naming conventions
  • Effective use of assertions for validation
  • Comprehensive edge case coverage
  • Clean test data setup and teardown

apolloconfig/apollo

apollo-biz/src/test/java/com/ctrip/framework/apollo/biz/utils/ReleaseKeyGeneratorTest.java

            
/*
 * Copyright 2024 Apollo Authors
 *
 * 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.ctrip.framework.apollo.biz.utils;

import com.google.common.collect.Sets;

import com.ctrip.framework.apollo.biz.MockBeanFactory;
import com.ctrip.framework.apollo.biz.entity.Namespace;

import java.util.List;
import org.junit.Test;

import java.util.Set;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.TimeUnit;

import static org.junit.Assert.assertEquals;

/**
 * @author Jason Song([email protected])
 */
public class ReleaseKeyGeneratorTest {

  @Test
  public void testGenerateReleaseKey() throws Exception {
    String someAppId = "someAppId";
    String someCluster = "someCluster";
    String someNamespace = "someNamespace";

    String anotherAppId = "anotherAppId";

    Namespace namespace = MockBeanFactory.mockNamespace(someAppId, someCluster, someNamespace);
    Namespace anotherNamespace = MockBeanFactory.mockNamespace(anotherAppId, someCluster, someNamespace);
    int generateTimes = 50000;
    Set<String> releaseKeys = Sets.newConcurrentHashSet();

    ExecutorService executorService = Executors.newFixedThreadPool(2);
    CountDownLatch latch = new CountDownLatch(1);

    executorService.submit(generateReleaseKeysTask(namespace, releaseKeys, generateTimes, latch));
    executorService.submit(generateReleaseKeysTask(anotherNamespace, releaseKeys, generateTimes, latch));

    latch.countDown();

    executorService.shutdown();
    executorService.awaitTermination(10, TimeUnit.SECONDS);

    //make sure keys are unique
    assertEquals(generateTimes * 2, releaseKeys.size());
  }

  @Test
  public void testMessageToList() {
    String message = "appId+cluster+namespace";
    List<String> keys = ReleaseMessageKeyGenerator.messageToList(message);
    assert keys != null;
    assertEquals(3, keys.size());
    assertEquals("appId", keys.get(0));
    assertEquals("cluster", keys.get(1));
    assertEquals("namespace", keys.get(2));

    message = "appId+cluster";
    keys = ReleaseMessageKeyGenerator.messageToList(message);
    assert keys != null;
    assertEquals(0, keys.size());
  }

  private Runnable generateReleaseKeysTask(Namespace namespace, Set<String> releaseKeys,
                                   int generateTimes, CountDownLatch latch) {
    return () -> {
      try {
        latch.await();
      } catch (InterruptedException e) {
        //ignore
      }
      for (int i = 0; i < generateTimes; i++) {
        releaseKeys.add(ReleaseKeyGenerator.generateReleaseKey(namespace));
      }
    };
  }

}