Class IvParameterSpec

java.lang.Object

javax.crypto.spec.IvParameterSpec

All Implemented Interfaces:

AlgorithmParameterSpec

public class IvParameterSpec
extends Object
implements AlgorithmParameterSpec

This class specifies an initialization vector (IV). Examples which use IVs are ciphers in feedback mode, e.g., DES in CBC mode and RSA ciphers with OAEP encoding operation.

Since:

1.4

Constructor Summary

Constructors

Constructor	Description
IvParameterSpec(byte[] iv)	Creates an IvParameterSpec object using the bytes in iv as the IV.
IvParameterSpec(byte[] iv, int offset, int len)	Creates an IvParameterSpec object using the first len bytes in iv, beginning at offset inclusive, as the IV.

Method Summary

Modifier and Type	Method	Description
byte[]	getIV()	Returns the initialization vector (IV).

Methods declared in class Object

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

Modifier and Type	Method	Description
protected Object	clone()	Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
boolean	equals(Object o)	Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
protected void	finalize()	Deprecated, for removal: This API element is subject to removal in a future version. May cause performance issues, deadlocks and hangs.
final Class<? extends Object>	getClass()	Answers the unique instance of java.lang.Class which represents the class of the receiver.
int	hashCode()	Answers an integer hash code for the receiver.
final void	notify()	Causes one thread which is waiting on the receiver to be made ready to run.
final void	notifyAll()	Causes all threads which are waiting on the receiver to be made ready to run.
String	toString()	Answers a string containing a concise, human-readable description of the receiver.
final void	wait()	Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
final void	wait(long time)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
final void	wait(long time, int frac)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

Constructor Details

IvParameterSpec

public IvParameterSpec(byte[] iv)

Creates an IvParameterSpec object using the bytes in iv as the IV.

Parameters:

iv - the buffer with the IV. The contents of the buffer are copied to protect against subsequent modification.

Throws:

NullPointerException - if iv is null

IvParameterSpec

public IvParameterSpec(byte[] iv,
 int offset,
 int len)

Creates an IvParameterSpec object using the first len bytes in iv, beginning at offset inclusive, as the IV.

The bytes that constitute the IV are those between iv[offset] and iv[offset+len-1] inclusive.

Parameters:

iv - the buffer with the IV. The first len bytes of the buffer beginning at offset inclusive are copied to protect against subsequent modification.

offset - the offset in iv where the IV starts.

len - the number of IV bytes.

Throws:

IllegalArgumentException - if iv is null or (iv.length - offset < len)

ArrayIndexOutOfBoundsException - if offset or len are negative.

Method Details

getIV

public byte[] getIV()

Returns the initialization vector (IV).

Returns:

the initialization vector (IV). Returns a new array each time this method is called.