cn.gongler.util.bytes

类 BytesBuilder

java.lang.Object

cn.gongler.util.bytes.BytesBuilder

所有已实现的接口:

ToBytes

public class BytesBuilder
extends Object
implements ToBytes

字节数组构造器

从以下版本开始:

3.1

作者:

gongler

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	BytesBuilder.Builder

字段概要

字段

限定符和类型	字段和说明
protected byte[]	buf
protected int	initCapacity 初始容量，不够时会自动扩展
protected int	mark
int	nullValType
protected int	pos

构造器概要

构造器

限定符	构造器和说明
protected	BytesBuilder()
protected	BytesBuilder(int initCapacity)

方法概要

限定符和类型	方法和说明
protected BytesBuilder	_addByte(int byteVal)
protected BytesBuilder	_addBytes(byte[] buf, int from, int size)
BytesBuilder	addBcd(int byteCnt, BigInteger val)
BytesBuilder	addBcd(int byteCnt, long val)
BytesBuilder	addBcd(int byteCnt, String bcd) 处理BCD超过8字节的情况
BytesBuilder	addBit(boolean bitVal)
BytesBuilder	addBit(int bitVal)
BytesBuilder	addBitRepeat(boolean bitVal, int repeatTimes)
BytesBuilder	addBitRepeat(int bitVal, int repeatTimes)
BytesBuilder	addBits(CharSequence bitsStr)
BytesBuilder	addBits(int bitCnt, long val)
BytesBuilder	addBits(List<Boolean> bits)
BytesBuilder	addByte(Byte byteVal)
BytesBuilder	addByte(int byteVal) 添加1个字节
BytesBuilder	addByteBySupplier(int times, java.util.function.IntUnaryOperator mapper) 添加n个字节，字节值与序号相关。
BytesBuilder	addByteRepeat(int byteVal, int repeatTimes)
BytesBuilder	addBytes(byte[] bytes)
BytesBuilder	addBytes(Byte[] bytes)
BytesBuilder	addBytes(byte[] buf, int from, int size)
BytesBuilder	addBytes(Byte[] bytes, int from, int size)
BytesBuilder	addBytes(BytesBuildable item)
BytesBuilder	addBytes(BytesBuilder another)
BytesBuilder	addBytes(CharSequence hex)
BytesBuilder	addBytes(IBytesRange bytesRange)
BytesBuilder	addBytes(int byteCnt, byte[] bytes) 长截断；短右补齐
BytesBuilder	addBytes(int byteCnt, CharSequence hex)
BytesBuilder	addBytes(Iterable<BytesBuildable> items)
<T> BytesBuilder	addBytes(Iterable<T> list, java.util.function.Function<T,byte[]> mapper)
BytesBuilder	addBytes(List<ToBytes> items)
BytesBuilder	addBytes(java.util.stream.Stream<byte[]> stream)
<T> BytesBuilder	addBytes(T obj, java.util.function.Function<T,byte[]> mapper)
BytesBuilder	addBytes(ToBytes item) 也相当于Supplier
BytesBuilder	addBytesRefPrevious(java.util.function.Function<IBytesRange,byte[]> mapper) 根据已经输出的字节块计算后面的输出。
BytesBuilder	addByteStream(InputStream in)
BytesBuilder	addByteStream(java.util.stream.IntStream stream) IntStream.range(1, 10).forEach(System.out::println); IntStream.generate(Random.next()).forEach(System.out::println);
BytesBuilder	addByteStream(java.util.stream.Stream<Byte> stream)
BytesBuilder	addGbk(int byteCnt, CharSequence msg)
BytesBuilder	addHex(CharSequence hex)
BytesBuilder	addHex(int byteCnt, CharSequence hexNum) addNumByHex
BytesBuilder	addHex(int byteCntPerItem, Iterable<String> hexList)
BytesBuilder	addHex(Iterable<String> hexList)
<T> BytesBuilder	addHex(Iterable<T> list, java.util.function.Function<T,String> mapper)
BytesBuilder	addHex(java.util.stream.Stream<String> stream)
BytesBuilder	addHex(String... hexArray)
BytesBuilder	addInt(Integer value)
BytesBuilder	addLong(Long value)
BytesBuilder	addNum(int byteCnt, BigInteger value)
BytesBuilder	addNum(int byteCnt, BigInteger value, ByteOrder byteOrder)
BytesBuilder	addNum(int byteCnt, Integer value)
BytesBuilder	addNum(int byteCnt, long value) 默认大端字节顺序
BytesBuilder	addNum(int byteCnt, Long value)
BytesBuilder	addNum(int byteCnt, long value, ByteOrder byteOrder)
BytesBuilder	addNum(int byteCnt, Short value)
BytesBuilder	addNum(int byteCnt, String decode) 自动解码整数字符串。
BytesBuilder	addNum1(long value)
BytesBuilder	addNum2(long value)
BytesBuilder	addNum3(long value)
BytesBuilder	addNum4(long value)
BytesBuilder	addNum8(long value)
BytesBuilder	addNumBigEndian(int byteCnt, BigInteger value)
BytesBuilder	addNumBigEndian(int byteCnt, long value)
BytesBuilder	addNumLittleEndian(int byteCnt, BigInteger value)
BytesBuilder	addNumLittleEndian(int byteCnt, long value) 小端字节顺序
BytesBuilder	addNumPreviousCount(int byteCnt) 写入已经创建的字节数
BytesBuilder	addShort(Short value)
BytesBuilder	addString(int byteCnt, CharSequence msg)
BytesBuilder	addString(int byteCnt, CharSequence msg, Charset charset)
BytesBuilder	addUtf8(int byteCnt, CharSequence msg)
static BytesBuilder	bigEndian()
protected byte[]	buf()
ByteOrder	byteOrder()
BytesBuilder	byteOrder(ByteOrder byteOrder)
Charset	charset()
BytesBuilder	charset(Charset charset)
BytesBuilder	duplicate() 有时会遇到有的字节需要后面字节生成后才能确定要写什么值。
BytesBuilder	duplicate(int newPos)
BytesBuilder	exceptionIfNullVal()
protected BytesBuilder	fillValueAtPos(int byteValue)
BytesBuilder	forEach(IntByteConsumer consumer)
BytesBuilder	initCapacity(int initCapacity)
boolean	isBigEndian()
int	limited()
BytesBuilder	limited(int limited)
static BytesBuilder	littleEndian()
BytesBuilder	mark()
protected void	movePos(int byteCnt)
BytesBuilder	moveToMark()
BytesBuilder	nullValType(int nullValType)
static BytesBuilder	of()
BytesBuilder	placeHolderIfNullVal()
protected int	pos()
protected BytesBuilder	pos(int newPos)
protected void	prepareNextWriteBytes(int newBytes)
protected BytesBuilder	requireBitsFinished()
BytesBuilder	save(Path file)
BytesBuilder	save(String filename)
BytesBuilder	setBack(int backIndex, int byteVal) 只能修改游标之前的字节，用于逆序输出字节值。
BytesBuilder	setByte(int globalIndex, int byteVal) 允许用绝对位置修改值
BytesBuilder	setBytes(int globalIndex, byte[] block)
BytesBuilder	setBytes(int globalIndex, ToBytes item)
BytesBuilder	setNum(int globalIndex, int byteCnt, long val)
BytesBuilder	setString(int globalIndex, int byteCnt, CharSequence msg, Charset charset)
BytesBuilder	skip(int byteCnt)
BytesBuilder	slice(int byteCnt) 有时会遇到有的字节需要后面字节生成后才能确定要写什么值。
byte[]	toBytes()
IBytesRange	toBytesRange()
String	toHex()
int	toIntResult(int beginVal, IntByteOperator mapper) 计算校验位等
long	toLongResult(long beginVal, LongByteOperator mapper)
<T> T	toResult(java.util.function.Function<IBytesRange,T> mapper) 根据生成的bytes创建T
String	toString()
BytesBuilder	trace(java.util.function.Consumer<CharSequence> consumer)
BytesBuilder	trace(int postfix, java.util.function.Consumer<CharSequence> consumer)
BytesBuilder	trace(int prefix, int postfix, java.util.function.Consumer<CharSequence> consumer)

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

