kenmirrors/asterisk
1
0
Fork 0
mirror of https://github.com/asterisk/asterisk.git synced 2025-11-20 08:40:16 +00:00
Code Issues Packages Projects Releases Wiki Activity

stasis: Add internal filtering of messages.

Browse Source 
This change adds the ability for subscriptions to indicate
which message types they are interested in accepting. By
doing so the filtering is done before being dispatched
to the subscriber, reducing the amount of work that has
to be done.

This is optional and if a subscriber does not add
message types they wish to accept and set the subscription
to selective filtering the previous behavior is preserved
and they receive all messages.

There is also the ability to explicitly force the reception
of all messages for cases such as AMI or ARI where a large
number of messages are expected that are then generically
converted into a different format.

ASTERISK-28103

Change-Id: I99bee23895baa0a117985d51683f7963b77aa190
This commit is contained in:
Joshua Colp
2018-09-23 17:50:01 -03:00
parent dd0a3c0bba
commit 8d436a95e7
33 changed files with 457 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

35
include/asterisk/stasis_cache_pattern.h
View File

@@ -169,4 +169,39 @@ struct stasis_topic *stasis_cp_single_topic(struct stasis_cp_single *one);
struct stasis_topic *stasis_cp_single_topic_cached(
struct stasis_cp_single *one);
/*!
* \brief Indicate to an instance that we are interested in a message type.
*
* This will cause the caching topic to receive messages of the given message
* type. This enables internal filtering in the stasis message bus to reduce
* messages.
*
* \param one One side of the cache pattern.
* \param type The message type we wish to receive.
* \retval 0 on success
* \retval -1 failure
*
* \since 17.0.0
*/
int stasis_cp_single_accept_message_type(struct stasis_cp_single *one,
struct stasis_message_type *type);
/*!
* \brief Set the message type filtering level on a cache
*
* This will cause the underlying subscription to filter messages according to the
* provided filter level. For example if selective is used then only
* messages matching those provided to \ref stasis_subscription_accept_message_type
* will be raised to the subscription callback.
*
* \param one One side of the cache pattern.
* \param filter What filter to use
* \retval 0 on success
* \retval -1 failure
*
* \since 17.0.0
*/
int stasis_cp_single_set_filter(struct stasis_cp_single *one,
enum stasis_subscription_message_filter filter);
#endif /* _ASTERISK_STASIS_CACHE_PATTERN_H */