다음을 통해 공유

DataContractJsonSerializer를 사용하여 독립 실행형 JSON 직렬화

  • 아티클

참고

이 문서는 DataContractJsonSerializer에 대한 것입니다. JSON 직렬화 및 역직렬화와 관련된 대부분의 시나리오에서는 System.Text.Json 네임스페이스의 API를 사용하는 것이 좋습니다.

JSON (JavaScript Object Notation)은 브라우저 내의 웹 페이지에서 실행되는 JavaScript 코드에 의해 사용되도록 특별히 디자인된 데이터 형식이며 WCF(Windows Communication Foundation)에서 만든 ASP.NET AJAX 서비스에서 사용하는 기본 데이터 형식입니다.

이 형식은 ASP.NET과 결합하지 않고 AJAX 서비스를 만드는 경우에도 사용할 수 있습니다. 이 경우 XML이 기본값이지만 JSON을 선택할 수 있습니다.

마지막으로 JSON 지원이 필요하지만 AJAX 서비스는 만들지 않을 경우 DataContractJsonSerializer를 사용하면 .NET 개체를 JSON 데이터로 직렬화하고 다시 .NET 형식의 인스턴스로 직접 해당 데이터를 역직렬화할 수 있습니다. 이 작업을 수행하는 방법에 대한 설명은 방법: JSON 데이터 직렬화 및 역직렬화를 참조하세요.

JSON으로 작업할 경우 몇 가지 예외를 제외하고는 DataContractSerializer에서 지원하는 것과 같은 .NET 형식이 지원됩니다. 지원되는 형식 목록은 데이터 계약 직렬 변환기에서 지원하는 형식을 참조하세요. 여기에는 대부분의 기본 형식, 대부분의 배열 및 컬렉션 형식뿐만 아니라 DataContractAttribute 및 DataMemberAttribute를 사용하는 복합 형식도 포함됩니다.

JSON 형식에 .NET 형식 매핑

다음 표에서는 serialization 및 deserialization 절차를 통해 매핑될 때 .NET 형식과 JSON/JavaScript 형식 간의 대응 관계를 보여 줍니다.

.NET 형식 JSON/JavaScript 메모
모든 숫자 형식. 예: Int32, Decimal 또는 Double 숫자 Double.NaN, Double.PositiveInfinity, Double.NegativeInfinity와 같은 특수한 값은 지원되지 않으므로 잘못된 JSON이 됩니다.
Enum 숫자 이 항목의 뒷부분에 있는 ‘열거 및 JSON’을 참조하세요.
Boolean 부울
String, Char String
TimeSpan, Guid, Uri 문자열 이러한 유형의 JSON 형식은 XML의 형식과 동일합니다(기본적으로 ISO 8601 기간 형식의 시간 범위, “12345678-ABCD-ABCD-ABCD-1234567890AB” 형식의 GUID 및 "http://www.example.com"과 같은 문자열 형식의 URI). 자세한 내용은 데이터 계약 스키마 참조를 참조하세요.
XmlQualifiedName String 형식은 "name:namespace"이며 첫 번째 콜론 앞에 오는 것이 이름입니다. 이름 또는 네임스페이스가 없는 경우도 있습니다. 네임스페이스가 없는 경우 콜론도 생략할 수 있습니다.
Array(Byte 형식) 숫자 배열 각 숫자는 1바이트 값을 나타냅니다.
DateTime 날짜/시간 또는 문자열 이 항목의 뒷부분에 있는 날짜/시간 및 JSON을 참조하세요.
DateTimeOffset 복합 형식 이 항목의 뒷부분에 있는 날짜/시간 및 JSON을 참조하세요.
XML 및 ADO.NET 형식(XmlElement,

XElement. XmlNode의 배열,

ISerializable,

DataSet).		 String 이 항목의 XML 형식 및 JSON 단원을 참조하세요.
DBNull 빈 복합 형식 --
컬렉션, 사전 및 배열 Array 이 항목의 컬렉션, 사전 및 배열 단원을 참조하십시오.
복합 형식(DataContractAttribute 또는 SerializableAttribute 적용) 복합 형식 데이터 멤버는 JavaScript 복합 형식의 멤버가 됩니다.
ISerializable 인터페이스를 구현하는 복합 형식) 복합 형식 다른 복합 형식과 동일하지만 일부 ISerializable 형식은 지원되지 않습니다. ISerializable 지원을 참조하세요.
모든 형식에 대해 Null 값 Null Nullable 값 형식은 nullable이 아닌 값 형식과 같은 방식으로 지원되고 JSON에 매핑됩니다.

