Import exception references

[mdsal.git] / binding / mdsal-binding-java-api-generator / src / main / java / org / opendaylight / mdsal / binding / java / api / generator / JavaFileTemplate.java

diff --git a/binding/mdsal-binding-java-api-generator/src/main/java/org/opendaylight/mdsal/binding/java/api/generator/JavaFileTemplate.java b/binding/mdsal-binding-java-api-generator/src/main/java/org/opendaylight/mdsal/binding/java/api/generator/JavaFileTemplate.java
index 669e843a6293ef37a8eb8000076945e823bf15bb..845545b50629402dd9a9750abfafda1911061e09 100644 (file)
--- a/binding/mdsal-binding-java-api-generator/src/main/java/org/opendaylight/mdsal/binding/java/api/generator/JavaFileTemplate.java
+++ b/binding/mdsal-binding-java-api-generator/src/main/java/org/opendaylight/mdsal/binding/java/api/generator/JavaFileTemplate.java
@@ -12,10 +12,9 @@ import static com.google.common.base.Verify.verify;
 import static java.util.Objects.requireNonNull;
 import static org.opendaylight.mdsal.binding.generator.BindingGeneratorUtil.encodeAngleBrackets;
 import static org.opendaylight.mdsal.binding.generator.BindingGeneratorUtil.replaceAllIllegalChars;
-import static org.opendaylight.mdsal.binding.spec.naming.BindingMapping.AUGMENTABLE_AUGMENTATION_NAME;
-import static org.opendaylight.mdsal.binding.spec.naming.BindingMapping.GETTER_PREFIX;
 
 import com.google.common.base.CharMatcher;
+import com.google.common.base.MoreObjects;
 import com.google.common.collect.ImmutableSortedSet;
 import java.lang.reflect.Method;
 import java.util.AbstractMap;
@@ -52,8 +51,6 @@ import org.opendaylight.mdsal.binding.model.ri.Types;
 import org.opendaylight.mdsal.binding.spec.naming.BindingMapping;
 import org.opendaylight.yangtools.yang.binding.Augmentable;
 import org.opendaylight.yangtools.yang.binding.CodeHelpers;
-import org.opendaylight.yangtools.yang.common.QName;
-import org.opendaylight.yangtools.yang.common.XMLNamespace;
 import org.opendaylight.yangtools.yang.model.api.ContainerSchemaNode;
 import org.opendaylight.yangtools.yang.model.api.DocumentedNode;
 import org.opendaylight.yangtools.yang.model.api.ListSchemaNode;
