Compétences allra-error-handling
📦

allra-error-handling

Sûr

Standardisierte Fehlerbehandlung implementieren

Java Spring-Anwendungen fehlen oft konsistente Muster zur Fehlerbehandlung. Dieser Skill bietet einen vollständigen Standard für Fehlerbehandlung einschließlich Exception-Hierarchien, globaler Exception-Handler und strukturierter Fehlerantworten.

Prend en charge: Claude Codex Code(CC)
📊 71 Adéquat
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "allra-error-handling". Erstelle eine benutzerdefinierte Exception für Szenarien, in denen Benutzer nicht gefunden werden

Résultat attendu:

  • public class UserNotFoundException extends BusinessException {
  • public UserNotFoundException(Long userId) {
  • super(ErrorCode.USER_NOT_FOUND,
  • String.format("사용자(id=%d)를 찾을 수 없습니다", userId));
  • }
  • }

Utilisation de "allra-error-handling". Implementiere Fehlerbehandlung für Validierungsfehler

Résultat attendu:

  • public record ErrorResponse(
  • String code,
  • String message,
  • List<FieldError> errors,
  • LocalDateTime timestamp
  • ) {}

Audit de sécurité

Sûr
v6 • 1/21/2026

All static findings are false positives. The skill is a documentation-only skill containing Java code examples for error handling patterns. No actual security risks present.

2
Fichiers analysés
758
Lignes analysées
0
résultats
6
Total des audits
Aucun problème de sécurité trouvé
Audité par: claude Voir l’historique des audits →

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
32
Communauté
100
Sécurité
91
Conformité aux spécifications

Ce que vous pouvez construire

Konsistente API-Fehlerantworten erstellen

Entwirft ein standardisiertes Fehlerantwortformat über alle REST-Endpunkte hinweg mit konsistenten Fehlercodes, Meldungen und feldspezifischen Validierungsdetails.

Domänenspezifische Exceptions implementieren

Erstellt eine Hierarchie benutzerdefinierter Exceptions für Geschäftslogikfehler wie EntityNotFoundException, DuplicateResourceException und Autorisierungsfehler.

Zentralisierte Exception-Behandlung hinzufügen

Implementiert einen globalen Exception-Handler, der alle Exceptions einheitlich erfasst und verarbeitet, um konsistente Fehlerantworten an API-Clients sicherzustellen.

Essayez ces prompts

Grundlegende Fehlerbehandlung 
Create a business exception hierarchy for a Java Spring Boot application. Include a base BusinessException class, an ErrorCode enum with common HTTP error codes, and examples of domain-specific exceptions like UserNotFoundException.
Globaler Exception-Handler 
Implement a @RestControllerAdvice GlobalExceptionHandler that handles BusinessException, MethodArgumentNotValidException for validation errors, and generic Exception. Return a structured ErrorResponse with timestamp, error code, message, and field errors.
Strukturierte Fehlerantworten 
Design an ErrorResponse record in Java that includes error code, message, a list of field-level errors with field name, rejected value, and error message, plus a timestamp. Provide factory methods for different error scenarios.
Fehlermuster in der Service-Schicht 
Show how to use custom exceptions in a Spring service layer. Include examples of orElseThrow with EntityNotFoundException, duplicate resource validation with DuplicateResourceException, and authorization checks with ForbiddenException.

Bonnes pratiques

  • Definiere ein zentrales ErrorCode-Enum mit konsistenten HTTP-Statuscodes und Fehlercodes für alle Business-Exceptions
  • Verwende WARN-Level-Logging für erwartete Business-Exceptions und ERROR-Level für unerwartete System-Exceptions
  • Schließe sensible Daten aus Fehlerantworten und Log-Meldungen aus, um Informationslecks zu vermeiden

Éviter

  • Werfen generischer Exception oder RuntimeException anstelle benutzerdefinierter Business-Exceptions
  • Direktes Offenlegen von Stack Traces oder internen Fehlerdetails gegenüber API-Clients
  • Verwendung von String-Konkatenation anstelle parametrisiertem Logging für strukturierte Log-Ausgaben

Foire aux questions

Wie unterscheidet sich dieser Skill von der Standard-Fehlerbehandlung von Spring?
Dieser Skill bietet ein standardisiertes, unternehmenstaugliches Fehlerbehandlungsmuster mit benutzerdefinierten Exception-Hierarchien, strukturierten Fehlerantworten und konsistentem Logging. Die Standard-Fehlerbehandlung von Spring ist grundlegend und nicht für Produktions-APIs geeignet.
Kann ich dies mit Java-Anwendungen außerhalb von Spring verwenden?
Die Exception-Hierarchie und Fehlerantwortmuster können an jede Java-Anwendung angepasst werden. Die @RestControllerAdvice-Beispiele sind jedoch spezifisch für Spring Boot.
Wie behandle ich Validierungsfehler aus Request-Bodies?
Verwende @Valid bei Request-Body-Parametern und fange MethodArgumentNotValidException im GlobalExceptionHandler ab. Extrahiere Feldfehler aus dem BindingResult und füge sie in die ErrorResponse ein.
Sollte ich Stack Traces in Fehlerantworten einschließen?
Nein. Stack Traces legen interne Implementierungsdetails offen und können sensible Informationen preisgeben. Gib in Produktionsumgebungen immer benutzerfreundliche Meldungen zurück.
Wie logge ich Fehler korrekt, ohne sensible Daten offenzulegen?
Verwende parametrisiertes Logging mit Platzhaltern wie log.warn("User not found: userId={}", id). Logge niemals direkt Benutzereingaben, Passwörter oder sensible Felder.
Kann ich dieses Muster für Microservices erweitern?
Ja. Füge Correlation-IDs zu ErrorResponse für Distributed Tracing hinzu. Erwäge die Standardisierung von ErrorCode-Enums über Services hinweg für konsistente Fehlerbehandlung in Microservice-Architekturen.

Détails du développeur

Licence

MIT

Dépôt

https://github.com/Allra-Fintech/allra-ai-skills/tree/main/backend-plugin/skills/error-handling

Réf

main

Structure de fichiers

📄 SKILL.md