Microsoft MVP성태의 닷넷 이야기
.NET Framework: 739. .NET Framework 4.7.1의 새 기능 - Configuration builders [링크 복사], [링크+제목 복사],
조회: 17497
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일

.NET Framework 4.7.1의 새 기능 - Configuration builders

.NET 4.7.1에 추가된 기능 중에,

Announcing the .NET Framework 4.7.1
; https://blogs.msdn.microsoft.com/dotnet/2017/10/17/announcing-the-net-framework-4-7-1/

Configuration builders라는 것이 있는데 이에 대한 소개를 해보겠습니다. ^^




간혹, App.config의 appSettings에 값을 보관하는 경우가 있습니다. 문제는, 이 값이 너무 정적이다는 것입니다. 예를 들어, 다음과 같이 app.config에 값을 정의했을 때,

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <appSettings>
        <add key="Setting1" value="1" />
        <add key="Setting2" value="2" />
    </appSettings>
</configuration>

각각의 값을 다음과 같은 식으로 AppSettingsReader를 통해 읽을 수 있습니다.

using System;
using System.Configuration;

namespace ConsoleApp1
{
    class Program
    {
        static void Main(string[] args)
        {
            System.Configuration.AppSettingsReader reader = new System.Configuration.AppSettingsReader();

            PrintValue(reader, "Setting1");
            PrintValue(reader, "Setting2");
            PrintValue(reader, "my");
        }

        private static void PrintValue(AppSettingsReader reader, string key)
        {
            string txt1 = null;

            try
            {
                txt1 = reader.GetValue(key, typeof(string)) as string;
            }
            catch
            {
                Console.WriteLine($"'{key}' is not defined");
                return;
            }

            Console.WriteLine($"'{key}' == {txt1}");
        }
    }
}

// 출력 결과
/*

'Setting1' == 1
'Setting2' == 
'my' is not defined

*/

그런데 만약, "Setting1"이라는 값이 "환경 변수"에 정의되어 있다면 app.config이 아닌 환경 변수의 값을 활용하고 싶다면 어떻게 해야 할까요? 물론, 그냥 AppSettingsReader로 값을 읽기 전 환경 변수를 한번 더 체크하면 됩니다.

.NET 4.7.1부터는 AppSettingsReader에 그런 부가적인 작업을 할 필요 없이 동적으로 app.config의 값을 추가/변경/삭제할 수 있는 기능을 제공하는데 그것이 바로 "Configuration Builder"입니다. 이를 위해 필요한 작업은 app.config에 builder 클래스를 알리는 정도입니다.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <configSections>
        <section name="configBuilders" type="System.Configuration.ConfigurationBuildersSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" restartOnExternalChanges="false" requirePermission="false"/>
    </configSections>

    <configBuilders>
        <builders>
            <add name="MyConfigBuilder" type="ConsoleApp1.MyConfigBuilder, ConsoleApp1" />
        </builders>
    </configBuilders>

    <appSettings configBuilders="MyConfigBuilder">
        <add key="Setting1" value="May Be Replaced" />
        <add key="Setting2" value="May Be Removed" />
        <!-- Setting3 could be added by a builder without even being declared here. -->
    </appSettings>

    <startup>
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7.1" />
    </startup>
</configuration>

물론, Configuration Builder 역할을 하는 사용자 클래스는 구현해야 합니다. 이론 상으로는 해당 클래스가 GAC에 등록한 어셈블리에 있다면 기존 응용 프로그램의 코드는 전혀 변경하지 않아도 되지만, 그렇지 않은 경우라면 자신의 프로젝트에 다음과 같은 클래스를 정의해 제공해야 합니다.

using System.Collections.Specialized;
using System.Configuration;
using System.Xml;

namespace ConsoleApp1
{
    public class MyConfigBuilder : ConfigurationBuilder
    {
        protected MyConfigBuilder()
        {
        }

        public override void Initialize(string name, NameValueCollection config)
        {
            // name == "MyConfigBuilder"
            base.Initialize(name, config);
        }

        public override ConfigurationSection ProcessConfigurationSection(ConfigurationSection configSection)
        {
            return base.ProcessConfigurationSection(configSection);
        }

        public override XmlNode ProcessRawXml(XmlNode rawXml)
        {
            return base.ProcessRawXml(rawXml);
        }
    }
}

위의 클래스는 기본 제공 코드일 뿐, 원한다면 다음과 같이 app.config의 configBuilders 속성이 추가된 XML 노드를 직접 제어할 수 있습니다.

public override XmlNode ProcessRawXml(XmlNode rawXml)
{
    XmlNode node = rawXml.SelectSingleNode("./add[@key = 'Setting1']");
    SetAttrValue(node, "value", "Replaced");

    node = rawXml.SelectSingleNode("./add[@key = 'Setting2']");
    rawXml.RemoveChild(node);

    AppendAddNode(rawXml, "my", "value");

    return base.ProcessRawXml(rawXml);
}

private void AppendAddNode(XmlNode rawXml, string addName, string addValue)
{
    XmlNode addNode = rawXml.OwnerDocument.CreateNode(XmlNodeType.Element, "add", rawXml.NamespaceURI);

    XmlAttribute keyNode = rawXml.OwnerDocument.CreateAttribute(rawXml.Prefix, "key", rawXml.NamespaceURI);
    keyNode.Value = "my";

    XmlAttribute valueNode = rawXml.OwnerDocument.CreateAttribute(rawXml.Prefix, "value", rawXml.NamespaceURI);
    valueNode.Value = "value";

    addNode.Attributes.SetNamedItem(keyNode);
    addNode.Attributes.SetNamedItem(valueNode);

    rawXml.AppendChild(addNode);
}