从接口继承的方法 cn.gongler.util.bytes.ToBytes

toHexMessage

字段详细资料

initCapacity

protected final int initCapacity

初始容量，不够时会自动扩展

buf

protected byte[] buf

pos

protected int pos

mark

protected int mark

nullValType

public int nullValType

构造器详细资料

BytesBuilder

protected BytesBuilder()

BytesBuilder

protected BytesBuilder(int initCapacity)

参数:

initCapacity - capacity

方法详细资料

of

public static BytesBuilder of()

littleEndian

public static BytesBuilder littleEndian()

bigEndian

public static BytesBuilder bigEndian()

initCapacity

public BytesBuilder initCapacity(int initCapacity)

buf

protected byte[] buf()

prepareNextWriteBytes

protected void prepareNextWriteBytes(int newBytes)

参数:

newBytes - 字节数

byteOrder

public BytesBuilder byteOrder(ByteOrder byteOrder)

byteOrder

public ByteOrder byteOrder()

isBigEndian

public boolean isBigEndian()

charset

public BytesBuilder charset(Charset charset)

charset

public Charset charset()

skip

public BytesBuilder skip(int byteCnt)

参数:

byteCnt - 字节数

返回:

this

movePos

protected void movePos(int byteCnt)

mark

public BytesBuilder mark()

moveToMark

public BytesBuilder moveToMark()

pos

protected int pos()

pos

protected BytesBuilder pos(int newPos)

setBack

public BytesBuilder setBack(int backIndex,
                            int byteVal)

只能修改游标之前的字节，用于逆序输出字节值。可以配合skip(bytes)方法使用。

参数:

backIndex - 回退字节数

byteVal - 值

返回:

this

limited

public BytesBuilder limited(int limited)

limited

public int limited()

exceptionIfNullVal

public BytesBuilder exceptionIfNullVal()

placeHolderIfNullVal

public BytesBuilder placeHolderIfNullVal()

nullValType

public BytesBuilder nullValType(int nullValType)

duplicate

@Unstable
public BytesBuilder duplicate()

有时会遇到有的字节需要后面字节生成后才能确定要写什么值。例：字节数、校验等。

返回:

副本

duplicate

@Unstable
public BytesBuilder duplicate(int newPos)

slice

@Unstable
public BytesBuilder slice(int byteCnt)

有时会遇到有的字节需要后面字节生成后才能确定要写什么值。例：字节数、校验等。

参数:

byteCnt - 跳过的字节数。也是副本最多可写的字节数

返回:

副本

fillValueAtPos

protected BytesBuilder fillValueAtPos(int byteValue)

setByte

public BytesBuilder setByte(int globalIndex,
                            int byteVal)

允许用绝对位置修改值

参数:

globalIndex - 全局索引

byteVal - 字节取值

返回:

this

setBytes

public BytesBuilder setBytes(int globalIndex,
                             byte[] block)

setBytes

public BytesBuilder setBytes(int globalIndex,
                             ToBytes item)

setNum

public BytesBuilder setNum(int globalIndex,
                           int byteCnt,
                           long val)

setString

@Unstable
public BytesBuilder setString(int globalIndex,
                                         int byteCnt,
                                         CharSequence msg,
                                         Charset charset)

trace

public BytesBuilder trace(java.util.function.Consumer<CharSequence> consumer)

trace

public BytesBuilder trace(int postfix,
                          java.util.function.Consumer<CharSequence> consumer)

trace

public BytesBuilder trace(int prefix,
                          int postfix,
                          java.util.function.Consumer<CharSequence> consumer)

_addByte

protected BytesBuilder _addByte(int byteVal)

_addBytes

protected BytesBuilder _addBytes(byte[] buf,
                                 int from,
                                 int size)

参数:

buf - 数组

from - 起始位置

size - 允许大于buf.length

返回:

this

addByte

public BytesBuilder addByte(int byteVal)

添加1个字节

参数:

byteVal - byte value

返回:

this

addByte

public BytesBuilder addByte(Byte byteVal)

addByteRepeat

public BytesBuilder addByteRepeat(int byteVal,
                                  int repeatTimes)

addBcd

public BytesBuilder addBcd(int byteCnt,
                           long val)

addBcd

