dotnet-json-polymorphic
/dotnet-json-polymorphic
Konfiguruje polimorficzną serializację JSON atrybutami [JsonPolymorphic] i [JsonDerivedType], w tym dyskryminator typu i serializację typów pochodnych.
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 2
Brak sygnałów. Repozytorium zmienione 15.09.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Konfiguruje polimorficzną serializację JSON atrybutami [JsonPolymorphic] i [JsonDerivedType], w tym dyskryminator typu i serializację typów pochodnych.
Wyzwalacze z opisu
Oryginalny opis (EN)
Configures polymorphic JSON serialization with [JsonPolymorphic] and [JsonDerivedType] attributes. Also use when the user mentions "polymorphic JSON," "JsonDerivedType," "JSON inheritance," "type discriminator," "serialize derived types," or "JSON polymorphism." For full JSON source generation, see dotnet-source-gen-json.
Jak działa
- When to Use
- Requirements
- Steps
- Example Conversion
- Notes
- Documentation
Podgląd SKILL.md
---
name: dotnet-json-polymorphic
description: Configures polymorphic JSON serialization with [JsonPolymorphic] and [JsonDerivedType] attributes. Also use when the user mentions "polymorphic JSON," "JsonDerivedType," "JSON inheritance," "type discriminator," "serialize derived types," or "JSON polymorphism." For full JSON source generation, see dotnet-source-gen-json.
license: MIT
metadata:
author: Im5tu
version: "1.0"
repositoryUrl: https://github.com/im5tu/dotnet-skills
allowed-tools: Bash(dotnet:*), Read, Edit, Write, Glob, Grep, AskUserQuestion
---
Configure polymorphic JSON serialization using `[JsonPolymorphic]` and `[JsonDerivedType]` attributes for type-safe inheritance hierarchies.
## When to Use
- Serializing inheritance hierarchies with System.Text.Json
- Adding type discriminators for polymorphic deserialization
- Preparing polymorphic types for AOT-compatible JSON source generation
- Replacing Newtonsoft.Json `TypeNameHandling` with `[JsonPolymorphic]`/`[JsonDerivedType]`
## Requirements
- .NET 7 or higher
## Steps
1. **Ask scope**:
- Ask user: "Apply to entire solution or specific project?"
- If specific project, ask which project
2. **Search for existing `[JsonPolymorphic]` attributes**:
- Detect existing project conventions
- Note any `TypeDiscriminatorPropertyName` values found
3. **Extract discriminator conventions**:
- Search for `TypeDiscriminatorPropertyName` in existing attributes
- Record all unique discriminator property names found
4. **Find polymorphic candidates**:
- Search for abstract classes with derived types
- Search for interfaces with implementing classes used in serialization
- Look for classes with virtual members that are inherited
5. **Ask about discriminator property name**:
- If existing discriminators found, show them to user
- Ask: "What discriminator property name? (Default: `$type`, Found: [list existing])"
6. **Check for consistency**:
- If multiple different discriminators found in codebase
- Ask: "Found multiple discriminators: [list]. Standardize to single value?"
7. **Apply attributes to base types**:
```csharp
[JsonPolymorphic(TypeDiscriminatorPropertyName = "$type")]
[JsonDerivedType(typeof(DerivedA), typeDiscriminator: "DerivedA")]
[JsonDerivedType(typeof(DerivedB), typeDiscriminator: "DerivedB")]
public abstract class BaseClass
{
}
```
- Use full type name as discriminator value (e.g., `"WeatherForecastWithCity"`)
8. **Add using directive**:
- Ensure `using System.Text.Json.Serialization;` is present
9. **Verify with build**:
```bash
dotnet build
```
10. **Report results**:
- List all base types configured
- List all derived type mappings added
- Confirm build status
## Example Conversion
**Before:**
```csharp
public abstract class Notification
{
public string Message { get; set; }
}
public class EmailNotification : Notification
{
public string EmailAddress { get; set; }
}
public class SmsNotification : Notification
{
public string PhoneNumber { get; set; }
}
```
**After:**
```csharp
[JsonPolymorphic(TypeDiscriminatorPropertyName = "$type")]
[JsonDerivedType(typeof(EmailNotification), typeDiscriminator: "EmailNotification")]
[JsonDerivedType(typeof(SmsNotification), typeDiscriminator: "SmsNotification")]
public abstract class Notification
{
public string Message { get; set; }
}
public class EmailNotification : Notification
{
public string EmailAddress { get; set; }
}
public class SmsNotification : Notification
{
public string PhoneNumber { get; set; }
}
```
**JSON Output:**
```json
{
"$type": "EmailNotification",
"message": "Hello",
"emailAddress": "user@example.com"
}
```
## Notes
- **AOT Compatibility**: Metadata-based source generation is supported; fast-path source generation is NOT supported for polymorphic types
- **Serialization requirement**: Must serialize using the base type for polymorphism to work (e.g., `JsonSerializer.Serialize<Notification>(emailNotification)`)
- **Discriminator values**: String discriminators are recommended over integers for readability and forward compatibility
- **Nested hierarchies**: Each level in the hierarchy needs its own `[JsonPolymorphic]` attribute if it has derived types
- **Interface support**: Interfaces can also use `[JsonPolymorphic]` when they define the contract for serialization
## Documentation
- [System.Text.Json Polymorphism](https://learn.microsoft.com/en-us/dotnet/standard/serialization/system-text-json/polymorphism)
Wersje
W bazie nie ma innych skilli o nazwie dotnet-json-polymorphic.
Migawka bazy z 13.11.2026 · wersja paczki e8910b6f142a (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100dotnet-source-gen-json
Konfiguruje generowanie źródeł System.Text.Json dla serializacji JSON zgodnej z AOT, z JsonSerializerContext i JsonSerializable, bez refleksji. - 100dotnet-aot-analysis
Analizuje i konfiguruje projekt lub rozwiązanie .NET pod kątem zgodności z Native AOT, koordynując skille generatorów źródeł i stosując ustawienia AOT, w tym trimming. - 100unit-test-json-serialization
Dostarcza wzorce testów serializacji i deserializacji JSON z Jackson i @JsonTest: mapowanie JSON, własne serializery, formaty dat i typy polimorficzne w Spring Boot. - 100flutter-implement-json-serialization
Pomaga pisać ręczne serializatory JSON z dart:convert i dopasowaniem wzorców Dart albo automatyzować serializację modeli. - 100refactoring-conditionals-polymorphism-strategy
Zamienia zagnieżdżone warunki i instrukcje switch na polimorficzne wzorce Strategy i Command. - 100flutter-handling-http-and-json
Wykonuje żądania HTTP i obsługuje serializację JSON w aplikacji Flutter przy integracji z REST API i parsowaniu danych strukturalnych.