java.lang.Object
- java.lang.Enum<ChaosMode>
- - org.refcodes.security.alt.chaos.ChaosMode

All Implemented Interfaces:

Serializable, Comparable<ChaosMode>, org.refcodes.mixin.EncodedAccessor, ChaosOptions
```
public enum ChaosMode
extends Enum<ChaosMode>
implements ChaosOptions
```
The ChaosMode specifies the mode of operation of a ChaosKey when using Chaos-based encryption/decryption. Attention: Comparing a ChaosMode with a different implementation of the ChaosOptions only functions as expected when passing the ChaosMode as argument to that different ChaosOptions implementation's ChaosOptions.equals(Object) method as the Enum.equals(Object) method of the ChaosMode enumeration cannot be overwritten (the Enum.equals(Object) method of an enumeration cannot be overridden)! The ChaosOptionsBuilder is an implementation which's ChaosOptionsBuilder.equals(Object) evaluates equality correctly when being passed a ChaosMode element.

Nested Class Summary
- Nested classes/interfaces inherited from interface org.refcodes.mixin.EncodedAccessor
  org.refcodes.mixin.EncodedAccessor.EncodedBuilder<B extends org.refcodes.mixin.EncodedAccessor.EncodedBuilder<B>>, org.refcodes.mixin.EncodedAccessor.EncodedMutator, org.refcodes.mixin.EncodedAccessor.EncodedProperty

Enum Constant Summary

Enum Constants
Enum Constant	Description
`MUTATE`	A MUTATION operation as of `isMutateS()` is being applied.
`MUTATE_XOR`	Combination of the `XOR` mode alongside the `MUTATE` mode.
`NONE`	No additions are to be applied to the raw Chaos-based encryption/decryption.
`SALTED`	A SALTING operation as of `isSalted()` is being applied where applicable.
`SALTED_MUTATE`	Combination of the `SALTED` mode alongside the `MUTATE` mode.
`SALTED_MUTATE_XOR`	Combination of the `SALTED` mode as well as the `XOR` mode alongside the `MUTATE` mode.
`SALTED_XOR`	Combination of the `SALTED` mode alongside the `XOR` mode.
`XOR`	XOR obfuscation as of `isXorNext()` is being applied.

Field Summary
- Fields inherited from interface org.refcodes.security.alt.chaos.ChaosOptions
  ENCODED_LENGTH, OPTIONS_BIT_MUTATE_S, OPTIONS_BIT_RND_PREFIX, OPTIONS_BIT_SALTED, OPTIONS_BIT_XOR_NEXT, OPTIONS_BYTES, PREFIX_SIZE_BYZES

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`short`	`getRndPrefixSize()`	Sets the number of random bytes to be prefixed upon a PREFIX operation of decrypted (raw) data when encrypting with the accordingly configured `ChaosKey`: Prefixing with random bytes will cause the same (succeeding) decrypted (raw) data to be encrypted differently even when using the same `ChaosKey` configuration.
`boolean`	`isMutateS()`	Determines whether a MUTATION operation of the `ChaosKey`'s S value is to be applied with the previous byte value (before its encryption or zero 0 in case of the first value being processed), S then varies by +127 to -128 by each iteration: Nearly equal encrypted datasets will differ chaotically beginning with the the first occurrence of a different byte.
`boolean`	`isSalted()`	Determines whether an additional SALTING operation with an additional salting (random) `ChaosKey` is to be applied: The salting `ChaosKey`'s encoded bytes representation (as of `ChaosKey.getEncoded()`) is prefixed to the actual data which in a first pass is encoded with the this very salting `ChaosKey`.
`boolean`	`isXorNext()`	Determines whether an XOR obfuscation of the next byte value to be encrypted is to be applied with the previous byte value (before its encryption or zero 0 in case of the first value being processed).
`String`	`toString()`
`static ChaosMode`	`valueOf(String name)`	Returns the enum constant of this type with the specified name.
`static ChaosMode[]`	`values()`	Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.refcodes.security.alt.chaos.ChaosOptions
equals, getEncoded, hasRndPrefix, isFixedLength

- Enum Constant Detail
  - NONE
```
public static final ChaosMode NONE
```
    No additions are to be applied to the raw Chaos-based encryption/decryption.
  - MUTATE
```
public static final ChaosMode MUTATE
```
    A MUTATION operation as of isMutateS() is being applied.
  - XOR
```
public static final ChaosMode XOR
```
    XOR obfuscation as of isXorNext() is being applied.
  - MUTATE_XOR
```
public static final ChaosMode MUTATE_XOR
```
    Combination of the XOR mode alongside the MUTATE mode.
  - SALTED
```
public static final ChaosMode SALTED
```
    A SALTING operation as of isSalted() is being applied where applicable.
  - SALTED_MUTATE
```
public static final ChaosMode SALTED_MUTATE
```
    Combination of the SALTED mode alongside the MUTATE mode.
  - SALTED_XOR
