Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The above sections of an event receiver configuration are described below.

Section
Description
FromAn input event adapter (transport) configuration via which the event receiver receives events.
Adapter propertiesSpecific properties of the selected input event adapter. For information on configuring adapter properties of various transport types, see Event Receiver Types.
ToThe event stream that is generated from
which the event receiver will fetch the events for processing
the receivers received events.
Mapping configurationThe format of the message that is received. You can configure custom mappings on the selected format via advanced settings. For information on configuring custom mappings, see Input Mapping Types.

Creating event receivers

You can create event receivers either using the management console or using a configuration file as explained below.

...

  1. Create an XML file with the following event receiver configurations. An event receiver implementation must start with  <eventReceiver>  as the root element.

    Note

    In the following configuration, specify the respective adapter properties based on the transport type of the receiver within the <from> element. For the respective adapter properties of the event receiver configuration based on the transport type, see Event Receiver Types .

    Code Block
    languagexml
    <eventReceiver name="EVENT-RECEIVER-NAME" statistics="disable" trace="disable" xmlns="http://wso2.org/carbon/eventreceiver">
        <from eventAdapterType="EVENT-ADAPTER-TYPE">
           .................................
        </from>
        <mapping customMapping="disable" type="xml"/>
        <to streamName="Test Stream" version="1.0.0"/>
    </eventReceiver>

    The properties of the above configuration are described below.

    Adapter propertyDescription
    name
    Name of the event receiver
    statistics
    Whether monitoring event statistics is enabled for the receiver
    trace
    Whether tracing events is enabled for the receiver
    xmlns
    XML namespace for event receivers
    eventAdapterType
    Type of the event adapter.
    customMapping
    Whether a custom mapping is enabled on the receiver.
    type
    Type of the enabled custom mapping.
    streamName
    Name of the event stream to which the receiver is mapped.
  2.   Add the XML file to the <PRODUCT_HOME>/repository/deployment/server/eventreceivers/ directory. Since hot deployment is supported in the product, you can simply add/remove event receiver configuration files to deploy/undeploy event receivers to/from the server.

...