다음을 통해 공유


ASP.NET Core 애플리케이션에서 사용자 지정 필터를 사용하여 조건부 기능 사용

기능 플래그는 기능 필터를 사용하여 기능을 조건부로 사용하도록 설정할 수 있습니다. 기능 필터에 대한 자세한 내용은 기능 필터를 사용하여 조건부 기능 사용을 참조 하세요.

이 가이드에서 사용되는 예제는 기능 관리 빠른 시작에 도입된 ASP.NET Core 애플리케이션을 기반으로 합니다. 계속 진행하기 전에 빠른 시작을 완료하여 베타 기능 플래그를 사용해 ASP.NET Core 애플리케이션을 만듭니다. 완료되면 App Configuration 저장소의 베타 기능 플래그에 사용자 지정 기능 필터를 추가해야 합니다.

이 가이드에서는 사용자 지정 기능 필터를 구현하고 기능 필터를 사용하여 기능을 조건부로 사용하도록 설정하는 방법을 알아봅니다.

필수 조건

사용자 지정 기능 필터 구현

필수 구성 요소에 베타 기능 플래그에 대한 Percentage 매개 변수를 사용하여 Random이라는 사용자 지정 기능 필터를 추가했습니다. 다음으로, 기능 필터를 구현하여 Percentage 매개 변수에 정의된 확률에 따라 베타 기능 플래그를 사용하도록 설정합니다.

  1. 다음 코드를 사용하여 RandomFilter.cs 파일을 추가합니다.

    using Microsoft.FeatureManagement;
    
    namespace TestAppConfig
    {
        [FilterAlias("Random")]
        public class RandomFilter : IFeatureFilter
        {
            private readonly Random _random;
    
            public RandomFilter()
            {
                _random = new Random();
            }
    
            public Task<bool> EvaluateAsync(FeatureFilterEvaluationContext context)
            {
                int percentage = context.Parameters.GetSection("Percentage").Get<int>();
    
                int randomNumber = _random.Next(100);
    
                return Task.FromResult(randomNumber <= percentage);
            }
        }
    }
    

    Microsoft.FeatureManagement 라이브러리에서 IFeatureFilter 인터페이스를 구현하는 RandomFilter 클래스를 추가했습니다. IFeatureFilter 인터페이스에는 기능 플래그가 평가될 때마다 호출되는 EvaluateAsync라는 단일 메서드가 있습니다. EvaluateAsync에서 기능 필터는 true를 반환하여 기능 플래그를 사용하도록 설정합니다.

    FilterAliasAttributeRandomFilter로 데코레이팅하여 Azure App Configuration의 베타기능 플래그에 설정한 필터 이름과 일치하는 별칭 Random 필터에 지정했습니다.

  2. Program.cs 파일을 열고 AddFeatureFilter 메서드를 호출하여 RandomFilter를 등록합니다.

    // The rest of existing code in Program.cs
    // ... ...
    
    // Add feature management to the container of services.
    builder.Services.AddFeatureManagement()
                    .AddFeatureFilter<RandomFilter>();
    
    // The rest of existing code in Program.cs
    // ... ...
    

작동 중인 기능 필터

애플리케이션을 다시 시작하고 브라우저를 몇 번 새로 고칩니다. 기능 플래그를 수동으로 전환하지 않으면 베타 메뉴가 나타날 때도 있고 그렇지 않을 때도 있습니다.

베타 메뉴가 숨겨진 브라우저 스크린샷.

베타 메뉴가 포함된 브라우저 스크린샷.

다음 단계

기본 제공 기능 필터에 대해 자세히 알아보려면 다음 문서를 계속 진행하세요.

.NET 기능 관리 라이브러리의 전체 기능 요약을 보려면 다음 문서를 계속 진행합니다.