us.daveread.basicquery.util

Class Utility

java.lang.Object

us.daveread.basicquery.util.Utility

public class Utility
extends java.lang.Object

Title: Utilities Description: Utilities for string manipulation and other convenience methods Copyright: Copyright (c) 2003-2014

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

Author:

David Read

Field Summary

Fields

Modifier and Type	Field and Description
private static java.util.Map<java.lang.String,java.text.SimpleDateFormat>	formats Map used for storing date formats for formattedDate() methods
private static org.apache.log4j.Logger	LOGGER Logger

Constructor Summary

Constructors

Modifier	Constructor and Description
private	Utility() Utility class, no instances should be created

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.String	characterInsert(java.lang.String saData, java.lang.String saInsert, int iaMinSectionLength, int iaMaxSectionLength, java.lang.String saBreakCharacters) Ensure that a given character is inserted at intervals along a String.
static java.lang.String	formattedDate(java.util.Date date) Formats the System date to appear as MM/dd/yyyy HH:mm:ss.SSS
static java.lang.String	formattedDate(java.util.Date date, java.lang.String formatString) Formats the System date in the order determined by the formatString
static java.lang.String	formattedNumber(long number, java.lang.String format) Formats a number using the supplied format template
static java.lang.Object[]	getLongestValues(javax.swing.table.TableModel model) Gets longest values, one for each column
static void	initColumnSizes(javax.swing.JTable table, javax.swing.table.TableModel model) This method picks good column sizes.
static java.lang.String	replace(java.lang.String aString, java.lang.String aOldSubString, java.lang.String aNewSubString) Replaces the specified substring with another in the first (whole) string.
static java.lang.String	replace(java.lang.String saString, java.lang.String saOldSubString, java.lang.String saNewSubString, int iaStartIndex, boolean replaceAll) Replaces the specified substring with another in the first (whole) string starting at iaStartIndex.
static java.lang.String[]	splitWithQuotes(java.lang.String data, java.lang.String splitPattern) Split a string at a pattern, but be sensitive to quoted sections of the string.

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

private static final org.apache.log4j.Logger LOGGER

Logger

formats

private static java.util.Map<java.lang.String,java.text.SimpleDateFormat> formats

Map used for storing date formats for formattedDate() methods

Constructor Detail

Utility

private Utility()

Utility class, no instances should be created

Method Detail

replace

public static java.lang.String replace(java.lang.String aString,
                       java.lang.String aOldSubString,
                       java.lang.String aNewSubString)

Replaces the specified substring with another in the first (whole) string.

Parameters:

aString - The whole string.

aOldSubString - The substrinng to be replaced.

aNewSubString - The new substring to replace the old one.

Returns:

The whole string with the substrings replaced.

replace

public static java.lang.String replace(java.lang.String saString,
                       java.lang.String saOldSubString,
                       java.lang.String saNewSubString,
                       int iaStartIndex,
                       boolean replaceAll)

Replaces the specified substring with another in the first (whole) string starting at iaStartIndex.

Parameters:

saString - The whole string.

saOldSubString - The substring to be replaced.

saNewSubString - The new substring to replace the old one.

iaStartIndex - The index at which to start the process of 'search and replace'.

replaceAll - Whether to replace all matches or only the first

Returns:

The whole string with the substring(s) replaced.

initColumnSizes

public static void initColumnSizes(javax.swing.JTable table,
                   javax.swing.table.TableModel model)

This method picks good column sizes. If all column heads are wider than the column's cells' contents, then you can just use column.sizeWidthToFit().

Parameters:

table - The table contains the columns for comparision

model - This is the Default Table Model of the Jtable

getLongestValues

public static java.lang.Object[] getLongestValues(javax.swing.table.TableModel model)

Gets longest values, one for each column

Parameters:

model - The DefaultTable model

Returns:

obj1longest Object that has the longest value for each column

formattedDate

public static java.lang.String formattedDate(java.util.Date date)

Formats the System date to appear as MM/dd/yyyy HH:mm:ss.SSS

Parameters:

date - The system date that needs to be formatted

Returns:

String The formatted date

formattedDate

public static java.lang.String formattedDate(java.util.Date date,
                             java.lang.String formatString)

Formats the System date in the order determined by the formatString

Parameters:

date - The System Date

formatString - The desired format for writing out the date

Returns:

String The formatted date

formattedNumber

public static java.lang.String formattedNumber(long number,
                               java.lang.String format)

Formats a number using the supplied format template

Parameters:

number - The number to format

format - The format template

Returns:

The formatted number

characterInsert

public static final java.lang.String characterInsert(java.lang.String saData,
                               java.lang.String saInsert,
                               int iaMinSectionLength,
                               int iaMaxSectionLength,
                               java.lang.String saBreakCharacters)

Ensure that a given character is inserted at intervals along a String. This is typically used to force inclusion of a space periodically. The method will walk through the supplied data string, looking for characters that are in the break characters String. If found, and the minimum number of characters have been traversed, the insert string is inserted and the character count reset. If the maximum section length is reached and no break characters have been found, the insert string is inserted anyway.

Parameters:

saData - The string to have characters inserted into

saInsert - The String to insert into the data string

iaMinSectionLength - The minumum number of characters in the data string, that must occur between inserted strings

iaMaxSectionLength - The maximum number of characters to allow in the data string between inserted strings

saBreakCharacters - The characters that signal a possible insertion point in the data string

Returns:

The updated data string. If the data string is null, a null String is returned.

splitWithQuotes

public static java.lang.String[] splitWithQuotes(java.lang.String data,
                                 java.lang.String splitPattern)

Split a string at a pattern, but be sensitive to quoted sections of the string. Quoted sections should not be parsed. Nested quotes and apostrophes are also observed. e.g. Parsing for semicolons (;), the following string: This is;a test;string should become three string: 1) This is 2) a test 3) string But the string: This "is;a" test;string should only become two strings: 1) This "is;a" test 2) string

Parameters:

data - String The string to be split into separate strings

splitPattern - String The pattern used to split the string

Returns:

String[] The individually split strings