@autorest/java 4.1.18

package/docs/readme.md

@@ -0,0 +1,34 @@
+# AutoRest Java Documentation
+
+These documents are Java-specific, see [our main docs][main_docs] for more general information
+
+
+1. Generating Java Clients with AutoRest
+    - How do I generate code? Main documents are [here][main_generate], while here are the [Java-specific docs][java_generate]
+
+2. Using Your Generated Java Client
+    - How do I [use my Java client][java_client] now that I've generated it? Main docs are [here][main_client]
+
+3. Migrating from AutoRest 2.0 to 3.0
+    - I have old generated code using the previous version of AutoRest. How do I upgrade my code? Main docs [here][main_migrate], Java-specific docs [here][java_migrate]
+
+4. Developing with AutoRest
+    - How do I generate or contribute to AutoRest in [dev mode][java_dev] Main docs [here][main_dev]
+
+5. Samples
+    - [Sample][sample] readmes and generated code for common scenarios.
+
+6. [FAQ][faq]
+
+<!-- LINKS -->
+[main_docs]: https://github.com/Azure/autorest/tree/main/docs
+[main_generate]: https://github.com/Azure/autorest/tree/main/docs/generate/readme.md
+[java_generate]: ./generate/readme.md
+[java_client]: ./client/readme.md
+[main_client]: https://github.com/Azure/autorest/tree/main/docs/generate/client.md
+[main_migrate]: https://github.com/Azure/autorest/tree/main/docs/migrate/readme.md
+[java_migrate]: ./migrate/readme.md
+[java_dev]: ./developer/readme.md
+[main_dev]: https://github.com/Azure/autorest/tree/main/docs/developer/readme.md
+[sample]: ./samples/readme.md
+[faq]: ./faq.md

package/fluentgen/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@autorest/java.fluent",
+  "version": "4.0.0",
+  "description": "The Java extension for classic generators in AutoRest.",
+  "scripts": {
+    "autorest": "autorest",
+    "start": "java --add-exports jdk.compiler/com.sun.tools.javac.api=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.file=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.parser=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.tree=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED -jar target/azure-autorest-fluentgen-jar-with-dependencies.jar",
+    "debug": "java --add-exports jdk.compiler/com.sun.tools.javac.api=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.file=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.parser=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.tree=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,quiet=y,address=5005 -jar target/azure-autorest-fluentgen-jar-with-dependencies.jar",
+    "build": "mvn package -P local"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Azure/autorest.java"
+  },
+  "readme": "./readme.md",
+  "keywords": [
+    "autorest",
+    "java"
+  ],
+  "author": "Microsoft Corporation",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Azure/autorest.java/issues"
+  },
+  "homepage": "https://github.com/Azure/autorest.java/blob/main/readme.md"
+}

package/fluentgen/readme.md

@@ -0,0 +1,25 @@
+### Java Code Formatter
+
+Formatter depends on a customized [google-java-format](https://github.com/weidongxu-microsoft/google-java-format?organization=weidongxu-microsoft&organization=weidongxu-microsoft), which requires JRE 11.
+
+#### Fluentgen
+
+``` yaml
+use: $(this-folder)/../fluentnamer
+pipeline:
+
+  fluentgen:
+    scope: java
+    input: fluentnamer
+    output-artifact: java-files
+  
+  fluentgen/emitter:
+    input: fluentgen
+    scope: scope-fluentgen/emitter
+
+scope-fluentgen/emitter:
+    input-artifact: java-files
+    output-uri-expr: $key
+  
+output-artifact: java-files
+```

package/fluentnamer/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@autorest/java.fluentnamer",
+  "version": "4.0.0",
+  "description": "The Java extension for fluentnamer in AutoRest.",
+  "scripts": {
+    "autorest": "autorest",
+    "start": "java -jar target/azure-autorest-fluentnamer-jar-with-dependencies.jar",
+    "debug": "java -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,quiet=y,address=5005 -jar target/azure-autorest-fluentnamer-jar-with-dependencies.jar",
+    "build": "mvn package -P local"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Azure/autorest.java"
+  },
+  "readme": "./readme.md",
+  "keywords": [
+    "autorest",
+    "java"
+  ],
+  "author": "Microsoft Corporation",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Azure/autorest.java/issues"
+  },
+  "homepage": "https://github.com/Azure/autorest.java/blob/main/README.md"
+}

