add response

Author: amber-yujueWang

sdk/cognitiveservices/azure-ai-speech-transcription/customization/src/main/java/SpeechTranscriptionCustomization.java

@@ -114,7 +114,7 @@ private void customizeDiarizationOptionsToJson(PackageCustomization packageCusto
     /**
      * Customize TranscriptionOptions to:
      * 1. Add AudioFileDetails field (final)
-     * 2. Add initialization to default constructor
+     * 2. Remove default no-arg constructor
      * 3. Add constructor with String audioUrl parameter
      * 4. Add constructor with AudioFileDetails parameter
      * 5. Make setAudioUrl() private instead of public
@@ -129,15 +129,12 @@ private void customizeTranscriptionOptions(PackageCustomization packageCustomiza
                     com.github.javaparser.ast.Modifier.Keyword.PRIVATE,
                     com.github.javaparser.ast.Modifier.Keyword.FINAL);
 
-                // Update default constructor to initialize audioFileDetails
+                // Remove default no-arg constructor
                 clazz.getConstructors()
                     .stream()
                     .filter(c -> c.getParameters().isEmpty())
                     .findFirst()
-                    .ifPresent(defaultConstructor -> {
-                        BlockStmt body = defaultConstructor.getBody();
-                        body.addStatement(0, parseStatement("this.audioFileDetails = null;"));
-                    });
+                    .ifPresent(com.github.javaparser.ast.Node::remove);
 
                 // Add constructor with String audioUrl parameter
                 ConstructorDeclaration audioUrlConstructor = clazz.addConstructor(Modifier.Keyword.PUBLIC);
@@ -166,7 +163,7 @@ private void customizeTranscriptionOptions(PackageCustomization packageCustomiza
 
     /**
      * Customize TranscriptionClient to add public transcribe(TranscriptionOptions) method
-     * that hides TranscriptionContent construction.
+     * that hides TranscriptionContent construction and add transcribeWithResponse method.
      *
      * @param packageCustomization the package customization
      */
@@ -186,12 +183,48 @@ private void customizeTranscriptionClient(PackageCustomization packageCustomizat
                         method.getAnnotationByName("Generated").ifPresent(com.github.javaparser.ast.Node::remove);
                     }
                 });
+
+                // Add public transcribeWithResponse method that returns Response<TranscriptionResult>
+                com.github.javaparser.ast.body.MethodDeclaration transcribeWithResponseMethod = clazz.addMethod("transcribeWithResponse", Modifier.Keyword.PUBLIC)
+                    .addParameter("TranscriptionOptions", "options")
+                    .setType("Response<TranscriptionResult>");
+                com.github.javaparser.ast.expr.NormalAnnotationExpr serviceMethodAnnotation = new com.github.javaparser.ast.expr.NormalAnnotationExpr();
+                serviceMethodAnnotation.setName("ServiceMethod");
+                serviceMethodAnnotation.addPair("returns", "ReturnType.SINGLE");
+                transcribeWithResponseMethod.addAnnotation(serviceMethodAnnotation);
+                transcribeWithResponseMethod.setBody(parseBlock(
+                        "{ TranscriptionContent requestContent = new TranscriptionContent(); "
+                        + "requestContent.setOptions(options); "
+                        + "RequestOptions requestOptions = new RequestOptions(); "
+                        + "Response<BinaryData> response = transcribeWithResponse("
+                        + "new MultipartFormDataHelper(requestOptions).serializeJsonField(\"definition\", requestContent.getOptions())"
+                        + ".serializeFileField(\"audio\", requestContent.getAudio() == null ? null : requestContent.getAudio().getContent(), "
+                        + "requestContent.getAudio() == null ? null : requestContent.getAudio().getContentType(), "
+                        + "requestContent.getAudio() == null ? null : requestContent.getAudio().getFilename())"
+                        + ".end().getRequestBody(), requestOptions); "
+                        + "return new Response<TranscriptionResult>() { "
+                        + "public int getStatusCode() { return response.getStatusCode(); } "
+                        + "public com.azure.core.http.HttpHeaders getHeaders() { return response.getHeaders(); } "
+                        + "public com.azure.core.http.HttpRequest getRequest() { return response.getRequest(); } "
+                        + "public TranscriptionResult getValue() { return response.getValue().toObject(TranscriptionResult.class); } "
+                        + "}; }"));
+                transcribeWithResponseMethod.setJavadocComment(new Javadoc(parseText(
+                        "Transcribes the provided audio stream with the specified options."))
+                        .addBlockTag("param", "options the transcription options including audio file details or audio URL")
+                        .addBlockTag("throws", "IllegalArgumentException thrown if parameters fail the validation.")
+                        .addBlockTag("throws", "HttpResponseException thrown if the request is rejected by server.")
+                        .addBlockTag("throws", "ClientAuthenticationException thrown if the request is rejected by server on status code 401.")
+                        .addBlockTag("throws", "ResourceNotFoundException thrown if the request is rejected by server on status code 404.")
+                        .addBlockTag("throws", "ResourceModifiedException thrown if the request is rejected by server on status code 409.")
+                        .addBlockTag("throws", "RuntimeException all other wrapped checked exceptions if the request fails to be sent.")
+                        .addBlockTag("return", "the response containing the result of the transcribe operation."));
             });
         });
     }
 
     /**
-     * Customize TranscriptionAsyncClient to make transcribe(TranscriptionContent) package-private (internal).
+     * Customize TranscriptionAsyncClient to make transcribe(TranscriptionContent) package-private (internal)
+     * and add transcribeWithResponse method.
      *
      * @param packageCustomization the package customization
      */
