com.joyzl.codec.DataOutput Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of odbs Show documentation
Java对象序列化，同时支持二进制和JSON格式
The newest version!
/*-
 * www.joyzl.net
 * 中翌智联（重庆）科技有限公司
 * Copyright © JOY-Links Company. All rights reserved.
 */
package com.joyzl.codec;

import java.io.IOException;
import java.math.BigDecimal;
import java.math.BigInteger;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.util.Date;

/**
 * 数据编码为字节
 * 
 *  * VALUE: 0x76543210
 * WRITE: 0 ~ 3
 *  0  1  2  3
 * +--+--+--+--+
 * |76|54|32|10|
 * +--+--+--+--+
 * 
 * 
 * @author ZhangXi
 * @date 2023年7月28日
 */
public interface DataOutput extends java.io.DataOutput {

	@Override
	default void write(int b) throws IOException {
		writeByte((byte) b);
	}

	@Override
	default void write(byte[] values) throws IOException {
		for (int index = 0; index < values.length; index++) {
			writeByte(values[index]);
		}
	}

	@Override
	default void write(byte[] values, int offset, int length) throws IOException {
		for (; length > 0; offset++, length--) {
			writeByte(values[offset]);
		}
	}

	////////////////////////////////////////////////////////////////////////////////

	@Override
	void writeByte(int b) throws IOException;

	default void writeByte(byte value) throws IOException {
		writeByte((int) value);
	}

	@Override
	default void writeBoolean(boolean value) throws IOException {
		writeByte(value ? 1 : 0);
	}

	@Override
	default void writeShort(int value) throws IOException {
		writeShort((short) value);
	}

	void writeShort(short value) throws IOException;

	@Override
	void writeInt(int value) throws IOException;

	@Override
	void writeLong(long value) throws IOException;

	@Override
	void writeFloat(float value) throws IOException;

	@Override
	void writeDouble(double value) throws IOException;

	/** 写入integer值(变长),1~4 Byte, 8~32 Bit */
	default void writeVarint(int value) throws IOException {
		while ((value & ~0x7F) != 0) {
			writeByte((value & 0x7F) | 0x80);
			value >>>= 7;
		}
		writeByte(value);
	}

	/** 写入long值(变长),1~4 Byte, 8~64 Bit */
	default void writeVarlong(long value) throws IOException {
		while ((value & ~0x7FL) != 0) {
			writeByte(((int) value & 0x7F) | 0x80);
			value >>>= 7;
		}
		writeByte((int) value);
	}

	/** 写入decimal值,n Byte, n*8 Bit */
	default void writeDecimal(BigDecimal value) throws IOException {
		BigInteger theInt = value.unscaledValue();
		byte[] bytes = theInt.toByteArray();
		writeByte(bytes.length);
		write(bytes);
		writeByte(value.scale());
	}

	/** 写入Date值,8 Byte */
	default void writeDate(Date value) throws IOException {
		writeLong(value.getTime());
	}

	/** 写入LocalTime值,1~7 Byte */
	default void writeLocalTime(LocalTime value) throws IOException {
		// 参考:LocalTime.writeExternal(DataOutput out);
		int hour = value.getHour();
		int minute = value.getMinute();
		int second = value.getSecond();
		int nano = value.getNano();
		if (nano == 0) {
			if (second == 0) {
				if (minute == 0) {
					writeByte(~hour);
				} else {
					writeByte(hour);
					writeByte(~minute);
				}
			} else {
				writeByte(hour);
				writeByte(minute);
				writeByte(~second);
			}
		} else {
			writeByte(hour);
			writeByte(minute);
			writeByte(second);
			writeInt(nano);
		}
	}

	/** 写入LocalDate值,6 Byte */
	default void writeLocalDate(LocalDate value) throws IOException {
		// 参考:LocalDate.writeExternal(DataOutput out);
		writeInt(value.getYear());
		writeByte(value.getMonthValue());
		writeByte(value.getDayOfMonth());
	}

	/** 写入LocalDateTime值,7~13 Byte */
	default void writeLocalDateTime(LocalDateTime value) throws IOException {
		// 参考:LocalDateTime.writeExternal(DataOutput out);
		writeLocalDate(value.toLocalDate());
		writeLocalTime(value.toLocalTime());
	}

	@Override
	default void writeChar(int value) throws IOException {
		writeChar((char) value);
	}

	/** 写入char值,2 Byte, 16 Bit */
	default void writeChar(char value) throws IOException {
		// 参考:https://www.unicode.org/versions/Unicode15.0.0/
		writeVarint(value);
	}

	@Override
	default void writeChars(String value) throws IOException {
		writeChars((CharSequence) value);
	}

	/**
	 * 写入CharSequence值,无前导数量
	 * 
	 * @see #writeChar(char)
	 */
	default void writeChars(CharSequence value) throws IOException {
		for (int index = 0; index < value.length(); index++) {
			writeChar(value.charAt(index));
		}
	}

	/** 写入String值,具有前导数量,n Byte */
	default void writeString(CharSequence value) throws IOException {
		writeVarint(value.length());
		writeChars(value);
	}

	/** 写入ASCII值,1 Byte, 8 Bit */
	default void writeASCII(char value) throws IOException {
		writeByte(value);
	}

	/** 写入ASCII值,无前导数量 */
	default void writeASCIIs(CharSequence value) throws IOException {
		for (int index = 0; index < value.length(); index++) {
			writeASCII(value.charAt(index));
		}
	}

	/** 写入ASCII String值,具有前导长度,n Byte */
	default void writeASCIIString(CharSequence value) throws IOException {
		writeVarint(value.length());
		writeASCIIs(value);
	}

	@Override
	@Deprecated
	default void writeBytes(String s) {
		throw new UnsupportedOperationException();
	}

	@Override
	@Deprecated
	default void writeUTF(String s) {
		throw new UnsupportedOperationException();
	}
}