Added "Get{ValueType}OrNull" and "Get{ValueType}OrNullByPath" extension methods to the "NewtonsoftJsonObjectExtensions" class

Author: abjerner

src/Skybrud.Essentials/Json/Newtonsoft/Extensions/NewtonsoftJsonObjectExtensions.Boolean.cs

@@ -31,6 +31,18 @@ public static bool GetBoolean(this JObject? json, string propertyName, bool fall
             return JsonTokenUtils.GetBoolean(json?[propertyName], fallback);
         }
 
+        /// <summary>
+        /// Returns the <see cref="bool"/> value of the property with the specified <paramref name="propertyName"/>. If
+        /// a matching property can not be found or the value can not be successfully converted to a <see cref="bool"/>
+        /// value, <see langword="null"/> is returned instead.
+        /// </summary>
+        /// <param name="json">The parent JSON object.</param>
+        /// <param name="propertyName">The name of the property.</param>
+        /// <returns>An instance of <see cref="bool"/> if successful; otherwise, <see langword="null"/>.</returns>
+        public static bool? GetBooleanOrNull(this JObject? json, string propertyName) {
+            return JsonTokenUtils.GetBooleanOrNull(json?[propertyName]);
+        }
+
         /// <summary>
         /// Returns the <see cref="bool"/> value of the token matching the specified <paramref name="path"/>.
         /// If a matching property can not be found or the value can not be successfully converted to a
@@ -56,6 +68,18 @@ public static bool GetBooleanByPath(this JObject? json, string path, bool fallba
             return JsonTokenUtils.GetBoolean(json?.SelectToken(path), fallback);
         }
 
+        /// <summary>
+        /// Returns the <see cref="bool"/> value of the token matching the specified <paramref name="path"/>.
+        /// If a matching property can not be found or the value can not be successfully converted to a
+        /// <see cref="bool"/> value, <see langword="null"/> is returned instead.
+        /// </summary>
+        /// <param name="json">The parent JSON object.</param>
+        /// <param name="path">A <see cref="string"/> that contains a JPath expression.</param>
+        /// <returns>An instance of <see cref="bool"/> if successful; otherwise, <see langword="null"/>.</returns>
+        public static bool? GetBooleanOrNullByPath(this JObject? json, string path) {
+            return JsonTokenUtils.GetBooleanOrNull(json?.SelectToken(path));
+        }
+
         /// <summary>
         /// Attempts to get a boolean value from the property with the specified <paramref name="propertyName"/>.
         /// </summary>

src/Skybrud.Essentials/Json/Newtonsoft/Extensions/NewtonsoftJsonObjectExtensions.Double.cs

@@ -47,6 +47,18 @@ public static double GetDouble(this JObject? json, string propertyName, double f
             return JsonTokenUtils.GetDouble(json?[propertyName], callback);
         }
 
+        /// <summary>
+        /// Returns the <see cref="double"/> value of the property with the specified <paramref name="propertyName"/>.
+        /// If a matching property can not be found or the value can not be successfully converted to a
+        /// <see cref="double"/> value, <see langword="null"/> is returned instead.
+        /// </summary>
+        /// <param name="json">The parent JSON object.</param>
+        /// <param name="propertyName">The name of the property.</param>
+        /// <returns>An instance of <see cref="double"/> if successful; otherwise, <see langword="null"/>.</returns>
+        public static double? GetDoubleOrNull(this JObject? json, string propertyName) {
+            return JsonTokenUtils.GetDoubleOrNull(json?[propertyName]);
+        }
+
         /// <summary>
         /// Returns the <see cref="double"/> value of the token matching the specified <paramref name="path"/>.
         /// If a matching token can not be found or the value can not be successfully converted to a
@@ -86,6 +98,18 @@ public static double GetDoubleByPath(this JObject? json, string path, double fal
             return JsonTokenUtils.GetDouble(json?.SelectToken(path), callback);
         }
 
+        /// <summary>
+        /// Returns the <see cref="double"/> value of the token matching the specified <paramref name="path"/>.
+        /// If a matching token can not be found or the value can not be successfully converted to a
+        /// <see cref="double"/> value,<see langword="null"/> is returned instead.
+        /// </summary>
+        /// <param name="json">The parent JSON object.</param>
+        /// <param name="path">A <see cref="string"/> that contains a JPath expression.</param>
+        /// <returns>An instance of <see cref="double"/> if successful; otherwise, <see langword="null"/>.</returns>
+        public static double? GetDoubleOrNullByPath(this JObject? json, string path) {
+            return JsonTokenUtils.GetDoubleOrNull(json?.SelectToken(path));
+        }
+
         /// <summary>
         /// Attempts to get a <see cref="double"/> value from the property with the specified <paramref name="propertyName"/>.
         /// </summary>