public BytesBuilder addBcd(int byteCnt,
                           BigInteger val)

addBcd

public BytesBuilder addBcd(int byteCnt,
                           String bcd)

处理BCD超过8字节的情况

参数:

byteCnt - 字节数

bcd - BCD值

返回:

this

addShort

public BytesBuilder addShort(Short value)

参数:

value - value

返回:

this

addInt

public BytesBuilder addInt(Integer value)

参数:

value - value

返回:

this

addLong

public BytesBuilder addLong(Long value)

参数:

value - value

返回:

this

addNum

public BytesBuilder addNum(int byteCnt,
                           long value)

默认大端字节顺序

参数:

byteCnt - 字节数

value - 值

返回:

builder

addNum

public BytesBuilder addNum(int byteCnt,
                           Long value)

addNum

public BytesBuilder addNum(int byteCnt,
                           Integer value)

addNum

public BytesBuilder addNum(int byteCnt,
                           Short value)

addNum1

public BytesBuilder addNum1(long value)

addNum2

public BytesBuilder addNum2(long value)

addNum3

public BytesBuilder addNum3(long value)

addNum4

public BytesBuilder addNum4(long value)

addNum8

public BytesBuilder addNum8(long value)

addNumLittleEndian

public BytesBuilder addNumLittleEndian(int byteCnt,
                                       long value)

小端字节顺序

参数:

byteCnt - 字节数

value - 值

返回:

this

addNumBigEndian

public BytesBuilder addNumBigEndian(int byteCnt,
                                    long value)

addNum

public BytesBuilder addNum(int byteCnt,
                           long value,
                           ByteOrder byteOrder)

addNum

public BytesBuilder addNum(int byteCnt,
                           String decode)

自动解码整数字符串。可以参看Long::decode说明

参数:

byteCnt - 字节数

decode - "255", "0xFF", "#FF", "0b111111", "-12"

返回:

this

addNum

public BytesBuilder addNum(int byteCnt,
                           BigInteger value)

addNumLittleEndian

public BytesBuilder addNumLittleEndian(int byteCnt,
                                       BigInteger value)

addNumBigEndian

public BytesBuilder addNumBigEndian(int byteCnt,
                                    BigInteger value)

addNum

public BytesBuilder addNum(int byteCnt,
                           BigInteger value,
                           ByteOrder byteOrder)

addNumPreviousCount

@Unstable
public BytesBuilder addNumPreviousCount(int byteCnt)

写入已经创建的字节数

参数:

byteCnt - 字节数

返回:

this

addHex

public BytesBuilder addHex(int byteCnt,
                           CharSequence hexNum)

addNumByHex

参数:

byteCnt - 字节数

hexNum - HEX字符数可以不是偶数

返回:

this

addHex

public BytesBuilder addHex(CharSequence hex)

addHex

public BytesBuilder addHex(Iterable<String> hexList)

addHex

public BytesBuilder addHex(int byteCntPerItem,
                           Iterable<String> hexList)

参数:

byteCntPerItem - 单条统一字节数

hexList - 主要是String的List

返回:

this

addHex

public BytesBuilder addHex(java.util.stream.Stream<String> stream)

addHex

public BytesBuilder addHex(String... hexArray)

addHex

public <T> BytesBuilder addHex(Iterable<T> list,
                               java.util.function.Function<T,String> mapper)

addString

public BytesBuilder addString(int byteCnt,
                              CharSequence msg,
                              Charset charset)

addString

public BytesBuilder addString(int byteCnt,
                              CharSequence msg)

参数:

byteCnt - 正值：字节数，结尾用'\0'补齐;负值：用-n字节存放字节数;0长度：尾部追加'\0'。 注：如果希望写入的字符串没有头部长度项，也没有\0结尾，也没有固定长度。那么可以采用AddBytes(String.getBytes(),这是不需要关心长度)

msg - 字符串

返回:

this

addUtf8

public BytesBuilder addUtf8(int byteCnt,
                            CharSequence msg)

addGbk

public BytesBuilder addGbk(int byteCnt,
                           CharSequence msg)

addByteStream

public BytesBuilder addByteStream(InputStream in)

addByteStream

public BytesBuilder addByteStream(java.util.stream.IntStream stream)

