[Form recognizer] Fix Javadoc improvements JDK 20 (#36700)

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/FormRecognizerClientBuilder.java

@@ -101,6 +101,14 @@ public final class FormRecognizerClientBuilder implements
     EndpointTrait<FormRecognizerClientBuilder>,
     HttpTrait<FormRecognizerClientBuilder>,
     TokenCredentialTrait<FormRecognizerClientBuilder> {
+
+    /**
+     * Constructs a {@link FormRecognizerClientBuilder} object.
+     */
+    public FormRecognizerClientBuilder() {
+        httpLogOptions = new HttpLogOptions();
+    }
+
     private final ClientLogger logger = new ClientLogger(FormRecognizerClientBuilder.class);
 
     private final List<HttpPipelinePolicy> perCallPolicies = new ArrayList<>();

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/DocumentAnalysisClientBuilder.java

@@ -103,6 +103,12 @@ public final class DocumentAnalysisClientBuilder implements
     TokenCredentialTrait<DocumentAnalysisClientBuilder> {
     private final ClientLogger logger = new ClientLogger(DocumentAnalysisClientBuilder.class);
 
+    /**
+     * Create a DocumentAnalysisClientBuilder instance.
+     */
+    public DocumentAnalysisClientBuilder() {
+    }
+
     private final List<HttpPipelinePolicy> perCallPolicies = new ArrayList<>();
     private final List<HttpPipelinePolicy> perRetryPolicies = new ArrayList<>();
 

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/DocumentModelAdministrationClientBuilder.java

@@ -102,6 +102,14 @@ public final class DocumentModelAdministrationClientBuilder implements
     EndpointTrait<DocumentModelAdministrationClientBuilder>,
     HttpTrait<DocumentModelAdministrationClientBuilder>,
     TokenCredentialTrait<DocumentModelAdministrationClientBuilder> {
+
+    /**
+     * Constructs a DocumentModelAdministrationClientBuilder object.
+     */
+    public DocumentModelAdministrationClientBuilder() {
+        httpLogOptions = new HttpLogOptions();
+    }
+
     private final ClientLogger logger = new ClientLogger(DocumentModelAdministrationClientBuilder.class);
 
     private final List<HttpPipelinePolicy> perCallPolicies = new ArrayList<>();

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/BuildDocumentClassifierOptions.java

@@ -14,6 +14,12 @@ public final class BuildDocumentClassifierOptions {
 
     private String classifierId;
 
+    /**
+     * Create a BuildDocumentClassifierOptions instance.
+     */
+    public BuildDocumentClassifierOptions() {
+    }
+
     /**
      * Get the model description.
      *

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/BuildDocumentModelOptions.java

@@ -18,6 +18,12 @@ public final class BuildDocumentModelOptions {
 
     private String modelId;
 
+    /**
+     * Create a BuildDocumentModelOptions instance.
+     */
+    public BuildDocumentModelOptions() {
+    }
+
     /**
      * Get the model description.
      *

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/ComposeDocumentModelOptions.java

@@ -16,6 +16,12 @@ public final class ComposeDocumentModelOptions {
     private Map<String, String> tags;
     private String modelId;
 
+    /**
+     * Create a ComposeDocumentModelOptions instance.
+     */
+    public ComposeDocumentModelOptions() {
+    }
+
     /**
      * Get the optional model description defined by the user.
      *

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/ContentSourceKind.java

@@ -11,6 +11,14 @@
 /** Type of content source. */
 public final class ContentSourceKind extends ExpandableStringEnum<ContentSourceKind> {
 
+    /**
+     * Creates or finds a ContentSourceKind from its string representation.
+     * @deprecated Use the {@link #fromString(String)} factory method.
+     */
+    @Deprecated
+    public ContentSourceKind() {
+    }
+
     /** Enum value azureBlob. */
     public static final ContentSourceKind AZURE_BLOB = fromString("azureBlob");
 

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/CopyAuthorizationOptions.java

@@ -16,6 +16,12 @@ public final class CopyAuthorizationOptions {
     private Map<String, String> tags;
     private String modelId;
 
+    /**
+     * Create a CopyAuthorizationOptions instance.
+     */
+    public CopyAuthorizationOptions() {
+    }
+
     /**
      * Get the model description.
      *

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/DocumentFieldSchema.java

@@ -14,6 +14,13 @@
  */
 @Immutable
 public final class DocumentFieldSchema {
+
+    /**
+     * Constructs a DocumentFieldSchema object.
+     */
+    public DocumentFieldSchema() {
+    }
+
     /*
      * Semantic data type of the field value.
      */

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/DocumentModelBuildMode.java

@@ -12,6 +12,14 @@
 @Immutable
 public final class DocumentModelBuildMode extends ExpandableStringEnum<DocumentModelBuildMode> {
 
+    /**
+     * Creates a DocumentModelBuildMode object.
+     * @deprecated Use the {@link #fromString(String)} factory method.
+     */
+    @Deprecated
+    public DocumentModelBuildMode() {
+    }
+
     /**
      * Used for documents with fixed visual templates.
      */
@@ -32,7 +40,10 @@ public static DocumentModelBuildMode fromString(String name) {
         return fromString(name, DocumentModelBuildMode.class);
     }
 
-    /** @return known DocumentModelBuildMode values. */
+    /**
+     * Returns known DocumentModelBuildMode values.
+     * @return known DocumentModelBuildMode values.
+     */
     public static Collection<DocumentModelBuildMode> values() {
         return values(DocumentModelBuildMode.class);
     }

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/DocumentModelBuildOperationDetails.java

@@ -9,6 +9,14 @@
 /** Build document model operation details */
 @Immutable
 public final class DocumentModelBuildOperationDetails extends OperationDetails {
+
+    /**
+     * Creates a DocumentModelBuildOperationDetails object.
+     */
+    public DocumentModelBuildOperationDetails() {
+        super();
+    }
+
     /*
      * Operation result upon success.
      */

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/DocumentModelComposeOperationDetails.java

@@ -9,6 +9,14 @@
 /** Compose document model operation details */
 @Immutable
 public final class DocumentModelComposeOperationDetails extends OperationDetails {
+
+    /**
+     * Creates a DocumentModelComposeOperationDetails object.
+     */
+    public DocumentModelComposeOperationDetails() {
+        super();
+    }
+
     /*
      * Operation result upon success.
      */

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/DocumentModelCopyToOperationDetails.java

@@ -9,6 +9,14 @@
 /** Copy document model operation details. */
 @Immutable
 public final class DocumentModelCopyToOperationDetails extends OperationDetails {
+
+    /**
+     * Creates a DocumentModelCopyToOperationDetails object.
+     */
+    public DocumentModelCopyToOperationDetails() {
+        super();
+    }
+
     /*
      * Operation result upon success.
      */

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/DocumentModelDetails.java

@@ -15,6 +15,12 @@
 @Immutable
 public final class DocumentModelDetails {
 
+    /**
+     * Creates a DocumentModelDetails object.
+     */
+    public DocumentModelDetails() {
+    }
+
     /*
      * Unique model identifier.
      */
@@ -119,7 +125,7 @@ public OffsetDateTime getExpiresOn() {
     private void setExpiresOn(OffsetDateTime expiresOn) {
         this.expiresOn = expiresOn;
     }
-    
+
     /**
      * Get the Service version used to create this document classifier.
      *

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/DocumentModelSummary.java

@@ -14,6 +14,13 @@
  */
 @Immutable
 public final class DocumentModelSummary {
+
+    /**
+     * Creates a DocumentModelSummary object.
+     */
+    public DocumentModelSummary() {
+    }
+
     /*
      * Unique model identifier.
      */

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/DocumentTypeDetails.java

@@ -13,6 +13,13 @@
  */
 @Immutable
 public final class DocumentTypeDetails {
+
+    /**
+     * Creates a DocumentTypeDetails instance.
+     */
+    public DocumentTypeDetails() {
+    }
+
     /*
      * Model description.
      */

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/OperationDetails.java

@@ -14,6 +14,13 @@
  * The OperationDetails model.
  */
 public class OperationDetails {
+
+    /**
+     * Creates an instance of OperationDetails.
+     */
+    public OperationDetails() {
+    }
+
     private String operationId;
     private OperationStatus status;
     private Integer percentCompleted;

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/OperationKind.java

@@ -11,6 +11,15 @@
 /** Known values for type of operation. */
 @Immutable
 public final class OperationKind extends ExpandableStringEnum<OperationKind> {
+
+    /**
+     * Creates a OperationKind object.
+     * @deprecated Use the {@link #fromString(String)} factory method.
+     */
+    @Deprecated
+    public OperationKind() {
+    }
+
     /** Static value documentModelBuild for OperationKind. */
     public static final OperationKind DOCUMENT_MODEL_BUILD = fromString("documentModelBuild");
 
@@ -30,7 +39,10 @@ public static OperationKind fromString(String name) {
         return fromString(name, OperationKind.class);
     }
 
-    /** @return known OperationKind values. */
+    /**
+     * Returns known OperationKind values.
+     * @return known OperationKind values.
+     */
     public static Collection<OperationKind> values() {
         return values(OperationKind.class);
     }

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/OperationStatus.java

@@ -11,6 +11,15 @@
 /** Known values for operation status. */
 @Immutable
 public final class OperationStatus extends ExpandableStringEnum<OperationStatus> {
+
+    /**
+     * Creates a OperationStatus object.
+     * @deprecated Use the {@link #fromString(String)} factory method.
+     */
+    @Deprecated
+    public OperationStatus() {
+    }
+
     /** Static value notStarted for OperationStatus. */
     public static final OperationStatus NOT_STARTED = fromString("notStarted");
 
@@ -36,7 +45,10 @@ public static OperationStatus fromString(String name) {
         return fromString(name, OperationStatus.class);
     }
 
-    /** @return known OperationStatus values. */
+    /**
+     * Returns known OperationStatus values.
+     * @return known OperationStatus values.
+     */
     public static Collection<OperationStatus> values() {
         return values(OperationStatus.class);
     }

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/OperationSummary.java

@@ -12,6 +12,13 @@
 /** OperationSummary. */
 @Immutable
 public final class OperationSummary {
+
+    /**
+     * Creates a OperationSummary object.
+     */
+    public OperationSummary() {
+    }
+
     /*
      * Operation ID
      */

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/QuotaDetails.java

@@ -11,6 +11,13 @@
 /** Quota used, limit, and next reset date/time. */
 @Immutable
 public final class QuotaDetails {
+
+    /**
+     * Creates a QuotaDetails object.
+     */
+    public QuotaDetails() {
+    }
+
     /*
      * Amount of the resource quota used.
      */

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/models/ResourceDetails.java

@@ -24,6 +24,12 @@ public final class ResourceDetails {
 
     private QuotaDetails customNeuralDocumentModelQuota;
 
+    /**
+     * Creates a ResourceDetails object.
+     */
+    public ResourceDetails() {
+    }
+
     /**
      * Get the current count of built document analysis models
      *

sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/implementation/FormRecognizerClientImpl.java

@@ -16,13 +16,13 @@
 public final class FormRecognizerClientImpl {
     /**
      * Supported Cognitive Services endpoints (protocol and hostname, for example:
-     * <a href="https://westus2.api.cognitive.microsoft.com">here</a>).
+     * https://westus2.api.cognitive.microsoft.com).
      */
     private final String endpoint;
 
     /**
      * Gets Supported Cognitive Services endpoints (protocol and hostname, for example:
-     * <a href="https://westus2.api.cognitive.microsoft.com">here</a>).
+     * https://westus2.api.cognitive.microsoft.com).
      *
      * @return the endpoint value.
      */
@@ -106,7 +106,7 @@ public DocumentClassifiersImpl getDocumentClassifiers() {
      * Initializes an instance of FormRecognizerClient client.
      *
      * @param endpoint Supported Cognitive Services endpoints (protocol and hostname, for example:
-     *     <a href="https://westus2.api.cognitive.microsoft.com">here</a>).
+     *     https://westus2.api.cognitive.microsoft.com).
      * @param apiVersion Api Version.
      */
     FormRecognizerClientImpl(String endpoint, String apiVersion) {
@@ -124,7 +124,7 @@ public DocumentClassifiersImpl getDocumentClassifiers() {
      *
      * @param httpPipeline The HTTP pipeline to send requests through.
      * @param endpoint Supported Cognitive Services endpoints (protocol and hostname, for example:
-     *     <a href="https://westus2.api.cognitive.microsoft.com">here</a>).
+     *     https://westus2.api.cognitive.microsoft.com).
      * @param apiVersion Api Version.
      */
     FormRecognizerClientImpl(HttpPipeline httpPipeline, String endpoint, String apiVersion) {
@@ -137,7 +137,7 @@ public DocumentClassifiersImpl getDocumentClassifiers() {
      * @param httpPipeline The HTTP pipeline to send requests through.
      * @param serializerAdapter The serializer to serialize an object into a string.
      * @param endpoint Supported Cognitive Services endpoints (protocol and hostname, for example:
-     *     <a href="https://westus2.api.cognitive.microsoft.com">here</a>).
+     *     https://westus2.api.cognitive.microsoft.com).
      * @param apiVersion Api Version.
      */
     FormRecognizerClientImpl(