Javassist Maven Plugin – javassist:javassist

javassist:javassist

Full name:

de.icongmbh.oss.maven.plugins:javassist-maven-plugin:2.0.3-SNAPSHOT:javassist

Description:

Maven plugin that will apply Javassist class transformations on compiled classes (bytecode instrumentation).

The real modifications of the bytecode are performed by one or more instances of the configured IClassTransformer.

Example plugin configuration :


...
<configuration>
  <includeTestClasses>false</includeTestClasses>
  <buildDir>bin/classes</buildDir>
  <testBuildDir>bin/test-classes</testBuildDir>
  <transformerClasses>
    <transformerClass>
     <className>
      de.icongmbh.oss.maven.plugin.javassist.example.transformer.MethodCallClassTransformer
     </className>
    </transformerClass>
  </transformerClasses>
</configuration>
...

Attributes:

Requires a Maven project to be executed.
Requires dependency resolution of artifacts in scope: compile+runtime.
Since version: 1.0.0.
Binds by default to the lifecycle phase: process-classes.

Required Parameters

Name	Type	Since	Description
`<includeTestClasses>`	`Boolean`	`1.0.0`	Whether or not to include test classes to be processed by declared transformers. `... <configuration> <includeTestClasses>false</includeTestClasses> </configuration> ...` Default value is: `true`. User property is: `javassist.includeTestClasses`.
`<transformerClasses>`	`ClassTransformerConfiguration[]`	`1.0.0`	Configure one or more class transformer. `... <configuration> <transformerClasses> <transformerClass> <className> de.icongmbh.oss.maven.plugin.javassist.example.transformer.MethodCallClassTransformer </className> </transformerClass> </transformerClasses> </configuration> ...` User property is: `javassist.transformerClasses`.

Optional Parameters

Name	Type	Since	Description
`<buildDir>`	`String`	`1.0.0`	Allows to customize the build directory of the project, used for both finding classes to transform and output them once transformed. The path must be either absolute or relative to project base directory. `... <configuration> <buildDir>bin/classes</buildDir> </configuration> ...` Default value is: `target/classes`. User property is: `javassist.buildDir`.
`<skip>`	`boolean`	`1.0.0`	Skips all processing performed by this goal. `... <configuration> <skip>false</skip> </configuration> ...` Default value is: `false`. User property is: `javassist.skip`.
`<testBuildDir>`	`String`	`1.0.0`	Allows to customize the build directory of the tests of the project, used for both finding classes to transform and output them once transformed. The path must be either absolute or relative to project base directory. `... <configuration> <testBuildDir>bin/test-classes</testBuildDir> </configuration> ...` Default value is: `target/test-classes`. User property is: `javassist.testBuildDir`.

Parameter Details

<buildDir>

Allows to customize the build directory of the project, used for both finding classes to transform and output them once transformed.

The path must be either absolute or relative to project base directory.


...
<configuration>
  <buildDir>bin/classes</buildDir>
</configuration>
...

Type: java.lang.String
Since: 1.0.0
Required: No
User Property: javassist.buildDir
Default: target/classes

<includeTestClasses>

Whether or not to include test classes to be processed by declared transformers.


...
<configuration>
  <includeTestClasses>false</includeTestClasses>
</configuration>
...

Type: java.lang.Boolean
Since: 1.0.0
Required: Yes
User Property: javassist.includeTestClasses
Default: true

<skip>

Skips all processing performed by this goal.


...
<configuration>
  <skip>false</skip>
</configuration>
...

Type: boolean
Since: 1.0.0
Required: No
User Property: javassist.skip
Default: false

<testBuildDir>

Allows to customize the build directory of the tests of the project, used for both finding classes to transform and output them once transformed.

The path must be either absolute or relative to project base directory.


...
<configuration>
  <testBuildDir>bin/test-classes</testBuildDir>
</configuration>
...

Type: java.lang.String
Since: 1.0.0
Required: No
User Property: javassist.testBuildDir
Default: target/test-classes

<transformerClasses>

Configure one or more class transformer.


...
<configuration>
  <transformerClasses>
    <transformerClass>
     <className>
      de.icongmbh.oss.maven.plugin.javassist.example.transformer.MethodCallClassTransformer
     </className>
    </transformerClass>
  </transformerClasses>
</configuration>
...

Type: de.icongmbh.oss.maven.plugin.javassist.ClassTransformerConfiguration[]
Since: 1.0.0
Required: Yes
User Property: javassist.transformerClasses