src/Skybrud.Essentials/Json/Newtonsoft/Extensions/NewtonsoftJsonObjectExtensions.Float.cs

@@ -47,6 +47,18 @@ public static float GetFloat(this JObject? json, string propertyName, float fall
             return JsonTokenUtils.GetFloat(json?[propertyName], callback);
         }
 
+        /// <summary>
+        /// Returns the <see cref="float"/> value of the property with the specified <paramref name="propertyName"/>.
+        /// If a matching property can not be found or the value can not be successfully converted to a
+        /// <see cref="float"/> value, <see langword="null"/> is returned instead.
+        /// </summary>
+        /// <param name="json">The parent JSON object.</param>
+        /// <param name="propertyName">The name of the property.</param>
+        /// <returns>An instance of <see cref="float"/> if successful; otherwise, <see langword="null"/>.</returns>
+        public static float? GetFloatOrNull(this JObject? json, string propertyName) {
+            return JsonTokenUtils.GetFloatOrNull(json?[propertyName]);
+        }
+
         /// <summary>
         /// Returns the <see cref="float"/> value of the token matching the specified <paramref name="path"/>.
         /// If a matching token can not be found or the value can not be successfully converted to a
@@ -86,6 +98,18 @@ public static float GetFloatByPath(this JObject? json, string path, float fallba
             return JsonTokenUtils.GetFloat(json?.SelectToken(path), callback);
         }
 
+        /// <summary>
+        /// Returns the <see cref="float"/> value of the token matching the specified <paramref name="path"/>.
+        /// If a matching token can not be found or the value can not be successfully converted to a
+        /// <see cref="float"/> value,<see langword="null"/> is returned instead.
+        /// </summary>
+        /// <param name="json">The parent JSON object.</param>
+        /// <param name="path">A <see cref="string"/> that contains a JPath expression.</param>
+        /// <returns>An instance of <see cref="float"/> if successful; otherwise, <see langword="null"/>.</returns>
+        public static float? GetFloatOrNullByPath(this JObject? json, string path) {
+            return JsonTokenUtils.GetFloatOrNull(json?.SelectToken(path));
+        }
+
         /// <summary>
         /// Attempts to get a <see cref="float"/> value from the property with the specified <paramref name="propertyName"/>.
         /// </summary>

src/Skybrud.Essentials/Json/Newtonsoft/Extensions/NewtonsoftJsonObjectExtensions.Guid.cs

@@ -47,6 +47,18 @@ public static Guid GetGuid(this JObject? json, string propertyName, Guid fallbac
             return JsonTokenUtils.GetGuid(json?[propertyName], callback);
         }
 
+        /// <summary>
+        /// Returns the <see cref="Guid"/> value of the property with the specified <paramref name="propertyName"/>.
+        /// If a matching property can not be found or the value can not be successfully converted to a
+        /// <see cref="Guid"/> value, <see langword="null"/> is returned instead.
+        /// </summary>
+        /// <param name="json">The parent JSON object.</param>
+        /// <param name="propertyName">The name of the property.</param>
+        /// <returns>An instance of <see cref="Guid"/> if successful; otherwise, <see langword="null"/>.</returns>
+        public static Guid? GetGuidOrNull(this JObject? json, string propertyName) {
+            return JsonTokenUtils.GetGuidOrNull(json?[propertyName]);
+        }
+
         /// <summary>
         /// Returns the <see cref="Guid"/> value of the token matching the specified <paramref name="path"/>. If
         /// a matching token can not be found or the value can not be successfully converted to an <see cref="Guid"/>
@@ -87,6 +99,18 @@ public static Guid GetGuidByPath(this JObject? json, string path, Guid fallback)
             return JsonTokenUtils.GetGuid(json?.SelectToken(path), callback);
         }
 
+        /// <summary>
+        /// Returns the <see cref="Guid"/> value of the token matching the specified <paramref name="path"/>.
+        /// If a matching token can not be found or the value can not be successfully converted to a
+        /// <see cref="Guid"/> value,<see langword="null"/> is returned instead.
+        /// </summary>
+        /// <param name="json">The parent JSON object.</param>
+        /// <param name="path">A <see cref="string"/> that contains a JPath expression.</param>
+        /// <returns>An instance of <see cref="Guid"/> if successful; otherwise, <see langword="null"/>.</returns>
+        public static Guid? GetGuidOrNullByPath(this JObject? json, string path) {
+            return JsonTokenUtils.GetGuidOrNull(json?.SelectToken(path));
+        }
+
         /// <summary>
         /// Attempts to get an <see cref="Guid"/> value from the property with the specified <paramref name="propertyName"/>.
         /// </summary>

