DESCRIPTION¶ ↑

This is a bunch of useful utils for Java BlackBerry development.

StringUtils¶ ↑

Provides convenient String manipulation methods:

• boolean isBlank(String str)

• boolean isNotBlank(String str)

• String safe(String str)

• String safe(String str, String defaultValue)

• int linesCount(String str)

• String removeBefore(String str, String substrToDelete)

• String replaceAll(String source, String pattern, String replacement)

• String join(String delimiter, Object[] tokens)

• String join(String delimiter, Enumeration tokens)

• String[] split(String str, String delimiter)

• String arrayToString(Object[] array)

• String toHumanReadableString(Object obj)

• String getStringFromStream(InputStream in) throws IOException

• String getStringFromStream(InputStream in, String encoding) throws IOException

MathUtils¶ ↑

Provides convenient math rounding methods the RIM API 4.5 does not provide:

• int round(float x)

• long round(double x)

IMPORTANT: for API 4.6.0+ use net.rim.device.api.util.MathUtilities class instead.

FontUtils¶ ↑

Provides convenient methods to set/get the default font for the application:

• void setApplicationDefaultFont()

• Font getApplicationDefaultFont()

IOUtils¶ ↑

Provides convenient methods for file IO manipulations:

• void safelyCloseStream(InputStream stream)

• void safelyCloseStream(OutputStream stream)

• void safelyCloseStream(FileConnection stream)

• void safelyCloseStream(OutputStreamWriter stream)

• void delete(String url) throws IOException

• void rename(String url, String newName) throws IOException

• void copyFile(String sourceFileUrl, String destinationFileUrl) throws IOException

• void copyFileForTorchHack(String sourceFileUrl, String destinationFileUrl) throws IOException

• void saveDataToFile(String url, byte[] data) throws IOException

• void saveDataToFile(String url, InputStream is) throws IOException

• byte[] getFileData(String url) throws IOException

• void createDir(String url) throws IOException

• void createDirIncludingAncestors(String url) throws IOException

• boolean isDirectory(String url) throws IOException

• void deleteDir(String url) throws IOException

• String removeEncExtension(String url)

• long getFileSize(String url) throws IOException

• boolean isPresent(String url) throws IOException

• boolean isSDCardAccessible()

• boolean isDeviceMemoryAccessible()

• long getDirectorySize(String url, boolean includeSubDirs) throws IOException

• long getAvailableFileSystemSize(String url) throws IOException

• String getFileIOExceptionInfo(FileIOException e)

• long getTotalFileSystemSize(String url) throws IOException

• long getUsedFileSystemSize(String url) throws IOException

• long getUsedDeviceMemory() throws IOException

• long getAvailableDeviceMemory() throws IOException

• long getTotalDeviceMemory() throws IOException

• long getUsedSDCardSize() throws IOException

• long getAvailableSDCardSize() throws IOException

• long getTotalSDCardSize() throws IOException

• boolean isFileSystemFullException(Throwable e)

• boolean isSDCardEncryptionEnabled() throws IOException

ImageUtils¶ ↑

Provides convenient methods for image manipulations:

• EncodedImage resize(EncodedImage eImage, int toWidth, int toHeight, boolean keepAspectRatio)

• EncodedImage getResizedImage(String imgUrl, int toWidth, int toHeight) throws IOException

Logger¶ ↑

A simple file logging facility.

• void debug(Object o, String msg)

• void debug(String msg)

See details on Logger usage here: github.com/cleverua/blackberry_logger

SoftwareVersionUtils¶ ↑

Provides OsVersion class that has convenient methods for OS (Sotfware) Version manipulations:

• isEqualTo(OsVersion other)

• isGreaterThan(OsVersion other)

• isGreaterThanOrEquals(OsVersion other)

• isLessThan(OsVersion other)

• isLessThanOrEquals(OsVersion other)

• isEqualTo(OsVersion other, int precision)

• isGreaterThan(OsVersion other, int precision)

• isGreaterThanOrEquals(OsVersion other, int precision)

• isLessThan(OsVersion other, int precision)

• isLessThanOrEquals(OsVersion other, int precision)

EXAMPLES¶ ↑

Examples are not present. Though the source code contains UtilsTestingApplication it is not a demo/sample application. The application was created just to test the utils during development.