package/fluentnamer/readme.md

@@ -0,0 +1,65 @@
+#### Fluentnamer
+
+``` yaml
+pass-thru:
+  - model-deduplicator
+  - subset-reducer
+
+use-extension:
+  "@autorest/modelerfour": "4.26.2"
+
+pipeline:
+
+# --- extension remodeler ---
+
+  # "Shake the tree", and normalize the model
+  modelerfour:
+    input: openapi-document/multi-api/identity     # the plugin where we get inputs from
+  
+  # allow developer to do transformations on the code model.
+  modelerfour/new-transform:
+    input: modelerfour
+
+  fluentnamer:
+    input: modelerfour/identity
+    naming:
+      override:
+        eTag: etag
+        userName: username
+        metaData: metadata
+        timeStamp: timestamp
+        hostName: hostname
+        webHook: webhook
+        coolDown: cooldown
+        resourceregion: resourceRegion
+        sTag: stag
+        tagname: tagName
+        tagvalue: tagValue
+
+modelerfour:
+  flatten-models: false
+  flatten-payloads: false
+
+  additional-checks: true
+  lenient-model-deduplication: false
+  remove-empty-child-schemas: false
+  seal-single-value-enum-by-default: true
+
+  naming:
+    choiceValue: upper
+    preserve-uppercase-max-length: 2
+    override:
+      ip: Ip
+      id: Id
+
+include-x-ms-examples-original-file: true
+
+license-header: MICROSOFT_MIT_SMALL
+regenerate-pom: true
+sync-methods: all
+client-side-validations: true
+client-logger: true
+generate-client-interfaces: true
+required-parameter-client-methods: true
+client-flattened-annotation-target: none
+```

package/javagen/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@autorest/java.vanilla",
+  "version": "4.0.0",
+  "description": "The Java extension for classic generators in AutoRest.",
+  "scripts": {
+    "autorest": "autorest",
+    "start": "java -jar target/azure-autorest-javagen-jar-with-dependencies.jar",
+    "debug": "java -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,quiet=y,address=5005 -jar target/azure-autorest-javagen-jar-with-dependencies.jar",
+    "build": "mvn package -Dlocal"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Azure/autorest.java"
+  },
+  "readme": "./readme.md",
+  "keywords": [
+    "autorest",
+    "java"
+  ],
+  "author": "Microsoft Corporation",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Azure/autorest.java/issues"
+  },
+  "homepage": "https://github.com/Azure/autorest.java/blob/main/readme.md"
+}

package/javagen/readme.md

@@ -0,0 +1,29 @@
+#### Javagen
+
+``` yaml
+use:
+  - $(this-folder)/../preprocessor
+  - $(this-folder)/../postprocessor
+
+pipeline:
+
+# --- extension remodeler ---
+  javagen:
+    scope: java
+    input: preprocessor
+    output-artifact: java-files
+  
+  postprocessor:
+    input: javagen
+    output-artifact: java-files
+  
+  postprocess/emitter:
+    input: postprocessor
+    scope: scope-javagen/emitter
+
+scope-javagen/emitter:
+    input-artifact: java-files
+    output-uri-expr: $key
+
+output-artifact: java-files
+```

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@autorest/java",
+  "version": "4.1.18",
+  "description": "The Java extension for classic generators in AutoRest.",
+  "scripts": {
+    "autorest": "autorest",
+    "start": "java -jar javagen/target/azure-autorest-javagen-jar-with-dependencies.jar",
+    "debug": "java -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,quiet=y,address=5005 -jar javagen/target/azure-autorest-javagen-jar-with-dependencies.jar",
+    "build": "mvn package -P local",
+    "generate": "./generate",
+    "testserver-run": "autorest-testserver run",
+    "testserver-stop": "autorest-testserver stop",
+    "testserver-coverage-publish": "autorest-testserver-coverage publish"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Azure/autorest.java"
+  },
+  "readme": "./readme.md",
+  "keywords": [
+    "autorest",
+    "java"
+  ],
+  "author": "Microsoft Corporation",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Azure/autorest.java/issues"
+  },
+  "homepage": "https://github.com/Azure/autorest.java/blob/main/readme.md",
+  "files": [
+    "*/package.json",
+    "/readme.md",
+    "/androidgen/*.md",
+    "/fluentgen/*.md",
+    "/fluentnamer/*.md",
+    "/javagen/*.md",
+    "/postprocessor/*.md",
+    "/preprocessor/*.md",
+    "*/target/*-jar-with-dependencies.jar"
+  ],
+  "devDependencies": {
+    "autorest": "^3.0.0",
+    "@microsoft.azure/autorest.testserver": "3.3.45"
+  }
+}

