Revise public- and internal API

Due to the relations between the changes it is necessary to keep those
in one commit which are explained in detail below.

The main change of this revise is the clean rewrite of the internal API
logic.

Public API breaking changes:

* All parameterized constructors have been removed due to the already
provided interfaces through the Hashids.Builder class. It provides
methods to achieve the same instance configuration, an instance with
the default interoperable configurations is still available through the
default constructor or by using default constructed builder instance.
* The Hashids.Builder methods "minHashLength(int) : Builder" has been renamed to
"minLength(int) : Builder" to adapt to the the builder methods naming style.
* The methods
  * encodeToString(long...) : String
  * encodeToString(int...) : String
  * decodeLongNumbers(String) : long[]
  * decodeIntegerNumbers(String) : int[]
  are unnecessary now due to the removement of the "Hashid" class and
  have also been removed.

The internal API has been redesigned and rewritten from scratch
regarding optimizations for Java 8, reduction of complexity, performance
and the new code style guide conventions.

Internal API changes:

* The private main logic methods "doEncode(long...)" and
"doDecode(String, String)" have been removed and rewritten from scratch
into the associated public API methods.
* The private method "consistentShuffle(String, String) : String" has
been rewritten from scratch and renamed to "shuffle(char[], char[]) :
char[]".
* The private methods "hash(long, String)" and "unhash(String, String)"
have been rewritten from scratch and renamed to
"transform(long, char[], StringBuilder, int)" and
"transform(char[], char"])".
* The primary algorithm logic, which was mainly implemented in the
"doEncode" and "doDecode" private methods, has been rewritten from
scratch and modularized into the new methods
"deriveNewAlphabet(char[], char[], char) : char[]" and
"filterSeparators(char[], char[]) : char[]".
* The private support methods "toArray(List<Long>) : long[]" and
"isEmpty(String) : boolean" have been removed.

The new "HashidsFeature" enum contains constants for various
features which can be enabled per instance through the Hashids.Builder
method "features(HashidFeature) : Builder".

Next to the changes listed above the public API now provides the
"decodeOne(String) : Optional<Long>" method to simplify the use-case
where the amount of resulting numbers is known before to handle the
return value as single value instead of an array.
This improves the prevention of an ArrayIndexOutOfBounceException when
the user tries to access an non-existent array index due to an failed
encoding- or decoding.

All unit tests have also been rewritten from scratch to match the new
API and include as much use-cases as possible and increase the code
coverage.

The interoperability tests run against the latest version of the
reference implementation "hashids.js". The script is loaded by using
thge maven-frontend-plugin which installs NodeJS locally and runs NPM
to install all dependencies defined in the package.json. The
parameterized "InteropHashidsTest" class compares the results of both
algorithms to ensure interoperability.

GH-9

Author: arcticicestudio

.idea/runConfigurations/Interop_Tests.xml

@@ -24,6 +24,6 @@ notifications:
     on_success: never
     on_failure: change
 before_script: mvn --version