private void SetAttrValue(XmlNode node, string attrName, string attrValue)
{
    XmlNode attrNode = node.Attributes.GetNamedItem(attrName);
    attrNode.Value = attrValue;
}

위의 코드에서는 "Setting1"의 값을 변경하고, "Setting2"의 설정은 제거한 후 새롭게 "my"라는 설정을 추가하고 있습니다. 따라서 기존 응용 프로그램을 실행하면 다음과 같은 결과를 볼 수 있습니다.

'Setting1' == Replaced
'Setting2' is not defined
'my' == value

(첨부 파일은 이 글의 예제 코드를 포함합니다.)




github에 소스 코드 공개 문화가 생기다 보니, 간혹 보면 개발자 PC에서 appSettings에 Facebook 등의 인증 정보를 넣고 테스트하다가 실수로 github 등에 올리는 문제가 있는데요. configBuilders를 잘 활용하면 그런 실수를 미연에 방지할 수 있습니다.

마지막으로 살짝 아쉬운 것이 있다면,

With Configuration Builders, applications can apply a custom-defined set of builders to any section of config.

"any section"을 어떻게 해석해야 할지 모르겠는데 분명한 것은 "all of"는 아니고 "some of"... 도 아니고 "a few of" 정도라는 점입니다. 일단은 appSettings, connectionStrings에 대해 제공하는 것을 확인했고 그 외의 노드는 Visual Studio의 app.config 편집 시에 인텔리센스로 "configBuilders"가 지원되는 지 여부로 쉽게 확인할 수 있습니다.




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]







[최초 등록일: ]
[최종 수정일: 4/12/2018]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 



2018-05-23 04시44분
정성태

... 136  137  138  139  140  141  142  [143]  144  145  146  147  148  149  150  ...
NoWriterDateCnt.TitleFile(s)
1480정성태8/22/201337863개발 환경 구성: 194. 윈도우 서버의 80 포트에 대한 port forwarding 설정 방법파일 다운로드1
1479정성태8/14/201325193오류 유형: 183. IIS - 바인딩 추가 시 Object reference not set to an instance of an object 오류 [5]
1478정성태8/14/201328518오류 유형: 182. 윈도우 정품 활성화 오류 - 0x80070426
1477정성태8/14/201327374VC++: 71. codeplex의 Project Austin - 실감나게 책장 넘기는 표현
1476정성태8/13/201335841디버깅 기술: 55. Windbg - 윈도우 핸들 테이블 (2)
1475정성태8/12/201334946.NET Framework: 377. 프로세스가 종료된 후에도 소켓이 살아있다면?파일 다운로드1
1474정성태8/10/201331023오류 유형: 181. 윈도우 8 - WmiPrvSE.exe 프로세스가 CPU 소비하는 현상
1473정성태8/8/201327827VC++: 70. Win32 socket이 Thread-safe할까? [1]파일 다운로드1
1472정성태8/7/201326255.NET Framework: 376. .NET 2.0의 유니코드 관련 문자열 비교 오류
1471정성태8/7/201331012개발 환경 구성: 193. .aspx 확장자 대신 .html 확장자를 사용하는 방법
1470정성태8/6/201327020오류 유형: 180. DISM.exe 0xc1510111 실행 오류
1469정성태8/6/201324082.NET Framework: 375. System.Net.Sockets.Socket이 Thread-safe할까? [2]파일 다운로드1
1468정성태8/6/201322225오류 유형: 179. IIS - No connection could be made because the target machine actively refused it 127.0.0.1:80
1467정성태8/5/201325669Java: 16. IE에 로드된 Java Applet의 다운로드 위치를 확인하는 방법
1466정성태7/27/201331286.NET Framework: 374. C#과 비교한 C++ STL vector 성능 [7]파일 다운로드1
1465정성태7/18/201334572기타: 33. C:\Windows\Installer 폴더의 용량 줄이기 [3]
1464정성태7/15/201322843오류 유형: 178. Visual Studio 2012 Express - ImportCardinalityMismatchException
1463정성태7/15/201323510오류 유형: 177. [DBNETLIB][ConnectionOpen (Connect()).]SQL Server does not exist or access denied.
1462정성태7/5/201326801VC++: 69. geek스러운 C/C++ 퀴즈 문제 [2]
1461정성태6/27/201343352.NET Framework: 373. C# 문자열의 인코딩이란?
1460정성태6/17/201325217.NET Framework: 372. PerformanceCounter - Category does not exist. [1]
1459정성태6/15/201328842Windows: 74. 한글 키가 아닌 영문 키를 기본으로 선택하는 방법 [5]
1458정성태6/13/201329674.NET Framework: 371. CAS Lock 방식이 과연 성능에 얼마나 도움이 될까요? [1]파일 다운로드1
1457정성태6/13/201325883개발 환경 구성: 192. "Probabilistic Programming and Bayesian Methods for Hackers" 예제 코드 실행 방법
1456정성태6/5/201334543.NET Framework: 370. C# - WebKit .NET 사용 [2]파일 다운로드1
1455정성태6/1/201328326.NET Framework: 369. ThreadPool.QueueUserWorkItem의 실행 지연 [4]파일 다운로드1
... 136  137  138  139  140  141  142  [143]  144  145  146  147  148  149  150  ...