Releasing version 2.25.0

Releasing version 2.25.0

Author: VidhiBhansali

CHANGELOG.md

@@ -3,6 +3,32 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/).
 
+## 2.25.0 - 2022-04-26
+### Added
+- Support for the Service Mesh service
+- Support for security zones in the Cloud Guard service
+- Support for virtual test access points (VTAPs) in the Networking service
+- Support for monitoring as a source in the Service Connector Hub service
+- Support for creating budgets that target subscriptions and child tenancies in the Budgets service
+- Support for listing shapes and specifying a shape during creation of a node in the Roving Edge Infrastructure service
+- Support for bringing your own key in the Roving Edge Infrastructure service
+- Support for enabling inspection of HTTP request bodies in the Web Application Acceleration and Security
+- Support for cost management schedules in the Usage service
+- Support for TCPS on external containers as well as non-container and pluggable databases in the Database service
+- Support for autoscaling on Open Data Hub (ODH) clusters in the Big Data service
+- Support for creating Open Data Hub (ODH) 0.9 clusters in the Big Data service
+- Support for Open Data Hub (ODH) patch management in the Big Data service
+- Support for customizable Kerberos realm names in the Big Data service
+- Support for dedicated vantage points in the Application Performance Monitoring service
+- Support for reactivating child tenancies in the Organizations service
+- Support for punctuation and the SRT transcription format in the AI Speech service
+
+### Breaking Changes
+- Support for default retries on some operations in the Networking service
+- Support for default retries on all operations in the Data Safe service
+- Support for default retries on some additional operations in the Application Performance Monitoring service
+- Method `public java.lang.Double getRiskScore()` has been removed from the model `com.oracle.bmc.cloudguard.model.Sighting` in the Cloud Guard service
+
 ## 2.24.0 - 2022-04-19
 ### Added
 - Support for the Stack Monitoring service

Development-README.md