-script: mvn -B clean verify -P code-coverage
+script: mvn -B clean verify -P node,code-coverage
 after_success:
   - bash <(curl -s https://codecov.io/bash)

.idea/runConfigurations/Unit_Tests.xml

@@ -27,5 +27,5 @@ test:
     - mkdir -p $CIRCLE_TEST_REPORTS/junit/
     - find . -type f -regex ".*/target/surefire-reports/.*xml" -exec cp {} $CIRCLE_TEST_REPORTS/junit/ \;
   override:
-    - mvn clean verify -P code-coverage
+    - mvn -B clean verify -P node,code-coverage
     - find . -type f -regextype posix-egrep -regex ".*/target/(.*asc|.*jar|.*md5|.*pom|.*sha1)" -exec cp {} $CIRCLE_ARTIFACTS \;

.travis.yml

@@ -14,5 +14,7 @@
     <orderEntry type="sourceFolder" forTests="false" />
     <orderEntry type="library" scope="TEST" name="Maven: junit:junit:4.12" level="project" />
     <orderEntry type="library" scope="TEST" name="Maven: org.hamcrest:hamcrest-core:1.3" level="project" />
+    <orderEntry type="library" scope="TEST" name="Maven: org.hamcrest:hamcrest-junit:2.0.0.0" level="project" />
+    <orderEntry type="library" scope="TEST" name="Maven: org.hamcrest:java-hamcrest:2.0.0.0" level="project" />
   </component>
 </module>

circle.yml

@@ -0,0 +1,16 @@
+{
+  "name": "icecore-hashids",
+  "version": "0.3.0",
+  "private": true,
+  "description": "A lightweight generator for short, unique, non-sequential and decodable Hashids from positive unsigned (long) integer numbers.",
+  "author": {
+    "name": "Arctic Ice Studio",
+    "url": "http://arcticicestudio.com"
+  },
+  "license": "Apache 2.0",
+  "dependencies": {},
+  "devDependencies": {
+    "hashids": "1.1.1"
+  },
+  "scripts": {}
+}

icecore-hashids.iml

@@ -71,10 +71,10 @@
     <java.version>1.8</java.version>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <maven.version.min>3.0.4</maven.version.min>
-
     <checkstyle.version>8.0</checkstyle.version>
     <junit.version>4.12</junit.version>
-    <hamcrest.version>1.3</hamcrest.version>
+    <hamcrest.version>2.0.0.0</hamcrest.version>
+    <node.version>v8.2.1</node.version>
   </properties>
 
   <scm>
@@ -99,7 +99,7 @@
 
     <dependency>
       <groupId>org.hamcrest</groupId>
-      <artifactId>hamcrest-core</artifactId>
+      <artifactId>hamcrest-junit</artifactId>
       <version>${hamcrest.version}</version>
       <scope>test</scope>
     </dependency>
@@ -286,6 +286,54 @@
   </pluginRepositories>
 
   <profiles>
+    <profile>
+      <id>node</id>
+      <build>
+        <plugins>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-clean-plugin</artifactId>
+            <configuration>
+              <filesets>
+                <fileset>
+                  <directory>node_modules</directory>
+                </fileset>
+              </filesets>
+            </configuration>
+          </plugin>
+
+          <plugin>
+            <groupId>com.github.eirslett</groupId>
+            <artifactId>frontend-maven-plugin</artifactId>
+            <version>1.5</version>
+            <executions>
+              <execution>
+                <id>install-node-and-npm</id>
+                <goals>
+                  <goal>install-node-and-npm</goal>
+                </goals>
+                <configuration>
+                  <nodeVersion>${node.version}</nodeVersion>
+                  <installDirectory>${project.build.directory}</installDirectory>
+                </configuration>
+              </execution>
+              <execution>
+                <id>npm install</id>
+                <goals>
+                  <goal>npm</goal>
+                </goals>
+                <phase>generate-resources</phase>
+                <configuration>
+                  <installDirectory>${project.build.directory}</installDirectory>
+                  <arguments>install</arguments>
+                </configuration>
+              </execution>
+            </executions>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
+
     <profile>
       <id>code-coverage</id>
       <build>
@@ -317,15 +365,15 @@
       <id>jfrog</id>
       <distributionManagement>
         <downloadUrl>https://github.com/arcticicestudio/icecore-hashids</downloadUrl>
-          <snapshotRepository>
-            <id>bintray</id>
-            <name>OSS JFrog</name>
-            <url>http://oss.jfrog.org/artifactory/oss-snapshot-local</url>
-          </snapshotRepository>
+        <snapshotRepository>
+          <id>bintray</id>
+          <name>OSS JFrog</name>
+          <url>http://oss.jfrog.org/artifactory/oss-snapshot-local</url>
+        </snapshotRepository>
         <repository>
-           <id>bintray</id>
-           <name>JFrog Bintray</name>
-           <url>https://api.bintray.com/maven/arcticicestudio/IceCore/icecore-hashids/;publish=1</url>
+          <id>bintray</id>
+          <name>JFrog Bintray</name>
+          <url>https://api.bintray.com/maven/arcticicestudio/IceCore/icecore-hashids/;publish=1</url>
         </repository>
       </distributionManagement>
     </profile>