열거 및 JSON

열거형 멤버 값은 JSON에서 숫자로 처리되며 이는 열거형 멤버 값이 멤버 이름으로 포함되는 데이터 계약에서의 처리 방식과 다릅니다. 데이터 계약 처리에 대한 자세한 내용은 데이터 계약의 열거형 형식을 참조하세요.

  • 예를 들어, public enum Color {red, green, blue, yellow, pink}가 있을 경우 yellow를 serialize하면 문자열 "yellow"가 아닌 숫자 3이 생성됩니다.

  • 모든 enum 멤버는 serialize할 수 있습니다. EnumMemberAttribute 및 NonSerializedAttribute 특성은 사용될 경우 무시됩니다.

  • 존재하지 않는 enum 값을 역직렬화할 수 있습니다. 예를 들어, 해당 색 이름이 정의되어 있지 않더라도 값 87을 이전 Color 열거형으로 역직렬화할 수 있습니다.

  • 플래그 enum은 특수한 플래그가 아니며 enum과 동일하게 처리됩니다.

날짜/시간 및 JSON

JSON 형식은 날짜 및 시간을 직접적으로 지원하지 않습니다. 그러나 매우 일반적으로 사용되며 ASP.NET AJAX는 이러한 형식을 특수한 방식으로 지원합니다. ASP.NET AJAX 프록시를 사용할 경우 .NET의 DateTime 형식은 JavaScrip의 DateTime 형식과 완전히 일치합니다.

  • ASP.NET을 사용하지 않을 경우 DateTime 형식은 JSON에서 이 항목의 고급 정보 단원에 설명된 특수 형식의 문자열로 표시됩니다.

  • DateTimeOffset은 JSON에 복합 형식 {"DateTime":dateTime,"OffsetMinutes":offsetMinutes}로 표현됩니다. offsetMinutes 멤버는 GMT(그리니치 표준시)의 현지 시간 오프셋으로, 관련 이벤트의 위치와 연관된 UTC(세계 협정시)라고도 합니다. dateTime 멤버는 관련 이벤트가 발행했을 때의 시간 인스턴스를 나타내며, ASP.NET AJAX를 사용할 때는 JavaScript에서 DateTime이 되고 사용하지 않을 때는 문자열이 됩니다. serialization 시 dateTime 멤버는 항상 GMT로 serialize됩니다. 따라서 뉴욕 시간으로 오전 3시인 경우 dateTime 시간 구성 요소는 오전 8시이고 offsetMinutes는 300(GMT에서 300분 또는 5시간을 뺀 값)입니다.

    참고

    JSON으로 serialize한 경우 DateTime 및 DateTimeOffset 개체는 밀리초 수준의 정보만 유지합니다. 서브-밀리초 값(마이크로초/나노초)은 serialization 중에 손실됩니다.

XML 형식 및 JSON

XML 형식은 JSON 문자열이 됩니다.

  • 예를 들어, XElement 형식의 데이터 멤버 “q”에 <abc/>가 포함된 경우 JSON은 {"q":"<abc/>"}입니다.

  • XML 래핑 방법을 지정하는 몇 가지 특수한 규칙이 있습니다. 자세한 내용은 이 문서의 뒷부분에 있는 고급 정보 단원을 참조하세요.

  • ASP.NET AJAX를 사용 중인 경우 JavaScript에서 문자열을 사용하는 대신 XML DOM을 사용하려면 ResponseFormat에서WebGetAttribute 속성을 XML로 설정하거나 ResponseFormat에서 WebInvokeAttribute 속성을 XML로 설정합니다.

