Prepare Event Hubs release (Azure#22898)

* Run prepare-release for checkpointstore-blob

* Run Prepare-Release script for eventhubs

* Adding CHANGELOG entries.

* Adding documentation.

Author: conniey

eng/jacoco-test-coverage/pom.xml

@@ -214,12 +214,12 @@
     <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-messaging-eventhubs</artifactId>
-      <version>5.9.0-beta.1</version> <!-- {x-version-update;com.azure:azure-messaging-eventhubs;current} -->
+      <version>5.9.0</version> <!-- {x-version-update;com.azure:azure-messaging-eventhubs;current} -->
     </dependency>
     <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-messaging-eventhubs-checkpointstore-blob</artifactId>
-      <version>1.9.0-beta.1</version> <!-- {x-version-update;com.azure:azure-messaging-eventhubs-checkpointstore-blob;current} -->
+      <version>1.8.1</version> <!-- {x-version-update;com.azure:azure-messaging-eventhubs-checkpointstore-blob;current} -->
     </dependency>
     <dependency>
       <groupId>com.azure</groupId>

eng/versioning/version_client.txt

@@ -90,8 +90,8 @@ com.azure:azure-identity-perf;1.0.0-beta.1;1.0.0-beta.1
 com.azure:azure-iot-deviceupdate;1.0.0-beta.1;1.0.0-beta.2
 com.azure:azure-iot-modelsrepository;1.0.0-beta.1;1.0.0-beta.2
 com.azure:azure-messaging-eventgrid;4.4.0;4.5.0-beta.1
-com.azure:azure-messaging-eventhubs;5.8.0;5.9.0-beta.1
-com.azure:azure-messaging-eventhubs-checkpointstore-blob;1.8.0;1.9.0-beta.1
+com.azure:azure-messaging-eventhubs;5.8.0;5.9.0
+com.azure:azure-messaging-eventhubs-checkpointstore-blob;1.8.0;1.8.1
 com.azure:azure-messaging-eventhubs-track1-perf;1.0.0-beta.1;1.0.0-beta.1
 com.azure:azure-messaging-eventhubs-track2-perf;1.0.0-beta.1;1.0.0-beta.1
 com.azure:azure-messaging-servicebus;7.3.0;7.4.0-beta.1

sdk/eventhubs/azure-messaging-eventhubs-checkpointstore-blob/CHANGELOG.md

@@ -1,7 +1,9 @@
 # Release History
 
-## 1.9.0-beta.1 (Unreleased)
+## 1.8.1 (2021-07-09)
+### Dependency Updates
 
+- Update `azure-messaging-eventhubs` dependency to `5.9.0`.
 
 ## 1.8.0 (2021-06-14)
 

sdk/eventhubs/azure-messaging-eventhubs-checkpointstore-blob/pom.xml

@@ -17,7 +17,7 @@
 
   <groupId>com.azure</groupId>
   <artifactId>azure-messaging-eventhubs-checkpointstore-blob</artifactId>
-  <version>1.9.0-beta.1</version> <!-- {x-version-update;com.azure:azure-messaging-eventhubs-checkpointstore-blob;current} -->
+  <version>1.8.1</version> <!-- {x-version-update;com.azure:azure-messaging-eventhubs-checkpointstore-blob;current} -->
 
   <name>Microsoft Azure client library for storing checkpoints in Storage Blobs</name>
   <description>Library for using storing checkpoints in Storage Blobs</description>
@@ -40,7 +40,7 @@
     <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-messaging-eventhubs</artifactId>
-      <version>5.9.0-beta.1</version> <!-- {x-version-update;com.azure:azure-messaging-eventhubs;current} -->
+      <version>5.9.0</version> <!-- {x-version-update;com.azure:azure-messaging-eventhubs;current} -->
     </dependency>
     <dependency>
       <groupId>com.azure</groupId>

sdk/eventhubs/azure-messaging-eventhubs-track2-perf/pom.xml

@@ -28,7 +28,7 @@
     <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-messaging-eventhubs-checkpointstore-blob</artifactId>
-      <version>1.9.0-beta.1</version> <!-- {x-version-update;com.azure:azure-messaging-eventhubs-checkpointstore-blob;current} -->
+      <version>1.8.1</version> <!-- {x-version-update;com.azure:azure-messaging-eventhubs-checkpointstore-blob;current} -->
     </dependency>
     <dependency>
       <groupId>com.azure</groupId>

sdk/eventhubs/azure-messaging-eventhubs/CHANGELOG.md

@@ -1,11 +1,16 @@
 # Release History
 
-## 5.9.0-beta.1 (Unreleased)
+## 5.9.0 (2021-07-09)
 
 ### Features Added
 
 - Add additional fields to `EventData`. `getContentType()`, `getCorrelationId()`, `getMessageId()` and the corresponding setters were added.
-- Add `EventData.getRawAmqpMessage()`.
+- Add `EventData.getRawAmqpMessage()`. Data in `EventData.getSystemProperties()` is backed by `AmqpAnnotatedMessage` but are read-only.
+
+### Dependency Updates
+
+- Update `azure-core` dependency to `1.18.0`.
+- Update `azure-core-amqp` dependency to `2.3.0`.
 
 ## 5.8.0 (2021-06-14)
 

sdk/eventhubs/azure-messaging-eventhubs/pom.xml

@@ -14,7 +14,7 @@
 
   <groupId>com.azure</groupId>
   <artifactId>azure-messaging-eventhubs</artifactId>
-  <version>5.9.0-beta.1</version> <!-- {x-version-update;com.azure:azure-messaging-eventhubs;current} -->
+  <version>5.9.0</version> <!-- {x-version-update;com.azure:azure-messaging-eventhubs;current} -->
 
   <name>Microsoft Azure client library for Event Hubs</name>
   <description>Libraries built on Microsoft Azure Event Hubs</description>

sdk/eventhubs/azure-messaging-eventhubs/src/main/java/com/azure/messaging/eventhubs/EventData.java

@@ -168,10 +168,12 @@ public Map<String, Object> getProperties() {
 
     /**
      * Properties that are populated by Event Hubs service. As these are populated by the Event Hubs service, they are
-     * only present on a <b>received</b> {@link EventData}.
+     * only present on a <b>received</b> {@link EventData}. Provides an abstraction on top of properties exposed by
+     * {@link #getRawAmqpMessage()}. These properties are read-only and can be modified via
+     * {@link #getRawAmqpMessage()}.
      *
-     * @return An encapsulation of all system properties appended by EventHubs service into {@link EventData}. {@code
-     *     null} if the {@link EventData} is not received from the Event Hubs service.
+     * @return An encapsulation of all system properties appended by EventHubs service into {@link EventData}. If the
+     *     {@link EventData} is not received from the Event Hubs service, the values returned are {@code null}.
      */
     public Map<String, Object> getSystemProperties() {
         return systemProperties;

sdk/eventhubs/pom.xml

@@ -20,12 +20,12 @@
         <dependency>
           <groupId>com.azure</groupId>
           <artifactId>azure-messaging-eventhubs</artifactId>
-          <version>5.9.0-beta.1</version> <!-- {x-version-update;com.azure:azure-messaging-eventhubs;current} -->
+          <version>5.9.0</version> <!-- {x-version-update;com.azure:azure-messaging-eventhubs;current} -->
         </dependency>
         <dependency>
           <groupId>com.azure</groupId>
           <artifactId>azure-messaging-eventhubs-checkpointstore-blob</artifactId>
-          <version>1.9.0-beta.1</version> <!-- {x-version-update;com.azure:azure-messaging-eventhubs-checkpointstore-blob;current} -->
+          <version>1.8.1</version> <!-- {x-version-update;com.azure:azure-messaging-eventhubs-checkpointstore-blob;current} -->
         </dependency>
       </dependencies>