methodMembers

Talks about: <a class="post-tag post-tag-annotations" href="/tags/annotations">annotations</a>

The annotation members to use for methods.

Configuration Options

Option: ‘WITHOUT_DATE’

The default value of the methodMembers configuration option is WITHOUT_DATE. Setting the option to WITHOUT_DATE therefore produces the same code generated as the default configuration.

package com.example.persistence;

import javax.annotation.processing.Generated;

public class SomeRepository {

    @Generated(
        value = "YoSQL",
        comments = "DO NOT MODIFY - automatically generated by YoSQL"
    )
    public void someMethod() {
      // ... some code
    }

    // ... rest of generated code

}

Option: ‘ALL’

Changing the methodMembers configuration option to ALL outputs all annotation members.

package com.example.persistence;

import javax.annotation.processing.Generated;

public class SomeRepository {

    @Generated(
        value = "YoSQL",
        date = "<current_timestamp>",
        comments = "DO NOT MODIFY - automatically generated by YoSQL"
    )
    public void someMethod() {
        // ... some code
    }

     // ... rest of generated code (same as above)

}

Option: ‘NONE’

Changing the methodMembers configuration option to NONE outputs no annotation members.

package com.example.persistence;

import javax.annotation.processing.Generated;

public class SomeRepository {

    @Generated
    public void someMethod() {
        // ... some code
    }

    // ... rest of generated code (same as above)

}

Option: ‘VALUE’

Changing the methodMembers configuration option to VALUE outputs only the value member.

package com.example.persistence;

import javax.annotation.processing.Generated;

public class SomeRepository {

    @Generated(
        value = "YoSQL"
    )
    public void someMethod() {
      // ... some code
    }

    // ... rest of generated code (same as above)

}

Option: ‘DATE’

Changing the methodMembers configuration option to DATE outputs only the date member.

package com.example.persistence;

import javax.annotation.processing.Generated;

public class SomeRepository {

    @Generated(
        date = "<current_timestamp>"
    )
    public void someMethod() {
        // ... some code
    }

    // ... rest of generated code (same as above)

}

Option: ‘COMMENT’

Changing the methodMembers configuration option to COMMENT outputs only the comment member.

package com.example.persistence;

import javax.annotation.processing.Generated;

public class SomeRepository {

    @Generated(
        comments = "DO NOT MODIFY - automatically generated by YoSQL"
    )
    public void someMethod() {
        // ... some code
    }

    // ... rest of generated code (same as above)

}

annotateClasses: Controls whether Generated annotations should be added to the generated classes.
annotateFields: Controls whether Generated annotations should be added to the generated fields.
annotateMethods: Controls whether Generated annotations should be added to the generated methods.
annotationApi: The annotation API to use.
classComment: Sets the comment used for annotated classes.
classMembers: The annotation members to use for classes.
constructorAnnotations: The additional annotations to be placed on generated constructors.
fieldComment: Sets the comment used for annotated fields.
fieldMembers: The annotation members to use for fields.
generatorName: The name of the code generator
methodAnnotations: The additional annotations to be placed on generated methods.
methodComment: Sets the comment used for annotated methods.
repositoryAnnotations: The additional annotations to be placed on generated repository classes.

Tooling

Ant

In order to use YoSQL together with Ant, take a look at the tooling documentation for Ant.

Bazel

In order to use YoSQL together with Bazel, take a look at the tooling documentation for Bazel.

CLI

In order to use YoSQL on the command line, take a look at the tooling documentation for CLI.

$ yosql --annotations-method-members=configValue

As long as the name of the config option is unique across all configuration groups, you can use the shorter form:

$ yosql --method-members=configValue

Gradle

In order to use YoSQL together with Gradle, take a look at the tooling documentation for Gradle. The methodMembers setting can be configured using Gradle in Kotlin syntax like this:

plugins {
  java
  id("wtf.metio.yosql") version "2023.2.22"
}

yosql {
  annotations {
    methodMembers.set(configValue)
  }
}

or in Groovy syntax like this:

plugins {
  id "java"
  id "wtf.metio.yosql" version "2023.2.22"
}

yosql {
  annotations {
    methodMembers = configValue
  }
}

Maven

In order to use YoSQL together with Maven, take a look at the tooling documentation for Maven. The methodMembers setting can be configured using Maven like this:

<build>
  <plugins>
    <plugin>
      <groupId>wtf.metio.yosql</groupId>
      <artifactId>yosql-tooling-maven</artifactId>
      <version>2023.2.22</version>
      <configuration>
        <annotations>
          <methodMembers>configValue</methodMembers>
        </annotations>
      </configuration>
    </plugin>
  </plugins>
</build>