org.jomc.tools.templates.jomc-java.implementation-documentation.vm Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jomc-tools Show documentation
Object management and configuration tools.
There is a newer version: 1.10.1
##
##   Copyright (C) Christian Schulte , 2005-206
##   All rights reserved.
##
##   Redistribution and use in source and binary forms, with or without
##   modification, are permitted provided that the following conditions
##   are met:
##
##     o Redistributions of source code must retain the above copyright
##       notice, this list of conditions and the following disclaimer.
##
##     o Redistributions in binary form must reproduce the above copyright
##       notice, this list of conditions and the following disclaimer in
##       the documentation and/or other materials provided with the
##       distribution.
##
##   THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
##   INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
##   AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
##   THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY DIRECT, INDIRECT,
##   INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
##   NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
##   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
##   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
##   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
##   THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
##
##   $JOMC: implementation-documentation.vm 5043 2015-05-27 07:03:39Z schulte $
##
## @param model The model declaring the modules of the implementation to render.
## @param modules The modules declaring the implementation to render.
## @param imodel The inheritance model of the modules declaring the implementation to render.
## @param smodel The source file model to render.
## @param ssection The source section model to render.
## @param implementation The implementation to render.
## @param tool The tool merging the template.
## @param toolName The name of the tool merging the template.
## @param toolVersion The version of the tool merging the template.
## @param toolUrl The URL to the site of the tool merging the template.
## @param calendar A java.util.Calendar instance.
## @param now The current timestamp formatted using the pattern "yyyy-MM-dd'T'HH:mm:ss.SSSZ".
## @param year The current year formatted using the pattern "yyyy".
## @param month The current month formatted using the pattern "MM".
## @param day The current day formatted using the pattern "dd".
## @param hour The current hour formatted using the pattern "HH".
## @param minute The current minute formatted using the pattern "mm".
## @param second The current second formatted using the pattern "ss".
## @param timezone The current timezone formatted using the pattern "Z".
## @param shortDate The current date formatted using a 'SHORT' format style.
## @param mediumDate The current date formatted using a 'MEDIUM' format style.
## @param longDate The current date formatted using a 'LONG' format style.
## @param isoDate The current date formatted using an ISO-8601 format style.
## @param shortTime The current time formatted using a 'SHORT' format style.
## @param mediumTime The current time formatted using a 'MEDIUM' format style.
## @param longTime The current time formatted using a 'LONG' format style.
## @param isoTime The current time formatted using an ISO-8601 format style.
## @param shortDateTime The current date and time formatted using a 'SHORT' format style.
## @param mediumDateTime The current date and time formatted using a 'MEDIUM' format style.
## @param longDateTime The current date and time formatted using a 'LONG' format style.
## @param isoDateTime The current date and time formatted using an ISO-8601 format style.
#if($with-editor-fold)
${tool.getIndentation(0)}${smodel.getHeadComment()} #if(${smodel.getTailComment()} && ${smodel.getTailComment().length()} > 0) ${smodel.getTailComment()}#end

#end
#if($with-javadoc)
${tool.getIndentation(0)}/**
#if($implementation.getDocumentation())
${tool.getIndentation(0)} * $implementation.getDocumentation().getText($tool.getLocale()).getJavadocComment($tool.getLineSeparator(), $tool.getIndentation(0))
#else
${tool.getIndentation(0)} * Implementation {@code <$implementation.getIdentifier()>}.
#end
${tool.getIndentation(0)} *
${tool.getIndentation(0)} * 
${tool.getIndentation(0)} *   Identifier:
$tool.getHtmlString($implementation.getIdentifier())
${tool.getIndentation(0)} *   Name:
$tool.getHtmlString($implementation.getName())
#set($specifications = $modules.getSpecifications($implementation.getIdentifier()))
#if($specifications && !$specifications.getReference().isEmpty())
${tool.getIndentation(0)} *   Specifications:
#foreach($reference in $specifications.getReference())
${tool.getIndentation(0)} *     $tool.getHtmlString($reference.getIdentifier())#if($reference.getVersion()) @ $tool.getHtmlString($reference.getVersion())#end
#end
#end
${tool.getIndentation(0)} *   Abstract:
$tool.getBooleanString($implementation.isAbstract())
${tool.getIndentation(0)} *   Final:
$tool.getBooleanString($implementation.isFinal())
${tool.getIndentation(0)} *   Stateless:
$tool.getBooleanString($implementation.isStateless())
${tool.getIndentation(0)} * 
${tool.getIndentation(0)} *
#if($with-javadoc-author && $implementation.getAuthors())
#foreach($author in $implementation.getAuthors().getAuthor())
${tool.getIndentation(0)} * @author #if($author.getMail())#end$tool.getHtmlString($author.getName())#if($author.getMail())#end#if($author.getVersion()) $tool.getHtmlString($author.getVersion())#end

#end
#end
#if($with-javadoc-version)
#if($implementation.getVersion())
${tool.getIndentation(0)} * @version $tool.getHtmlString($implementation.getVersion())
#else
${tool.getIndentation(0)} * @version This implementation does not support versioning.
#end
#end
${tool.getIndentation(0)} */
#end
#if($with-editor-fold)
${tool.getIndentation(0)}${smodel.getHeadComment()} #if(${smodel.getTailComment()} && ${smodel.getTailComment().length()} > 0) ${smodel.getTailComment()}#end

#end