org.arquillian.droidium.container.configuration

Class Validate

java.lang.Object

org.arquillian.droidium.container.configuration.Validate

public class Validate
extends Object

Simple validation utility

Author:

Karel Piwko, Stefan Miklosovic

Field Summary

Fields

Modifier and Type	Field and Description
static long	ADB_PORT_MAX Maximal number of adb port.
static long	ADB_PORT_MIN Minimal number of adb port.
static long	CONSOLE_PORT_MAX Maximal number of console port.
static long	CONSOLE_PORT_MIN Minimal number of console port.

Constructor Summary

Constructors

Constructor and Description
Validate()

Method Summary

Methods

Modifier and Type	Method and Description
static void	isAdbPortValid(String adbPort) Checks if adb port is in valid range.
static void	isConsolePortValid(String consolePort) Checks if console port is in valid range.
static boolean	isPortValid(int port) Checks if port is in range 0 - 65535
static boolean	isPortValid(String port) Checks if port is in range 0 - 65535
static boolean	isReadable(File file, String message) Checks that the specified file represents a readable file.
static boolean	isReadable(String path, String message) Checks that the specified String is not null or empty and represents a readable file, throws exception if it is empty or null and does not represent a path to a file.
static void	isReadableDirectory(File file, String message) Checks that the specified file represents a readable directory.
static void	isReadableDirectory(String path, String message) Checks that the specified String is not null or empty and represents a readable directory, throws exception if it is empty or null and does not represent a path to a directory.
static void	isWritable(File file, String message) Checks that the specified File is not null or empty and represents a writeable file, throws exception if it is empty or null and does not represent a path to a file.
static void	notAllNullsOrEmpty(String[] strings, String message) Checks that at least one of specified String is not empty
static void	notNull(Object object, String message) Checks if some object is null or not.
static void	notNullOrEmpty(String string, String message) Checks that the specified String is not null or empty, throws exception if it is.
static void	notNulls(Object[] objects, String message) Checks that all specified objects are not null objects.
static void	sdCardFileName(String fileName, String message) Checks if file name of the SD card is valid which means it has to have suffix of ".img".
static void	sdSize(String sdSize, String message) Checks if user set size of SD card in the proper format.

Methods inherited from class java.lang.Object

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

Field Detail

CONSOLE_PORT_MIN

public static final long CONSOLE_PORT_MIN

Minimal number of console port.

See Also:

Constant Field Values

CONSOLE_PORT_MAX

public static final long CONSOLE_PORT_MAX

Maximal number of console port.

See Also:

Constant Field Values

ADB_PORT_MIN

public static final long ADB_PORT_MIN

Minimal number of adb port.

See Also:

Constant Field Values

ADB_PORT_MAX

public static final long ADB_PORT_MAX

Maximal number of adb port.

See Also:

Constant Field Values

Constructor Detail

Validate

public Validate()

Method Detail

notNull

public static void notNull(Object object,
           String message)
                    throws IllegalStateException,
                           IllegalArgumentException

Checks if some object is null or not.

Parameters:

object - object to check against nullity

message - the exception message

Throws:

IllegalStateException - if object is null

IllegalArgumentException - when message object is null

notNulls

public static void notNulls(Object[] objects,
            String message)
                     throws IllegalStateException

Checks that all specified objects are not null objects.

Parameters:

objects - objects to check against nullity

message - exception message

Throws:

IllegalArgumentException - throws if at leas one object is null

IllegalStateException

notNullOrEmpty

public static void notNullOrEmpty(String string,
                  String message)
                           throws IllegalStateException

Checks that the specified String is not null or empty, throws exception if it is.

Parameters:

string - The object to check

message - The exception message

Throws:

IllegalArgumentException - Thrown if string is null

IllegalStateException

notAllNullsOrEmpty

public static void notAllNullsOrEmpty(String[] strings,
                      String message)
                               throws IllegalStateException

Checks that at least one of specified String is not empty

Parameters:

strings - The array of strings to be checked

message - The exception message

Throws:

AndroidConfigurationException - Throws if all strings are null or empty

IllegalStateException

isReadable

public static boolean isReadable(String path,
                 String message)
                          throws IllegalArgumentException

Checks that the specified String is not null or empty and represents a readable file, throws exception if it is empty or null and does not represent a path to a file.

Parameters:

path - The path to check

message - The exception message

Throws:

IllegalArgumentException - Thrown if path is empty, null or invalid

isReadableDirectory

public static void isReadableDirectory(String path,
                       String message)
                                throws IllegalArgumentException

Checks that the specified String is not null or empty and represents a readable directory, throws exception if it is empty or null and does not represent a path to a directory.

Parameters:

path - The path to check

message - The exception message

Throws:

IllegalArgumentException - Thrown if path is empty, null or invalid

isReadable

public static boolean isReadable(File file,
                 String message)
                          throws IllegalArgumentException

Checks that the specified file represents a readable file.

Parameters:

file - The file to check

message - The exception message

Throws:

IllegalArgumentException - Thrown if file is null or invalid

isReadableDirectory

public static void isReadableDirectory(File file,
                       String message)
                                throws IllegalArgumentException

Checks that the specified file represents a readable directory.

Parameters:

file - The path to check

message - The exception message

Throws:

IllegalArgumentException - Thrown if file is null or invalid

sdSize

public static void sdSize(String sdSize,
          String message)
                   throws AndroidContainerConfigurationException

Checks if user set size of SD card in the proper format. SD card size has to be between 9M (9126K) and 1023G. Everything out of this range is considered to be invalid. This method follows size and format recommendation of mksdcard tool from the Android tools distribution.

Parameters:

sdSize - size of sd card

message - The exception message

Throws:

AndroidContainerConfigurationException - when sdSize is invalid

isConsolePortValid

public static void isConsolePortValid(String consolePort)
                               throws AndroidContainerConfigurationException

Checks if console port is in valid range. Console port has to be even number in range 5554L - 5584L.

Parameters:

consolePort - console port to check validity of

Throws:

AndroidContainerConfigurationException - if console port is null or not a number or not valid

isAdbPortValid

public static void isAdbPortValid(String adbPort)
                           throws AndroidContainerConfigurationException

Checks if adb port is in valid range. adbPort port has to be odd number in range 5555L - 5585L

Parameters:

adbPort - adb port to check validity of

Throws:

AndroidContainerConfigurationException - if adb port is null or not a number or not valid

isPortValid

public static boolean isPortValid(int port)

Checks if port is in range 0 - 65535

Parameters:

port - port number to check the validity of

Returns:

true if port is in sane range, false otherwise

isPortValid

public static boolean isPortValid(String port)

Checks if port is in range 0 - 65535

Parameters:

port - port number to check the validity of

Returns:

true if port is in sane range, false otherwise

Throws:

NumberFormatException - when port is not a number

sdCardFileName

public static void sdCardFileName(String fileName,
                  String message)
                           throws AndroidContainerConfigurationException

Checks if file name of the SD card is valid which means it has to have suffix of ".img".

Parameters:

fileName - name of the file to check validity of

message - exception message

Throws:

AndroidContainerConfigurationException - if file name of SD card is not valid.

isWritable

public static void isWritable(File file,
              String message)
                       throws IllegalArgumentException

Checks that the specified File is not null or empty and represents a writeable file, throws exception if it is empty or null and does not represent a path to a file.

Parameters:

file - The file to check

message - The exception message

Throws:

IllegalArgumentException - Thrown if file is null or invalid