jibx:jibx2wsdl

Full name:

org.jibx:jibx-maven-plugin:1.4.2:jibx2wsdl

Description:

Generates WSDL from java code.

Attributes:

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

Required Parameters

Name Type Since Description
<interfaceClassNames> ArrayList - The full class names of the service interface. Note: Classes should be in target/classes (which is where they should be after compiling).
User property is: interfaceClassNames.
<load> boolean - Control flag for test loading generated/modified classes.
Default value is: false.
User property is: load.
<multimodule> boolean - Control flag multi-module mode.
Default value is: false.
User property is: multi-module.
<outputDirectory> String - Target directory path for generated output (default is current directory). Note: If you want the wsdl and schema included in your distribution, remember to include it in the <resources> section of your pom file.
Default value is: ${project.build.directory}/schema.
User property is: outputDirectory.
<validate> boolean - Control flag for test loading generated/modified classes.
Default value is: true.
User property is: validate.
<verbose> boolean - Control flag for verbose processing reports.
Default value is: false.
User property is: verbose.
<verify> boolean - Control flag for verifying generated/modified classes with BCEL.
Default value is: false.
User property is: verify.

Optional Parameters

Name Type Since Description
<baseBindingDirectory> String - Get the default location of the base binding files.
Defaults value is: schemaBindingDirectory.
User property is: baseBindingDirectory.
<customizations> ArrayList - Include pattern for customization files.
User property is: customizations.
<directory> String - Deprecated. - Since binding and codegen use this for different locations, use schemaBindingDirectory.
Defaults to "src/main/config" (or "src/test/config" for test goals).
User property is: directory.
<excludeSchemaBindings> ArrayList - Exclude pattern for schema binding files.
User property is: excludeSchemaBindings.
<excludes> ArrayList - Deprecated. - This name was confusing since it is used as a binding file pattern for bind and a schema file pattern for code-gen.
Use excludeSchemaBindings for binding and excludeSchemas for schema
User property is: excludes.
<includeBaseBindings> HashSet - A list of modules or files to search for base binding files. This can specify files in the local directory or files stored in your dependencies. If your based binding files are in a local file system, specify them as follows:
<includeBaseBindings>
  <includeBaseBinding>
    <directory>src/main/config</directory>
    <includes>
      <include>base-binding.xml</include>
    </includes>
  </includeBaseBinding>
 </includeBaseBindings>
If your based binding files are in a artifact that is one of your dependencies:
<includeBaseBindings>
  <includeBaseBinding>
    <groupId>com.mycompany.baseschema</groupId>
    <artifactId>base-schema</artifactId>
    <classifier>bindings</classifier>
    <directory>META-INF</directory>
    <includes>
      <include>base-binding.xml</include>
    </includes>
  </includeBaseBinding>
</includeBaseBindings>
The classifier is optional (if your binding file is not in the main artifact) A version is not necessary, since this declaration must be on your list of dependencies.
Note: For file filters, use the standard filter format described in the plexus DirectoryScanner.
Defaults value is: binding.xml. Include existing bindings and use mappings from the bindings for matching schema global definitions. (this is the basis for modular code generation)
Note: If directory is not specified, relative paths start at <baseBindingDirectory>.
User property is: includeBaseBindings.
<includeSchemaBindings> ArrayList - Include pattern for schema binding files.
Note: Uses the standard filter format described in the plexus DirectoryScanner.
Defaults value is: binding.xml. Include existing bindings and use mappings from the bindings for matching schema global definitions. (this is the basis for modular code generation) Include base bindings as follows:
<includeSchemaBindings>
  <includeSchemaBinding>base-binding.xml</includeSchemaBinding>