package/postprocessor/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@autorest/java.postprocessor",
+  "version": "4.0.0",
+  "description": "The Java extension for postprocessor in AutoRest.",
+  "scripts": {
+    "autorest": "autorest",
+    "start": "java -jar target/azure-autorest-postprocessor-jar-with-dependencies.jar",
+    "debug": "java -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,quiet=y,address=5005 -jar target/azure-autorest-postprocessor-jar-with-dependencies.jar",
+    "build": "mvn package -Dlocal"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Azure/autorest.java"
+  },
+  "readme": "./readme.md",
+  "keywords": [
+    "autorest",
+    "java"
+  ],
+  "author": "Microsoft Corporation",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Azure/autorest/issues"
+  },
+  "homepage": "https://github.com/Azure/autorest.java/blob/main/README.md"
+}

package/postprocessor/readme.md

@@ -0,0 +1,9 @@
+#### Postprocessor
+
+``` yaml
+pipeline:
+
+# --- extension remodeler ---
+  postprocessor:
+    input: java-files
+```

package/preprocessor/data-plane.md

@@ -0,0 +1,21 @@
+#### data-plane
+
+```yaml
+azure-arm: false
+
+license-header: MICROSOFT_MIT_SMALL
+
+generate-client-interfaces: false
+generate-client-as-impl: true
+generate-sync-async-clients: true
+generate-builder-per-client: true
+sync-methods: all
+enable-sync-stack: true
+
+use-default-http-status-code-to-exception-type-mapping: true
+polling: {}
+
+models-subpackage: implementation.models
+client-logger: true
+required-fields-as-ctor-args: true
+```

package/preprocessor/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@autorest/java.preprocessor",
+  "version": "4.0.0",
+  "description": "The Java extension for preprocessor in AutoRest.",
+  "scripts": {
+    "autorest": "autorest",
+    "start": "java -jar target/azure-autorest-preprocessor-jar-with-dependencies.jar",
+    "debug": "java -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,quiet=y,address=5005 -jar target/azure-autorest-preprocessor-jar-with-dependencies.jar",
+    "build": "mvn package -Dlocal"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Azure/autorest.java"
+  },
+  "readme": "./readme.md",
+  "keywords": [
+    "autorest",
+    "java"
+  ],
+  "author": "Microsoft Corporation",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Azure/autorest/issues"
+  },
+  "homepage": "https://github.com/Azure/autorest.java/blob/main/README.md"
+}

package/preprocessor/readme.md

@@ -0,0 +1,62 @@
+#### Preprocessor
+
+``` yaml
+pass-thru:
+  - model-deduplicator
+  - subset-reducer
+
+use-extension:
+  "@autorest/modelerfour": "4.26.2"
+
+pipeline:
+
+# --- extension remodeler ---
+
+  # "Shake the tree", and normalize the model
+  modelerfour:
+    input: openapi-document/multi-api/identity     # the plugin where we get inputs from
+
+  # allow developer to do transformations on the code model.
+  modelerfour/new-transform:
+    input: modelerfour
+
+  preprocessor:
+    input: modelerfour/identity
+
+modelerfour:
+  seal-single-value-enum-by-default: true
+
+  skip-special-headers:
+    - Repeatability-Request-ID
+    - Repeatability-First-Sent
+```
+
+```yaml !$(data-plane)
+modelerfour:
+  flatten-models: true
+  flatten-payloads: true
+  group-parameters: true
+```
+
+```yaml $(data-plane)
+modelerfour:
+  flatten-models: false
+  flatten-payloads: false
+  group-parameters: false
+
+  lenient-model-deduplication: true
+
+  naming:
+    choiceValue: upper
+    preserve-uppercase-max-length: 2
+    override:
+      ip: Ip
+      id: Id
+
+require:
+  - $(this-folder)data-plane.md
+```
+
+```yaml $(data-plane) && $(sdk-integration)
+regenerate-pom: true
+```