matrun/wsdl2java

Gradle plugin for generating java source from wsdl/xsd files

wsdl2java gradle plugin

Gradle plugin for generating java from wsdl, using cxf under the hood and the same options as the maven wsdl-2-java plugin from apache-cxf.

The plugin binaries are downloadable from bintray: https://bintray.com/nilsmagnus/maven/wsdl2java/

Issues

If you have any issues with the plugin, please file an issue at github, https://github.com/nilsmagnus/wsdl2java/issues

Contribution

Contributions are welcome as long as they are sane.

Contributors

• Mats Faugli, https://github.com/fowlie
• Nils Larsgård , https://github.com/nilsmagnus

CXF

This plugin uses the apache-cxf tools to do the actual work.

Tasks

Name	Description	Dependecy
wsdl2java	Generate java source from wsdl-files	CompileJava depends on wsdl2java
xsd2java	Generate java source from xsd-files	CompileJava depends on xsd2java
deleteGeneratedSources	Delete all generated sources	Clean depends on deleteGeneratedSources

Usage

To use this plugin, you must

• modify your buildscript to have dependencies to the plugin
• apply the plugin
• set the properties of the plugin
• add the generated sources to your sourceset

Applying the plugin

buildscript{
    repositories{
        jcenter()
        mavenCentral()
    }
    dependencies {
        classpath 'no.nils:wsdl2java:0.5'
    }
}
apply plugin: 'no.nils.wsdl2java'

Options for wsdl2java

Option	Default value	Description
generatedWsdlDir	generated-sources/src/main/java	This is where you want the generated sources to be placed.
wsdlDir	src/main/resources	Define the wsdl files directory to support incremental build. This means that the task will be up-to-date if nothing in this directory has changed.
wsdlsToGenerate	empty	This is the main input to the plugin that defines the wsdls to process. It is a list of arguments where each argument is a list of arguments to process a wsdl-file. The Wsdl-file with full path is the last argument. The array can be supplied with the same options as described for the maven-cxf plugin(http://cxf.apache.org/docs/wsdl-to-java.html).
cxfVersion	'+' (latest)	The version of cxf you want to use.

Example setting of options:

wsdl2java {
    generatedWsdlDir = file("my-generated-sources")  // target directory for generated source coude
    wsdlDir = file("src/main/resources/myWsdlFiles") // define to support incremental build
    wsdlsToGenerate = [   //  2d-array of wsdls and cxf-parameters
                ['src/main/resources/wsdl/firstwsdl.wsdl'],
                ['-xcj','-b','bingingfile.xml','src/main/resources/wsdl/secodwsdl.wsdl']
        ]
    cxfVersion = "2.5.1"
}

Options for xsd2java

Option	Default value	Description
generatedXsdDir	"generatedsources/src/main/java"	Destination directory for generated sources
xsdsToGenerate	null	2-d array consisting of 2 values in each array: xsd-file(input) and package for the generated sources

Example setting of options:

xsd2java{
    xsdsToGenerate = [
        ["src/main/resources/xsd/CustomersAndOrders.xsd", 'no.nils.xsd2java.sample']
    ]
    generatedXsdDir = file("generatedsources/xsd2java")
}

Complete example usage

This is a an example of a working build.gradle for a java project. You can also take a look at this projects submodule "consumer" which has a working wsdl compiling.

buildscript{
    repositories{
        jcenter() 
        mavenCentral()
    }
    dependencies {
        classpath 'no.nils:wsdl2java:0.5'
    }
}

apply plugin :'java'
apply plugin :'no.nils.wsdl2java'

repositories{
    mavenCentral()
}

dependencies(){
    testCompile 'junit:junit:+'
}

wsdl2java{
    wsdlsToGenerate = [
            ['src/main/resources/wsdl/stockqoute.wsdl']
    ]
    generatedWsdlDir = file("generatedsources")
    wsdlDir = file("src/main/resources/wsdl")
    cxfVersion = "3.0.1"
}
xsd2java{
    xsdsToGenerate = [
        ["src/main/resources/xsd/CustomersAndOrders.xsd", 'no.nils.xsd2java.sample']
    ]
    generatedXsdDir = file("generatedsources/xsd2java")
}