Compare Models (#601)

* add support of model diff tool

* Merge branch 'master' into model_diff

* update parameter

* Fix various delete problem

* add message properties and command file for windows

* update exception

* add topology section

* merge from master

* grab from master

* fix script name

* Fix command line parameter

* Fix merging problems

* correct spellings

* Experiment to use alias tree to figure out folder or attribute

* add validation

* add message for validation

* Use alias methods to check for folder or attributes

* use for loop to prevent infinite loop

* correct logic

* update method and add CompareException

* copyrights update

* change wordings

* removed operator specific logic

* Add documentations

* Fix file writing issues

* Fix file writing for results

* remove unused var

* add support of variable substitution

* update doc

* fix script error

* update wordings and script

* handle deleting top level tree

* fix code error

* Add unit test for model diff

* Add parsing to catch error

* Add translate error check

* Add more tests for model_diff

* Add CreateException

* minor refactor

* update exception handling

* update exception in test

* change to use true or false for dictionary check

* rename model_diff to compare_model

* renamed file and update test

* change test to use new temporary directory each time

* update unit test

* doc updates

* adding messages for identical model

Author: jshum2479

README.md

@@ -10,6 +10,7 @@ Many organizations are using WebLogic Server, with or without other Oracle Fusio
     - [Discover Domain Tool](site/discover.md)
     - [Encrypt Model Tool](site/encrypt.md)
     - [Validate Model Tool](site/validate.md)
+    - [Compare Model Tool](site/compare.md)
     - [Extract Domain Resource Tool](site/kubernetes.md)
 - [The Model](#the-metadata-model)
     - [Top-Level Sections](#top-level-model-sections)
@@ -82,6 +83,7 @@ Currently, the project provides five single-purpose tools, all exposed as shell
 - The [Discover Domain Tool](site/discover.md) (`discoverDomain`) introspects an existing domain and creates a model file describing the domain and an archive file of the binaries deployed to the domain.
 - The [Encrypt Model Tool](site/encrypt.md) (`encryptModel`) encrypts the passwords in a model (or its variable file) using a user-provided passphrase.
 - The [Validate Model Tool](site/validate.md) (`validateModel`) provides both standalone validation of a model as well as model usage information to help users write or edit their models.
+- The [Compare Model Tool](site/compare.md) (`compareModel`) compares two model files.
 - The [Extract Domain Resource Tool](site/kubernetes.md) (`extractDomainResource`) generates a domain resource YAML for use with the Oracle WebLogic Server Kubernetes Operator.
 
 As new use cases are discovered, new tools will likely be added to cover those operations but all will use the metadata model to describe what needs to be done.

core/src/main/java/oracle/weblogic/deploy/compare/CompareException.java

@@ -0,0 +1,79 @@
+/*
+ * Copyright (c) 2020 Oracle Corporation and/or its affiliates.
+ * Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
+ */
+package oracle.weblogic.deploy.compare;
+
+import oracle.weblogic.deploy.exception.BundleAwareException;
+import oracle.weblogic.deploy.exception.ExceptionHelper;
+
+/**
+ * The exception used by the validation-related components.
+ */
+public class CompareException extends BundleAwareException {
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * Constructs a default exception.
+     */
+    public CompareException() {
+        // default constructor
+    }
+
+    /**
+     * Constructs a new exception with the specified message id.
+     *
+     * @param messageID the message ID
+     */
+    public CompareException(String messageID) {
+        super(messageID);
+    }
+
+    /**
+     * Constructs a new exception with the specified message id and parameters.
+     *
+     * @param messageID the message ID
+     * @param params    the parameters to use to fill in the message tokens
+     */
+    public CompareException(String messageID, Object... params) {
+        super(messageID, params);
+    }
+
+    /**
+     * Constructs a new exception with the specified message id and cause.
+     *
+     * @param messageID the message ID
+     * @param cause     the exception that triggered the creation of this exception
+     */
+    public CompareException(String messageID, Throwable cause) {
+        super(messageID, cause);
+    }
+
+    /**
+     * Constructs a new exception with passed message id, cause, and parameters.
+     *
+     * @param messageID the message ID
+     * @param cause     the exception that triggered the creation of this exception
+     * @param params    the parameters to use to fill in the message tokens
+     */
+    public CompareException(String messageID, Throwable cause, Object... params) {
+        super(messageID, cause, params);
+    }
+
+    /**
+     * Constructs a new exception with the specified cause.
+     *
+     * @param cause the exception that triggered the creation of this exception
+     */
+    public CompareException(Throwable cause) {
+        super(cause);
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    @Override
+    public String getBundleName() {
+        return ExceptionHelper.getResourceBundleName();
+    }
+}