@@ -211,6 +244,41 @@ private void customizeTranscriptionAsyncClient(PackageCustomization packageCusto
                         method.getAnnotationByName("Generated").ifPresent(com.github.javaparser.ast.Node::remove);
                     }
                 });
+
+                // Add public transcribeWithResponse method that returns Mono<Response<TranscriptionResult>>
+                com.github.javaparser.ast.body.MethodDeclaration transcribeWithResponseMethod = clazz.addMethod("transcribeWithResponse", Modifier.Keyword.PUBLIC)
+                    .addParameter("TranscriptionOptions", "options")
+                    .setType("Mono<Response<TranscriptionResult>>");
+                com.github.javaparser.ast.expr.NormalAnnotationExpr serviceMethodAnnotation = new com.github.javaparser.ast.expr.NormalAnnotationExpr();
+                serviceMethodAnnotation.setName("ServiceMethod");
+                serviceMethodAnnotation.addPair("returns", "ReturnType.SINGLE");
+                transcribeWithResponseMethod.addAnnotation(serviceMethodAnnotation);
+                transcribeWithResponseMethod.setBody(parseBlock(
+                        "{ TranscriptionContent requestContent = new TranscriptionContent(); "
+                        + "requestContent.setOptions(options); "
+                        + "RequestOptions requestOptions = new RequestOptions(); "
+                        + "return transcribeWithResponse("
+                        + "new MultipartFormDataHelper(requestOptions).serializeJsonField(\"definition\", requestContent.getOptions())"
+                        + ".serializeFileField(\"audio\", requestContent.getAudio() == null ? null : requestContent.getAudio().getContent(), "
+                        + "requestContent.getAudio() == null ? null : requestContent.getAudio().getContentType(), "
+                        + "requestContent.getAudio() == null ? null : requestContent.getAudio().getFilename())"
+                        + ".end().getRequestBody(), requestOptions)"
+                        + ".map(response -> new Response<TranscriptionResult>() { "
+                        + "public int getStatusCode() { return response.getStatusCode(); } "
+                        + "public com.azure.core.http.HttpHeaders getHeaders() { return response.getHeaders(); } "
+                        + "public com.azure.core.http.HttpRequest getRequest() { return response.getRequest(); } "
+                        + "public TranscriptionResult getValue() { return response.getValue().toObject(TranscriptionResult.class); } "
+                        + "}); }"));
+                transcribeWithResponseMethod.setJavadocComment(new Javadoc(parseText(
+                        "Transcribes the provided audio stream with the specified options."))
+                        .addBlockTag("param", "options the transcription options including audio file details or audio URL")
+                        .addBlockTag("throws", "IllegalArgumentException thrown if parameters fail the validation.")
+                        .addBlockTag("throws", "HttpResponseException thrown if the request is rejected by server.")
+                        .addBlockTag("throws", "ClientAuthenticationException thrown if the request is rejected by server on status code 401.")
+                        .addBlockTag("throws", "ResourceNotFoundException thrown if the request is rejected by server on status code 404.")
+                        .addBlockTag("throws", "ResourceModifiedException thrown if the request is rejected by server on status code 409.")
+                        .addBlockTag("throws", "RuntimeException all other wrapped checked exceptions if the request fails to be sent.")
+                        .addBlockTag("return", "the response containing the result of the transcribe operation on successful completion of Mono."));
             });
         });
     }

sdk/cognitiveservices/azure-ai-speech-transcription/src/main/java/com/azure/ai/speech/transcription/TranscriptionAsyncClient.java

@@ -142,4 +142,48 @@ public Mono<TranscriptionResult> transcribe(TranscriptionOptions options) {
         requestContent.setOptions(options);
         return transcribe(requestContent);
     }
