Back to Repositories

Testing Hystrix Command Fallback Integration in Netflix/Hystrix

This test suite validates Hystrix fallback functionality in a Spring context environment, focusing on command fallback patterns and error handling. The suite extends BasicCommandFallbackTest to verify fallback behavior when primary command execution fails.

Test Coverage Overview

The test coverage focuses on Hystrix’s fallback mechanisms within Spring applications.

Key areas tested include:

Command fallback execution paths
Spring AOP integration with CGLIB
User service fallback scenarios
Integration between Hystrix commands and Spring beans

Implementation Analysis

The testing approach leverages Spring’s testing framework with JUnit4 integration. It implements a hierarchical structure extending BasicCommandFallbackTest while utilizing Spring’s dependency injection for service instantiation.

Technical patterns include:

Spring context configuration with @ContextConfiguration
Autowired service injection
CGLIB-based AOP configuration
Bean configuration through @Configurable annotation

Technical Details

Testing infrastructure includes:

SpringJUnit4ClassRunner for test execution
Spring Context configuration classes
AopCglibConfig for aspect-oriented programming
Autowired dependency injection
Bean configuration through @Bean annotations
Integration with Hystrix’s command pattern implementation

Best Practices Demonstrated

The test suite exemplifies several testing best practices in Spring-Hystrix integration testing.

Notable practices include:

Clean separation of concerns between test configuration and test cases
Proper use of Spring’s testing annotations and runners
Effective dependency injection in test scenarios
Modular test configuration through separate config classes
Extension of base test classes for reusability

netflix/hystrix

hystrix-contrib/hystrix-javanica/src/test/java/com/netflix/hystrix/contrib/javanica/test/spring/fallback/CommandFallbackTest.java

            
/**
 * Copyright 2015 Netflix, Inc.
 * <p/>
 * 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
 * <p/>
 * http://www.apache.org/licenses/LICENSE-2.0
 * <p/>
 * 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.netflix.hystrix.contrib.javanica.test.spring.fallback;

import com.netflix.hystrix.contrib.javanica.test.common.fallback.BasicCommandFallbackTest;
import com.netflix.hystrix.contrib.javanica.test.spring.conf.AopCglibConfig;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Configurable;
import org.springframework.context.annotation.Bean;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;

/**
 * Test covers "Fallback" functionality.
 * <p/>
 * https://github.com/Netflix/Hystrix/wiki/How-To-Use#Fallback
 */
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(classes = {AopCglibConfig.class, CommandFallbackTest.CommandTestConfig.class})
public class CommandFallbackTest extends BasicCommandFallbackTest {

    @Autowired
    private UserService userService;

    @Override
    protected BasicCommandFallbackTest.UserService createUserService() {
        return userService;
    }

    @Configurable
    public static class CommandTestConfig {
        @Bean
        public UserService userService() {
            return new UserService();
        }
    }

}