</includeSchemaBindings>
Note: Relative paths start at <directory>.
User property is: includeSchemaBindings.
<includes> ArrayList - Deprecated. - This name was confusing since it is used as a binding file pattern for bind and a schema file pattern for code-gen.
Use includeSchemaBindings for binding and includeSchemas for schema.
Note: Uses the standard filter format described in the plexus DirectoryScanner.
Defaults value is: binding.xml.
User property is: includes.
<modules> HashSet - A list of modules to search for binding files in the format: groupID:artifactID
User property is: modules.
<options> Map - Extra options to be given for customization via CLI.Enter extra customizations or other command-line options.
The extra customizations are described on the JiBX2WSDL customizations page
The single character JiBX2WSDL commands may also be supplied here.
For example, to include Names of extra classes (-x) and Sets the base address used for the service endpoint address specified in the WSDL, supply the following options:
<options>
  <x>com.company.pacakge.ClassName</x>
  <service-base>http://localhost:8080/axis2/services</service-base>
</options>
<schemaBindingDirectory> String - The directory which contains schema binding files. Defaults to "src/main/config" (or "src/test/config" for test goals). For code-gen or if the default directory does not exist, defaults to "target/generated-sources" (or "target/generated-test-sources" for test goals).
User property is: schemaBindingDirectory.
<sourceDirectories> ArrayList - The source directories. Note: The source directory defaults to: <sourceDirectories>
  <sourceDirectory>src/main/java</sourceDirectory>
</sourceDirectories> If you are using the code-gen plugin, you may want to specify the generated sources directory: <sourceDirectories>
  <sourceDirectory>src/main/java</sourceDirectory>
  <sourceDirectory>${project.build.directory}/generated-source</sourceDirectory>
</sourceDirectories> If you don't want sources include, you will have to explicitly delare an empty list: <sourceDirectories>
  <sourceDirectory></sourceDirectory>
</sourceDirectories>
User property is: sourceDirectories.

Parameter Details

<baseBindingDirectory>

Get the default location of the base binding files.
Defaults value is: schemaBindingDirectory.
  • Type: java.lang.String
  • Required: No
  • User Property: baseBindingDirectory

<customizations>

Include pattern for customization files.
  • Type: java.util.ArrayList
  • Required: No
  • User Property: customizations

<directory>

Deprecated. - Since binding and codegen use this for different locations, use schemaBindingDirectory.
Defaults to "src/main/config" (or "src/test/config" for test goals).
The directory which contains binding files.
  • Type: java.lang.String
  • Required: No
  • User Property: directory

<excludeSchemaBindings>

Exclude pattern for schema binding files.
  • Type: java.util.ArrayList
  • Required: No
  • User Property: excludeSchemaBindings

<excludes>

Deprecated. - This name was confusing since it is used as a binding file pattern for bind and a schema file pattern for code-gen.
Use excludeSchemaBindings for binding and excludeSchemas for schema
Exclude pattern for binding files.
  • Type: java.util.ArrayList
  • Required: No
  • User Property: excludes

<includeBaseBindings>

A list of modules or files to search for base binding files. This can specify files in the local directory or files stored in your dependencies. If your based binding files are in a local file system, specify them as follows:
<includeBaseBindings>
  <includeBaseBinding>
    <directory>src/main/config</directory>
    <includes>
      <include>base-binding.xml</include>
    </includes>
  </includeBaseBinding>
 </includeBaseBindings>
If your based binding files are in a artifact that is one of your dependencies:
<includeBaseBindings>
  <includeBaseBinding>
    <groupId>com.mycompany.baseschema</groupId>
    <artifactId>base-schema</artifactId>
    <classifier>bindings</classifier>
    <directory>META-INF</directory>
    <includes>
      <include>base-binding.xml</include>
    </includes>
  </includeBaseBinding>
</includeBaseBindings>
The classifier is optional (if your binding file is not in the main artifact) A version is not necessary, since this declaration must be on your list of dependencies.
Note: For file filters, use the standard filter format described in the plexus DirectoryScanner.
Defaults value is: binding.xml. Include existing bindings and use mappings from the bindings for matching schema global definitions. (this is the basis for modular code generation)
Note: If directory is not specified, relative paths start at <baseBindingDirectory>.
  • Type: java.util.HashSet
  • Required: No
  • User Property: includeBaseBindings