컬렉션, 사전 및 배열

모든 컬렉션, 사전 및 배열은 JSON에서 배열로 표시됩니다.

  • CollectionDataContractAttribute를 사용하는 모든 사용자 지정은 JSON 표현에서 무시됩니다.

  • 사전은 JSON에 직접 사용할 수 있는 방식이 아닙니다. 사전<string,object>는 WCF에서 다른 JSON 기술로 작업할 때 예상한 것과 같은 방식으로 지원되지 않을 수도 있습니다. 예를 들어 "abc"가 "xyz"로 매핑되고 "def"가 사전의 42로 매핑되는 경우 JSON 표현은 {"abc":"xyz","def":42}가 아니라 [{"Key":"abc","Value":"xyz"},{"Key":"def","Value":42}]입니다.

  • JSON으로 직접 작업하려는 경우(엄격한 계약을 미리 정의하지 않고 키 및 값에 동적으로 액세스하는 경우) 다음과 같은 몇 가지 옵션이 있습니다.

    • 약한 형식의 JSON Serialization(AJAX) 샘플을 사용하는 것이 좋습니다.

    • ISerializable 인터페이스와 deserialization 생성자를 사용합니다. 이 두 메커니즘을 사용하면 serialization과 deserialization 시 각각 JSON 키/값 쌍에 액세스할 수 있지만 부분 신뢰 시나리오에서 작업할 수 없습니다.

    • 직렬 변환기를 사용하는 대신 JSON과 XML 간 매핑을 사용하는 것이 좋습니다.

    • serialization 컨텍스트에서 다형성은 기본 형식이 필요한 경우에 파생 형식을 직렬화하는 기능을 말합니다. 예를 들어 컬렉션을 Object에 할당할 때처럼 컬렉션을 다형적으로 사용하는 경우 특수한 JSON 관련 규칙이 있습니다. 이러한 내용은 이 문서의 뒷부분에 있는 고급 정보 단원에 자세히 설명되어 있습니다.

추가 정보

데이터 멤버 순서

JSON을 사용할 때 데이터 멤버의 순서는 중요하지 않습니다. 특히 Order가 설정된 경우에도 JSON 데이터를 원하는 순서로 역직렬화할 수 있습니다.

JSON 형식

deserialization 시 JSON 형식은 위의 표와 일치하지 않아도 됩니다. 예를 들어 Int는 일반적으로 JSON 숫자로 매핑되지만 JSON 문자열에 유효한 숫자가 있으면 이 문자열에서 역직렬화할 수도 있습니다. 즉, "q"라고 하는 Int 데이터 멤버가 있는 경우 {"q":42} 및 {"q":"42"}는 유효합니다.

다형성

다형 serialization은 기본 형식이 필요한 경우에 파생 형식을 serialize하는 기능으로 구성됩니다. 다형 serialization은 XML serialization이 지원되는 방식과 비슷하게 WCF에서 JSON serialization에 대해 지원됩니다. 예를 들어 MyBaseType이 필요한 경우 MyDerivedType을 직렬화하거나 Object가 필요한 경우 Int를 직렬화할 수 있습니다.

복합 형식을 역직렬화하지 않는 한 기본 형식이 필요한 경우에 파생 형식을 역직렬화하면 형식 정보가 손실될 수도 있습니다. 예를 들어 Uri가 필요한 경우 Object를 serialize하면 JSON 문자열이 됩니다. 이 문자열을 다시 Object로 역직렬화하면 .NET String이 반환됩니다. 역직렬 변환기는 문자열이 처음에 Uri 형식이었음을 인식하지 못합니다. 일반적으로 Object가 필요한 경우 실제 원본 형식에 관계없이 모든 JSON 문자열은 .NET 문자열로 역직렬화되고 .NET 컬렉션, 사전 및 배열을 serialize하는 데 사용되는 모든 JSON 배열은 Array 형식의 .NET Object로 역직렬화됩니다. JSON 부울은 .NET Boolean로 매핑됩니다. 그러나 Object가 필요한 경우 JSON 숫자는 .NET Int32, Decimal 또는 Double로 역직렬화되며, 이때 가장 적합한 형식이 자동으로 선택됩니다.

