[BUG][JAVA] Deprecated endpoints are not marked with Deprecated in public webclient methods

##### Description

I use java 21 with Spring boot 3.5.5, openapi-generator 7.18.0

When an endpoint is marked Deprecated

```yaml
paths:
  /pets:
    get:
      deprecated: true
      operationId: getPets
      summary: List all pets
```

**Current behaviour:** The public method of the generated project is not marked with **@Deprecated**

```java
DefaultApi defaultApi = new DefaultApi();
defaultApi.getPets() // is not marked deprecated
```

**I expect** **getPets()** to be deprecated because it represents the endpoint that properly marked in the specification.

**More details:**
The public method **getPets()* uses a private method that is marked **@Deprecated**. 

```java
   public Flux<Pet> getPets() throws WebClientResponseException {
        ParameterizedTypeReference<Pet> localVarReturnType = new ParameterizedTypeReference<Pet>() {};
        return getPetsRequestCreation().bodyToFlux(localVarReturnType);
    }
```

```java
    /**
     * List all pets
     * 
     * <p><b>200</b> - A list of pets
     * @return List&lt;Pet&gt;
     * @throws WebClientResponseException if an error occurs while attempting to invoke the API
     * @deprecated
     */
    @Deprecated
    private ResponseSpec getPetsRequestCreation() throws WebClientResponseException {
```

Because of this, we can't use java's compilers flags to detect usage of deprecated methods

```
javac -Xlint:deprecation -Werror
```

**The problem source:**

**api.mustache** fie from webclient defines deprecation only for private methos of the API client

```
{{/isDeprecated}}
     */
    {{#isDeprecated}}
    @Deprecated
    {{/isDeprecated}}
    private ResponseSpec
```


**Suggested solution:**

Public methods should use deprecation mark

```
{{#externalDocs}}
    * {{description}}
    * @see <a href="{{url}}">{{summary}} Documentation</a>
{{/externalDocs}}
     */
    {{#isDeprecated}}
    @Deprecated
    {{/isDeprecated}}
    public {{#returnType}}{{#vendorExtensions.x-webclient-blocking}}{{#vendorExtensions.x-webclient-return-except-list-of-string}
```



##### openapi-generator version

7.18.0

##### OpenAPI declaration file content or url

<!-- if it is a bug, a json or yaml that produces it.
If you post the code inline, please wrap it with
```yaml
openapi: 3.0.3
info:
  title: Pet API
  version: 1.0.0
servers:
  - url: http://localhost:8080
paths:
  /pets:
    get:
      deprecated: true
      operationId: getPets
      summary: List all pets
      responses:
        '200':
          description: A list of pets
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Pet'
    post:
      operationId: createPet
      summary: Create a pet
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Pet'
      responses:
        '201':
          description: Pet created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pet'
  /pets/{petId}:
    get:
      operationId: getPetById
      summary: Get a pet by ID
      parameters:
        - name: petId
          in: path
          required: true
          schema:
            type: integer
            format: int64
      responses:
        '200':
          description: A pet
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pet'
components:
  schemas:
    Pet:
      type: object
      required:
        - id
        - name
      properties:
        id:
          type: integer
          format: int64
        name:
          type: string
        tag:
          type: string

```
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>webclient-example</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <packaging>jar</packaging>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.5.5</version>
    </parent>

    <properties>
        <java.version>21</java.version>
        <openapi-generator.version>7.18.0</openapi-generator.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-webflux</artifactId>
        </dependency>
        <dependency>
            <groupId>jakarta.annotation</groupId>
            <artifactId>jakarta.annotation-api</artifactId>
        </dependency>
        <dependency>
            <groupId>org.openapitools</groupId>
            <artifactId>jackson-databind-nullable</artifactId>
            <version>0.2.8</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.openapitools</groupId>
                <artifactId>openapi-generator-maven-plugin</artifactId>
                <version>${openapi-generator.version}</version>
                <executions>
                    <execution>
                        <goals>
                            <goal>generate</goal>
                        </goals>
                        <configuration>
                            <inputSpec>${project.basedir}/api.yaml</inputSpec>
                            <generatorName>java</generatorName>
                            <library>webclient</library>
                            <apiPackage>com.example.client.api</apiPackage>
                            <modelPackage>com.example.client.model</modelPackage>
                            <invokerPackage>com.example.client</invokerPackage>
                            <configOptions>
                                <useJakartaEe>true</useJakartaEe>
                                <dateLibrary>java8</dateLibrary>
                            </configOptions>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

```


##### Steps to reproduce

Run 
``` mvn clean install ```

and check that defaultApi.getPets() is not marked @Deprecated

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[BUG][JAVA] Deprecated endpoints are not marked with Deprecated in public webclient methods #22675

Description

openapi-generator version

OpenAPI declaration file content or url

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Uh oh!

[BUG][JAVA] Deprecated endpoints are not marked with Deprecated in public webclient methods #22675

Description

Description

openapi-generator version

OpenAPI declaration file content or url

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions