ecotone-identifier-mapping
OfficialRoute to the right aggregate or saga via id.
System Documentation
What problem does it solve?
Implements identifier mapping for Ecotone aggregates and sagas: native ID resolution, aggregate.id metadata, #[TargetIdentifier], identifierMapping expressions, and #[IdentifierMethod]. Use when wiring commands/events to aggregates or sagas by identifier, resolving aggregate IDs from messages, or mapping event properties to saga identifiers.
Core Features & Use Cases
- Declarative identifiers with #[Identifier] on aggregates and sagas
- Native mapping by property name (automatic if it matches the identifier)
- aggregate.id metadata override to force routing
- #[TargetIdentifier] to map differently named properties
- identifierMapping for expressions from payload or headers
- identifierMetadataMapping for header-based identifier resolution
- identifier also supports #[IdentifierMethod] for computed values
- Support for composite keys via multiple identifiers
- Distinct rules preventing combining identifierMapping and identifierMetadataMapping on the same handler
Quick Start
Define identifier mappings on handlers (such as identifierMapping or identifierMetadataMapping) and emit an event or command to verify routing to the correct aggregate or saga by its identifier.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: ecotone-identifier-mapping Download link: https://github.com/ecotoneframework/skills/archive/main.zip#ecotone-identifier-mapping Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.