DataContractJsonSerializer는 인터페이스 형식으로 역직렬화될 때 선언된 형식이 개체인 것처럼 역직렬화됩니다.

사용자 고유의 기본 형식 및 파생 형식으로 작업하는 경우에는 일반적으로 KnownTypeAttribute, ServiceKnownTypeAttribute 또는 이와 동등한 메커니즘을 사용해야 합니다. 예를 들어, Animal 반환 값을 갖는 작업을 수행할 때 실제로는 Animal에서 파생된 Cat 인스턴스가 반환되면 Animal 형식에 KnownTypeAttribute를 적용하거나 작업에 ServiceKnownTypeAttribute를 적용하고 해당 특성에 Cat 형식을 지정해야 합니다. 자세한 내용은 데이터 계약 알려진 형식을합니다.

다형 serialization 작동 방식에 대한 자세한 내용 및 다형 serialization 사용 시 고려해야 할 제한 사항에 대한 설명은 이 문서의 뒷부분에 있는 고급 정보 단원을 참조하세요.

버전 관리

JSON에서는 IExtensibleDataObject 인터페이스를 포함한 데이터 계약 버전 관리 기능이 완벽하게 지원됩니다. 또한 대부분의 경우에 형식을 한 가지 형식(예: XML)으로 역직렬화한 다음 다른 형식(예: JSON)으로 직렬화할 수 있으며 이 경우 데이터를 IExtensibleDataObject에 유지할 수 있습니다. 자세한 내용은 호환 가능한 데이터 계약을 참조하세요. JSON은 순서가 지정되지 않으므로 순서 정보가 손실됩니다. 또한 JSON은 키 이름이 같은 여러 키/값 쌍을 지원하지 않습니다. 마지막으로, IExtensibleDataObject의 모든 작업은 원래 다형적입니다. 즉, 모든 형식의 기본 형식인 Object에 파생 형식이 할당됩니다.

URL의 JSON

ASP.NET AJAX 엔드포인트를 WebGetAttribute 특성을 사용하는 HTTP GET 동사와 함께 사용하는 경우 요청 URL에 메시지 본문 대신 들어오는 매개 변수가 표시됩니다. JSON은 요청 URL에서도 지원되므로 “number”라고 하는 Int와 “p”라고 하는 Person 복합 형식을 사용하는 작업을 수행하는 경우 URL이 다음과 유사할 수 있습니다.

http://example.com/myservice.svc/MyOperation?number=7&p={"name":"John","age":42}

ASP.NET AJAX Script Manager 컨트롤 및 프록시를 사용하여 서비스를 호출하는 경우 프록시에 의해 이 URL이 자동으로 생성되지만 표시되지는 않습니다. JSON은 ASP.NET AJAX가 아닌 엔드포인트에 있는 URL에서 사용할 수 없습니다.

고급 정보

ISerializable 지원

지원되는 ISerializable 형식과 지원되지 않는 ISerializable 형식

