X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=blobdiff_plain;f=binding%2Fmdsal-binding-java-api-generator%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Fmdsal%2Fbinding%2Fjava%2Fapi%2Fgenerator%2FBaseTemplate.xtend;h=71005ca2ac6b1c9fb8b45c0911573bb7328251b5;hb=62d1bb7f2cf0c96ce34ca181462132dc95555daf;hp=63d426937ac5eb5eee792faff7ac8d8856adc5d0;hpb=398c503a7a374d3bf766980ed5ea675a3e5c68ed;p=mdsal.git diff --git a/binding/mdsal-binding-java-api-generator/src/main/java/org/opendaylight/mdsal/binding/java/api/generator/BaseTemplate.xtend b/binding/mdsal-binding-java-api-generator/src/main/java/org/opendaylight/mdsal/binding/java/api/generator/BaseTemplate.xtend index 63d426937a..71005ca2ac 100644 --- a/binding/mdsal-binding-java-api-generator/src/main/java/org/opendaylight/mdsal/binding/java/api/generator/BaseTemplate.xtend +++ b/binding/mdsal-binding-java-api-generator/src/main/java/org/opendaylight/mdsal/binding/java/api/generator/BaseTemplate.xtend @@ -15,20 +15,26 @@ import com.google.common.base.Splitter import com.google.common.collect.Iterables import java.util.Collection import java.util.List +import java.util.Locale +import java.util.Map.Entry import java.util.StringTokenizer import java.util.regex.Pattern +import org.opendaylight.mdsal.binding.model.api.AnnotationType import org.opendaylight.mdsal.binding.model.api.ConcreteType import org.opendaylight.mdsal.binding.model.api.Constant import org.opendaylight.mdsal.binding.model.api.GeneratedProperty import org.opendaylight.mdsal.binding.model.api.GeneratedType -import org.opendaylight.mdsal.binding.model.api.GeneratedTransferObject +import org.opendaylight.mdsal.binding.model.api.JavaTypeName import org.opendaylight.mdsal.binding.model.api.MethodSignature import org.opendaylight.mdsal.binding.model.api.Restrictions import org.opendaylight.mdsal.binding.model.api.Type import org.opendaylight.mdsal.binding.model.api.TypeMember import org.opendaylight.mdsal.binding.model.api.YangSourceDefinition.Single import org.opendaylight.mdsal.binding.model.api.YangSourceDefinition.Multiple +import org.opendaylight.mdsal.binding.model.util.BindingGeneratorUtil +import org.opendaylight.mdsal.binding.model.util.TypeConstants import org.opendaylight.mdsal.binding.model.util.Types +import org.opendaylight.mdsal.binding.spec.naming.BindingMapping import org.opendaylight.yangtools.yang.binding.CodeHelpers import org.opendaylight.yangtools.yang.common.QName import org.opendaylight.yangtools.yang.model.api.ContainerSchemaNode @@ -43,14 +49,14 @@ import org.opendaylight.yangtools.yang.model.api.stmt.ModuleEffectiveStatement import org.opendaylight.yangtools.yang.model.export.DeclaredStatementFormatter abstract class BaseTemplate extends JavaFileTemplate { - private static final char NEW_LINE = '\n' - private static val AMP_MATCHER = CharMatcher.is('&') - private static val NL_MATCHER = CharMatcher.is(NEW_LINE) - private static val TAB_MATCHER = CharMatcher.is('\t') - private static val SPACES_PATTERN = Pattern.compile(" +") - private static val NL_SPLITTER = Splitter.on(NL_MATCHER) - private static val TAIL_COMMENT_PATTERN = Pattern.compile("*/", Pattern.LITERAL); - private static val YANG_FORMATTER = DeclaredStatementFormatter.builder() + static final char NEW_LINE = '\n' + static final char SPACE = ' ' + static val AMP_MATCHER = CharMatcher.is('&') + static val WS_MATCHER = CharMatcher.anyOf("\n\t") + static val SPACES_PATTERN = Pattern.compile(" +") + static val NL_SPLITTER = Splitter.on(NEW_LINE) + static val TAIL_COMMENT_PATTERN = Pattern.compile("*/", Pattern.LITERAL); + static val YANG_FORMATTER = DeclaredStatementFormatter.builder() .addIgnoredStatement(YangStmtMapping.CONTACT) .addIgnoredStatement(YangStmtMapping.DESCRIPTION) .addIgnoredStatement(YangStmtMapping.REFERENCE) @@ -61,7 +67,11 @@ abstract class BaseTemplate extends JavaFileTemplate { super(type) } - final public def generate() { + new(AbstractJavaGeneratedType javaType, GeneratedType type) { + super(javaType, type) + } + + final def generate() { val _body = body() ''' package «type.packageName»; @@ -77,19 +87,17 @@ abstract class BaseTemplate extends JavaFileTemplate { final protected def fieldName(GeneratedProperty property) '''_«property.name»''' final protected def propertyNameFromGetter(MethodSignature getter) { - var int prefix; - if (getter.name.startsWith("is")) { - prefix = 2 - } else if (getter.name.startsWith("get")) { - prefix = 3 + var String prefix; + if (getter.name.startsWith(BindingMapping.BOOLEAN_GETTER_PREFIX)) { + prefix = BindingMapping.BOOLEAN_GETTER_PREFIX + } else if (getter.name.startsWith(BindingMapping.GETTER_PREFIX)) { + prefix = BindingMapping.GETTER_PREFIX + } else if (getter.name.startsWith(BindingMapping.NONNULL_PREFIX)) { + prefix = BindingMapping.NONNULL_PREFIX } else { - throw new IllegalArgumentException("Not a getter") + throw new IllegalArgumentException(getter + " is not a getter") } - return getter.name.substring(prefix).toFirstLower; - } - - final protected def isAccessor(MethodSignature maybeGetter) { - return maybeGetter.name.startsWith("is") || maybeGetter.name.startsWith("get"); + return getter.name.substring(prefix.length).toFirstLower; } /** @@ -102,10 +110,11 @@ abstract class BaseTemplate extends JavaFileTemplate { protected def getterMethod(GeneratedProperty field) { ''' public «field.returnType.importedName» «field.getterMethodName»() { - «IF field.returnType.importedName.contains("[]")» - return «field.fieldName» == null ? null : «field.fieldName».clone(); + «val fieldName = field.fieldName» + «IF field.returnType.name.endsWith("[]")» + return «fieldName» == null ? null : «fieldName».clone(); «ELSE» - return «field.fieldName»; + return «fieldName»; «ENDIF» } ''' @@ -148,7 +157,7 @@ abstract class BaseTemplate extends JavaFileTemplate { * group of generated property instances which are transformed to the sequence of parameter names * @return string with the list of the parameter names of the parameters */ - def final protected asArguments(Iterable parameters) '''«IF !parameters.empty»«FOR parameter : parameters SEPARATOR ", "»«parameter. + def final protected asArguments(Collection parameters) '''«IF !parameters.empty»«FOR parameter : parameters SEPARATOR ", "»«parameter. fieldName»«ENDFOR»«ENDIF»''' /** @@ -158,18 +167,15 @@ abstract class BaseTemplate extends JavaFileTemplate { * @return string with comment in JAVA format */ def protected CharSequence asJavadoc(String comment) { - if(comment === null) return '' - var txt = comment - - txt = comment.trim - txt = formatToParagraph(txt) - + if (comment === null) { + return '' + } return ''' - «wrapToDocumentation(txt)» + «wrapToDocumentation(formatToParagraph(comment.trim))» ''' } - def String wrapToDocumentation(String text) { + def static String wrapToDocumentation(String text) { if (text.empty) return "" @@ -177,8 +183,7 @@ abstract class BaseTemplate extends JavaFileTemplate { for (String t : NL_SPLITTER.split(text)) { sb.append(" *") if (!t.isEmpty()) { - sb.append(' '); - sb.append(t) + sb.append(SPACE).append(t) } sb.append(NEW_LINE) } @@ -281,7 +286,7 @@ abstract class BaseTemplate extends JavaFileTemplate { def private static void appendYangSnippet(StringBuilder sb, ModuleEffectiveStatement module, DeclaredStatement stmt) { for (String str : YANG_FORMATTER.toYangTextSnippet(module, stmt)) { - sb.append(encodeAngleBrackets(encodeJavadocSymbols(str))) + sb.append(BindingGeneratorUtil.replaceAllIllegalChars(encodeAngleBrackets(encodeJavadocSymbols(str)))) } } @@ -306,7 +311,7 @@ abstract class BaseTemplate extends JavaFileTemplate { return sb.toString(); } - def protected String formatDataForJavaDoc(TypeMember type, String additionalComment) { + def protected static String formatDataForJavaDoc(TypeMember type, String additionalComment) { val StringBuilder typeDescriptionBuilder = new StringBuilder(); if (!type.comment.nullOrEmpty) { typeDescriptionBuilder.append(formatToParagraph(type.comment)) @@ -328,7 +333,7 @@ abstract class BaseTemplate extends JavaFileTemplate { def asLink(String text) { val StringBuilder sb = new StringBuilder() var tempText = text - var char lastChar = ' ' + var char lastChar = SPACE var boolean badEnding = false if (text.endsWith('.') || text.endsWith(':') || text.endsWith(',')) { @@ -348,7 +353,7 @@ abstract class BaseTemplate extends JavaFileTemplate { return sb.toString } - protected def formatToParagraph(String text) { + protected static def formatToParagraph(String text) { if(text === null || text.isEmpty) return text @@ -358,51 +363,43 @@ abstract class BaseTemplate extends JavaFileTemplate { var boolean isFirstElementOnNewLineEmptyChar = false; formattedText = encodeJavadocSymbols(formattedText) - formattedText = NL_MATCHER.removeFrom(formattedText) - formattedText = TAB_MATCHER.removeFrom(formattedText) + formattedText = WS_MATCHER.replaceFrom(formattedText, SPACE) formattedText = SPACES_PATTERN.matcher(formattedText).replaceAll(" ") val StringTokenizer tokenizer = new StringTokenizer(formattedText, " ", true); - while (tokenizer.hasMoreElements) { - val nextElement = tokenizer.nextElement.toString + while (tokenizer.hasMoreTokens) { + val nextElement = tokenizer.nextToken if (lineBuilder.length != 0 && lineBuilder.length + nextElement.length > 80) { - if (lineBuilder.charAt(lineBuilder.length - 1) == ' ') { - lineBuilder.setLength(0) - lineBuilder.append(lineBuilder.substring(0, lineBuilder.length - 1)) + if (lineBuilder.charAt(lineBuilder.length - 1) == SPACE) { + lineBuilder.setLength(lineBuilder.length - 1) } - if (lineBuilder.charAt(0) == ' ') { - lineBuilder.setLength(0) - lineBuilder.append(lineBuilder.substring(1)) + if (lineBuilder.length != 0 && lineBuilder.charAt(0) == SPACE) { + lineBuilder.deleteCharAt(0) } - sb.append(lineBuilder); + sb.append(lineBuilder).append(NEW_LINE) lineBuilder.setLength(0) - sb.append(NEW_LINE) - if(nextElement.toString == ' ') { + if (nextElement == " ") { isFirstElementOnNewLineEmptyChar = !isFirstElementOnNewLineEmptyChar; } } if (isFirstElementOnNewLineEmptyChar) { isFirstElementOnNewLineEmptyChar = !isFirstElementOnNewLineEmptyChar - } - - else { + } else { lineBuilder.append(nextElement) } } - sb.append(lineBuilder) - sb.append(NEW_LINE) - return sb.toString + return sb.append(lineBuilder).append(NEW_LINE).toString } def protected generateToString(Collection properties) ''' «IF !properties.empty» - @Override + @«Override.importedName» public «String.importedName» toString() { final «MoreObjects.importedName».ToStringHelper helper = «MoreObjects.importedName».toStringHelper(«type.importedName».class); «FOR property : properties» @@ -429,23 +426,66 @@ abstract class BaseTemplate extends JavaFileTemplate { »''' def protected emitConstant(Constant c) ''' - «IF c.value instanceof QName» - «val qname = c.value as QName» - «val rev = qname.revision» - public static final «c.type.importedName» «c.name» = «QName.name».create("«qname.namespace.toString»", - «IF rev.isPresent»"«rev.get»", «ENDIF»"«qname.localName»").intern(); + «IF BindingMapping.QNAME_STATIC_FIELD_NAME.equals(c.name)» + «val entry = c.value as Entry» + public static final «c.type.importedNonNull» «c.name» = «entry.key.importedName».«BindingMapping.MODULE_INFO_QNAMEOF_METHOD_NAME»("«entry.value»"); «ELSE» public static final «c.type.importedName» «c.name» = «c.value»; «ENDIF» ''' - def static Restrictions getRestrictions(Type type) { - if (type instanceof ConcreteType) { - return type.restrictions - } - if (type instanceof GeneratedTransferObject) { - return type.restrictions - } - return null - } + def protected generateCheckers(GeneratedProperty field, Restrictions restrictions, Type actualType) ''' + «IF restrictions.rangeConstraint.present» + «AbstractRangeGenerator.forType(actualType).generateRangeChecker(field.name.toFirstUpper, + restrictions.rangeConstraint.get, this)» + «ENDIF» + «IF restrictions.lengthConstraint.present» + «LengthGenerator.generateLengthChecker(field.fieldName.toString, actualType, restrictions.lengthConstraint.get, this)» + «ENDIF» + ''' + + def protected checkArgument(GeneratedProperty property, Restrictions restrictions, Type actualType, String value) ''' + «IF restrictions.getRangeConstraint.isPresent» + «IF actualType instanceof ConcreteType» + «AbstractRangeGenerator.forType(actualType).generateRangeCheckerCall(property.getName.toFirstUpper, value)» + «ELSE» + «AbstractRangeGenerator.forType(actualType).generateRangeCheckerCall(property.getName.toFirstUpper, value + ".getValue()")» + «ENDIF» + «ENDIF» + «val fieldName = property.fieldName» + «IF restrictions.getLengthConstraint.isPresent» + «IF actualType instanceof ConcreteType» + «LengthGenerator.generateLengthCheckerCall(fieldName.toString, value)» + «ELSE» + «LengthGenerator.generateLengthCheckerCall(fieldName.toString, value + ".getValue()")» + «ENDIF» + «ENDIF» + + «val fieldUpperCase = fieldName.toString.toUpperCase(Locale.ENGLISH)» + «FOR currentConstant : type.getConstantDefinitions» + «IF currentConstant.getName.startsWith(TypeConstants.PATTERN_CONSTANT_NAME) + && fieldUpperCase.equals(currentConstant.getName.substring(TypeConstants.PATTERN_CONSTANT_NAME.length))» + «CodeHelpers.importedName».checkPattern(value, «Constants.MEMBER_PATTERN_LIST»«fieldName», «Constants.MEMBER_REGEX_LIST»«fieldName»); + «ENDIF» + «ENDFOR» + ''' + + def protected hashCodeResult(Collection properties) ''' + final int prime = 31; + int result = 1; + «FOR property : properties» + result = prime * result + «property.importedUtilClass».hashCode(«property.fieldName»); + «ENDFOR» + ''' + + def protected final generateAnnotation(AnnotationType annotation) ''' + @«annotation.importedName» + «IF annotation.parameters !== null && !annotation.parameters.empty» + ( + «FOR param : annotation.parameters SEPARATOR ","» + «param.name»=«param.value» + «ENDFOR» + ) + «ENDIF» + ''' }