root
/
rabbitmq-server
mirror of https://github.com/rabbitmq/rabbitmq-server.git
1
0
Fork 0
Code Issues Actions Packages Projects Releases Wiki Activity
rabbitmq-server/deps/rabbitmq_event_exchange/Makefile

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

22 lines
505 B
Makefile
Raw Permalink Normal View History

Upgrade to erlang.mk and RabbitMQ 3.6.0
2015-12-01 01:33:54 +08:00
PROJECT = rabbitmq_event_exchange
Move from .app.src to Makefile variables This is the recommended way with Erlang.mk. By default, the version is inherited from rabbitmq-server-release when the source archive is created, or computed from git-describe(1) (see `rabbitmq-components.mk`). One can override the version from the command line by setting the `PROJECT_VERSION` variable. [#130992027]
2016-12-06 22:59:48 +08:00
PROJECT_DESCRIPTION = Event Exchange Type
Upgrade to erlang.mk and RabbitMQ 3.6.0
2015-12-01 01:33:54 +08:00
Support publishing AMQP 1.0 to Event Exchange ## What? Prior to this commit, the `rabbitmq_event_exchange` internally published always AMQP 0.9.1 messages to the `amq.rabbitmq.event` topic exchange. This commit allows users to configure the plugin to publish AMQP 1.0 messages instead. ## Why? Prior to this commit, when an AMQP 1.0 client consumed events, event properties that are lists were omitted. For example property `client_properties` of event `connection.created` or property `arguments` of event `queue.created` were omitted because of the following sequence: 1. The event exchange plugins listens for all kind of internal events. 2. The event exchange plugin re-publishes all events as AMQP 0.9.1 message to the event exchange. 3. Later, when an AMQP 1.0 client consumes this message, the broker must translate the message from AMQP 0.9.1 to AMQP 1.0. 4. This translation follows the rules outlined in https://www.rabbitmq.com/docs/conversions#amqpl-amqp 5. Specifically, in this table the row before the last one describes the rule we're hitting here. It says that if the AMQP 0.9.1 header value is not an `x-` prefixed header and its value is an array or table, then this header is not converted. That's because AMQP 1.0 application-properties must be simple types as mandated in https://docs.oasis-open.org/amqp/core/v1.0/os/amqp-core-messaging-v1.0-os.html#type-application-properties ## How? The user can configure the plugin as follows to have the plugin internally publish AMQP 1.0 messages: ``` event_exchange.protocol = amqp_1_0 ``` To support complex types such as lists, the plugin sets all event properties as AMQP 1.0 message-annotations. The plugin prefixes all message annotation keys with `x-opt-` to comply with the AMQP 1.0 spec. ## Alternative Design An alternative design would have been to format all event properties e.g. as JSON within the message body. However, this breaks routing on specific event property values via a headers exchange. ## Documentation https://github.com/rabbitmq/rabbitmq-website/pull/2129
2024-11-12 19:16:15 +08:00
define PROJECT_ENV
[
{protocol, amqp_0_9_1}
]
endef
Merge branch 'stable'
2016-12-07 22:37:06 +08:00
define PROJECT_APP_EXTRA_KEYS
{broker_version_requirements, []}
endef
Upgrade to erlang.mk and RabbitMQ 3.6.0
2015-12-01 01:33:54 +08:00
Makefile: Explicitely list all DEPS Sync rabbitmq-components.mk with rabbitmq-common to remove automatic DEPS handling. [#130086871]
2016-09-19 19:48:10 +08:00
DEPS = rabbit_common rabbit
Add AMQP 1.0 event exchange test
2024-10-29 18:22:32 +08:00
TEST_DEPS = rabbitmq_ct_helpers rabbitmq_ct_client_helpers amqp_client rabbitmq_amqp_client
Upgrade to erlang.mk and RabbitMQ 3.6.0
2015-12-01 01:33:54 +08:00
Makefile: Load the new `rabbitmq-early-plugin.mk` early-stage plugin See the corresponding commit in rabbitmq-common for an explanation. [#144697185]
2017-05-16 23:32:41 +08:00
DEP_EARLY_PLUGINS = rabbit_common/mk/rabbitmq-early-plugin.mk
Upgrade to erlang.mk and RabbitMQ 3.6.0
2015-12-01 01:33:54 +08:00
DEP_PLUGINS = rabbit_common/mk/rabbitmq-plugin.mk
Remove duplicate rabbitmq-components.mk and erlang.mk files Also adjust the references in rabbitmq-components.mk to account for post monorepo locations
2021-03-22 17:38:17 +08:00
include ../../rabbitmq-components.mk
include ../../erlang.mk