+
+    /**
+     * Transcribes the provided audio stream with the specified options.
+     *
+     * @param options the transcription options including audio file details or audio URL
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws HttpResponseException thrown if the request is rejected by server.
+     * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+     * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+     * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     * @return the response containing the result of the transcribe operation on successful completion of Mono.
+     */
+    public Mono<Response<TranscriptionResult>> transcribeWithResponse(TranscriptionOptions options) {
+        TranscriptionContent requestContent = new TranscriptionContent();
+        requestContent.setOptions(options);
+        RequestOptions requestOptions = new RequestOptions();
+        return transcribeWithResponse(
+            new MultipartFormDataHelper(requestOptions).serializeJsonField("definition", requestContent.getOptions())
+                .serializeFileField("audio",
+                    requestContent.getAudio() == null ? null : requestContent.getAudio().getContent(),
+                    requestContent.getAudio() == null ? null : requestContent.getAudio().getContentType(),
+                    requestContent.getAudio() == null ? null : requestContent.getAudio().getFilename())
+                .end()
+                .getRequestBody(),
+            requestOptions).map(response -> new Response<TranscriptionResult>() {
+
+                public int getStatusCode() {
+                    return response.getStatusCode();
+                }
+
+                public com.azure.core.http.HttpHeaders getHeaders() {
+                    return response.getHeaders();
+                }
+
+                public com.azure.core.http.HttpRequest getRequest() {
+                    return response.getRequest();
+                }
+
+                public TranscriptionResult getValue() {
+                    return response.getValue().toObject(TranscriptionResult.class);
+                }
+            });
+    }
 }

sdk/cognitiveservices/azure-ai-speech-transcription/src/main/java/com/azure/ai/speech/transcription/TranscriptionClient.java

@@ -138,4 +138,49 @@ public TranscriptionResult transcribe(TranscriptionOptions options) {
         requestContent.setOptions(options);
         return transcribe(requestContent);
     }
+
+    /**
+     * Transcribes the provided audio stream with the specified options.
+     *
+     * @param options the transcription options including audio file details or audio URL
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws HttpResponseException thrown if the request is rejected by server.
+     * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+     * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+     * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     * @return the response containing the result of the transcribe operation.
+     */
+    public Response<TranscriptionResult> transcribeWithResponse(TranscriptionOptions options) {
+        TranscriptionContent requestContent = new TranscriptionContent();
+        requestContent.setOptions(options);
+        RequestOptions requestOptions = new RequestOptions();
+        Response<BinaryData> response = transcribeWithResponse(
+            new MultipartFormDataHelper(requestOptions).serializeJsonField("definition", requestContent.getOptions())
+                .serializeFileField("audio",
+                    requestContent.getAudio() == null ? null : requestContent.getAudio().getContent(),
+                    requestContent.getAudio() == null ? null : requestContent.getAudio().getContentType(),
+                    requestContent.getAudio() == null ? null : requestContent.getAudio().getFilename())
+                .end()
+                .getRequestBody(),
+            requestOptions);
+        return new Response<TranscriptionResult>() {
+
+            public int getStatusCode() {
+                return response.getStatusCode();
+            }
+
+            public com.azure.core.http.HttpHeaders getHeaders() {
+                return response.getHeaders();
+            }
+
+            public com.azure.core.http.HttpRequest getRequest() {
+                return response.getRequest();
+            }
+
+            public TranscriptionResult getValue() {
+                return response.getValue().toObject(TranscriptionResult.class);
+            }
+        };
+    }
 }

sdk/cognitiveservices/azure-ai-speech-transcription/src/main/java/com/azure/ai/speech/transcription/models/TranscriptionOptions.java

@@ -71,14 +71,6 @@ public final class TranscriptionOptions implements JsonSerializable<Transcriptio
     @Generated
     private PhraseListOptions phraseListOptions;
 
-    /**
-     * Creates an instance of TranscriptionOptions class.
-     */
-    @Generated
-    public TranscriptionOptions() {
-        this.audioFileDetails = null;
-    }
-
     /**
      * Get the audioUrl property: The URL of the audio to be transcribed. The audio must be shorter than 2 hours in
      * audio duration and smaller than 250 MB in size. If both Audio and AudioUrl are provided, Audio is used.

sdk/cognitiveservices/azure-ai-speech-transcription/tsp-location.yaml

@@ -1,4 +1,4 @@
 directory: specification/cognitiveservices/Speech.Transcription
-commit: 3c52e9d0eadc790cef71559d1979694f1bb501be
+commit: c75a959c5b6b60b1e4f4ffde2e9f5516702b41c8
 repo: Azure/azure-rest-api-specs
 additionalDirectories: