add slice buffer

Author: xxlabaza

CHANGELOG.md

@@ -12,11 +12,12 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Add more tests.
 - Add `JavaDoc`.
 
-## [1.17.3](https://github.com/appulse-projects/utils-java/releases/tag/1.17.3) - 2020-02-25
+## [1.18.0](https://github.com/appulse-projects/utils-java/releases/tag/1.18.0) - 2020-02-25
 
 ### Added
 
-- A **read-only** implementation of `Bytes`.
+- A **read-only** implementation of `Bytes`;
+- Now it's possible to create a diffirent `slice`s of `Bytes`.
 
 ### Changed
 

pom.xml

@@ -24,7 +24,7 @@ limitations under the License.
 
   <groupId>io.appulse</groupId>
   <artifactId>utils-java</artifactId>
-  <version>1.17.3</version>
+  <version>1.18.0</version>
   <packaging>jar</packaging>
 
   <properties>
@@ -66,7 +66,7 @@ limitations under the License.
     <url>https://github.com/appulse-projects/utils-java</url>
     <connection>scm:git:https://github.com/appulse-projects/utils-java.git</connection>
     <developerConnection>scm:git:https://github.com/appulse-projects/utils-java.git</developerConnection>
-    <tag>1.17.3</tag>
+    <tag>1.18.0</tag>
   </scm>
 
   <distributionManagement>

src/main/java/io/appulse/utils/Bytes.java

@@ -133,7 +133,7 @@ static Bytes resizableArray (int initialSize) {
    *
    * @return the new {@link Bytes} read-only instance
    *
-   * @since 1.17.3
+   * @since 1.18.0
    */
   static Bytes readOnly (byte[] bytes) {
     val delegate = Bytes.wrap(bytes);
@@ -149,7 +149,7 @@ static Bytes readOnly (byte[] bytes) {
    *
    * @return the new {@link Bytes} read-only instance
    *
-   * @since 1.17.3
+   * @since 1.18.0
    */
   static Bytes readOnly (ByteBuffer buffer) {
     val delegate = Bytes.wrap(buffer);
@@ -165,7 +165,7 @@ static Bytes readOnly (ByteBuffer buffer) {
    *
    * @return the new {@link Bytes} read-only instance
    *
-   * @since 1.17.3
+   * @since 1.18.0
    */
   static Bytes readOnly (Bytes delegate) {
     return new BytesReadOnly(delegate);
@@ -1827,4 +1827,13 @@ static Bytes readOnly (Bytes delegate) {
    * @return the copy of the array that backs this buffer
    */
   byte[] arrayCopy ();
+
+  /**
+   * Creates a new {@link BytesSliceBuilder} instance for making the buffer's slize.
+   *
+   * @return the {@link BytesSliceBuilder} instance
+   *
+   * @since 1.18.0
+   */
+  BytesSliceBuilder slice ();
 }

src/main/java/io/appulse/utils/BytesAbstract.java

@@ -479,6 +479,11 @@ public byte[] arrayCopy () {
     return Arrays.copyOfRange(array(), 0, writerIndex());
   }
 
+  @Override
+  public BytesSliceBuilder slice () {
+    return new BytesSliceBuilder(this);
+  }
+
   @Override
   public String toString () {
     return new StringBuilder()

src/main/java/io/appulse/utils/BytesByteBuf.java

@@ -24,12 +24,14 @@
 
 import io.netty.buffer.ByteBuf;
 import io.netty.buffer.Unpooled;
+import lombok.EqualsAndHashCode;
 import lombok.NonNull;
 import lombok.experimental.FieldDefaults;
 import lombok.val;
 
 @SuppressWarnings("PMD.LinguisticNaming")
 @FieldDefaults(level = PRIVATE)
+@EqualsAndHashCode(callSuper = true)
 public final class BytesByteBuf extends BytesAbstract {
 
   public static BytesByteBuf allocate (int size) {

src/main/java/io/appulse/utils/BytesByteBuffer.java

@@ -22,12 +22,14 @@
 import java.nio.charset.Charset;
 import java.util.Arrays;
 
+import lombok.EqualsAndHashCode;
 import lombok.NonNull;
 import lombok.experimental.FieldDefaults;
 import lombok.val;
 
-@FieldDefaults(level = PRIVATE)
 @SuppressWarnings("PMD.LinguisticNaming")
+@FieldDefaults(level = PRIVATE)
+@EqualsAndHashCode(callSuper = true)
 class BytesByteBuffer extends BytesAbstract {
 
   static BytesByteBuffer copy (@NonNull ByteBuffer buffer) {

src/main/java/io/appulse/utils/BytesExtendableArray.java

@@ -18,8 +18,10 @@
 
 import java.util.Arrays;
 
+import lombok.EqualsAndHashCode;
 import lombok.val;
 
+@EqualsAndHashCode(callSuper = true)
 class BytesExtendableArray extends BytesFixedArray {
 
   /**

src/main/java/io/appulse/utils/BytesFixedArray.java

@@ -21,12 +21,14 @@
 import java.nio.charset.Charset;
 import java.util.Arrays;
 
+import lombok.EqualsAndHashCode;
 import lombok.NonNull;
 import lombok.experimental.FieldDefaults;
 import lombok.val;
 
-@FieldDefaults(level = PROTECTED)
 @SuppressWarnings("PMD.LinguisticNaming")
+@FieldDefaults(level = PROTECTED)
+@EqualsAndHashCode(callSuper = true)
 class BytesFixedArray extends BytesAbstract {
 
   static BytesFixedArray copy (@NonNull byte[] bytes) {
@@ -52,6 +54,10 @@ static BytesFixedArray copy (@NonNull byte[] bytes) {
     writerIndex(bytes.length);
   }
 
+  protected BytesFixedArray () {
+    super();
+  }
+
   @Override
   public boolean isAutoResizable () {
     return false;

src/main/java/io/appulse/utils/BytesReadOnly.java

@@ -21,12 +21,14 @@
 
 import java.nio.charset.Charset;
 
+import lombok.EqualsAndHashCode;
 import lombok.RequiredArgsConstructor;
 import lombok.experimental.FieldDefaults;
 import lombok.val;
 
 @SuppressWarnings("PMD.AvoidDuplicateLiterals")
 @FieldDefaults(level = PRIVATE)
+@EqualsAndHashCode(callSuper = true)
 @RequiredArgsConstructor(access = PACKAGE)
 class BytesReadOnly extends BytesAbstract {