ISML Gradle Plugins2019-02-19Version 2 of this plugin will only work with Gradle 5 and JDK 8.SummaryThis package provides two plugins - one plugin for the ISML tag lib support and one for the compilation of ISML files.
These plugins compile ISML files of Intershop to Java class files. It generates also JSP and Java files from ISML files.
All files of the output have the same time stamp.UsageTo apply the ISML Gradle Plugins to your projects, add the following in your build script:build.gradleplugins {
// only necessary to use additonal TagLibs
id 'com.intershop.gradle.ismltaglib' version '2.0.2'
// necessary for the compilation of ISML files
id 'com.intershop.gradle.isml' version '2.0.2'
}The compiler plugin will create a default configuration for ISML templates of an Intershop project. The plugin uses the project
dependencies for the ISML task and the compilation of the files.TasksThe ISML Gradle plugin adds one task isml to the project. This task depends on all ISML plugin tasks 'isml2class*'.Task nameTypeDescriptionprepareTagLibscom.intershop.gradle.isml.tasks.PrepareTagLibsThis task prepares the environment for ISML compilation with TagLibs.
The output of this task is directly used by the isml2class* tasks.ismlTaskOverall isml code generation task of a project. This task depends on all isml2class tasks.isml2class<source set name>com.intershop.gradle.isml.tasks.IsmlCompileThis task compiles ISML files to class files.Project Extension 'isml'This plugin adds an extension isml to the project.PropertiesPropertyTypeDefault valueDescriptionjspCompilerVersionString'7.0.42'The version of JSP compiler.eclipseCompilerVersionString'4.2.2'The version of Eclipse Java compiler. This version depends on the JSP compiler. Please check the used Tomcat version.encodingString'UTF-8'Template encoding. This is also used for JSP and Java compilation.sourceSetNameString'main'Name of the Java source set, which can be used for ISML compilation.ismlConfigurationNameString'runtime'Name of the configuration, which is used for the classpath of ISML compilation.sourceCompatibilityString'1.6'This Java source compatibility is used for the compilation of java files.targetCompatibilityString'1.6'This Java target compatibility is used for the compilation of java files.taglibFolderFilenullFolder with WEB-INF and TagLib configuration files.MethodsMethodValuesDescriptionsourceSetsIsmlSourceSetThis contains all folders with ISML templates.<anchor xml:id="ismlSourceSet" xreflabel="[ismlSourceSet]"/>Object 'sourceSet' (IsmlSourceSet)PropertiesPropertyTypeDefault valueDescriptionnameString'main'The name of the ISML source setsrcDirFile'<project dir>/staticfiles/cartridge/templates'The input directory of the task.outputDirFile'<project builddir>/generated/isml/main'The output directory of the compiler task.jspPackageString'ish.cartridges.<project name>The package name of the compiled JSP files.taskNameString'isml2classMain'The task name.Example ConfigurationsSimple configurationplugins {
id 'com.intershop.gradle.ismltaglib' version '2.0.2'
id 'com.intershop.gradle.isml' version '2.0.2'
}
configurations {
compile
runtime.extendsFrom(compile)
}
dependencies {
compile "com.intershop.platform:core:<ICM platform version>"
compile "com.intershop.platform:isml:<ICM platform version>"
...
}Configuration with additional Java VM settings for process runnerplugins {
id 'com.intershop.gradle.ismltaglib' version '2.0.2'
id 'com.intershop.gradle.isml' version '2.0.2'
}
configurations {
compile
runtime.extendsFrom(compile)
}
tasks.withType(com.intershop.gradle.isml.tasks.IsmlCompile) {
forkOptions { JavaForkOptions options ->
options.setMaxHeapSize('64m')
options.jvmArgs += ['-Dhttp.proxyHost=10.0.0.100', '-Dhttp.proxyPort=8800']
}
}
dependencies {
compile "com.intershop.platform:core:<ICM platform version>"
compile "com.intershop.platform:isml:<ICM platform version>"
...
}LicenseCopyright 2014-2018 Intershop Communications.Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License athttp://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.