BaseNCodec (langx-java 3.3.2 API)

java.lang.Object
- com.jn.langx.codec.BaseNCodec

所有已实现的接口:

BinaryDecoder, BinaryEncoder, Decoder, Encoder

直接已知子类:

Base64
```
public abstract class BaseNCodec
extends Object
implements BinaryEncoder, BinaryDecoder
```
Abstract superclass for Base-N encoders and decoders.

This class is thread-safe.

嵌套类概要

嵌套类
限定符和类型类和说明

protected static class BaseNCodec.Context
Holds thread context so classes can be thread-safe.

嵌套类
限定符和类型	类和说明
`protected static class`	`BaseNCodec.Context` Holds thread context so classes can be thread-safe.

字段概要

字段
限定符和类型	字段和说明
`protected int`	`lineLength` Chunksize for encoding.
`protected static int`	`MASK_8BITS` Mask used to extract 8 bits, used in decoding bytes
`static int`	`MIME_CHUNK_SIZE` MIME chunk size per RFC 2045 section 6.8.
`protected byte`	`pad`
`protected byte`	`PAD` 已过时。 Use `pad`. Will be removed in 2.0.
`protected static byte`	`PAD_DEFAULT` Byte used to pad output.
`static int`	`PEM_CHUNK_SIZE` PEM chunk size per RFC 1421 section 4.3.2.4.

构造器概要

构造器
限定符	构造器和说明
`protected`	`BaseNCodec(int unencodedBlockSize, int encodedBlockSize, int lineLength, int chunkSeparatorLength)` Note `lineLength` is rounded down to the nearest multiple of `encodedBlockSize` If `chunkSeparatorLength` is zero, then chunking is disabled.
`protected`	`BaseNCodec(int unencodedBlockSize, int encodedBlockSize, int lineLength, int chunkSeparatorLength, byte pad)` Note `lineLength` is rounded down to the nearest multiple of `encodedBlockSize` If `chunkSeparatorLength` is zero, then chunking is disabled.

方法概要

所有方法静态方法实例方法抽象方法具体方法
限定符和类型	方法和说明
`protected boolean`	`containsAlphabetOrPad(byte[] arrayOctet)` Tests a given byte array to see if it contains any characters within the alphabet or PAD.
`byte[]`	`decode(byte[] pArray)` Decodes a byte[] containing characters in the Base-N alphabet.
`protected abstract void`	`decode(byte[] pArray, int i, int length, BaseNCodec.Context context)`
`Object`	`decode(Object obj)` Decodes an Object using the Base-N algorithm.
`byte[]`	`decode(String pArray)` Decodes a String containing characters in the Base-N alphabet.
`byte[]`	`encode(byte[] pArray)` Encodes a byte[] containing binary data, into a byte[] containing characters in the alphabet.
`byte[]`	`encode(byte[] pArray, int offset, int length)` Encodes a byte[] containing binary data, into a byte[] containing characters in the alphabet.
`protected abstract void`	`encode(byte[] pArray, int i, int length, BaseNCodec.Context context)`
`Object`	`encode(Object obj)` Encodes an Object using the Base-N algorithm.
`String`	`encodeAsString(byte[] pArray)` Encodes a byte[] containing binary data, into a String containing characters in the appropriate alphabet.
`String`	`encodeToString(byte[] pArray)` Encodes a byte[] containing binary data, into a String containing characters in the Base-N alphabet.
`protected byte[]`	`ensureBufferSize(int size, BaseNCodec.Context context)` Ensure that the buffer has room for `size` bytes
`protected int`	`getDefaultBufferSize()` Get the default buffer size.
`long`	`getEncodedLength(byte[] pArray)` Calculates the amount of space needed to encode the supplied array.
`protected abstract boolean`	`isInAlphabet(byte value)` Returns whether or not the `octet` is in the current alphabet.
`boolean`	`isInAlphabet(byte[] arrayOctet, boolean allowWSPad)` Tests a given byte array to see if it contains only valid characters within the alphabet.
`boolean`	`isInAlphabet(String basen)` Tests a given String to see if it contains only valid characters within the alphabet.
`protected static boolean`	`isWhiteSpace(byte byteToCheck)` Checks if a byte value is whitespace or not.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - MIME_CHUNK_SIZE
```
public static final int MIME_CHUNK_SIZE
```
    MIME chunk size per RFC 2045 section 6.8.
    
    The 76 character limit does not count the trailing CRLF, but counts all other characters, including any equal signs.
    
    另请参阅:
    
    RFC 2045 section 6.8, 常量字段值
  - PEM_CHUNK_SIZE