<includeSchemaBindings>

Include pattern for schema binding files.
Note: Uses the standard filter format described in the plexus DirectoryScanner.
Defaults value is: binding.xml. Include existing bindings and use mappings from the bindings for matching schema global definitions. (this is the basis for modular code generation) Include base bindings as follows:
<includeSchemaBindings>
  <includeSchemaBinding>base-binding.xml</includeSchemaBinding>
</includeSchemaBindings>
Note: Relative paths start at <directory>.
  • Type: java.util.ArrayList
  • Required: No
  • User Property: includeSchemaBindings

<includes>

Deprecated. - This name was confusing since it is used as a binding file pattern for bind and a schema file pattern for code-gen.
Use includeSchemaBindings for binding and includeSchemas for schema.
Note: Uses the standard filter format described in the plexus DirectoryScanner.
Defaults value is: binding.xml.
Include pattern for binding files.
  • Type: java.util.ArrayList
  • Required: No
  • User Property: includes

<interfaceClassNames>

The full class names of the service interface. Note: Classes should be in target/classes (which is where they should be after compiling).
  • Type: java.util.ArrayList
  • Required: Yes
  • User Property: interfaceClassNames

<load>

Control flag for test loading generated/modified classes.
  • Type: boolean
  • Required: Yes
  • User Property: load
  • Default: false

<modules>

A list of modules to search for binding files in the format: groupID:artifactID
  • Type: java.util.HashSet
  • Required: No
  • User Property: modules

<multimodule>

Control flag multi-module mode.
  • Type: boolean
  • Required: Yes
  • User Property: multi-module
  • Default: false

<options>

Extra options to be given for customization via CLI.Enter extra customizations or other command-line options.
The extra customizations are described on the JiBX2WSDL customizations page
The single character JiBX2WSDL commands may also be supplied here.
For example, to include Names of extra classes (-x) and Sets the base address used for the service endpoint address specified in the WSDL, supply the following options:
<options>
  <x>com.company.pacakge.ClassName</x>
  <service-base>http://localhost:8080/axis2/services</service-base>
</options>
  • Type: java.util.Map
  • Required: No

<outputDirectory>

Target directory path for generated output (default is current directory). Note: If you want the wsdl and schema included in your distribution, remember to include it in the <resources> section of your pom file.
  • Type: java.lang.String
  • Required: Yes
  • User Property: outputDirectory
  • Default: ${project.build.directory}/schema

<schemaBindingDirectory>

The directory which contains schema binding files. Defaults to "src/main/config" (or "src/test/config" for test goals). For code-gen or if the default directory does not exist, defaults to "target/generated-sources" (or "target/generated-test-sources" for test goals).
  • Type: java.lang.String
  • Required: No
  • User Property: schemaBindingDirectory

<sourceDirectories>

The source directories. Note: The source directory defaults to: <sourceDirectories>
  <sourceDirectory>src/main/java</sourceDirectory>
</sourceDirectories> If you are using the code-gen plugin, you may want to specify the generated sources directory: <sourceDirectories>
  <sourceDirectory>src/main/java</sourceDirectory>
  <sourceDirectory>${project.build.directory}/generated-source</sourceDirectory>
</sourceDirectories> If you don't want sources include, you will have to explicitly delare an empty list: <sourceDirectories>
  <sourceDirectory></sourceDirectory>
</sourceDirectories>
  • Type: java.util.ArrayList
  • Required: No
  • User Property: sourceDirectories

<validate>

Control flag for test loading generated/modified classes.
  • Type: boolean
  • Required: Yes
  • User Property: validate
  • Default: true

<verbose>

Control flag for verbose processing reports.
  • Type: boolean
  • Required: Yes
  • User Property: verbose
  • Default: false

<verify>

Control flag for verifying generated/modified classes with BCEL.
  • Type: boolean
  • Required: Yes
  • User Property: verify
  • Default: false