Module seppiko.commons.utils

Package org.seppiko.commons.utils.crypto

Class SymmetricUtil

java.lang.Object

org.seppiko.commons.utils.crypto.SymmetricUtil

All Implemented Interfaces:

Serializable, Cryptography

public class SymmetricUtil
extends Object
implements Cryptography, Serializable

Symmetric-key cryptography utility

Author:

Leonard Woo

See Also:

• Cipher Algorithm Names
• Symmetric-key cryptography
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
SymmetricUtil(String algorithm)	Symmetric-key algorithm

Method Summary

Modifier and Type	Method	Description
byte[]	decrypt(byte[] data)	Decrypt data with Symmetric cryptography
byte[]	encrypt(byte[] data)	Encrypt data with Symmetric cryptography
void	setKey(Key key)	Set key
void	setParameterSpec(AlgorithmParameterSpec params)	Set AlgorithmParameterSpec.
void	setProvider(Provider provider)	Set provider.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.seppiko.commons.utils.crypto.Cryptography

setProvider

Constructor Details

SymmetricUtil

public SymmetricUtil(String algorithm)
              throws NoSuchAlgorithmException

Symmetric-key algorithm

Parameters:

algorithm - Algorithm name.

Throws:

NoSuchAlgorithmException - Algorithm name parser failed.

Method Details

setProvider

public void setProvider(Provider provider)

Set provider.

Specified by:

setProvider in interface Cryptography

Parameters:

provider - the provider.

setParameterSpec

public void setParameterSpec(AlgorithmParameterSpec params)

Set AlgorithmParameterSpec.

Specified by:

setParameterSpec in interface Cryptography

Parameters:

params - AlgorithmParameterSpec subclass.

setKey

public void setKey(Key key)

Set key

Parameters:

key - key instance. Include KeySpec and subclass instance.

encrypt

public byte[] encrypt(byte[] data)
               throws InvalidAlgorithmParameterException,
NoSuchPaddingException,
IllegalBlockSizeException,
NoSuchAlgorithmException,
BadPaddingException,
InvalidKeyException,
NullPointerException

Encrypt data with Symmetric cryptography

Specified by:

encrypt in interface Cryptography

Parameters:

data - plaintext data buffer

Returns:

ciphertext data buffer

Throws:

InvalidAlgorithmParameterException - if the given algorithm parameters are inappropriate for this cipher, or this cipher requires algorithm parameters and params is null, or the given algorithm parameters imply a cryptographic strength that would exceed the legal limits (as determined from the configured jurisdiction policy files).

NoSuchPaddingException - if transformation contains a padding scheme that is not available.

IllegalBlockSizeException - if this cipher is a block cipher, no padding has been requested (only in encryption mode), and the total input length of the data processed by this cipher is not a multiple of block size; or if this encryption algorithm is unable to process the input data provided.

NoSuchAlgorithmException - if transformation is null, empty, in an invalid format, or if no Provider supports a CipherSpi implementation for the specified algorithm.

BadPaddingException - if this cipher is in decryption mode, and (un)padding has been requested, but the decrypted data is not bounded by the appropriate padding bytes.

InvalidKeyException - if the given key is inappropriate for initializing this cipher, or its key-size exceeds the maximum allowable key-size (as determined from the configured jurisdiction policy files).

NullPointerException - key is null.

decrypt

public byte[] decrypt(byte[] data)
               throws InvalidAlgorithmParameterException,
NoSuchPaddingException,
IllegalBlockSizeException,
NoSuchAlgorithmException,
BadPaddingException,
InvalidKeyException,
NullPointerException

Decrypt data with Symmetric cryptography

Specified by:

decrypt in interface Cryptography

Parameters:

data - ciphertext data buffer

Returns:

plaintext data buffer

Throws:

InvalidAlgorithmParameterException - if the given algorithm parameters are inappropriate for this cipher, or this cipher requires algorithm parameters and params is null, or the given algorithm parameters imply a cryptographic strength that would exceed the legal limits (as determined from the configured jurisdiction policy files).

NoSuchPaddingException - if transformation contains a padding scheme that is not available.

IllegalBlockSizeException - if this cipher is a block cipher, no padding has been requested (only in encryption mode), and the total input length of the data processed by this cipher is not a multiple of block size; or if this encryption algorithm is unable to process the input data provided.

NoSuchAlgorithmException - if transformation is null, empty, in an invalid format, or if no Provider supports a CipherSpi implementation for the specified algorithm.

BadPaddingException - if this cipher is in decryption mode, and (un)padding has been requested, but the decrypted data is not bounded by the appropriate padding bytes.

InvalidKeyException - if the given key is inappropriate for initializing this cipher, or its key-size exceeds the maximum allowable key-size (as determined from the configured jurisdiction policy files).

NullPointerException - key is null.