Create a wrapper exception for UnexpectedElementException

src/main/java/com/github/zafarkhaja/semver/UnexpectedCharacterException.java

@@ -0,0 +1,94 @@
+/*
+ * The MIT License
+ *
+ * Copyright 2014 Zafar Khaja <zafarkhaja@gmail.com>.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package com.github.zafarkhaja.semver;
+
+import com.github.zafarkhaja.semver.VersionParser.CharType;
+import com.github.zafarkhaja.semver.util.UnexpectedElementException;
+import java.util.Arrays;
+
+/**
+ * Thrown when attempting to consume a character of unexpected types.
+ *
+ * This exception is a wrapper exception extending {@code ParseException}.
+ *
+ * @author Zafar Khaja <zafarkhaja@gmail.com>
+ * @since 0.8.0
+ */
+public class UnexpectedCharacterException extends ParseException {
+
+    /**
+     * The unexpected character.
+     */
+    private final Character unexpected;
+
+    /**
+     * The array of expected character types.
+     */
+    private final CharType[] expected;
+
+    /**
+     * Constructs a {@code UnexpectedCharacterException} instance
+     * with the unexpected character and the expected types.
+     *
+     * @param cause the wrapped exception
+     */
+    UnexpectedCharacterException(UnexpectedElementException cause) {
+        unexpected = (Character) cause.getUnexpectedElement();
+        expected = (CharType[]) cause.getExpectedElementTypes();
+    }
+
+    /**
+     * Gets the unexpected character.
+     *
+     * @return the unexpected character
+     */
+    Character getUnexpectedCharacter() {
+        return unexpected;
+    }
+
+    /**
+     * Gets the expected character types.
+     *
+     * @return an array of expected character types
+     */
+    CharType[] getExpectedCharTypes() {
+        return expected;
+    }
+
+    /**
+     * Returns the string representation of this exception
+     * containing the information about the unexpected
+     * element and, if available, about the expected types.
+     *
+     * @return the string representation of this exception
+     */
+    @Override
+    public String toString() {
+        String message = "Unexpected character '" + unexpected + "'";
+        if (expected.length > 0) {
+            message += ", expecting '" + Arrays.toString(expected) + "'";
+        }
+        return message;
+    }
+}

src/main/java/com/github/zafarkhaja/semver/util/UnexpectedElementException.java

@@ -57,6 +57,24 @@ public class UnexpectedElementException extends RuntimeException {
         this.expected = expected;
     }
 
+    /**
+     * Gets the unexpected element.
+     *
+     * @return the unexpected element
+     */
+    public Object getUnexpectedElement() {
+        return unexpected;
+    }
+
+    /**
+     * Gets the expected element types.
+     *
+     * @return an array of expected element types
+     */
+    public ElementType<?>[] getExpectedElementTypes() {
+        return expected;
+    }
+
     /**
      * Returns the string representation of this exception
      * containing the information about the unexpected