/* * Copyright 2018, OpenCensus Authors * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package io.opencensus.trace; import io.opencensus.internal.Utils; import java.util.Arrays; final class BigendianEncoding { static final int LONG_BYTES = Long.SIZE / Byte.SIZE; static final int BYTE_BASE16 = 2; static final int LONG_BASE16 = BYTE_BASE16 * LONG_BYTES; private static final String ALPHABET = "0123456789abcdef"; private static final int ASCII_CHARACTERS = 128; private static final char[] ENCODING = buildEncodingArray(); private static final byte[] DECODING = buildDecodingArray(); private static char[] buildEncodingArray() { char[] encoding = new char[512]; for (int i = 0; i < 256; ++i) { encoding[i] = ALPHABET.charAt(i >>> 4); encoding[i | 0x100] = ALPHABET.charAt(i & 0xF); } return encoding; } private static byte[] buildDecodingArray() { byte[] decoding = new byte[ASCII_CHARACTERS]; Arrays.fill(decoding, (byte) -1); for (int i = 0; i < ALPHABET.length(); i++) { char c = ALPHABET.charAt(i); decoding[c] = (byte) i; } return decoding; } /** * Returns the {@code long} value whose big-endian representation is stored in the first 8 bytes * of {@code bytes} starting from the {@code offset}. * * @param bytes the byte array representation of the {@code long}. * @param offset the starting offset in the byte array. * @return the {@code long} value whose big-endian representation is given. * @throws IllegalArgumentException if {@code bytes} has fewer than 8 elements. */ static long longFromByteArray(byte[] bytes, int offset) { Utils.checkArgument(bytes.length >= offset + LONG_BYTES, "array too small"); return (bytes[offset] & 0xFFL) << 56 | (bytes[offset + 1] & 0xFFL) << 48 | (bytes[offset + 2] & 0xFFL) << 40 | (bytes[offset + 3] & 0xFFL) << 32 | (bytes[offset + 4] & 0xFFL) << 24 | (bytes[offset + 5] & 0xFFL) << 16 | (bytes[offset + 6] & 0xFFL) << 8 | (bytes[offset + 7] & 0xFFL); } /** * Stores the big-endian representation of {@code value} in the {@code dest} starting from the * {@code destOffset}. * * @param value the value to be converted. * @param dest the destination byte array. * @param destOffset the starting offset in the destination byte array. */ static void longToByteArray(long value, byte[] dest, int destOffset) { Utils.checkArgument(dest.length >= destOffset + LONG_BYTES, "array too small"); dest[destOffset + 7] = (byte) (value & 0xFFL); dest[destOffset + 6] = (byte) (value >> 8 & 0xFFL); dest[destOffset + 5] = (byte) (value >> 16 & 0xFFL); dest[destOffset + 4] = (byte) (value >> 24 & 0xFFL); dest[destOffset + 3] = (byte) (value >> 32 & 0xFFL); dest[destOffset + 2] = (byte) (value >> 40 & 0xFFL); dest[destOffset + 1] = (byte) (value >> 48 & 0xFFL); dest[destOffset] = (byte) (value >> 56 & 0xFFL); } /** * Returns the {@code long} value whose base16 representation is stored in the first 16 chars of * {@code chars} starting from the {@code offset}. * * @param chars the base16 representation of the {@code long}. * @param offset the starting offset in the {@code CharSequence}. */ static long longFromBase16String(CharSequence chars, int offset) { Utils.checkArgument(chars.length() >= offset + LONG_BASE16, "chars too small"); return (decodeByte(chars.charAt(offset), chars.charAt(offset + 1)) & 0xFFL) << 56 | (decodeByte(chars.charAt(offset + 2), chars.charAt(offset + 3)) & 0xFFL) << 48 | (decodeByte(chars.charAt(offset + 4), chars.charAt(offset + 5)) & 0xFFL) << 40 | (decodeByte(chars.charAt(offset + 6), chars.charAt(offset + 7)) & 0xFFL) << 32 | (decodeByte(chars.charAt(offset + 8), chars.charAt(offset + 9)) & 0xFFL) << 24 | (decodeByte(chars.charAt(offset + 10), chars.charAt(offset + 11)) & 0xFFL) << 16 | (decodeByte(chars.charAt(offset + 12), chars.charAt(offset + 13)) & 0xFFL) << 8 | (decodeByte(chars.charAt(offset + 14), chars.charAt(offset + 15)) & 0xFFL); } /** * Appends the base16 encoding of the specified {@code value} to the {@code dest}. * * @param value the value to be converted. * @param dest the destination char array. * @param destOffset the starting offset in the destination char array. */ static void longToBase16String(long value, char[] dest, int destOffset) { byteToBase16((byte) (value >> 56 & 0xFFL), dest, destOffset); byteToBase16((byte) (value >> 48 & 0xFFL), dest, destOffset + BYTE_BASE16); byteToBase16((byte) (value >> 40 & 0xFFL), dest, destOffset + 2 * BYTE_BASE16); byteToBase16((byte) (value >> 32 & 0xFFL), dest, destOffset + 3 * BYTE_BASE16); byteToBase16((byte) (value >> 24 & 0xFFL), dest, destOffset + 4 * BYTE_BASE16); byteToBase16((byte) (value >> 16 & 0xFFL), dest, destOffset + 5 * BYTE_BASE16); byteToBase16((byte) (value >> 8 & 0xFFL), dest, destOffset + 6 * BYTE_BASE16); byteToBase16((byte) (value & 0xFFL), dest, destOffset + 7 * BYTE_BASE16); } /** * Encodes the specified byte, and returns the encoded {@code String}. * * @param value the value to be converted. * @param dest the destination char array. * @param destOffset the starting offset in the destination char array. */ static void byteToBase16String(byte value, char[] dest, int destOffset) { byteToBase16(value, dest, destOffset); } /** * Decodes the specified two character sequence, and returns the resulting {@code byte}. * * @param chars the character sequence to be decoded. * @param offset the starting offset in the {@code CharSequence}. * @return the resulting {@code byte} * @throws IllegalArgumentException if the input is not a valid encoded string according to this * encoding. */ static byte byteFromBase16String(CharSequence chars, int offset) { Utils.checkArgument(chars.length() >= offset + 2, "chars too small"); return decodeByte(chars.charAt(offset), chars.charAt(offset + 1)); } private static byte decodeByte(char hi, char lo) { Utils.checkArgument(lo < ASCII_CHARACTERS && DECODING[lo] != -1, "invalid character " + lo); Utils.checkArgument(hi < ASCII_CHARACTERS && DECODING[hi] != -1, "invalid character " + hi); int decoded = DECODING[hi] << 4 | DECODING[lo]; return (byte) decoded; } private static void byteToBase16(byte value, char[] dest, int destOffset) { int b = value & 0xFF; dest[destOffset] = ENCODING[b]; dest[destOffset + 1] = ENCODING[b | 0x100]; } private BigendianEncoding() {} }