```
public static final int PEM_CHUNK_SIZE
```
    PEM chunk size per RFC 1421 section 4.3.2.4.
    
    The 64 character limit does not count the trailing CRLF, but counts all other characters, including any equal signs.
    
    另请参阅:
    
    RFC 1421 section 4.3.2.4, 常量字段值
  - MASK_8BITS
```
protected static final int MASK_8BITS
```
    Mask used to extract 8 bits, used in decoding bytes
    
    另请参阅:
    
    常量字段值
  - PAD_DEFAULT
```
protected static final byte PAD_DEFAULT
```
    Byte used to pad output.
    
    另请参阅:
    
    常量字段值
  - PAD
```
protected final byte PAD
```
    已过时。 Use pad. Will be removed in 2.0.
    
    另请参阅:
    
    常量字段值
  - pad
```
protected final byte pad
```
  - lineLength
```
protected final int lineLength
```
    Chunksize for encoding. Not used when decoding. A value of zero or less implies no chunking of the encoded data. Rounded down to nearest multiple of encodedBlockSize.
- 构造器详细资料
  - BaseNCodec
```
protected BaseNCodec(int unencodedBlockSize,
                     int encodedBlockSize,
                     int lineLength,
                     int chunkSeparatorLength)
```
    Note lineLength is rounded down to the nearest multiple of encodedBlockSize If chunkSeparatorLength is zero, then chunking is disabled.
    
    参数:
    
    unencodedBlockSize - the size of an unencoded block (e.g. Base64 = 3)
    
    encodedBlockSize - the size of an encoded block (e.g. Base64 = 4)
    
    lineLength - if > 0, use chunking with a length lineLength
    
    chunkSeparatorLength - the chunk separator length, if relevant
  - BaseNCodec
```
protected BaseNCodec(int unencodedBlockSize,
                     int encodedBlockSize,
                     int lineLength,
                     int chunkSeparatorLength,
                     byte pad)
```
    Note lineLength is rounded down to the nearest multiple of encodedBlockSize If chunkSeparatorLength is zero, then chunking is disabled.
    
    参数:
    
    unencodedBlockSize - the size of an unencoded block (e.g. Base64 = 3)
    
    encodedBlockSize - the size of an encoded block (e.g. Base64 = 4)
    
    lineLength - if > 0, use chunking with a length lineLength
    
    chunkSeparatorLength - the chunk separator length, if relevant
    
    pad - byte used as padding byte.
- 方法详细资料
  - getDefaultBufferSize
```
protected int getDefaultBufferSize()
```
    Get the default buffer size. Can be overridden.
    
    返回:
    
    DEFAULT_BUFFER_SIZE
  - ensureBufferSize
```
protected byte[] ensureBufferSize(int size,
                                  BaseNCodec.Context context)
```
    Ensure that the buffer has room for size bytes
    
    参数:
    
    size - minimum spare space required
    
    context - the context to be used
    
    返回:
    
    the buffer
  - isWhiteSpace
```
protected static boolean isWhiteSpace(byte byteToCheck)
```
    Checks if a byte value is whitespace or not. Whitespace is taken to mean: space, tab, CR, LF
    
    参数:
    
    byteToCheck - the byte to check
    
    返回:
    
    true if byte is whitespace, false otherwise
  - encode
```
public Object encode(Object obj)
              throws EncoderException
```
    Encodes an Object using the Base-N algorithm. This method is provided in order to satisfy the requirements of the Encoder interface, and will throw an EncoderException if the supplied object is not of type byte[].
    
    指定者:
    
    encode 在接口中 Encoder
    
    参数:
    
    obj - Object to encode
    
    返回:
    
    An object (of type byte[]) containing the Base-N encoded data which corresponds to the byte[] supplied.
    
    抛出:
    
    EncoderException - if the parameter supplied is not of type byte[]
  - encodeToString
```
public String encodeToString(byte[] pArray)
```
    Encodes a byte[] containing binary data, into a String containing characters in the Base-N alphabet. Uses UTF8 encoding.
    
    参数:
    
    pArray - a byte array containing binary data
    
    返回:
    
    A String containing only Base-N character data
  - encodeAsString
```
public String encodeAsString(byte[] pArray)
```
    Encodes a byte[] containing binary data, into a String containing characters in the appropriate alphabet. Uses UTF8 encoding.
    
    参数:
    
    pArray - a byte array containing binary data
    
    返回:
    
    String containing only character data in the appropriate alphabet.
    This is a duplicate of encodeToString(byte[]); it was merged during refactoring.
  - decode