src/Skybrud.Essentials/Json/Newtonsoft/Extensions/NewtonsoftJsonObjectExtensions.Int16.cs

@@ -47,6 +47,18 @@ public static short GetInt16(this JObject? json, string propertyName, short fall
             return JsonTokenUtils.GetInt16(json?[propertyName], callback);
         }
 
+        /// <summary>
+        /// Returns the <see cref="short"/> value of the property with the specified <paramref name="propertyName"/>.
+        /// If a matching property can not be found or the value can not be successfully converted to a
+        /// <see cref="short"/> value, <see langword="null"/> is returned instead.
+        /// </summary>
+        /// <param name="json">The parent JSON object.</param>
+        /// <param name="propertyName">The name of the property.</param>
+        /// <returns>An instance of <see cref="short"/> if successful; otherwise, <see langword="null"/>.</returns>
+        public static short? GetInt16OrNull(this JObject? json, string propertyName) {
+            return JsonTokenUtils.GetInt16OrNull(json?[propertyName]);
+        }
+
         /// <summary>
         /// Returns the <see cref="short"/> value of the token matching the specified <paramref name="path"/>.
         /// If a matching token can not be found or the value can not be successfully converted to a
@@ -86,6 +98,18 @@ public static short GetInt16ByPath(this JObject? json, string path, short fallba
             return JsonTokenUtils.GetInt16(json?.SelectToken(path), callback);
         }
 
+        /// <summary>
+        /// Returns the <see cref="short"/> value of the token matching the specified <paramref name="path"/>.
+        /// If a matching token can not be found or the value can not be successfully converted to a
+        /// <see cref="short"/> value,<see langword="null"/> is returned instead.
+        /// </summary>
+        /// <param name="json">The parent JSON object.</param>
+        /// <param name="path">A <see cref="string"/> that contains a JPath expression.</param>
+        /// <returns>An instance of <see cref="short"/> if successful; otherwise, <see langword="null"/>.</returns>
+        public static short? GetInt16OrNullByPath(this JObject? json, string path) {
+            return JsonTokenUtils.GetInt16OrNull(json?.SelectToken(path));
+        }
+
         /// <summary>
         /// Attempts to get a <see cref="short"/> value from the property with the specified <paramref name="propertyName"/>.
         /// </summary>

src/Skybrud.Essentials/Json/Newtonsoft/Extensions/NewtonsoftJsonObjectExtensions.Int32.cs

@@ -47,6 +47,18 @@ public static int GetInt32(this JObject? json, string propertyName, int fallback
             return JsonTokenUtils.GetInt32(json?[propertyName], callback);
         }
 
+        /// <summary>
+        /// Returns the <see cref="int"/> value of the property with the specified <paramref name="propertyName"/>.
+        /// If a matching property can not be found or the value can not be successfully converted to a
+        /// <see cref="int"/> value, <see langword="null"/> is returned instead.
+        /// </summary>
+        /// <param name="json">The parent JSON object.</param>
+        /// <param name="propertyName">The name of the property.</param>
+        /// <returns>An instance of <see cref="int"/> if successful; otherwise, <see langword="null"/>.</returns>
+        public static int? GetInt32OrNull(this JObject? json, string propertyName) {
+            return JsonTokenUtils.GetInt32OrNull(json?[propertyName]);
+        }
+
         /// <summary>
         /// Returns the <see cref="int"/> value of the token matching the specified <paramref name="path"/>.
         /// If a matching token can not be found or the value can not be successfully converted to a
@@ -86,6 +98,18 @@ public static int GetInt32ByPath(this JObject? json, string path, int fallback)
             return JsonTokenUtils.GetInt32(json?.SelectToken(path), callback);
         }
 
+        /// <summary>
+        /// Returns the <see cref="int"/> value of the token matching the specified <paramref name="path"/>.
+        /// If a matching token can not be found or the value can not be successfully converted to a
+        /// <see cref="int"/> value,<see langword="null"/> is returned instead.
+        /// </summary>
+        /// <param name="json">The parent JSON object.</param>
+        /// <param name="path">A <see cref="string"/> that contains a JPath expression.</param>
+        /// <returns>An instance of <see cref="int"/> if successful; otherwise, <see langword="null"/>.</returns>
+        public static int? GetInt32OrDefaultByNull(this JObject? json, string path) {
+            return JsonTokenUtils.GetInt32OrNull(json?.SelectToken(path));
+        }
+
         /// <summary>
         /// Attempts to get an <see cref="int"/> value from the property with the specified <paramref name="propertyName"/>.
         /// </summary>

