Package socialmediasteganography

Interface SocialMediaSteganography

All Known Implementing Classes:

SocialMediaSteganographyImpl

public interface SocialMediaSteganography

Method Summary

Modifier and Type	Method	Description
byte[]	decodeCarrier(MediaType mediaType, byte[] carrier)	Decodes hidden payload from carrier
boolean	encodeAndPost(APINames apiNames, java.lang.String keyword, byte[] carrier, byte[] payload, MediaType mediaType)	Encodes payload in carrier and posts the result to socialMedia
boolean	encodeAndPost(APINames apiNames, java.lang.String keyword, byte[] carrier, byte[] payload, MediaType mediaType, Token token)	Loads carrier from file path and uses encodeAndPost
boolean	encodeAndPost(APINames apiNames, java.lang.String keyword, java.lang.String path, byte[] payload, MediaType mediaType)	Loads carrier from file path and uses encodeAndPost
byte[]	encodeCarrier(byte[] carrier, byte[] payload, MediaType mediaType)	Encodes payload into carrier for a given mediatype
byte[][]	getMediaAndDecode(java.lang.String keyword, APINames apiNames, MediaType mediaType)	Gets Media for a certain Keyword and checks if it is a steganographic picture.
boolean	postToSocialMedia(byte[] carrier, APINames apiNames, java.lang.String keyword, MediaType mediaType)	Post media to Social Media, if no Token is given set Parameter beforehand e.g.
boolean	postToSocialMedia(byte[] carrier, APINames apiNames, java.lang.String keyword, MediaType mediaType, Token token)	Post media to Social Media
void	saveEncodedPicture(byte[] carrier, byte[] payload, MediaType mediaType, java.lang.String savepath)	Save encoded Media to given path as a file
void	saveEncodePicture(java.lang.String filepath, MediaType mediaType, byte[] payload, java.lang.String savepath)	Load Media from a file and save encoded Media to given path as a file
void	setSeed(java.lang.Long seed)	Set the seed for decoding or encoding
SocialMedia	subscribeToSocialMedia(java.lang.String keyword, APINames apiNames)	Subscribes a keyword to a social media

Method Detail

encodeAndPost

boolean encodeAndPost(APINames apiNames,
                      java.lang.String keyword,
                      byte[] carrier,
                      byte[] payload,
                      MediaType mediaType)
               throws UnsupportedMediaTypeException,
                      MediaNotFoundException,
                      MediaCapacityException,
                      MediaReassemblingException,
                      java.io.IOException

Encodes payload in carrier and posts the result to socialMedia

Parameters:

apiNames - API Name

carrier - data used to encode the payload in

payload - payload to encode

mediaType - The type of the carrier (e.g. PNG.GIF)

keyword - The name under which the carrier is posted to social Media

Returns:

boolean true, when carrier is successfully posted

Throws:

UnsupportedMediaTypeException - if the MediaType is not supported

MediaNotFoundException - if f the intended media (e.g. Image, Video, ...) could not be read from data

MediaCapacityException - if the payload doesn't fit in the carrier

java.io.IOException - if there is a problem with reading Data from carrier or payload

MediaReassemblingException - if a problem occurred during writing of the result media

encodeAndPost

boolean encodeAndPost(APINames apiNames,
                      java.lang.String keyword,
                      java.lang.String path,
                      byte[] payload,
                      MediaType mediaType)
               throws java.io.IOException,
                      UnsupportedMediaTypeException,
                      MediaNotFoundException,
                      MediaReassemblingException,
                      MediaCapacityException

Loads carrier from file path and uses encodeAndPost

Parameters:

path - Path to a Media file

apiNames - API Name

payload - payload to encode

mediaType - The type of the carrier (e.g. PNG.GIF)

keyword - The name under which the carrier is posted to social Media

Returns:

boolean true, when carrier is successfully posted

Throws:

UnsupportedMediaTypeException - if the MediaType is not supported

MediaNotFoundException - if f the intended media (e.g. Image, Video, ...) could not be read from data

MediaCapacityException - if the payload doesn't fit in the carrier

java.io.IOException - if there is a problem with reading Data from carrier or payload

MediaReassemblingException - if a problem occurred during writing of the result media

See Also:

encodeAndPost(APINames, String, byte[], byte[], MediaType)

encodeAndPost

boolean encodeAndPost(APINames apiNames,
                      java.lang.String keyword,
                      byte[] carrier,
                      byte[] payload,
                      MediaType mediaType,
                      Token token)
               throws java.io.IOException,
                      UnsupportedMediaTypeException,
                      MediaNotFoundException,
                      MediaReassemblingException,
                      MediaCapacityException

Loads carrier from file path and uses encodeAndPost

Parameters:

apiNames - API Name

payload - payload to encode

carrier - data used to encode the payload in

mediaType - The type of the carrier (e.g. PNG.GIF)

keyword - The name under which the carrier is posted to social Media

token - Token class with tokens for Social Media

Returns:

boolean true, when carrier is successfully posted

Throws:

UnsupportedMediaTypeException - if the MediaType is not supported

MediaNotFoundException - if f the intended media (e.g. Image, Video, ...) could not be read from data

MediaCapacityException - if the payload doesn't fit in the carrier

java.io.IOException - if there is a problem with reading Data from carrier or payload

MediaReassemblingException - if a problem occurred during writing of the result media

See Also:

encodeAndPost(APINames, String, byte[], byte[], MediaType)

