*/
package org.opendaylight.mdsal.binding.java.api.generator
+import static extension org.opendaylight.mdsal.binding.spec.naming.BindingMapping.DATA_CONTAINER_IMPLEMENTED_INTERFACE_NAME
+import static extension org.opendaylight.mdsal.binding.spec.naming.BindingMapping.getGetterMethodForNonnull
+import static extension org.opendaylight.mdsal.binding.spec.naming.BindingMapping.isGetterMethodName
+import static extension org.opendaylight.mdsal.binding.spec.naming.BindingMapping.isNonnullMethodName
+
import java.util.List
import org.opendaylight.mdsal.binding.model.api.AnnotationType
import org.opendaylight.mdsal.binding.model.api.Constant
import org.opendaylight.mdsal.binding.model.api.Enumeration
import org.opendaylight.mdsal.binding.model.api.GeneratedType
-import org.opendaylight.mdsal.binding.model.api.JavaTypeName
import org.opendaylight.mdsal.binding.model.api.MethodSignature
import org.opendaylight.mdsal.binding.model.api.Type
import org.opendaylight.mdsal.binding.model.util.TypeConstants
+import org.opendaylight.yangtools.yang.binding.CodeHelpers
/**
* Template for generating JAVA interfaces.
*/
class InterfaceTemplate extends BaseTemplate {
- static val JavaTypeName NULLABLE = JavaTypeName.create("org.eclipse.jdt.annotation", "Nullable")
-
/**
* List of constant instances which are generated as JAVA public static final attributes.
*/
* Creates the instance of this class which is used for generating the interface file source
* code from <code>genType</code>.
*
- * @throws IllegalArgumentException if <code>genType</code> equals <code>null</code>
+ * @throws NullPointerException if <code>genType</code> is <code>null</code>
*/
new(GeneratedType genType) {
super(genType)
- if (genType === null) {
- throw new IllegalArgumentException("Generated type reference cannot be NULL!")
- }
-
consts = genType.constantDefinitions
methods = genType.methodDefinitions
enums = genType.enumerations
'''
-
def private generateAnnotations(List<AnnotationType> annotations) '''
«IF annotations !== null && !annotations.empty»
«FOR annotation : annotations»
- @«annotation.importedName»
- «IF annotation.parameters !== null && !annotation.parameters.empty»
- (
- «FOR param : annotation.parameters SEPARATOR ","»
- «param.name»=«param.value»
- «ENDFOR»
- )
- «ENDIF»
+ «annotation.generateAnnotation»
«ENDFOR»
«ENDIF»
'''
def private generateMethods() '''
«IF !methods.empty»
«FOR m : methods SEPARATOR "\n"»
- «val accessor = m.isAccessor»
- «val ret = m.returnType»
- «IF accessor»
- «formatDataForJavaDoc(m, "@return " + asCode(ret.fullyQualifiedName) + " "
- + asCode(propertyNameFromGetter(m)) + ", or " + asCode("null") + " if not present")»
+ «IF m.isDefault»
+ «generateDefaultMethod(m)»
+ «ELSEIF m.parameters.empty && m.name.isGetterMethodName»
+ «generateAccessorMethod(m)»
«ELSE»
- «m.comment.asJavadoc»
+ «generateMethod(m)»
«ENDIF»
- «m.annotations.generateAnnotations»
- «nullableType(ret, accessor)» «m.name»(«m.parameters.generateParameters»);
«ENDFOR»
«ENDIF»
'''
- def private String nullableType(Type type, boolean accessor) {
- if (accessor && type.isObject) {
- return importedName(type, NULLABLE.importedName)
+ def private generateDefaultMethod(MethodSignature method) {
+ if (method.name.isNonnullMethodName) {
+ generateNonnullMethod(method)
+ } else {
+ switch method.name {
+ case DATA_CONTAINER_IMPLEMENTED_INTERFACE_NAME : generateDefaultImplementedInterface
+ }
+ }
+ }
+
+ def private generateMethod(MethodSignature method) '''
+ «method.comment.asJavadoc»
+ «method.annotations.generateAnnotations»
+ «method.returnType.importedName» «method.name»(«method.parameters.generateParameters»);
+ '''
+
+ def private generateAccessorMethod(MethodSignature method) '''
+ «val ret = method.returnType»
+ «formatDataForJavaDoc(method, "@return " + asCode(ret.fullyQualifiedName) + " " + asCode(propertyNameFromGetter(method)) + ", or " + asCode("null") + " if not present")»
+ «method.annotations.generateAnnotations»
+ «nullableType(ret)» «method.name»();
+ '''
+
+ def private generateDefaultImplementedInterface() '''
+ @«Override.importedName»
+ default «Class.importedName»<«type.fullyQualifiedName»> «DATA_CONTAINER_IMPLEMENTED_INTERFACE_NAME»() {
+ return «type.fullyQualifiedName».class;
+ }
+ '''
+
+ def private generateNonnullMethod(MethodSignature method) '''
+ «val ret = method.returnType»
+ «val name = method.name»
+ «formatDataForJavaDoc(method, "@return " + asCode(ret.fullyQualifiedName) + " " + asCode(propertyNameFromGetter(method)) + ", or an empty list if it is not present")»
+ «method.annotations.generateAnnotations»
+ default «ret.importedNonNull» «name»() {
+ return «CodeHelpers.importedName».nonnull(«getGetterMethodForNonnull(name)»());
+ }
+ '''
+
+ def private String nullableType(Type type) {
+ if (type.isObject) {
+ return type.importedNullable
}
return type.importedName
}