com.captainalm.lib.calmnet.packet.core

Class EncryptedPacket

java.lang.Object

com.captainalm.lib.calmnet.packet.core.EncryptedPacket

All Implemented Interfaces:

IInternalCache, IPacket, IStreamedPacket

public class EncryptedPacket
extends java.lang.Object
implements IStreamedPacket, IInternalCache

This class provides an encrypted packet that can hold an IPacket.

Major ID: 255 Minor ID: 252

Author:

Captain ALM

Constructor Summary

Constructors

Constructor and Description
EncryptedPacket(IPacketFactory factory, PacketLoader loader, com.captainalm.lib.stdcrypt.encryption.ICipherFactory cipherFactory) Constructs a new EncryptedPacket with the specified IPacketFactory, PacketLoader and ICipherFactory.
EncryptedPacket(IPacketFactory factory, PacketLoader loader, com.captainalm.lib.stdcrypt.encryption.ICipherFactory cipherFactory, boolean useCache) Constructs a new EncryptedPacket with the specified IPacketFactory, PacketLoader, ICipherFactory and if the encrypted data should be cached.
EncryptedPacket(IPacketFactory factory, PacketLoader loader, com.captainalm.lib.stdcrypt.encryption.ICipherFactory cipherFactory, IPacket packet) Constructs a new EncryptedPacket with the specified IPacketFactory, PacketLoader, ICipherFactory and IPacket.
EncryptedPacket(IPacketFactory factory, PacketLoader loader, com.captainalm.lib.stdcrypt.encryption.ICipherFactory cipherFactory, IPacket packet, boolean useCache) Constructs a new EncryptedPacket with the specified IPacketFactory, PacketLoader, ICipherFactory, IPacket and if the encrypted data should be cached.

Method Summary

Modifier and Type	Method and Description
com.captainalm.lib.stdcrypt.encryption.ICipherFactory	getCipherFactory() Gets the ICipherFactory being used.
IPacketFactory	getFactory() Gets the IPacketFactory in use.
IPacket	getHeldPacket() Gets the held packet or null.
PacketLoader	getPacketLoader() Gets the PacketLoader in use.
PacketProtocolInformation	getProtocol() Gets the protocol information.
int	getSize() Gets the size of the output data.
static PacketProtocolInformation	getTheProtocol() Gets the protocol information statically.
java.lang.String	getTrailingPassword() Gets the trailing password (Or null if no trailing password).
boolean	isCacheUsed() Gets if the encrypted data is cached.
boolean	isValid() Gets if the packet is valid.
void	loadPayload(byte[] packetData) Loads the packet payload from save data.
void	readData(java.io.OutputStream outputStream) Reads payload data to an OutputStream.
byte[]	savePayload() Saves the packet payload to a byte array.
void	setCacheUsed(boolean used) Sets if the encrypted data is cached.
void	setCipherFactory(com.captainalm.lib.stdcrypt.encryption.ICipherFactory cipherFactory) Sets the ICipherFactory being used.
void	setFactory(IPacketFactory factory) Sets the IPacketFactory to use.
void	setHeldPacket(IPacket packet) Sets the held packet.
void	setPacketLoader(PacketLoader loader) Sets the PacketLoader to use.
void	setTrailingPassword(java.lang.String trailingPassword) Sets the trailing password (Use null for no trailing password).
void	writeData(java.io.InputStream inputStream, int size) Writes payload data from an InputStream.

Methods inherited from class java.lang.Object

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

Constructor Detail

EncryptedPacket

public EncryptedPacket(IPacketFactory factory,
                       PacketLoader loader,
                       com.captainalm.lib.stdcrypt.encryption.ICipherFactory cipherFactory)

Constructs a new EncryptedPacket with the specified IPacketFactory, PacketLoader and ICipherFactory. The encrypted data will not be cached.

Parameters:

factory - The packet factory to use.

loader - The Packet Loader to use.

cipherFactory - The cipher factory to use.

Throws:

java.lang.NullPointerException - factory, loader or cipherFactory is null.

EncryptedPacket

public EncryptedPacket(IPacketFactory factory,
                       PacketLoader loader,
                       com.captainalm.lib.stdcrypt.encryption.ICipherFactory cipherFactory,
                       boolean useCache)

Constructs a new EncryptedPacket with the specified IPacketFactory, PacketLoader, ICipherFactory and if the encrypted data should be cached.

Parameters:

factory - The packet factory to use.

loader - The Packet Loader to use.

cipherFactory - The cipher factory to use.

useCache - If the encrypted data should be cached.

Throws:

java.lang.NullPointerException - factory, loader or cipherFactory is null.

EncryptedPacket

public EncryptedPacket(IPacketFactory factory,
                       PacketLoader loader,
                       com.captainalm.lib.stdcrypt.encryption.ICipherFactory cipherFactory,
                       IPacket packet)

Constructs a new EncryptedPacket with the specified IPacketFactory, PacketLoader, ICipherFactory and IPacket. The encrypted data will not be cached.

Parameters:

factory - The packet factory to use.

loader - The Packet Loader to use.