@@ -78,6 +75,10 @@ class JavaFileTemplate {
      * {@code java.lang.Deprecated} as a JavaTypeName.
      */
     static final @NonNull JavaTypeName DEPRECATED = JavaTypeName.create(Deprecated.class);
+    /**
+     * {@code java.lang.IllegalArgumentException} as a JavaTypeName.
+     */
+    static final @NonNull JavaTypeName IAE = JavaTypeName.create(IllegalArgumentException.class);
     /**
      * {@code java.lang.NullPointerException} as a JavaTypeName.
      */
@@ -143,6 +144,10 @@ class JavaFileTemplate {
      */
     static final @NonNull JavaTypeName CODEHELPERS = JavaTypeName.create(CodeHelpers.class);
 
+    /**
+     * {@code com.google.common.base.MoreObjects} as a JavaTypeName.
+     */
+    static final @NonNull JavaTypeName MOREOBJECTS = JavaTypeName.create(MoreObjects.class);
 
     private static final Comparator<MethodSignature> METHOD_COMPARATOR = new AlphabeticallyTypeMemberComparator<>();
     private static final CharMatcher AMP_MATCHER = CharMatcher.is('&');
@@ -153,12 +158,13 @@ class JavaFileTemplate {
         .addIgnoredStatement(YangStmtMapping.REFERENCE)
         .addIgnoredStatement(YangStmtMapping.ORGANIZATION)
         .build();
+    private static final int GETTER_PREFIX_LENGTH = BindingMapping.GETTER_PREFIX.length();
     private static final Type AUGMENTATION_RET_TYPE;
 
     static {
         final Method m;
         try {
-            m = Augmentable.class.getDeclaredMethod(AUGMENTABLE_AUGMENTATION_NAME, Class.class);
+            m = Augmentable.class.getDeclaredMethod(BindingMapping.AUGMENTABLE_AUGMENTATION_NAME, Class.class);
         } catch (NoSuchMethodException e) {
             throw new ExceptionInInitializerError(e);
         }
@@ -414,12 +420,12 @@ class JavaFileTemplate {
 
                 if (node instanceof SchemaNode) {
                     final SchemaNode schema = (SchemaNode) node;
-                    sb.append("The schema path to identify an instance is\n");
-                    appendPath(sb.append("<i>"), def.getModule(), schema.getPath().getPathFromRoot());
-                    sb.append("</i>\n");
+//                    sb.append("The schema path to identify an instance is\n");
+//                    appendPath(sb.append("<i>"), def.getModule(), schema.getPath().getPathFromRoot());
+//                    sb.append("</i>\n");
 
                     if (hasBuilderClass(schema)) {
-                        final String builderName = type.getName() + "Builder";
+                        final String builderName = type.getName() + BindingMapping.BUILDER_SUFFIX;
 
                         sb.append("\n<p>To create instances of this class use {@link ").append(builderName)
                         .append("}.\n")
@@ -427,7 +433,7 @@ class JavaFileTemplate {
                         if (node instanceof ListSchemaNode) {
                             final var keyDef = ((ListSchemaNode) node).getKeyDefinition();
                             if (!keyDef.isEmpty()) {
-                                sb.append("@see ").append(type.getName()).append("Key");
+                                sb.append("@see ").append(type.getName()).append(BindingMapping.KEY_SUFFIX);
                             }
                             sb.append('\n');
                         }
@@ -456,24 +462,24 @@ class JavaFileTemplate {
         }
     }
 
-    private static void appendPath(final StringBuilder sb, final ModuleEffectiveStatement module,
-            final List<QName> path) {
-        if (!path.isEmpty()) {
-            // FIXME: this is module name, while when we switch, we end up using QName.toString() -- which is weird
-            sb.append(module.argument().getLocalName());
-            XMLNamespace currentNamespace = path.get(0).getNamespace();
-
-            for (QName pathElement : path) {
-                final XMLNamespace elementNamespace = pathElement.getNamespace();
-                if (!elementNamespace.equals(currentNamespace)) {
-                    sb.append(pathElement);
-                    currentNamespace = elementNamespace;
-                } else {
-                    sb.append(pathElement.getLocalName());
-                }
-            }
-        }
-    }
+//    private static void appendPath(final StringBuilder sb, final ModuleEffectiveStatement module,
+//            final List<QName> path) {
+//        if (!path.isEmpty()) {
+//            // FIXME: this is module name, while when we switch, we end up using QName.toString() -- which is weird
+//            sb.append(module.argument().getLocalName());
+//            XMLNamespace currentNamespace = path.get(0).getNamespace();
+//
+//            for (QName pathElement : path) {
+//                final XMLNamespace elementNamespace = pathElement.getNamespace();
+//                if (!elementNamespace.equals(currentNamespace)) {
+//                    sb.append(pathElement);
+//                    currentNamespace = elementNamespace;
+//                } else {
+//                    sb.append(pathElement.getLocalName());
+//                }
+//            }
+//        }
+//    }
 
     private static boolean hasBuilderClass(final SchemaNode schemaNode) {
         return schemaNode instanceof ContainerSchemaNode || schemaNode instanceof ListSchemaNode
@@ -528,7 +534,7 @@ class JavaFileTemplate {
             return null;
         }
 
-        final String fieldName = StringExtensions.toFirstLower(method.getName().substring(GETTER_PREFIX.length()));
+        final String fieldName = StringExtensions.toFirstLower(method.getName().substring(GETTER_PREFIX_LENGTH));
         return new BuilderGeneratedProperty(fieldName, method);
     }
 }