일반적으로 ISerializable 인터페이스를 구현하는 형식은 JSON을 직렬화하거나 역직렬화할 때 완전히 지원됩니다. 그러나 이러한 형식 중에는 JSON 관련 serialization의 영향을 받으면 역직렬화하지 않도록 구현되는 형식(일부 .NET Framework 형식 포함)도 있습니다.

  • ISerializable을 사용하면 개별 데이터 멤버의 형식을 미리 알 수 없습니다. 따라서 다형적 상황은 형식을 개체로 역직렬화하는 상황과 유사합니다. 앞서 설명한 바와 같이 이로 인해 JSON에서 형식 정보가 손실될 수 있습니다. 예를 들어, 해당 enum 구현에서 ISerializable을 직렬화한 형식이 적절한 캐스팅 없이 바로 enum으로 다시 역직렬화를 시도하는 경우 실패하게 됩니다. 이는 enum이 JSON에서 숫자를 사용하여 serialize되고 JSON 숫자는 기본 제공 .NET 숫자 형식(Int32, Decimal 또는 Double)으로 역직렬화되기 때문입니다. 따라서 enum 값으로 사용된 숫자가 손실됩니다.

  • 대부분의 JSON은 특정 순서를 보장하지 않기 때문에 해당 deserialization 생성자에서 특정 deserialization 순서에 의존하는 ISerializable 형식도 일부 JSON 데이터를 역직렬화하지 못할 수 있습니다.

팩터리 형식

IObjectReference 인터페이스는 일반적으로 JSON에서 지원되지만, 인터페이스를 구현하는 형식과 다른 형식의 인스턴스를 GetRealObject(StreamingContext)에서 반환하는 "팩터리 형식" 기능을 필요로 하는 형식은 지원되지 않습니다.

DateTime 통신 형식

DateTime 값은 "/Date(700000+0500)/" 형식의 JSON 문자열로 표시됩니다. 여기서 첫 번째 숫자(이 예제에서는 700000)는 1970년 1월 1일 자정부터의 정규 시간(일광 절약 시간이 아님)인 GMT 시간대의 시간(밀리초)입니다. 이 숫자는 이보다 이전 시간을 나타낼 경우 음수가 될 수 있습니다. 예제에서 "+0500"으로 구성된 부분은 선택적 요소이며, 시간이 Local 종류, 즉 deserialization 시 현지 시간대로 변환되어야 함을 나타냅니다. 이 부분이 없으면 시간은 Utc로 역직렬화됩니다. 실제 숫자(이 예제에서는 "0500")와 해당 기호(+ 또는 -)는 무시됩니다.

DateTime을 serialize하는 경우 Local 및 Unspecified 시간은 오프셋과 함께 기록되고 Utc는 오프셋 없이 기록됩니다.

ASP.NET AJAX 클라이언트 JavaScript 코드는 이러한 문자열을 JavaScript DateTime 인스턴스로 자동으로 변환합니다. .NET에 DateTime 형식이 아닌 유사한 형식을 지닌 다른 문자열이 있는 경우 이 문자열 또한 변환됩니다.

변환은 “/” 문자가 이스케이프된 경우(JSON이 “\/Date(700000+0500)\/”와 같이 표시되는 경우)에만 발생하며, 이런 이유로 WCF의 JSON 인코더(WebHttpBinding에 의해 사용하도록 설정됨)는 “/” 문자를 항상 이스케이프합니다.

JSON 문자열의 XML

XmlElement

XmlElement는 래핑 없이 그대로 serialize됩니다. 예를 들어, <abc/>를 포함하는 XmlElement 형식의 데이터 멤버 “x”는 다음과 같이 표시됩니다.

{"x":"<abc/>"}

XmlNode 배열

Array 형식의 XmlNode 개체는 형식에 대한 표준 데이터 계약 네임스페이스에서 ArrayOfXmlNode라는 요소에 래핑됩니다. "x"가 "value"와 빈 요소 노드 "M"을 포함하는 네임스페이스 "ns"에 특성 노드 "N"을 포함하는 배열인 경우 해당 표현은 다음과 같습니다.

{"x":"<ArrayOfXmlNode xmlns=\"http://schemas.datacontract.org/2004/07/System.Xml\" a:N=\"value\" xmlns:a=\"ns\"><M/></ArrayOfXmlNode>"}

XmlNode 배열의 시작 부분(다른 요소들 앞)에서 빈 네임스페이스의 특성은 지원되지 않습니다.

XElement 및 DataSet을 포함한 IXmlSerializable 형식

ISerializable 형식은 "콘텐츠 형식", "DataSet 형식" 및 "요소 형식"으로 나누어집니다. 이러한 형식에 대한 정의는 데이터 계약의 XML 및 ADO.NET 형식을 참조하세요.

