// JsonKit v0.5 - A simple but flexible Json library in a single .cs file. // // Copyright (C) 2014 Topten Software (contact@toptensoftware.com) All rights reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); you may not use this product // 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. using System; using System.Globalization; using System.IO; using System.Reflection; namespace Topten.JsonKit { /// /// Provides a reader for JSON data /// [Obfuscation(Exclude=true, ApplyToMembers=true)] public interface IJsonReader { /// /// Parses an object of specified type from the JSON stream /// /// The type to be parsed /// A reference to the loaded instance object Parse(Type type); /// /// Parses an object of specified type from the JSON stream /// /// The type to be parsed /// A reference to the loaded instance T Parse(); /// /// Parses from a JSON stream into an existing object instance /// /// The target object void ParseInto(object into); /// /// The current token in the input JSON stream /// Token CurrentToken { get; } /// /// Reads a literal value from the JSON stream /// /// A converter function to convert the value /// The parsed and converted value object ReadLiteral(Func converter); /// /// Reads a dictinary from the input stream /// /// The type of the dictionary key /// A callback that will be invoked for each encountered dictionary key void ParseDictionary(Type keyType, Action callback); /// /// Reads an array from the input stream /// /// A callback that will be invoked as each array element is encounters void ParseArray(Action callback); /// /// Gets the literal kind of the current stream token /// /// LiteralKind GetLiteralKind(); /// /// Gets a string literal from the JSON stream /// /// string GetLiteralString(); /// /// Moves to the next token in the input stream /// void NextToken(); } /// /// Helper functions for working with IJsonReader /// public static class IJsonReaderExtensions { /// /// Read a literal number /// /// The number type /// The reader to read from /// A number of specified type, or throws an InvalidDataException public static T ReadLiteralNumber(this IJsonReader reader) { return (T)ReadLiteralNumber(reader, typeof(T)); } /// /// Reads a dictionary from the input stream /// /// The IJsonReader instance /// A callback that will be invoked for each encountered dictionary key public static void ParseDictionary(this IJsonReader reader, Action callback) { reader.ParseDictionary(callback); } /// /// Reads a dictionary from the input stream /// /// The IJsonReader instance /// A callback that will be invoked for each encountered dictionary key public static void ParseDictionary(this IJsonReader reader, Action callback) { reader.ParseDictionary(typeof(T), (o) => callback((T)o)); } /// /// Read a literal number /// /// The reader to read from /// The number type to return /// A number of specified type, or throws an InvalidDataException public static object ReadLiteralNumber(this IJsonReader reader, Type type) { switch (reader.GetLiteralKind()) { case LiteralKind.String: var value = Convert.ChangeType(reader.GetLiteralString(), type, CultureInfo.InvariantCulture); reader.NextToken(); return value; case LiteralKind.SignedInteger: case LiteralKind.UnsignedInteger: { var str = reader.GetLiteralString(); if (str.StartsWith("0x", StringComparison.InvariantCultureIgnoreCase)) { var tempValue = Convert.ToUInt64(str.Substring(2), 16); object val = Convert.ChangeType(tempValue, type, CultureInfo.InvariantCulture); reader.NextToken(); return val; } else { object val = Convert.ChangeType(str, type, CultureInfo.InvariantCulture); reader.NextToken(); return val; } } case LiteralKind.FloatingPoint: { object val = Convert.ChangeType(reader.GetLiteralString(), type, CultureInfo.InvariantCulture); reader.NextToken(); return val; } } throw new InvalidDataException("expected a numeric literal"); } } }