```
public static final ChaosMode SALTED_XOR
```
    Combination of the SALTED mode alongside the XOR mode.
  - SALTED_MUTATE_XOR
```
public static final ChaosMode SALTED_MUTATE_XOR
```
    Combination of the SALTED mode as well as the XOR mode alongside the MUTATE mode.
- Method Detail
  - values
```
public static ChaosMode[] values()
```
    Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
    for (ChaosMode c : ChaosMode.values()) System.out.println(c);
    Returns:
    
    an array containing the constants of this enum type, in the order they are declared
  - valueOf
```
public static ChaosMode valueOf(String name)
```
    Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
    
    Parameters:
    
    name - the name of the enum constant to be returned.
    
    Returns:
    
    the enum constant with the specified name
    
    Throws:
    
    IllegalArgumentException - if this enum type has no constant with the specified name
    
    NullPointerException - if the argument is null
  - isXorNext
```
public boolean isXorNext()
```
    Determines whether an XOR obfuscation of the next byte value to be encrypted is to be applied with the previous byte value (before its encryption or zero 0 in case of the first value being processed). XOR does not seem to be too effective obfuscating similar encrypted data with the same ChaosKey, though for low capability devices it can be handy to add that little extra obfuscation to make it hard to interpolate between two similar but different messages. Disclaimer: Using this option "stand alone" in a ChaosKey not in combination with ChaosOptions.isSalted() either in this ChaosKey or in combination with another ChaosKey not completely closes the "comparison" attack vector (see "https://www.metacodes.pro/funcodes/blog/chaos-based_encryption_revisited")
    
    Specified by:
    
    isXorNext in interface ChaosOptions
    
    Returns:
    
    True in case XOR obfuscation is to be established.
  - isMutateS
```
public boolean isMutateS()
```
    Determines whether a MUTATION operation of the ChaosKey's S value is to be applied with the previous byte value (before its encryption or zero 0 in case of the first value being processed), S then varies by +127 to -128 by each iteration: Nearly equal encrypted datasets will differ chaotically beginning with the the first occurrence of a different byte. Disclaimer: Using this option "stand alone" in a ChaosKey not in combination with ChaosOptions.isSalted() either in this ChaosKey or in combination with another ChaosKey not completely closes the "comparison" attack vector (see "https://www.metacodes.pro/funcodes/blog/chaos-based_encryption_revisited")
    
    Specified by:
    
    isMutateS in interface ChaosOptions
    
    Returns:
    
    True in case ADD obfuscation is to be established.
  - isSalted
```
public boolean isSalted()
```
    Determines whether an additional SALTING operation with an additional salting (random) ChaosKey is to be applied: The salting ChaosKey's encoded bytes representation (as of ChaosKey.getEncoded()) is prefixed to the actual data which in a first pass is encoded with the this very salting ChaosKey. The salting ChaosKey encoded bytes representation as well as the succeeding initially encoded (salted) data then is encoded with the actual encryption ChaosKey, ensuring that the prefixed salting ChaosKey bytes are encoded. Decryption then is applied in reverse order. Currently only the ChaosEncryptionOutputStream and the ChaosDecryptionInputStream support salting! The ChaosEncrypter and ChaosDecrypter ignore this option!
    
    Specified by:
    
    isSalted in interface ChaosOptions
    
    Returns:
    
    True in case SALTING is to be established.
  - getRndPrefixSize
```
public short getRndPrefixSize()
```
    Sets the number of random bytes to be prefixed upon a PREFIX operation of decrypted (raw) data when encrypting with the accordingly configured ChaosKey: Prefixing with random bytes will cause the same (succeeding) decrypted (raw) data to be encrypted differently even when using the same ChaosKey configuration. Valid values range from {1..256} representable by one byte as of {0x00..0xFF}. Disclaimer: Using this option "stand alone" in a ChaosKey not in combination with ChaosOptions.isSalted() either in this ChaosKey or in combination with another ChaosKey not close by any means the "comparison" attack vector (see "https://www.metacodes.pro/funcodes/blog/chaos-based_encryption_revisited")
    
    Specified by:
    
    getRndPrefixSize in interface ChaosOptions
    
    Returns:
    
    The number of bytes for establishing the PREFIX functionality, 0 if no prefixing is to be applied at all.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Enum<ChaosMode>

Enum ChaosMode

Nested Class Summary

Nested classes/interfaces inherited from interface org.refcodes.mixin.EncodedAccessor

Enum Constant Summary

Field Summary

Fields inherited from interface org.refcodes.security.alt.chaos.ChaosOptions

Method Summary

Methods inherited from class java.lang.Enum

Methods inherited from class java.lang.Object

Methods inherited from interface org.refcodes.security.alt.chaos.ChaosOptions

Enum Constant Detail

NONE

MUTATE

XOR

MUTATE_XOR

SALTED

SALTED_MUTATE

SALTED_XOR

SALTED_MUTATE_XOR

Method Detail

values

valueOf

isXorNext

isMutateS

isSalted

getRndPrefixSize

toString