IntStream.range(1, 10).forEach(System.out::println); IntStream.generate(Random.next()).forEach(System.out::println);

参数:

stream - IntStream

返回:

this

addByteStream

public BytesBuilder addByteStream(java.util.stream.Stream<Byte> stream)

addBytes

public BytesBuilder addBytes(byte[] buf,
                             int from,
                             int size)

参数:

buf - 数组

from - 数组中开始位置

size - 字节数.不能超过buf-from的长度

返回:

this

addBytes

public BytesBuilder addBytes(byte[] bytes)

参数:

bytes - 字节数组

返回:

this

addBytes

public BytesBuilder addBytes(int byteCnt,
                             byte[] bytes)

长截断；短右补齐

参数:

byteCnt - 字节数

bytes - 输出字节块

返回:

this

addBytes

public BytesBuilder addBytes(CharSequence hex)

addBytes

public BytesBuilder addBytes(int byteCnt,
                             CharSequence hex)

addBytes

public BytesBuilder addBytes(BytesBuilder another)

addBytes

public BytesBuilder addBytes(IBytesRange bytesRange)

addBytesRefPrevious

public BytesBuilder addBytesRefPrevious(java.util.function.Function<IBytesRange,byte[]> mapper)

根据已经输出的字节块计算后面的输出。例如后置的字节数、校验等

参数:

mapper - 映射

返回:

this

addBytes

public BytesBuilder addBytes(Byte[] bytes)

addBytes

public BytesBuilder addBytes(Byte[] bytes,
                             int from,
                             int size)

addBytes

public BytesBuilder addBytes(BytesBuildable item)

参数:

item - 提供者

返回:

this

addBytes

public BytesBuilder addBytes(Iterable<BytesBuildable> items)

addBytes

public BytesBuilder addBytes(ToBytes item)

也相当于Supplier

参数:

item - 对象

返回:

this

addBytes

public BytesBuilder addBytes(List<ToBytes> items)

addBytes

public <T> BytesBuilder addBytes(T obj,
                                 java.util.function.Function<T,byte[]> mapper)

addBytes

public <T> BytesBuilder addBytes(Iterable<T> list,
                                 java.util.function.Function<T,byte[]> mapper)

addBytes

public BytesBuilder addBytes(java.util.stream.Stream<byte[]> stream)

addBit

public BytesBuilder addBit(boolean bitVal)

addBitRepeat

public BytesBuilder addBitRepeat(boolean bitVal,
                                 int repeatTimes)

addBit

public BytesBuilder addBit(int bitVal)

addBitRepeat

public BytesBuilder addBitRepeat(int bitVal,
                                 int repeatTimes)

addBits

public BytesBuilder addBits(int bitCnt,
                            long val)

addBits

public BytesBuilder addBits(List<Boolean> bits)

addBits

public BytesBuilder addBits(CharSequence bitsStr)

requireBitsFinished

protected BytesBuilder requireBitsFinished()

addByteBySupplier

@Unstable
public BytesBuilder addByteBySupplier(int times,
                                                 java.util.function.IntUnaryOperator mapper)

添加n个字节，字节值与序号相关。方便生成不同的批量测试数据

参数:

times - 字节数

mapper - 映射

返回:

this

toBytes

public byte[] toBytes()

指定者:

toBytes 在接口中 ToBytes

返回:

bytes

toHex

public String toHex()

指定者:

toHex 在接口中 ToBytes

toBytesRange

public IBytesRange toBytesRange()

forEach

public BytesBuilder forEach(IntByteConsumer consumer)

toIntResult

public int toIntResult(int beginVal,
                       IntByteOperator mapper)

计算校验位等

参数:

beginVal - 初始值

mapper - 映射

返回:

结果

toLongResult

public long toLongResult(long beginVal,
                         LongByteOperator mapper)

toResult

public <T> T toResult(java.util.function.Function<IBytesRange,T> mapper)

根据生成的bytes创建T

类型参数:

T - 返回类型

参数:

mapper - 映射

返回:

返回值

save

public BytesBuilder save(Path file)

save

public BytesBuilder save(String filename)

toString

public String toString()

覆盖:

toString 在类中 Object