org.jivesoftware.smackx.omemo.util

Class OmemoMessageBuilder<T_IdKeyPair,T_IdKey,T_PreKey,T_SigPreKey,T_Sess,T_Addr,T_ECPub,T_Bundle,T_Ciph>

java.lang.Object

org.jivesoftware.smackx.omemo.util.OmemoMessageBuilder<T_IdKeyPair,T_IdKey,T_PreKey,T_SigPreKey,T_Sess,T_Addr,T_ECPub,T_Bundle,T_Ciph>

Type Parameters:

T_IdKeyPair - IdentityKeyPair class

T_IdKey - IdentityKey class

T_PreKey - PreKey class

T_SigPreKey - SignedPreKey class

T_Sess - Session class

T_Addr - Address class

T_ECPub - Elliptic Curve PublicKey class

T_Bundle - Bundle class

T_Ciph - Cipher class

public class OmemoMessageBuilder<T_IdKeyPair,T_IdKey,T_PreKey,T_SigPreKey,T_Sess,T_Addr,T_ECPub,T_Bundle,T_Ciph>
extends java.lang.Object

Class used to build OMEMO messages.

Constructor Summary

Constructors

Constructor and Description
OmemoMessageBuilder(OmemoDevice userDevice, OmemoTrustCallback callback, OmemoRatchet<T_IdKeyPair,T_IdKey,T_PreKey,T_SigPreKey,T_Sess,T_Addr,T_ECPub,T_Bundle,T_Ciph> ratchet, byte[] aesKey, byte[] iv, java.lang.String message) Create an OmemoMessageBuilder.
OmemoMessageBuilder(OmemoDevice userDevice, OmemoTrustCallback callback, OmemoRatchet<T_IdKeyPair,T_IdKey,T_PreKey,T_SigPreKey,T_Sess,T_Addr,T_ECPub,T_Bundle,T_Ciph> ratchet, java.lang.String message) Create an OmemoMessageBuilder.

Method Summary

Modifier and Type	Method and Description
void	addRecipient(OmemoDevice contactsDevice) Add a new recipient device to the message.
OmemoElement	finish() Assemble an OmemoMessageElement from the current state of the builder.
static byte[]	generateIv() Generate a 16 byte initialization vector for AES encryption.
static byte[]	generateKey(java.lang.String keyType, int keyLength) Generate a new AES key used to encrypt the message.

Methods inherited from class java.lang.Object

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

Constructor Detail

OmemoMessageBuilder

public OmemoMessageBuilder(OmemoDevice userDevice,
                           OmemoTrustCallback callback,
                           OmemoRatchet<T_IdKeyPair,T_IdKey,T_PreKey,T_SigPreKey,T_Sess,T_Addr,T_ECPub,T_Bundle,T_Ciph> ratchet,
                           byte[] aesKey,
                           byte[] iv,
                           java.lang.String message)
                    throws javax.crypto.NoSuchPaddingException,
                           javax.crypto.BadPaddingException,
                           java.security.InvalidKeyException,
                           java.security.NoSuchAlgorithmException,
                           javax.crypto.IllegalBlockSizeException,
                           java.security.InvalidAlgorithmParameterException

Create an OmemoMessageBuilder.

Parameters:

userDevice - our OmemoDevice

callback - trustCallback for querying trust decisions

ratchet - our OmemoRatchet

aesKey - aes message key used for message encryption

iv - initialization vector used for message encryption

message - message we want to send

Throws:

javax.crypto.NoSuchPaddingException

javax.crypto.BadPaddingException

java.security.InvalidKeyException

java.security.NoSuchAlgorithmException

javax.crypto.IllegalBlockSizeException

java.security.InvalidAlgorithmParameterException

OmemoMessageBuilder

public OmemoMessageBuilder(OmemoDevice userDevice,
                           OmemoTrustCallback callback,
                           OmemoRatchet<T_IdKeyPair,T_IdKey,T_PreKey,T_SigPreKey,T_Sess,T_Addr,T_ECPub,T_Bundle,T_Ciph> ratchet,
                           java.lang.String message)
                    throws javax.crypto.NoSuchPaddingException,
                           javax.crypto.BadPaddingException,
                           java.security.InvalidKeyException,
                           java.security.NoSuchAlgorithmException,
                           javax.crypto.IllegalBlockSizeException,
                           java.io.UnsupportedEncodingException,
                           java.security.InvalidAlgorithmParameterException

Create an OmemoMessageBuilder.

Parameters:

userDevice - our OmemoDevice

callback - trustCallback for querying trust decisions

ratchet - our OmemoRatchet

message - message we want to send

Throws:

javax.crypto.NoSuchPaddingException

javax.crypto.BadPaddingException

java.security.InvalidKeyException

java.security.NoSuchAlgorithmException

javax.crypto.IllegalBlockSizeException

java.io.UnsupportedEncodingException

java.security.InvalidAlgorithmParameterException

Method Detail

addRecipient

public void addRecipient(OmemoDevice contactsDevice)
                  throws NoIdentityKeyException,
                         CorruptedOmemoKeyException,
                         UndecidedOmemoIdentityException,
                         UntrustedOmemoIdentityException

Add a new recipient device to the message.

Parameters:

contactsDevice - device of the recipient

Throws:

NoIdentityKeyException - if we have no identityKey of that device. Can be fixed by fetching and processing the devices bundle.

CorruptedOmemoKeyException - if the identityKey of that device is corrupted.

UndecidedOmemoIdentityException - if the user hasn't yet decided whether to trust that device or not.

UntrustedOmemoIdentityException - if the user has decided not to trust that device.

finish

public OmemoElement finish()

Assemble an OmemoMessageElement from the current state of the builder.

Returns:

OmemoMessageElement

generateKey

public static byte[] generateKey(java.lang.String keyType,
                                 int keyLength)
                          throws java.security.NoSuchAlgorithmException

Generate a new AES key used to encrypt the message.

Parameters:

keyType - Key Type

keyLength - Key Length in bit

Returns:

new AES key

Throws:

java.security.NoSuchAlgorithmException

generateIv

public static byte[] generateIv()

Generate a 16 byte initialization vector for AES encryption.

Returns:

iv