saveEncodedPicture

void saveEncodedPicture(byte[] carrier,
                        byte[] payload,
                        MediaType mediaType,
                        java.lang.String savepath)
                 throws UnsupportedMediaTypeException,
                        MediaNotFoundException,
                        MediaCapacityException,
                        MediaReassemblingException,
                        java.io.IOException

Save encoded Media to given path as a file

Parameters:

carrier - data used to encode the payload in

payload - payload to encode

mediaType - The type of the carrier (e.g. PNG.GIF)

savepath - The path to which the generated file is saved

Throws:

UnsupportedMediaTypeException - if the MediaType is not supported

MediaNotFoundException - if f the intended media (e.g. Image, Video, ...) could not be read from data

MediaCapacityException - if the payload doesn't fit in the carrier

java.io.IOException - if there is a problem with reading Data from carrier or payload

MediaReassemblingException - if a problem occurred during writing of the result media

saveEncodePicture

void saveEncodePicture(java.lang.String filepath,
                       MediaType mediaType,
                       byte[] payload,
                       java.lang.String savepath)
                throws java.io.IOException,
                       UnsupportedMediaTypeException,
                       MediaNotFoundException,
                       MediaReassemblingException,
                       MediaCapacityException

Load Media from a file and save encoded Media to given path as a file

Parameters:

payload - payload to encode

mediaType - The type of the carrier (e.g. PNG.GIF)

savepath - The path to which the generated file is saved

filepath - the path to the file thath needs to be encoded

Throws:

UnsupportedMediaTypeException - if the MediaType is not supported

MediaNotFoundException - if f the intended media (e.g. Image, Video, ...) could not be read from data

MediaCapacityException - if the payload doesn't fit in the carrier

java.io.IOException - if there is a problem with reading Data from carrier or payload

MediaReassemblingException - if a problem occurred during writing of the result media

See Also:

saveEncodedPicture(byte[], byte[], MediaType, String)

postToSocialMedia

boolean postToSocialMedia(byte[] carrier,
                          APINames apiNames,
                          java.lang.String keyword,
                          MediaType mediaType)

Post media to Social Media, if no Token is given set Parameter beforehand e.g. Tumbler.setApiKey = "..." and Tumbler.setApiSecretKey

Parameters:

carrier - data that should be uploaded

apiNames - API Name

keyword - The name under which the carrier is posted to social Media

mediaType - The type of the carrier (e.g. PNG.GIF)

Returns:

boolean true when carrier was successfully posted

postToSocialMedia

boolean postToSocialMedia(byte[] carrier,
                          APINames apiNames,
                          java.lang.String keyword,
                          MediaType mediaType,
                          Token token)

Post media to Social Media

Parameters:

carrier - data that should be uploaded

apiNames - API Name

keyword - The name under which the carrier is posted to social Media

mediaType - The type of the carrier (e.g. PNG.GIF)

token - The token used to access Social Media

Returns:

boolean true when carrier was successfully posted

encodeCarrier

byte[] encodeCarrier(byte[] carrier,
                     byte[] payload,
                     MediaType mediaType)
              throws UnsupportedMediaTypeException,
                     MediaCapacityException,
                     MediaNotFoundException,
                     MediaReassemblingException,
                     java.io.IOException

Encodes payload into carrier for a given mediatype

Parameters:

carrier - data used to encode the payload in

payload - payload to encode

mediaType - The type of the carrier (e.g. PNG.GIF)

Returns:

byte[] carrier with encoded payload

Throws:

UnsupportedMediaTypeException - if the MediaType is not supported

MediaNotFoundException - if f the intended media (e.g. Image, Video, ...) could not be read from data

MediaCapacityException - if the payload doesn't fit in the carrier

java.io.IOException - if there is a problem with reading Data from carrier or payload

MediaReassemblingException - if a problem occurred during writing of the result media

subscribeToSocialMedia

SocialMedia subscribeToSocialMedia(java.lang.String keyword,
                                   APINames apiNames)

Subscribes a keyword to a social media

Parameters:

keyword - The name under which the carrier is posted to social Media

apiNames - API Name

Returns:

Social Media The Social Media Class that can be used for interacting with given API

getMediaAndDecode

byte[][] getMediaAndDecode(java.lang.String keyword,
                           APINames apiNames,
                           MediaType mediaType)

Gets Media for a certain Keyword and checks if it is a steganographic picture. If it is, proceeds to decode the picture and return payload

Parameters:

keyword - keyword under which the media was posted

apiNames - name of the api used

mediaType - media type in which the payload is decoded

Returns:

payloads all payloads that could be read

decodeCarrier

byte[] decodeCarrier(MediaType mediaType,
                     byte[] carrier)
              throws UnsupportedMediaTypeException,
                     UnknownStegFormatException,
                     MediaNotFoundException,
                     java.io.IOException

Decodes hidden payload from carrier

Parameters:

mediaType - The type of the carrier (e.g. PNG.GIF)

carrier - data with encoded payload

Returns:

payload decoded payload

Throws:

UnsupportedMediaTypeException - if the MediaType is not supported

UnknownStegFormatException - UnknownStegFormatException

java.io.IOException - if a problem occurs during reading of steganographicData

MediaNotFoundException - if the intended media (e.g. Image, Video, ...) could not be read from steganographicData

setSeed

void setSeed(java.lang.Long seed)

Set the seed for decoding or encoding

Parameters:

seed - The seed to initialize random function