@@ -0,0 +1,36 @@
+# Development Notes for Oracle Cloud Infrastructure SDK for Java
+
+## Build Profiles
+
+- *default profile* - Compile and generate Javadoc.
+- `dev` - Compile, reformat code and update licenses.
+- `dev` with `-Ddev.profile.skip.javadoc=false` - Compile, reformat code and update licenses, generate Javadoc.
+- `quick` - Only check for compilation errors, no Javadoc or tests.
+- `jdk-17-and-above` - This profile is automatically used when JDK 17 or higher is detected. No Jacdoc generated and tests failures should be ignored. See the [Java 17 test failures](#Java17TestFailures) section in [Known Development Issues](#KnownDevelopmentIssues).
+
+### Usage
+To run a maven build with the `dev` profile and generate Javadoc, use
+```
+mvn install -Pdev -Ddev.profile.skip.javadoc=false
+```
+
+## Javadoc Generation
+The build steps will also run delombok to create class files with appropriate documentation.  The delomboked files will be placed in a separate directory in the 'target' folder that will be used as input for the javadoc generation.
+
+Additionally, during javadoc generation, any javadocs with the template '*{{DOC_SERVER_URL}}*' will have that template replaced with the actual doc server URL.
+
+## <a id="KnownDevelopmentIssues"></a>Known Development Issues
+
+### <a id="Java17TestFailures"></a> Java 17 test failures
+If JDK 17 is used to build the OCI Java SDK, then there will be 5 unit tests that fail because of a test dependency that does not work well with more recent Java versions. To workaround this issue, ignore test failures with the `-Dmaven.test.failure.ignore` parameter:
+```
+mvn install -Dmaven.test.failure.ignore=true
+```
+The following tests should report errors: 
+ - ConfigFileDelegationTokenUtilsTest
+ - X509FederationClientTest
+ - DefaultConfiguratorTest
+ - RequestSignerImplTest
+ - UploadManagerTest
+
+Test failures beyond these may be test failures that come from implemented changes. To run these tests sucessfully, use JDK 8 for now.

bmc-addons/bmc-apache-connector-provider/pom.xml

@@ -4,7 +4,7 @@
   <parent>
     <groupId>com.oracle.oci.sdk</groupId>
     <artifactId>oci-java-sdk-addons</artifactId>
-    <version>2.24.0</version>
+    <version>2.25.0</version>
     <relativePath>../pom.xml</relativePath>
   </parent>
 
@@ -18,7 +18,7 @@
     <dependency>
       <groupId>com.oracle.oci.sdk</groupId>
       <artifactId>oci-java-sdk-common</artifactId>
-      <version>2.24.0</version>
+      <version>2.25.0</version>
     </dependency>
   </dependencies>
 </project>

bmc-addons/bmc-resteasy-client-configurator/pom.xml

@@ -5,7 +5,7 @@
   <parent>
     <groupId>com.oracle.oci.sdk</groupId>
     <artifactId>oci-java-sdk-addons</artifactId>
-    <version>2.24.0</version>
+    <version>2.25.0</version>
     <relativePath>../pom.xml</relativePath>
   </parent>
 
@@ -40,7 +40,7 @@
     <dependency>
       <groupId>com.oracle.oci.sdk</groupId>
       <artifactId>oci-java-sdk-common</artifactId>
-      <version>2.24.0</version>
+      <version>2.25.0</version>
     </dependency>
   </dependencies>
 </project>

bmc-addons/bmc-sasl/pom.xml

@@ -7,7 +7,7 @@
   <parent>
     <artifactId>oci-java-sdk-addons</artifactId>
     <groupId>com.oracle.oci.sdk</groupId>
-    <version>2.24.0</version>
+    <version>2.25.0</version>
     <relativePath>../pom.xml</relativePath>
   </parent>
 
@@ -62,7 +62,7 @@
     <dependency>
       <groupId>com.oracle.oci.sdk</groupId>
       <artifactId>oci-java-sdk-common</artifactId>
-      <version>2.24.0</version>
+      <version>2.25.0</version>
     </dependency>
   </dependencies>
 

bmc-addons/pom.xml

@@ -5,7 +5,7 @@
   <parent>
     <groupId>com.oracle.oci.sdk</groupId>
     <artifactId>oci-java-sdk</artifactId>
-    <version>2.24.0</version>
+    <version>2.25.0</version>
     <relativePath>../pom.xml</relativePath>
   </parent>
 

bmc-aianomalydetection/pom.xml

@@ -4,7 +4,7 @@
   <parent>
     <groupId>com.oracle.oci.sdk</groupId>
     <artifactId>oci-java-sdk</artifactId>
-    <version>2.24.0</version>
+    <version>2.25.0</version>
     <relativePath>../pom.xml</relativePath>
   </parent>
   <artifactId>oci-java-sdk-aianomalydetection</artifactId>
@@ -15,7 +15,7 @@
     <dependency>
       <groupId>com.oracle.oci.sdk</groupId>
       <artifactId>oci-java-sdk-common</artifactId>
-      <version>2.24.0</version>
+      <version>2.25.0</version>
     </dependency>
   </dependencies>
 </project>

bmc-ailanguage/pom.xml

@@ -4,7 +4,7 @@
   <parent>
     <groupId>com.oracle.oci.sdk</groupId>
     <artifactId>oci-java-sdk</artifactId>
-    <version>2.24.0</version>
+    <version>2.25.0</version>
     <relativePath>../pom.xml</relativePath>
   </parent>
   <artifactId>oci-java-sdk-ailanguage</artifactId>
@@ -15,7 +15,7 @@
     <dependency>
       <groupId>com.oracle.oci.sdk</groupId>
       <artifactId>oci-java-sdk-common</artifactId>
-      <version>2.24.0</version>
+      <version>2.25.0</version>
     </dependency>
   </dependencies>
 </project>

bmc-aispeech/pom.xml

@@ -4,7 +4,7 @@
   <parent>
     <groupId>com.oracle.oci.sdk</groupId>
     <artifactId>oci-java-sdk</artifactId>
-    <version>2.24.0</version>
+    <version>2.25.0</version>
     <relativePath>../pom.xml</relativePath>
   </parent>
   <artifactId>oci-java-sdk-aispeech</artifactId>
@@ -15,7 +15,7 @@
     <dependency>
       <groupId>com.oracle.oci.sdk</groupId>
       <artifactId>oci-java-sdk-common</artifactId>
-      <version>2.24.0</version>
+      <version>2.25.0</version>
     </dependency>
   </dependencies>
 </project>

bmc-aispeech/src/main/java/com/oracle/bmc/aispeech/model/CreateTranscriptionJobDetails.java

@@ -53,6 +53,16 @@ public Builder description(String description) {
             return this;
         }
 
+        @com.fasterxml.jackson.annotation.JsonProperty("additionalTranscriptionFormats")
+        private java.util.List<AdditionalTranscriptionFormats> additionalTranscriptionFormats;
+
+        public Builder additionalTranscriptionFormats(
+                java.util.List<AdditionalTranscriptionFormats> additionalTranscriptionFormats) {
+            this.additionalTranscriptionFormats = additionalTranscriptionFormats;
+            this.__explicitlySet__.add("additionalTranscriptionFormats");
+            return this;
+        }
+
         @com.fasterxml.jackson.annotation.JsonProperty("modelDetails")
         private TranscriptionModelDetails modelDetails;
 
@@ -117,6 +127,7 @@ public CreateTranscriptionJobDetails build() {
                             displayName,
                             compartmentId,
                             description,
+                            additionalTranscriptionFormats,
                             modelDetails,
                             normalization,
                             inputLocation,
@@ -133,6 +144,7 @@ public Builder copy(CreateTranscriptionJobDetails o) {
                     displayName(o.getDisplayName())
                             .compartmentId(o.getCompartmentId())
                             .description(o.getDescription())
+                            .additionalTranscriptionFormats(o.getAdditionalTranscriptionFormats())
                             .modelDetails(o.getModelDetails())
                             .normalization(o.getNormalization())
                             .inputLocation(o.getInputLocation())
@@ -153,22 +165,60 @@ public static Builder builder() {
     }
 
     /**
-     * Transcription job name.
+     * A user-friendly display name for the job.
      **/
     @com.fasterxml.jackson.annotation.JsonProperty("displayName")
     String displayName;
 
     /**
-     * The OCID of the compartment that contains the transcriptionJob.
+     * The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment where you want to create the job.
      **/
     @com.fasterxml.jackson.annotation.JsonProperty("compartmentId")
     String compartmentId;
 
     /**
-     * Transcription job description.
+     * A short description of the job.
      **/
     @com.fasterxml.jackson.annotation.JsonProperty("description")
     String description;
+    /**
+     **/
+    public enum AdditionalTranscriptionFormats {
+        Srt("SRT"),
+        ;
+
+        private final String value;
+        private static java.util.Map<String, AdditionalTranscriptionFormats> map;
+
+        static {
+            map = new java.util.HashMap<>();
+            for (AdditionalTranscriptionFormats v : AdditionalTranscriptionFormats.values()) {
+                map.put(v.getValue(), v);
+            }
+        }
+
+        AdditionalTranscriptionFormats(String value) {
+            this.value = value;
+        }
+
+        @com.fasterxml.jackson.annotation.JsonValue
+        public String getValue() {
+            return value;
+        }
+
+        @com.fasterxml.jackson.annotation.JsonCreator
+        public static AdditionalTranscriptionFormats create(String key) {
+            if (map.containsKey(key)) {
+                return map.get(key);
+            }
+            throw new IllegalArgumentException("Invalid AdditionalTranscriptionFormats: " + key);
+        }
+    };
+    /**
+     * Transcription Format. By default JSON format will be considered.
+     **/
+    @com.fasterxml.jackson.annotation.JsonProperty("additionalTranscriptionFormats")
+    java.util.List<AdditionalTranscriptionFormats> additionalTranscriptionFormats;
 
     @com.fasterxml.jackson.annotation.JsonProperty("modelDetails")
     TranscriptionModelDetails modelDetails;