```
public Object decode(Object obj)
              throws DecoderException
```
    Decodes an Object using the Base-N algorithm. This method is provided in order to satisfy the requirements of the Decoder interface, and will throw a DecoderException if the supplied object is not of type byte[] or String.
    
    指定者:
    
    decode 在接口中 Decoder
    
    参数:
    
    obj - Object to decode
    
    返回:
    
    An object (of type byte[]) containing the binary data which corresponds to the byte[] or String supplied.
    
    抛出:
    
    DecoderException - if the parameter supplied is not of type byte[]
  - decode
```
public byte[] decode(String pArray)
```
    Decodes a String containing characters in the Base-N alphabet.
    
    参数:
    
    pArray - A String containing Base-N character data
    
    返回:
    
    a byte array containing binary data
  - decode
```
public byte[] decode(byte[] pArray)
```
    Decodes a byte[] containing characters in the Base-N alphabet.
    
    指定者:
    
    decode 在接口中 BinaryDecoder
    
    参数:
    
    pArray - A byte array containing Base-N character data
    
    返回:
    
    a byte array containing binary data
  - encode
```
public byte[] encode(byte[] pArray)
```
    Encodes a byte[] containing binary data, into a byte[] containing characters in the alphabet.
    
    指定者:
    
    encode 在接口中 BinaryEncoder
    
    参数:
    
    pArray - a byte array containing binary data
    
    返回:
    
    A byte array containing only the base N alphabetic character data
  - encode
```
public byte[] encode(byte[] pArray,
                     int offset,
                     int length)
```
    Encodes a byte[] containing binary data, into a byte[] containing characters in the alphabet.
    
    参数:
    
    pArray - a byte array containing binary data
    
    offset - initial offset of the subarray.
    
    length - length of the subarray.
    
    返回:
    
    A byte array containing only the base N alphabetic character data
  - encode
```
protected abstract void encode(byte[] pArray,
                               int i,
                               int length,
                               BaseNCodec.Context context)
```
  - decode
```
protected abstract void decode(byte[] pArray,
                               int i,
                               int length,
                               BaseNCodec.Context context)
```
  - isInAlphabet
```
protected abstract boolean isInAlphabet(byte value)
```
    Returns whether or not the octet is in the current alphabet. Does not allow whitespace or pad.
    
    参数:
    
    value - The value to test
    
    返回:
    
    true if the value is defined in the current alphabet, false otherwise.
  - isInAlphabet
```
public boolean isInAlphabet(byte[] arrayOctet,
                            boolean allowWSPad)
```
    Tests a given byte array to see if it contains only valid characters within the alphabet. The method optionally treats whitespace and pad as valid.
    
    参数:
    
    arrayOctet - byte array to test
    
    allowWSPad - if true, then whitespace and PAD are also allowed
    
    返回:
    
    true if all bytes are valid characters in the alphabet or if the byte array is empty; false, otherwise
  - isInAlphabet
```
public boolean isInAlphabet(String basen)
```
    Tests a given String to see if it contains only valid characters within the alphabet. The method treats whitespace and PAD as valid.
    
    参数:
    
    basen - String to test
    
    返回:
    
    true if all characters in the String are valid characters in the alphabet or if the String is empty; false, otherwise
    
    另请参阅:
    
    isInAlphabet(byte[], boolean)
  - containsAlphabetOrPad
```
protected boolean containsAlphabetOrPad(byte[] arrayOctet)
```
    Tests a given byte array to see if it contains any characters within the alphabet or PAD.
    Intended for use in checking line-ending arrays
    
    参数:
    
    arrayOctet - byte array to test
    
    返回:
    
    true if any byte is a valid character in the alphabet or PAD; false otherwise
  - getEncodedLength
```
public long getEncodedLength(byte[] pArray)
```
    Calculates the amount of space needed to encode the supplied array.
    
    参数:
    
    pArray - byte[] array which will later be encoded
    
    返回:
    
    amount of space needed to encoded the supplied array. Returns a long since a max-len array will require > Integer.MAX_VALUE

类 BaseNCodec

嵌套类概要

字段概要

构造器概要

方法概要

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

字段详细资料

MIME_CHUNK_SIZE

PEM_CHUNK_SIZE

MASK_8BITS

PAD_DEFAULT

PAD

pad

lineLength

构造器详细资料

BaseNCodec

BaseNCodec

方法详细资料

getDefaultBufferSize

ensureBufferSize

isWhiteSpace

encode

encodeToString

encodeAsString

decode

decode

decode

encode

encode

encode

decode

isInAlphabet

isInAlphabet

isInAlphabet

containsAlphabetOrPad

getEncodedLength