Package com.microsoft.azure.eventhubs

Interface EventData

  • All Superinterfaces:
    Comparable<EventData>, Serializable
    All Known Implementing Classes:
    EventDataImpl
    public interface EventData
extends Serializable, Comparable<EventData>
    The data structure encapsulating the Event being sent-to and received-from EventHubs. Each EventHubs partition can be visualized as a Stream of EventData.

    Serializing a received EventData with AMQP sections other than ApplicationProperties (with primitive java types) and Data section is not supported.

    Here's how AMQP message sections map to EventData. Here's the reference used for AMQP 1.0 specification: http://docs.oasis-open.org/amqp/core/v1.0/os/amqp-core-complete-v1.0-os.pdf 

     i.   getProperties() - AMQPMessage.ApplicationProperties section
 ii.  getBytes() - if AMQPMessage.Body has Data section
 iii. getObject() - if AMQPMessage.Body has AMQPValue or AMQPSequence sections
    While using client libraries released by Microsoft Azure EventHubs, sections (i) and (ii) alone are sufficient. Section (iii) is used for advanced scenarios, where the sending application uses third-party AMQP library to send the message to EventHubs and the receiving application uses this client library to receive EventData.

    • Method Detail

      • create

        static EventData create​(byte[] data)
        Construct EventData to Send to EventHubs. Typical pattern to create a Sending EventData is: 
         i.   Serialize the sending ApplicationEvent to be sent to EventHubs into bytes.
 ii.  If complex serialization logic is involved (for example: multiple types of data) - add a Hint using the getProperties() for the Consumer.

        Sample Code: 

         EventData eventData = EventData.create(telemetryEventBytes);
 eventData.getProperties().put("eventType", "com.microsoft.azure.monitoring.EtlEvent");
 partitionSender.Send(eventData);
        Parameters:
        data - the actual payload of data in bytes to be Sent to EventHubs.
        Returns:
        EventData the created EventData to send to EventHubs.
        See Also:
        EventHubClient.createFromConnectionString(String, ScheduledExecutorService)

      • create

        static EventData create​(byte[] data,
                        int offset,
                        int length)
        Construct EventData to Send to EventHubs. Typical pattern to create a Sending EventData is: 
         i.   Serialize the sending ApplicationEvent to be sent to EventHubs into bytes.
 ii.  If complex serialization logic is involved (for example: multiple types of data) - add a Hint using the getProperties() for the Consumer.

        Illustration: 

         
  EventData eventData = EventData.create(telemetryEventBytes, offset, length);
  eventData.getProperties().put("eventType", "com.microsoft.azure.monitoring.EtlEvent");
  partitionSender.Send(eventData);
        Parameters:
        data - the byte[] where the payload of the Event to be sent to EventHubs is present
        offset - Offset in the byte[] to read from ; inclusive index
        length - length of the byte[] to be read, starting from offset
        Returns:
        EventData the created EventData to send to EventHubs.
        See Also:
        EventHubClient.createFromConnectionString(String, ScheduledExecutorService)

      • create

        static EventData create​(ByteBuffer buffer)
        Construct EventData to Send to EventHubs. Typical pattern to create a Sending EventData is: 
         i.   Serialize the sending ApplicationEvent to be sent to EventHubs into bytes.
 ii.  If complex serialization logic is involved (for example: multiple types of data) - add a Hint using the getProperties() for the Consumer.

        Illustration: 

         
  EventData eventData = EventData.create(telemetryEventByteBuffer);
  eventData.getProperties().put("eventType", "com.microsoft.azure.monitoring.EtlEvent");
  partitionSender.Send(eventData);
        Parameters:
        buffer - ByteBuffer which references the payload of the Event to be sent to EventHubs
        Returns:
        EventData the created EventData to send to EventHubs.
        See Also:
        EventHubClient.createFromConnectionString(String, ScheduledExecutorService)

      • getObject

        Object getObject()
        Use this method only if, the sender could be sending messages using third-party AMQP libraries.

        If all the senders of EventHub use client libraries released and maintained by Microsoft Azure EventHubs, use getBytes() method.

        Get the value of AMQP messages' Body section on the received EventData.

        If the AMQP message Body is always guaranteed to have Data section, use getBytes() method.

        Returns:
        returns the Object which could represent either Data or AmqpValue or AmqpSequence.

        Binary if the Body is Data section

        List if the Body is AmqpSequence

        package org.apache.qpid.proton.amqp contains various AMQP types that could be returned.

      • getBytes

        byte[] getBytes()
        Get Actual Payload/Data wrapped by EventData.
        Returns:
        byte[] of the actual data

        null if the body of the message has other inter-operable AMQP messages, whose body does not represent byte[]. In that case use getObject().

      • getProperties

        Map<String,​Object> getProperties()
        Application property bag
        Returns:
        returns Application properties