What is the priority order for identifier resolution in Ecotone?

Resolution follows this order: 1. aggregate.id metadata (highest), 2. Native mapping (matching names), 3. #[TargetIdentifier] attribute, 4. identifierMapping expressions, and 5. identifierMetadataMapping.

What is Native ID Mapping?

Native mapping is the default behavior where Ecotone automatically matches a property in your command or event to the property marked with #[Identifier] in your Aggregate if they share the same name.

Can I resolve an aggregate identifier from message headers?

Yes, you can use 'identifierMetadataMapping' to map an identifier to a specific header name, or use an expression in 'identifierMapping' like "headers['headerName']".

How do I map an identifier if the command property name is different?

You can use the #[TargetIdentifier('identifierName')] attribute on the command's property to explicitly point it to the aggregate's identifier.

Ecotone Identifier Mapping

Name: Ecotone Identifier Mapping
Author: ecotoneframework

byecotoneframework

•

Desarrollo de API

Simplifies aggregate and saga identifier resolution for the Ecotone PHP framework using attributes and expressions.

This skill provides expert guidance on configuring how Ecotone resolves and loads aggregate and saga instances from incoming commands and events. It covers the full hierarchy of identifier resolution, from native property matching and #[TargetIdentifier] attributes to advanced expression-based mapping and metadata overrides. By utilizing this skill, developers can ensure messages are correctly routed to business entities even when property names differ or when routing depends on complex header-based logic.

Características Principales

01Explicit property mapping with #[TargetIdentifier] and #[IdentifierMethod]

02Streamlined identifierMetadataMapping for direct header-to-identifier links

03Native identifier resolution through automatic property name matching

0452 GitHub stars

05Expression-based mapping for extracting identifiers from payloads or headers

06Metadata-based overrides using the aggregate.id header for high-priority routing

Casos de Uso

01Correlating domain events to sagas to manage complex, long-running business processes

02Wiring commands to aggregates when message property names don't match entity identifiers

03Implementing custom routing logic for legacy message structures using SpEL-like expressions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ecotoneframework/ecotone-dev ecotone-identifier-mapping

For use in Claude.ai and ChatGPT

Download Skill