java-utilities.xsl revision bb8874d71cdd8e5288297b9727703437c6dfcfed
169N/A<!--
2362N/A ! CDDL HEADER START
0N/A !
0N/A ! The contents of this file are subject to the terms of the
0N/A ! Common Development and Distribution License, Version 1.0 only
0N/A ! (the "License"). You may not use this file except in compliance
0N/A ! with the License.
0N/A !
0N/A ! You can obtain a copy of the license at
0N/A ! trunk/opends/resource/legal-notices/OpenDS.LICENSE
0N/A ! or https://OpenDS.dev.java.net/OpenDS.LICENSE.
0N/A ! See the License for the specific language governing permissions
0N/A ! and limitations under the License.
0N/A !
0N/A ! When distributing Covered Code, include this CDDL HEADER in each
0N/A ! file and include the License file at
0N/A ! trunk/opends/resource/legal-notices/OpenDS.LICENSE. If applicable,
0N/A ! add the following below this CDDL HEADER, with the fields enclosed
2362N/A ! by brackets "[]" replaced with your own identifying information:
2362N/A ! Portions Copyright [yyyy] [name of copyright owner]
2362N/A !
0N/A ! CDDL HEADER END
0N/A !
0N/A !
0N/A ! Portions Copyright 2007 Sun Microsystems, Inc.
0N/A ! -->
0N/A<xsl:stylesheet version="1.0"
0N/A xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
0N/A xmlns:exsl="http://exslt.org/common">
0N/A <!--
0N/A This XSLT file contains utility templates which can be used for any
0N/A generating Java code.
0N/A -->
0N/A <xsl:import href="text-utilities.xsl" />
0N/A <xsl:output method="text" encoding="us-ascii" />
0N/A <!--
0N/A Add a copyright notice to the top of a Java source file.
0N/A
0N/A TODO: it would be nice to generate the copyright year automatically.
0N/A -->
0N/A <xsl:template name="copyright-notice">
0N/A <xsl:value-of
0N/A select="concat('/*&#xa;',
0N/A ' * CDDL HEADER START&#xa;',
0N/A ' *&#xa;',
0N/A ' * The contents of this file are subject to the terms of the&#xa;',
0N/A ' * Common Development and Distribution License, Version 1.0 only&#xa;',
0N/A ' * (the &quot;License&quot;). You may not use this file except in compliance&#xa;',
0N/A ' * with the License.&#xa;',
0N/A ' *&#xa;',
0N/A ' * You can obtain a copy of the license at&#xa;',
0N/A ' * trunk/opends/resource/legal-notices/OpenDS.LICENSE&#xa;',
0N/A ' * or https://OpenDS.dev.java.net/OpenDS.LICENSE.&#xa;',
0N/A ' * See the License for the specific language governing permissions&#xa;',
0N/A ' * and limitations under the License.&#xa;',
0N/A ' *&#xa;',
0N/A ' * When distributing Covered Code, include this CDDL HEADER in each&#xa;',
0N/A ' * file and include the License file at&#xa;',
0N/A ' * trunk/opends/resource/legal-notices/OpenDS.LICENSE. If applicable,&#xa;',
0N/A ' * add the following below this CDDL HEADER, with the fields enclosed&#xa;',
0N/A ' * by brackets &quot;[]&quot; replaced with your own identifying information:&#xa;',
0N/A ' * Portions Copyright [yyyy] [name of copyright owner]&#xa;',
0N/A ' *&#xa;',
0N/A ' * CDDL HEADER END&#xa;',
0N/A ' *&#xa;',
0N/A ' *&#xa;',
0N/A ' * Portions Copyright 2007 Sun Microsystems, Inc.&#xa;',
0N/A ' */&#xa;')" />
0N/A </xsl:template>
0N/A <!--
0N/A Convert an entity or property ID to a Java mixed-cased name.
0N/A For example, the string "my-string-value" will be converted to
0N/A the string "myStringValue".
0N/A
0N/A @param value
0N/A The ID string to be converted to a Java name.
0N/A -->
0N/A <xsl:template name="name-to-java">
0N/A <xsl:param name="value" />
0N/A <xsl:if test="string-length($value)">
0N/A <xsl:choose>
0N/A <xsl:when test="contains($value, '-')">
0N/A <xsl:variable name="head"
0N/A select="substring-before($value, '-')" />
0N/A <xsl:variable name="tail"
0N/A select="substring-after($value, '-')" />
0N/A <xsl:call-template name="to-title-case">
0N/A <xsl:with-param name="value" select="$head" />
0N/A </xsl:call-template>
0N/A <xsl:call-template name="name-to-java">
0N/A <xsl:with-param name="value" select="$tail" />
169N/A </xsl:call-template>
0N/A </xsl:when>
0N/A <xsl:otherwise>
0N/A <xsl:call-template name="to-title-case">
0N/A <xsl:with-param name="value" select="$value" />
0N/A </xsl:call-template>
169N/A </xsl:otherwise>
169N/A </xsl:choose>
169N/A </xsl:if>
169N/A </xsl:template>
169N/A <!--
169N/A Convert an entity or property ID to a Java constant name.
169N/A For example, the string "my-string-value" will be converted to
0N/A the string "MY_STRING_VALUE".
169N/A
169N/A @param value
169N/A The ID string to be converted to a Java constant.
169N/A -->
0N/A <xsl:template name="name-to-java-constant">
0N/A <xsl:param name="value" />
169N/A <xsl:value-of
0N/A select="translate($value,
0N/A 'abcdefghijklmnopqrstuvwxyz-',
0N/A 'ABCDEFGHIJKLMNOPQRSTUVWXYZ_')" />
0N/A </xsl:template>
169N/A <!--
169N/A Add a Java comment. This template handles two levels of
0N/A indentation: the indentation string for the first line, and a
169N/A second indentation string used for subsequent lines. The template
169N/A will output the content wrapping at the nearest word boundary to
169N/A column 70.
169N/A
169N/A @param indent-text
169N/A The indentation text used for the first line.
169N/A
0N/A @param indent-text2
0N/A The indentation text used for all lines except
the first - defaults to the value of indent-text.
@param content
The content to be output in the comment.
-->
<xsl:template name="add-java-comment">
<xsl:param name="indent-text" />
<xsl:param name="indent-text2" select="$indent-text" />
<xsl:param name="content" />
<xsl:call-template name="format-text">
<xsl:with-param name="indent-text" select="$indent-text" />
<xsl:with-param name="indent-text2" select="$indent-text2" />
<xsl:with-param name="wrap-column" select="'70'" />
<xsl:with-param name="content" select="$content" />
</xsl:call-template>
</xsl:template>
<!--
Utility template for removing duplicate values from a node-set.
This template is based on the version published on the XSLT site.
It is not capable of normalizing nodes - so they must be
pre-normalized before this template is called.
@param nodes A node-set containing the duplicate nodes.
-->
<xsl:template name="set-distinct">
<xsl:param name="nodes" select="/.." />
<xsl:call-template name="_set-distinct">
<xsl:with-param name="nodes" select="$nodes" />
</xsl:call-template>
</xsl:template>
<!-- set-distinct helper template -->
<xsl:template name="_set-distinct">
<xsl:param name="nodes" select="/.." />
<xsl:param name="distinct" select="/.." />
<xsl:choose>
<xsl:when test="$nodes">
<xsl:variable name="value" select="$nodes[1]" />
<xsl:choose>
<xsl:when test="$distinct[. = $value]">
<xsl:call-template name="_set-distinct">
<xsl:with-param name="distinct" select="$distinct" />
<xsl:with-param name="nodes" select="$nodes[position() > 1]" />
</xsl:call-template>
</xsl:when>
<xsl:otherwise>
<xsl:call-template name="_set-distinct">
<xsl:with-param name="distinct" select="$distinct | $nodes[1]" />
<xsl:with-param name="nodes" select="$nodes[position() > 1]" />
</xsl:call-template>
</xsl:otherwise>
</xsl:choose>
</xsl:when>
<xsl:otherwise>
<xsl:apply-templates select="$distinct" mode="set-distinct" />
</xsl:otherwise>
</xsl:choose>
</xsl:template>
<!-- set-distinct helper template -->
<xsl:template match="node()|@*" mode="set-distinct">
<xsl:copy-of select="." />
</xsl:template>
<!--
Generate a set of import statements.
This template takes a result tree fragment as a parameter
containing elements of the form:
<import>java.net.InetAddress</import>
<import>...</import>
This template will normalize each element and remove duplicates
before generating the output.
@param imports The result tree fragment containing the import elements.
-->
<xsl:template name="generate-import-statements">
<xsl:param name="imports" select="/.." />
<!--
Normalize the import elements since the set-distinct
template cannot handle additional whitespace
-->
<xsl:variable name="normalized-imports">
<xsl:for-each select="exsl:node-set($imports)/import">
<xsl:element name="import">
<xsl:value-of select="normalize-space()" />
</xsl:element>
</xsl:for-each>
</xsl:variable>
<!--
Now remove the duplicates
-->
<xsl:variable name="unique">
<xsl:call-template name="set-distinct">
<xsl:with-param name="nodes"
select="exsl:node-set($normalized-imports)/import" />
</xsl:call-template>
</xsl:variable>
<!--
Now output the import statements
-->
<xsl:for-each select="exsl:node-set($unique)/import">
<xsl:sort select="normalize-space()" />
<xsl:value-of
select="concat('import ', normalize-space(),';&#xa;')" />
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>