"콘텐츠" 및 "DataSet" 형식은 이전 단원에서 설명한 Array의 XmlNode 개체와 비슷하게 serialize됩니다. "콘텐츠" 및 "DataSet" 형식은 이름과 네임스페이스가 해당 형식의 데이터 계약 이름과 네임스페이스에 해당하는 요소에 래핑됩니다.

XElement와 같은 ‘요소’ 형식은 이 항목의 앞에서 설명한 XmlElement와 비슷하게 그대로 직렬화됩니다.

다형성

형식 정보 유지

위에서 설명한 것처럼 다형성은 JSON에서 지원되지만 몇 가지 제한 사항이 있습니다. JavaScript는 약한 형식의 언어이며 형식 일치는 일반적으로 문제가 되지 않습니다. 그러나 JSON을 사용하여 강력한 형식 시스템(.NET)과 약한 형식 시스템(JavaScript) 간에 통신하는 경우에는 형식 일치를 유지하는 것이 좋습니다. 예를 들어 데이터 계약 이름이 "Shape"인 형식에서 데이터 계약 이름이 "Square"와 "Circle"인 형식이 파생됩니다. "Circle"을 .NET에서 JavaScript로 보낸 다음 나중에 "Shape"이 필요한 .NET 메서드에 반환하는 경우 .NET 측에서 해당 개체가 원래 "Circle"이었음을 알고 있는 것이 좋습니다. 그렇지 않으면 파생 형식에 특정한 정보(예: "Circle"의 "radius" 데이터 멤버)가 손실될 수도 있습니다.

형식 일치를 유지하려면 복합 형식을 JSON으로 직렬화할 때 "형식 힌트"를 추가하면 역직렬 변환기가 힌트를 인식하고 적절히 작동할 수 있습니다. "형식 힌트"는 키 이름이 "__type" (두 개의 밑줄과 "type")인 JSON 키/값 쌍입니다. 값은 "DataContractName:DataContractNamespace"(첫 번째 콜론까지는 이름) 형식의 JSON 문자열입니다. 앞의 예제를 사용하면 "Circle"은 다음과 같이 serialize될 수 있습니다.

{"__type":"Circle:http://example.com/myNamespace","x":50,"y":70,"radius":10}

형식 암시는 XML 스키마 인스턴스 표준을 통해 정의되고 XML을 직렬화/역직렬화할 때 사용되는 xsi:type 특성과 매우 비슷합니다.

형식 암시와 충돌할 수 있으므로 "__type" 데이터 멤버는 사용할 수 없습니다.

형식 암시 크기 줄이기

