Extract Traverser from UtBotSymbolicEngine (#307)

Author: sergeypospelov

utbot-framework/src/main/java/org/utbot/engine/overrides/UtArrayMock.java

@@ -5,7 +5,7 @@
 
 /**
  * Auxiliary class with static methods without implementation.
- * These static methods are just markers for <code>UtBotSymbolicEngine</code>,
+ * These static methods are just markers for {@link org.utbot.engine.Traverser}.,
  * to do some corresponding behavior, that can't be represent
  * with java instructions.
  * <p>
@@ -15,7 +15,7 @@
 @SuppressWarnings("unused")
 public class UtArrayMock {
     /**
-     * Traversing this instruction by <code>UtBotSymbolicEngine</code> should
+     * Traversing this instruction by {@link org.utbot.engine.Traverser} should
      * behave similar to call of {@link java.util.Arrays#copyOf(Object[], int)}
      * if length is less or equals to src.length, otherwise first
      * src.length elements are equal to src, but the rest are undefined.
@@ -45,7 +45,7 @@ public static char[] copyOf(char[] src, int length) {
     }
 
     /**
-     * Traversing this instruction by <code>UtBotSymbolicEngine</code> should
+     * Traversing this instruction by {@link org.utbot.engine.Traverser} should
      * behave similar to call of
      * {@link java.lang.System#arraycopy(Object, int, Object, int, int)}
      * if all the arguments are valid.
@@ -67,7 +67,7 @@ public static void arraycopy(Object[] src, int srcPos, Object[] dst, int destPos
     }
 
     /**
-     * Traversing this instruction by <code>UtBotSymbolicEngine</code> should
+     * Traversing this instruction by {@link org.utbot.engine.Traverser} should
      * behave similar to call of
      * {@link java.lang.System#arraycopy(Object, int, Object, int, int)}
      * if all the arguments are valid.
@@ -83,7 +83,7 @@ public static void arraycopy(boolean[] src, int srcPos, boolean[] dst, int destP
     }
 
     /**
-     * Traversing this instruction by <code>UtBotSymbolicEngine</code> should
+     * Traversing this instruction by {@link org.utbot.engine.Traverser} should
      * behave similar to call of
      * {@link java.lang.System#arraycopy(Object, int, Object, int, int)}
      * if all the arguments are valid.
@@ -99,7 +99,7 @@ public static void arraycopy(byte[] src, int srcPos, byte[] dst, int destPos, in
     }
 
     /**
-     * Traversing this instruction by <code>UtBotSymbolicEngine</code> should
+     * Traversing this instruction by {@link org.utbot.engine.Traverser} should
      * behave similar to call of
      * {@link java.lang.System#arraycopy(Object, int, Object, int, int)}
      * if all the arguments are valid.
@@ -115,7 +115,7 @@ public static void arraycopy(char[] src, int srcPos, char[] dst, int destPos, in
     }
 
     /**
-     * Traversing this instruction by <code>UtBotSymbolicEngine</code> should
+     * Traversing this instruction by {@link org.utbot.engine.Traverser} should
      * behave similar to call of
      * {@link java.lang.System#arraycopy(Object, int, Object, int, int)}
      * if all the arguments are valid.
@@ -131,7 +131,7 @@ public static void arraycopy(short[] src, int srcPos, short[] dst, int destPos,
     }
 
     /**
-     * Traversing this instruction by <code>UtBotSymbolicEngine</code> should
+     * Traversing this instruction by {@link org.utbot.engine.Traverser} should
      * behave similar to call of
      * {@link java.lang.System#arraycopy(Object, int, Object, int, int)}
      * if all the arguments are valid.
@@ -147,7 +147,7 @@ public static void arraycopy(int[] src, int srcPos, int[] dst, int destPos, int
     }
 
     /**
-     * Traversing this instruction by <code>UtBotSymbolicEngine</code> should
+     * Traversing this instruction by {@link org.utbot.engine.Traverser} should
      * behave similar to call of
      * {@link java.lang.System#arraycopy(Object, int, Object, int, int)}
      * if all the arguments are valid.
@@ -163,7 +163,7 @@ public static void arraycopy(long[] src, int srcPos, long[] dst, int destPos, in
     }
 
     /**
-     * Traversing this instruction by <code>UtBotSymbolicEngine</code> should
+     * Traversing this instruction by {@link org.utbot.engine.Traverser} should
      * behave similar to call of
      * {@link java.lang.System#arraycopy(Object, int, Object, int, int)}
      * if all the arguments are valid.
@@ -179,7 +179,7 @@ public static void arraycopy(float[] src, int srcPos, float[] dst, int destPos,
     }
 
     /**
-     * Traversing this instruction by <code>UtBotSymbolicEngine</code> should
+     * Traversing this instruction by {@link org.utbot.engine.Traverser} should
      * behave similar to call of
      * {@link java.lang.System#arraycopy(Object, int, Object, int, int)}
      * if all the arguments are valid.

utbot-framework/src/main/java/org/utbot/engine/overrides/UtLogicMock.java

@@ -2,7 +2,7 @@
 
 /**
  * Auxiliary class with static methods without implementation.
- * These static methods are just markers for <code>UtBotSymbolicEngine</code>,
+ * These static methods are just markers for {@link org.utbot.engine.Traverser},
  * to do some corresponding behavior, that can be represented with smt expressions.
  * <p>
  * <code>UtLogicMock</code> is used to store bool smt bool expressions in

utbot-framework/src/main/java/org/utbot/engine/overrides/UtOverrideMock.java

@@ -2,13 +2,13 @@
 
 /**
  * Auxiliary class with static methods without implementation.
- * These static methods are just markers for UtBotSymbolicEngine,
+ * These static methods are just markers for {@link org.utbot.engine.Traverser},
  * to do some corresponding behavior, that can't be represent
  * with java instructions.
  *
  * Set of methods in UtOverrideMock is used in code of classes,
  * that override implementation of some standard class by new implementation,
- * that is more simple for UtBotSymbolicEngine to traverse.
+ * that is more simple for {@link org.utbot.engine.Traverser} to traverse.
  */
 @SuppressWarnings("unused")
 public class UtOverrideMock {
@@ -25,7 +25,7 @@ public static boolean alreadyVisited(Object o) {
     }
 
     /**
-     * If UtBotSymbolicEngine meets invoke of this method in code,
+     * If {@link org.utbot.engine.Traverser} meets invoke of this method in code,
      * then it marks the address of object o in memory as visited
      * and creates new MemoryUpdate with parameter isVisited, equal to o.addr
      * @param o parameter, that need to be marked as visited.
@@ -34,7 +34,7 @@ public static void visit(Object o) {
     }
 
     /**
-     * If UtBotSymbolicEngine meets invoke of this method in code,
+     * If {@link org.utbot.engine.Traverser} meets invoke of this method in code,
      * then it marks the method, where met instruction is placed,
      * and all the methods that will be traversed in nested invokes
      * as methods that couldn't throw exceptions.
@@ -44,7 +44,7 @@ public static void doesntThrow() {
     }
 
     /**
-     * If UtBotSymbolicEngine meets invoke of this method in code,
+     * If {@link org.utbot.engine.Traverser} meets invoke of this method in code,
      * then it assumes that the specified object is parameter,
      * and need to be marked as parameter.
      * As address space of parameters in engine is non-positive, while
@@ -63,7 +63,7 @@ public static void parameter(Object[] objects) {
     }
 
     /**
-     * If UtBotSymbolicEngine meets invoke of this method in code,
+     * If {@link org.utbot.engine.Traverser} meets invoke of this method in code,
      * then it starts concrete execution from this point.
      */
     public static void executeConcretely() {

utbot-framework/src/main/java/org/utbot/engine/overrides/collections/UtArrayList.java

@@ -28,7 +28,7 @@
 
 
 /**
- * Class represents hybrid implementation (java + engine instructions) of List interface for UtBotSymbolicEngine.
+ * Class represents hybrid implementation (java + engine instructions) of List interface for {@link org.utbot.engine.Traverser}.
  * <p>
  * Implementation is based on org.utbot.engine.overrides.collections.RangeModifiableArray.
  * Should behave similar to {@link java.util.ArrayList}.

utbot-framework/src/main/java/org/utbot/engine/overrides/collections/UtHashMap.java

@@ -23,7 +23,7 @@
 
 
 /**
- * Class represents hybrid implementation (java + engine instructions) of Map interface for UtBotSymbolicEngine.
+ * Class represents hybrid implementation (java + engine instructions) of Map interface for {@link org.utbot.engine.Traverser}.
  * <p>
  * Implementation is based on using org.utbot.engine.overrides.collections.RangeModifiableArray as keySet
  * and org.utbot.engine.overrides.collections.UtArray as associative array from keys to values.

utbot-framework/src/main/java/org/utbot/engine/overrides/collections/UtHashSet.java

@@ -20,7 +20,7 @@
 import static org.utbot.engine.overrides.UtOverrideMock.visit;
 
 /**
- * Class represents hybrid implementation (java + engine instructions) of Set interface for UtBotSymbolicEngine.
+ * Class represents hybrid implementation (java + engine instructions) of Set interface for {@link org.utbot.engine.Traverser}.
  * <p>
  * Implementation is based on RangedModifiableArray, and all operations are linear.
  * Should behave similar to

utbot-framework/src/main/java/org/utbot/engine/overrides/collections/UtOptional.java

@@ -13,7 +13,7 @@
 import static org.utbot.engine.overrides.UtOverrideMock.visit;
 
 /**
- * Class represents hybrid implementation (java + engine instructions) of Optional for UtBotSymbolicEngine.
+ * Class represents hybrid implementation (java + engine instructions) of Optional for {@link org.utbot.engine.Traverser}.
  * <p>
  * Should behave the same as {@link java.util.Optional}.
  * @see org.utbot.engine.OptionalWrapper

utbot-framework/src/main/java/org/utbot/engine/overrides/collections/UtOptionalDouble.java

@@ -11,7 +11,7 @@
 import static org.utbot.engine.overrides.UtOverrideMock.visit;
 
 /**
- * Class represents hybrid implementation (java + engine instructions) of OptionalDouble for UtBotSymbolicEngine.
+ * Class represents hybrid implementation (java + engine instructions) of OptionalDouble for {@link org.utbot.engine.Traverser}.
  * <p>
  * Should behave the same as {@link java.util.OptionalDouble}.
  * @see org.utbot.engine.OptionalWrapper

utbot-framework/src/main/java/org/utbot/engine/overrides/collections/UtOptionalInt.java

@@ -11,7 +11,7 @@
 import static org.utbot.engine.overrides.UtOverrideMock.visit;
 
 /**
- * Class represents hybrid implementation (java + engine instructions) of OptionalInt for UtBotSymbolicEngine.
+ * Class represents hybrid implementation (java + engine instructions) of OptionalInt for {@link org.utbot.engine.Traverser}.
  * <p>
  * Should behave the same as {@link java.util.OptionalInt}.
  * @see org.utbot.engine.OptionalWrapper

utbot-framework/src/main/java/org/utbot/engine/overrides/collections/UtOptionalLong.java

@@ -10,7 +10,7 @@
 import static org.utbot.engine.overrides.UtOverrideMock.visit;
 
 /**
- * Class represents hybrid implementation (java + engine instructions) of Optional for UtBotSymbolicEngine.
+ * Class represents hybrid implementation (java + engine instructions) of Optional for {@link org.utbot.engine.Traverser}.
  * <p>
  * Should behave the same as {@link java.util.Optional}.
  * @see org.utbot.engine.OptionalWrapper