#44 added JBBPArraySizeLimiter into JBBPBitInputStream

Author: raydac

jbbp/src/main/java/com/igormaznitsa/jbbp/exceptions/JBBPReachedArraySizeLimitException.java

@@ -0,0 +1,35 @@
+package com.igormaznitsa.jbbp.exceptions;
+
+/**
+ * Exception thrown if reached limit of items for whole stream array.
+ *
+ * @since 2.1.0
+ */
+public class JBBPReachedArraySizeLimitException extends JBBPIOException {
+
+  private final int readSize;
+  private final int limitSize;
+
+  public JBBPReachedArraySizeLimitException(final String message, final int readSize,
+                                            final int limitSize) {
+    super(message);
+    this.readSize = readSize;
+    this.limitSize = limitSize;
+  }
+
+  public int getReadSize() {
+    return this.readSize;
+  }
+
+  public int getLimitSize() {
+    return this.limitSize;
+  }
+
+  @Override
+  public String toString() {
+    return JBBPReachedArraySizeLimitException.class.getSimpleName() + '{' +
+        "readSize=" + this.readSize +
+        ", limitSize=" + this.limitSize +
+        '}';
+  }
+}

jbbp/src/main/java/com/igormaznitsa/jbbp/io/JBBPArraySizeLimiter.java

@@ -0,0 +1,16 @@
+package com.igormaznitsa.jbbp.io;
+
+/**
+ * Interface describing an object which provides limit to read array items.
+ *
+ * @since 2.1.0
+ */
+@FunctionalInterface
+public interface JBBPArraySizeLimiter {
+  /**
+   * Get allowed size of array to read.
+   *
+   * @return 0 means no limit, positive value means allowed number of items with exception throwing if read more items, negative value means number of read values and stop read if exceeded.
+   */
+  int getArrayItemsLimit();
+}