Soenneker.Extensions.Objects.Reflection 4.0.4

Soenneker.Extensions.Objects.Reflection

Reflection-based object projection, query/form encoding, diagnostics, and JSON HttpContent creation.

Installation

dotnet add package Soenneker.Extensions.Objects.Reflection

Build a query string

using Soenneker.Extensions.Objects.Reflection;

string query = new SearchRequest
{
    Page = 2,
    IncludeArchived = false
}.ToQueryStringViaCachedReflection();

// ?page=2&includeArchived=false

ToQueryStringViaCachedReflection() uses readable public instance properties, [JsonPropertyName] or web-default camelCase names, and percent-escapes both names and values. It honors [JsonIgnore] conditions, formats scalar values invariantly, and JSON-formats other values before escaping. A null object or an object with no included values returns an empty string.

ToQueryStringViaReflection() is the simpler legacy path: it uses CLR property names, optionally lowercases them, calls ToString() under the current culture, skips nulls, and escapes names and values. Both methods prepend ? when at least one pair is emitted.

Project properties

Dictionary<string, object?> values = model.ToDictionaryViaReflection();

ToDictionaryViaReflection() includes only readable, non-indexed public properties declared directly on the runtime type. [JsonPropertyName] controls keys; inherited properties are excluded. Values are not serialized or cloned. A null source returns a new empty dictionary.

Create request bodies

using HttpContent json = request.ToHttpContentViaReflection();
using FormUrlEncodedContent form = request.ToFormUrlEncodedContentViaReflection();

ToHttpContentViaReflection() serializes with JsonUtil.WebOptions into application/json; null produces an empty JSON-typed body, not the literal null. The caller owns and must dispose every returned content object.

ToFormUrlEncodedContentViaReflection() includes readable public properties, honors [JsonPropertyName], skips nulls, formats IFormattable values invariantly, and lets FormUrlEncodedContent perform encoding. Nested objects and collections are converted through ToString() rather than flattened.

Diagnostics

• LogNullPropertiesViaReflection() reports top-level null public properties.
• LogNullPropertiesRecursivelyAsJsonViaReflection() traverses application objects and collections, tracks reference cycles, and logs a JSON tree containing only null locations.
• ToReadableStringViaReflection() recursively renders public properties for human diagnostics.

Reflection getters and custom ToString() implementations can execute user code and throw. Diagnostic output can contain secrets or personal data, and ToReadableStringViaReflection() does not protect against reference cycles; use these helpers only with known model types and appropriate logging destinations.