src/Skybrud.Essentials/Json/Newtonsoft/Extensions/NewtonsoftJsonObjectExtensions.Int64.cs

@@ -47,6 +47,18 @@ public static long GetInt64(this JObject? json, string propertyName, long fallba
             return JsonTokenUtils.GetInt64(json?[propertyName], callback);
         }
 
+        /// <summary>
+        /// Returns the <see cref="long"/> value of the property with the specified <paramref name="propertyName"/>.
+        /// If a matching property can not be found or the value can not be successfully converted to a
+        /// <see cref="long"/> value, <see langword="null"/> is returned instead.
+        /// </summary>
+        /// <param name="json">The parent JSON object.</param>
+        /// <param name="propertyName">The name of the property.</param>
+        /// <returns>An instance of <see cref="long"/> if successful; otherwise, <see langword="null"/>.</returns>
+        public static long? GetInt64OrNull(this JObject? json, string propertyName) {
+            return JsonTokenUtils.GetInt64OrNull(json?[propertyName]);
+        }
+
         /// <summary>
         /// Returns the <see cref="long"/> value of the token matching the specified <paramref name="path"/>.
         /// If a matching token can not be found or the value can not be successfully converted to a
@@ -86,6 +98,18 @@ public static long GetInt64ByPath(this JObject? json, string path, long fallback
             return JsonTokenUtils.GetInt64(json?.SelectToken(path), callback);
         }
 
+        /// <summary>
+        /// Returns the <see cref="long"/> value of the token matching the specified <paramref name="path"/>.
+        /// If a matching token can not be found or the value can not be successfully converted to a
+        /// <see cref="long"/> value,<see langword="null"/> is returned instead.
+        /// </summary>
+        /// <param name="json">The parent JSON object.</param>
+        /// <param name="path">A <see cref="string"/> that contains a JPath expression.</param>
+        /// <returns>An instance of <see cref="long"/> if successful; otherwise, <see langword="null"/>.</returns>
+        public static long? GetInt64OrNullByPath(this JObject? json, string path) {
+            return JsonTokenUtils.GetInt64OrNull(json?.SelectToken(path));
+        }
+
         /// <summary>
         /// Attempts to get a <see cref="long"/> value from the property with the specified <paramref name="propertyName"/>.
         /// </summary>

src/Skybrud.Essentials/Json/Newtonsoft/Extensions/NewtonsoftJsonObjectExtensions.UInt16.cs

@@ -47,6 +47,18 @@ public static ushort GetUInt16(this JObject? json, string propertyName, ushort f
             return JsonTokenUtils.GetUInt16(json?[propertyName], callback);
         }
 
+        /// <summary>
+        /// Returns the <see cref="ushort"/> value of the property with the specified <paramref name="propertyName"/>.
+        /// If a matching property can not be found or the value can not be successfully converted to a
+        /// <see cref="ushort"/> value, <see langword="null"/> is returned instead.
+        /// </summary>
+        /// <param name="json">The parent JSON object.</param>
+        /// <param name="propertyName">The name of the property.</param>
+        /// <returns>An instance of <see cref="ushort"/> if successful; otherwise, <see langword="null"/>.</returns>
+        public static ushort? GetUInt16OrNull(this JObject? json, string propertyName) {
+            return JsonTokenUtils.GetUInt16OrNull(json?[propertyName]);
+        }
+
         /// <summary>
         /// Returns the <see cref="ushort"/> value of the token matching the specified <paramref name="path"/>.
         /// If a matching token can not be found or the value can not be successfully converted to a
@@ -86,6 +98,18 @@ public static ushort GetUInt16ByPath(this JObject? json, string path, ushort fal
             return JsonTokenUtils.GetUInt16(json?.SelectToken(path), callback);
         }
 
+        /// <summary>
+        /// Returns the <see cref="ushort"/> value of the token matching the specified <paramref name="path"/>.
+        /// If a matching token can not be found or the value can not be successfully converted to a
+        /// <see cref="ushort"/> value,<see langword="null"/> is returned instead.
+        /// </summary>
+        /// <param name="json">The parent JSON object.</param>
+        /// <param name="path">A <see cref="string"/> that contains a JPath expression.</param>
+        /// <returns>An instance of <see cref="ushort"/> if successful; otherwise, <see langword="null"/>.</returns>
+        public static ushort? GetUInt16OrNullByPath(this JObject? json, string path) {
+            return JsonTokenUtils.GetUInt16OrNull(json?.SelectToken(path));
+        }
+
         /// <summary>
         /// Attempts to get an <see cref="ushort"/> value from the property with the specified <paramref name="propertyName"/>.
         /// </summary>