JSON 메시지의 크기를 줄이기 위해 기본 데이터 계약 네임스페이스 접두사(http://schemas.datacontract.org/2004/07/)가 “#” 문자로 바뀝니다. 반대로 바꾸기 위해서는 이스케이프 규칙이 사용됩니다. 네임스페이스가 "#" 또는 "\" 문자로 시작되는 경우 이 문자에 "\" 문자가 추가됩니다. 따라서 “Circle”이 .NET 네임스페이스 “MyApp.Shapes”의 형식인 경우 해당 기본 데이터 계약 네임스페이스는 http://schemas.datacontract.org/2004/07/MyApp입니다. Shapes와 JSON 표현은 다음과 같습니다.

{"__type":"Circle:#MyApp.Shapes","x":50,"y":70,"radius":10}

잘린 이름(#MyApp.Shapes)과 전체 이름(http://schemas.datacontract.org/2004/07/MyApp.Shapes)은 모두 deserialization 시 인식됩니다.

JSON 개체의 형식 힌트 위치

형식 힌트는 JSON 표현에서 맨 처음에 와야 합니다. 이 경우에만 JSON 처리에서 키/값 쌍의 순서가 중요합니다. 예를 들어 다음은 형식 힌트를 지정하는 올바른 방법이 아닙니다.

{"x":50,"y":70,"radius":10,"__type":"Circle:#MyApp.Shapes"}

DataContractJsonSerializer에서 사용되는 WCF와 ASP.NET AJAX 클라이언트 페이지는 모두 항상 형식 힌트를 첫 번째로 내보냅니다.

형식 힌트는 복합 형식에만 적용

복합 형식이 아닌 경우에는 형식 힌트를 내보낼 수 없습니다. 예를 들어, 작업에 Object 반환 형식이 있지만 Circle을 반환하는 경우 JSON 표현은 앞에서 보여 준 것과 같을 수 있으며 형식 정보는 유지됩니다. 그러나 URI가 반환되는 경우 JSON 표현은 문자열이고 URI를 표현하는 데 사용된 문자열은 손실됩니다. 이것은 기본 형식뿐 아니라 컬렉션 및 배열에도 적용됩니다.

형식 힌트를 내보내는 시기

형식 힌트는 메시지 크기를 상당히 증가시킬 수 있습니다. 이 문제를 완화하기 위한 한 가지 방법은 가능한 경우 더 짧은 데이터 계약 네임스페이스를 사용하는 것입니다. 따라서 다음 규칙에 따라 형식 힌트를 내보낼지 여부가 결정됩니다.

  • ASP.NET AJAX를 사용하는 경우, 기본/파생 할당이 없을 때(예를 들어 Circle이 Circle에 할당된 경우)에도 가능하면 항상 형식 힌트를 내보냅니다. 이는 정보의 큰 손실 없이 약한 형식 JSON 환경에서 강력한 형식 .NET 환경으로 호출하는 프로세스를 완벽하게 지원하기 위해 필요합니다.

  • ASP.NET과 통합되지 않은 AJAX 서비스를 사용하는 경우에는 기본/파생 할당이 있는 경우에만 형식 힌트를 내보냅니다. 즉, Circle이 Shape 또는 Object에 할당되었지만 Circle에는 할당되지 않은 경우에 형식 힌트를 내보냅니다. 이를 통해 JavaScript 클라이언트를 올바르게 구현하는 데 필요한 최소 정보가 제공되므로 성능이 향상되지만 잘못 디자인된 클라이언트의 경우 형식 정보 손실을 방지할 수 없습니다. 클라이언트에서 이 문제를 처리하지 않으려면 서버에 기본/파생 할당이 없도록 해야 합니다.

  • DataContractSerializer 형식을 사용하는 경우 alwaysEmitTypeInformation 생성자 매개 변수를 사용하면 기본값을 "false"(필요한 경우에만 형식 힌트를 내보냄)로 설정하여 앞의 두 모드 간에 선택할 수 있습니다.

중복 데이터 멤버 이름

파생 형식 정보는 기본 형식 정보와 함께 동일한 JSON 개체에 있으며 순서에 구애 받지 않습니다. 예를 들어 Shape는 다음과 같이 표시될 수 있습니다.

{"__type":"Shape:#MyApp.Shapes","x":50,"y":70}

반면 Circle은 다음과 같이 표시될 수 있습니다.

{"__type":"Circle:#MyApp.Shapes","x":50, "radius":10,"y":70}

기본 Shape 형식에도 “radius”라는 데이터 멤버가 포함된 경우, serialization에서는 JSON 개체는 반복되는 키 이름을 가질 수 없기 때문에 충돌이 발생하고 deserialization에서는 “radius”가 Shape.radius를 나타내는지, 아니면 Circle.radius를 나타내는지 명확하지 않기 때문에 충돌이 발생합니다. 그러므로 데이터 계약 클래스에서 "속성 숨기기"(기본 클래스와 파생 클래스에서 동일한 이름의 데이터 멤버)는 일반적으로 권장되지 않으며 JSON의 경우에는 금지됩니다.

다형성 및 IXmlSerializable 형식

IXmlSerializable 형식은 보통 일반 데이터 계약 규칙에 따라 알려진 형식 요구 사항을 충족하는 한 서로 다형적으로 할당될 수 있습니다. 그러나 IXmlSerializable 대신 Object 형식을 serialize하면 JSON 문자열이 되므로 형식 정보가 손실됩니다.

다형성 및 특정 인터페이스 형식

컬렉션 형식 또는 IXmlSerializable이 아닌 비컬렉션 형식(IXmlSerializable 예외)이 필요한 Object을 구현하는 형식은 serialize할 수 없습니다. 예를 들어 IMyInterface라는 사용자 지정 인터페이스와 int 형식의 IEnumerable<T>과 IMyInterface를 모두 구현하는 MyType 형식이 있습니다. 반환 형식이 IMyInterface인 작업에서 MyType을 반환할 수 없습니다. 그 이유는 MyType은 JSON 배열로 직렬화되어야 하며 형식 힌트가 필요한데, 앞서 설명한 바와 같이 배열에서는 형식 힌트를 포함할 수 없기 때문입니다. 형식 힌트는 복합 형식에서만 포함할 수 있습니다.

알려진 형식 및 구성

DataContractSerializer에서 사용되는 알려진 형식 메커니즘은 DataContractJsonSerializer에서도 동일한 방식으로 모두 지원됩니다. 두 직렬 변환기는 <system.runtime.serialization>에서 동일한 구성 요소인 <dataContractSerializer>를 읽어 구성 파일을 통해 추가된 알려진 형식을 검색합니다.

개체에 할당된 컬렉션

개체에 할당된 컬렉션은 IEnumerable<T>을 구현하는 컬렉션인 것처럼 serialize됩니다(복합 형식인 경우 각 항목에 형식 힌트가 있는 JSON 배열). 예를 들어 Object에 할당된 Shape 형식의 List<T>은 다음과 같습니다.

[{"__type":"Shape:#MyApp.Shapes","x":50,"y":70},
{"__type":"Shape:#MyApp.Shapes","x":58,"y":73},
{"__type":"Shape:#MyApp.Shapes","x":41,"y":32}]

Object로 다시 역직렬화하는 경우:

  • Shape는 알려진 형식 목록에 있어야 합니다. 알려진 형식에 Shape 형식의 List<T>이 있는 것은 아무 효과가 없습니다. 이 경우 serialization 시에 알려진 형식에 Shape를 추가하지 않아도 됩니다. 이 작업은 자동으로 수행됩니다.

  • 컬렉션은 Shape 인스턴스를 포함하는 Object 형식의 Array로 역직렬화됩니다.

기본 컬렉션에 할당된 파생 컬렉션

파생 컬렉션을 기본 컬렉션에 할당하면, 일반적으로 기본 형식의 컬렉션인 것처럼 컬렉션이 serialize됩니다. 그러나 파생 컬렉션의 항목 형식을 기본 컬렉션의 항목 형식에 할당할 수 없는 경우 예외가 throw됩니다.

형식 힌트 및 사전

사전을 Object에 할당하면 사전의 각 Key 및 Value 항목이 Object에 할당된 것처럼 처리되고 형식 힌트를 가져옵니다.

사전 형식을 serialize하는 경우 "Key" 및 "Value" 멤버를 포함하는 JSON 개체는 alwaysEmitTypeInformation 설정의 영향을 받지 않고 이전 컬렉션 규칙에서 요구하는 경우에만 형식 힌트를 포함합니다.

유효한 JSON 키 이름

serializer는 유효한 XML 이름이 아닌 키 이름을 XML 인코딩합니다. 예를 들어 이름이 "123"인 데이터 멤버의 경우 "123"이 유효하지 않은 XML 요소 이름(숫자로 시작)이기 때문에 "_x0031__x0032__x0033_"과 같은 인코딩된 이름을 갖게 됩니다. XML 이름에 유효하지 않은 일부 국제 문자 집합이 포함되는 경우에도 비슷한 상황이 발생할 수 있습니다. XML이 JSON 처리에 미치는 영향에 대한 설명은 JSON과 XML 간의 매핑을 참조하세요.

참고 항목