cipherFactory - The cipher factory to use.

packet - The packet to use.

Throws:

java.lang.NullPointerException - factory, loader or cipherFactory is null.

EncryptedPacket

public EncryptedPacket(IPacketFactory factory,
                       PacketLoader loader,
                       com.captainalm.lib.stdcrypt.encryption.ICipherFactory cipherFactory,
                       IPacket packet,
                       boolean useCache)

Constructs a new EncryptedPacket with the specified IPacketFactory, PacketLoader, ICipherFactory, IPacket and if the encrypted data should be cached.

Parameters:

factory - The packet factory to use.

loader - The Packet Loader to use.

cipherFactory - The cipher factory to use.

packet - The packet to use.

useCache - If the encrypted data should be cached.

Throws:

java.lang.NullPointerException - factory, loader or cipherFactory is null.

Method Detail

isValid

public boolean isValid()

Gets if the packet is valid.

Specified by:

isValid in interface IPacket

Returns:

Is the packet valid?

getProtocol

public PacketProtocolInformation getProtocol()

Gets the protocol information.

Specified by:

getProtocol in interface IPacket

Returns:

The protocol information.

getTheProtocol

public static PacketProtocolInformation getTheProtocol()

Gets the protocol information statically.

Returns:

The protocol information.

savePayload

public byte[] savePayload()
                   throws PacketException

Saves the packet payload to a byte array.

Specified by:

savePayload in interface IPacket

Returns:

The packet payload data.

Throws:

PacketException - An Exception has occurred.

loadPayload

public void loadPayload(byte[] packetData)
                 throws PacketException

Loads the packet payload from save data.

Specified by:

loadPayload in interface IPacket

Parameters:

packetData - The packet payload data.

Throws:

java.lang.NullPointerException - The new store data is null.

PacketException - An Exception has occurred.

readData

public void readData(java.io.OutputStream outputStream)
              throws java.io.IOException,
                     PacketException

Reads payload data to an OutputStream.

Specified by:

readData in interface IStreamedPacket

Parameters:

outputStream - The output stream to read data to.

Throws:

java.lang.NullPointerException - outputStream is null.

java.io.IOException - An IO Exception has occurred.

PacketException - An Exception has occurred.

writeData

public void writeData(java.io.InputStream inputStream,
                      int size)
               throws java.io.IOException,
                      PacketException

Writes payload data from an InputStream.

Specified by:

writeData in interface IStreamedPacket

Parameters:

inputStream - The input stream to write data from.

size - The size of the input payload in bytes.

Throws:

java.lang.NullPointerException - inputStream is null.

java.lang.IllegalArgumentException - size is less than 0.

java.io.IOException - An IO Exception has occurred.

PacketException - An Exception has occurred.

getSize

public int getSize()
            throws PacketException

Gets the size of the output data.

Specified by:

getSize in interface IStreamedPacket

Returns:

The size of the output data in bytes.

Throws:

PacketException - An Exception has occurred.

getPacketLoader

public PacketLoader getPacketLoader()

Gets the PacketLoader in use.

Returns:

The Packet Loader in use.

setPacketLoader

public void setPacketLoader(PacketLoader loader)

Sets the PacketLoader to use.

Parameters:

loader - The Packet Loader to use.

Throws:

java.lang.NullPointerException - loader is null.

getFactory

public IPacketFactory getFactory()

Gets the IPacketFactory in use.

Returns:

The Packet Factory in use.

setFactory

public void setFactory(IPacketFactory factory)

Sets the IPacketFactory to use.

Parameters:

factory - The Packet Factory to use.

Throws:

java.lang.NullPointerException - factory is null.

getCipherFactory

public com.captainalm.lib.stdcrypt.encryption.ICipherFactory getCipherFactory()

Gets the ICipherFactory being used.

Returns:

The Cipher Factory.

setCipherFactory

public void setCipherFactory(com.captainalm.lib.stdcrypt.encryption.ICipherFactory cipherFactory)

Sets the ICipherFactory being used.

Parameters:

cipherFactory - The Cipher Factory.

Throws:

java.lang.NullPointerException - cipherFactory is null.

getTrailingPassword

public java.lang.String getTrailingPassword()

Gets the trailing password (Or null if no trailing password).

Returns:

The trailing password or null.

setTrailingPassword

public void setTrailingPassword(java.lang.String trailingPassword)

Sets the trailing password (Use null for no trailing password).

Parameters:

trailingPassword - The new trailing password or null.

getHeldPacket

public IPacket getHeldPacket()

Gets the held packet or null.

Returns:

The packet or null.

setHeldPacket

public void setHeldPacket(IPacket packet)

Sets the held packet.

Parameters:

packet - The new packet or null.

isCacheUsed

public boolean isCacheUsed()

Gets if the encrypted data is cached.

Specified by:

isCacheUsed in interface IInternalCache

Returns:

If the encrypted data is cached.

setCacheUsed

public void setCacheUsed(boolean used)

Sets if the encrypted data is cached.

Specified by:

setCacheUsed in interface IInternalCache

Parameters:

used - If the encrypted data should be cached.