cleoni.adv
Class Utils

java.lang.Object
  cleoni.adv.Utils

public class Utils
extends java.lang.Object

Miscellaneous utilities. Most of them can be called as static methods (ie without instancing the Utils object).

Constructor Summary

Utils(javax.servlet.http.HttpServletRequest aRequest, javax.servlet.http.HttpServletResponse aResponse)
Utils constructor

Method Summary

static java.lang.String	absolutizeUrl(java.lang.String aUrl, java.lang.String baseHref)
static java.lang.String[]	array_merge(java.lang.String[] pa, java.lang.String[] pb)
static java.lang.String	arrayToString(java.lang.String[] v)
static double	cDbl(long x) Converte in un double
static double	cDbl(java.lang.Object x) Converte in un double
static double	cDbl(java.lang.String x) Converte in un double
static int	cInt(boolean x) Converts to int
static int	cInt(double x) Converts to int
static int	cInt(float x) Converts to int
static int	cInt(long x) Converte in un intero
static int	cInt(java.lang.Object x) Converte in un intero
static int	cInt(java.lang.String x) Converte in un intero
static long	cLng(double x) Converte in un long
static long	cLng(float x) Converte in un long
static long	cLng(int x) Converte in un long
static long	cLng(java.lang.Object x) Converte in un long
static long	cLng(java.lang.String x) Converte in un long
static int	compareDouble(double lhs, double rhs) Compares two doubles for order.
static java.lang.String	cStr(char x) Converte in una stringa valida
static java.lang.String	cStr(double x) Converte in una stringa valida
static java.lang.String	cStr(float x) Converte in una stringa valida
static java.lang.String	cStr(int x) Converte in una stringa valida
static java.lang.String	cStr(long x) Converte in una stringa valida
static java.lang.String	cStr(java.lang.Object x) Converte in una stringa valida
static java.lang.String	cStr(java.util.Vector v) Converte in una stringa valida
static java.lang.String	cTimeStamp(java.util.Date aDate)
static java.lang.String	dbString(java.lang.String aString) This method was created in VisualAge.
static java.lang.String	decodeURL(java.lang.String value)
static java.lang.String	deflate(java.lang.String aStr)
static java.lang.String	encodeURL(java.lang.String value)
static java.lang.String	escapeChars(java.lang.String str, java.lang.String escaped)
static boolean	executeSQLCommand(java.lang.String sql, java.sql.Connection con, boolean tolerateErrors, boolean failOnZeroCount)
static java.lang.String	fetch(java.lang.String filePath, java.lang.String encoding) Fetches a file from DimensioneX from disk or from the net.
static java.lang.String	fetchIncludes(java.lang.String filePath, java.lang.String encoding) Fetches a file from DimensioneX from disk or from the net.
java.lang.String	getCookie(java.lang.String key)
DictSorted	getFilesByMask(java.lang.String folder, java.io.FilenameFilter filter)
DictSorted	getForm()
java.lang.String	getForm(java.lang.String aKey) Legge dal canale di input (form POST o GET) il dato nel campo con chiave specificata NB: Proabilmente non � adatta per liste multiselezione in quanto torna una String e non un vettore
java.lang.String	getForm(java.lang.String aKey, java.lang.String charset)
java.lang.String	getFormSession(java.lang.String key) Legge un parametro dalla form in ingresso se non lo trova cerca in Session
protected static java.lang.String	getOppositeDirection(java.lang.String dir)
static java.lang.String	getParentFolder(java.lang.String ofFolder)
protected static java.lang.String	getRelativeDirection(java.lang.String dir, java.lang.String facing)
static java.lang.String	getRidOfParentFolder(java.lang.String ofFolder)
javax.servlet.http.HttpSession	getSession() Torna il riferimento alla sessione attuale (se esiste, senn� torna null) NB questa classe non crea sessioni
java.lang.Object	getSession(java.lang.String key) Torna il riferimento all'oggetto prelevato dall'area Session (se esiste, senn� torna null) NB questa classe non crea sessioni
static java.lang.String	getSettingDB(java.lang.String key, java.lang.String defvalue, java.sql.Connection dbConn, java.lang.String table)
static java.lang.String	getSystemDir(javax.servlet.ServletContext context)
static Dict	getWaysSorted(Dict things, java.lang.String from, java.lang.String facing)
java.lang.String	gSession(java.lang.String key) Come getSession, ma con cast a String equivalente alla Session("key") di VBScript
static int	indexOf(java.lang.String s, java.lang.String[] v)
static int	indexOf(Token t, Dict v, boolean caseSensitive)
static int	instr(java.lang.String target, java.lang.String searchfor, boolean ignoreCase)
static int	instr(java.lang.String target, java.lang.String searchfor, int startpos, boolean ignoreCase)
static int	instrCount(java.lang.String target, char searchfor)
static int	instrCount(java.lang.String target, java.lang.String searchfor, boolean ignoreCase)
static int	instrRev(java.lang.String target, java.lang.String searchfor, boolean ignoreCase)
static boolean	isIn(java.lang.String s, Dict v)
static boolean	isIn(java.lang.String searchfor, java.lang.String target)
static boolean	isIn(java.lang.String s, java.lang.String[] v)
static boolean	isIn(java.lang.String s, java.util.Vector v)
static boolean	isInCsens(java.lang.String s, java.lang.String[] v)
static java.lang.String	leadingZeroes(int n, int howmany)
protected static java.lang.String	nextFace(java.lang.String face, java.lang.String direction)
static java.lang.String	now()
static java.lang.String	now(java.lang.String format)
void	pageExpires() Sets the no-cache criterion for the current page.
java.lang.String	ping(java.lang.String machineName, int portInt) Manda un pacchetto TCP al server/porta specificati torna comunque una String
static int	proportion(int r, int realmin, int realmax, int targmin, int targmax) Returns the number r (which must be realmin <= r <= realmax) proportioned to a new interval: targmin ..
static java.sql.ResultSet	queryDatabase(java.lang.String sql, java.sql.Statement st, boolean tolerateErrors)
static void	removeWayFacing(Dict waysV, java.lang.String thisRoomId, java.lang.String direction)
static java.lang.String	rotate(AdvObject r, java.lang.String origFacing, java.lang.String direction)
static boolean	saveSettingDB(java.lang.String key, java.lang.String value, java.sql.Connection con, java.lang.String table)
void	setCookie(java.lang.String key, java.lang.String value)
void	setSession(java.lang.String key, java.lang.Object anObj) Equivale alla Session(key) = anObj in VBScript
static Dict	string2set(java.lang.String valuestring, java.lang.String sep1, java.lang.String sep2, boolean cheat)
static DictSorted	string2setTokens(java.lang.String valuestring, java.lang.String sep1, java.lang.String sep2, boolean unescape)
static java.lang.String	stringFlatten(java.lang.String str)
static java.lang.String	stringReplace(java.lang.String target, Dict replacements, boolean ignorecase)
static java.lang.String	stringReplace(java.lang.String target, java.lang.String searchfor, java.lang.String substwith, boolean ignorecase) Replaces all occurrences of a substring with another specified substring
static java.util.Vector	stringSplit_tolerant(java.lang.String valuestring, java.lang.String separator) Similar to stringSplit, tolerant version the separator could also not be there (this version of stringSplit was used until version 6.4.6a)
static java.util.Vector	stringSplit(java.lang.String valuestring, java.lang.String separator) Splits the specified string by using the specified separator returns a Vector of objects If problems, returns a single-valued vector containing the original string
static java.util.Vector	stringSplitPair(java.lang.String valuestring, java.lang.String separator)
static java.lang.String	unescapeChars(java.lang.String str, java.lang.String escaped)

Methods inherited from class java.lang.Object

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

Constructor Detail

Utils

public Utils(javax.servlet.http.HttpServletRequest aRequest,
             javax.servlet.http.HttpServletResponse aResponse)

Utils constructor

Parameters:

aRequest -

aResponse -

Method Detail

absolutizeUrl

public static java.lang.String absolutizeUrl(java.lang.String aUrl,
                                             java.lang.String baseHref)

cDbl

public static double cDbl(long x)

Converte in un double

cDbl

public static double cDbl(java.lang.Object x)

Converte in un double

cDbl

public static double cDbl(java.lang.String x)

Converte in un double

cInt

public static int cInt(double x)

Converts to int

cInt

public static int cInt(float x)

Converts to int

cInt

public static int cInt(long x)

Converte in un intero

cInt

public static int cInt(java.lang.Object x)

Converte in un intero

cInt

public static int cInt(java.lang.String x)

Converte in un intero

cInt

public static int cInt(boolean x)

Converts to int

cLng

public static long cLng(double x)

Converte in un long

cLng

public static long cLng(float x)

Converte in un long

cLng

public static long cLng(int x)

Converte in un long

cLng

public static long cLng(java.lang.Object x)

Converte in un long

cLng

public static long cLng(java.lang.String x)

Converte in un long

cStr

public static java.lang.String cStr(char x)

Converte in una stringa valida

cStr

public static java.lang.String cStr(double x)

Converte in una stringa valida

cStr

public static java.lang.String cStr(float x)

Converte in una stringa valida

cStr

public static java.lang.String cStr(int x)

Converte in una stringa valida

cStr

public static java.lang.String cStr(long x)

Converte in una stringa valida

cStr

public static java.lang.String cStr(java.lang.Object x)

Converte in una stringa valida

cStr

public static java.lang.String cStr(java.util.Vector v)

Converte in una stringa valida

cTimeStamp

public static java.lang.String cTimeStamp(java.util.Date aDate)

compareDouble

public static int compareDouble(double lhs,
                                double rhs)

Compares two doubles for order.

This method is more comprehensive than the standard Java greater than, less than and equals operators.

• It returns -1 if the first value is less than the second.
• It returns +1 if the first value is greater than the second.
• It returns 0 if the values are equal.

The ordering is as follows, largest to smallest:

• NaN
• Positive infinity
• Maximum double
• Normal positive numbers
• +0.0
• -0.0
• Normal negative numbers
• Minimum double (-Double.MAX_VALUE)
• Negative infinity

Comparing NaN with NaN will return 0.

Parameters:

lhs - the first double

rhs - the second double

Returns:

-1 if lhs is less, +1 if greater, 0 if equal to rhs

dbString

public static java.lang.String dbString(java.lang.String aString)

This method was created in VisualAge.

executeSQLCommand

public static boolean executeSQLCommand(java.lang.String sql,
                                        java.sql.Connection con,
                                        boolean tolerateErrors,
                                        boolean failOnZeroCount)
                                 throws DimxException

Throws:

DimxException

queryDatabase

public static java.sql.ResultSet queryDatabase(java.lang.String sql,
                                               java.sql.Statement st,
                                               boolean tolerateErrors)
                                        throws DimxException

Throws:

DimxException

getCookie

public java.lang.String getCookie(java.lang.String key)
                           throws DimxException

Throws:

DimxException

getForm

public java.lang.String getForm(java.lang.String aKey)

Legge dal canale di input (form POST o GET) il dato nel campo con chiave specificata NB: Proabilmente non � adatta per liste multiselezione in quanto torna una String e non un vettore

Returns:

java.lang.String

getForm

public DictSorted getForm()

getForm

public java.lang.String getForm(java.lang.String aKey,
                                java.lang.String charset)

getOppositeDirection

protected static java.lang.String getOppositeDirection(java.lang.String dir)

getSession

public javax.servlet.http.HttpSession getSession()

Torna il riferimento alla sessione attuale (se esiste, senn� torna null) NB questa classe non crea sessioni

Returns:

javax.servlet.http.HttpSession

getSession

public java.lang.Object getSession(java.lang.String key)

Torna il riferimento all'oggetto prelevato dall'area Session (se esiste, senn� torna null) NB questa classe non crea sessioni

Returns:

javax.servlet.http.HttpSession

gSession

public java.lang.String gSession(java.lang.String key)

Come getSession, ma con cast a String equivalente alla Session("key") di VBScript

now

public static java.lang.String now()

Returns:

java.lang.String current date/time, nicely formatted US locale

now

public static java.lang.String now(java.lang.String format)

Returns:

java.lang.String current date/time, nicely formatted as specified

pageExpires

public void pageExpires()

Sets the no-cache criterion for the current page. STRONG version - After this one the page cannot be navigated OFF-LINE

ping

public java.lang.String ping(java.lang.String machineName,
                             int portInt)

Manda un pacchetto TCP al server/porta specificati torna comunque una String

proportion

public static int proportion(int r,
                             int realmin,
                             int realmax,
                             int targmin,
                             int targmax)

Returns the number r (which must be realmin <= r <= realmax) proportioned to a new interval: targmin .. targmax

Parameters:

r - Number to be reproportioned

realmin - Minimum real value for r

realmax - Maximum real value for r

targmin - New minimum for result

targmax - New maximum for result

Returns:

result: reproportioned r

setSession

public void setSession(java.lang.String key,
                       java.lang.Object anObj)

Equivale alla Session(key) = anObj in VBScript

stringReplace

public static java.lang.String stringReplace(java.lang.String target,
                                             java.lang.String searchfor,
                                             java.lang.String substwith,
                                             boolean ignorecase)

Replaces all occurrences of a substring with another specified substring

stringReplace

public static java.lang.String stringReplace(java.lang.String target,
                                             Dict replacements,
                                             boolean ignorecase)

stringSplit

public static java.util.Vector stringSplit(java.lang.String valuestring,
                                           java.lang.String separator)

Splits the specified string by using the specified separator returns a Vector of objects If problems, returns a single-valued vector containing the original string

stringSplit_tolerant

public static java.util.Vector stringSplit_tolerant(java.lang.String valuestring,
                                                    java.lang.String separator)

Similar to stringSplit, tolerant version the separator could also not be there (this version of stringSplit was used until version 6.4.6a)

stringSplitPair

public static java.util.Vector stringSplitPair(java.lang.String valuestring,
                                               java.lang.String separator)

string2set

public static Dict string2set(java.lang.String valuestring,
                              java.lang.String sep1,
                              java.lang.String sep2,
                              boolean cheat)

string2setTokens

public static DictSorted string2setTokens(java.lang.String valuestring,
                                          java.lang.String sep1,
                                          java.lang.String sep2,
                                          boolean unescape)

getFormSession

public java.lang.String getFormSession(java.lang.String key)

Legge un parametro dalla form in ingresso se non lo trova cerca in Session

Returns:

javax.servlet.http.HttpSession

getRelativeDirection

protected static java.lang.String getRelativeDirection(java.lang.String dir,
                                                       java.lang.String facing)

getSettingDB

public static java.lang.String getSettingDB(java.lang.String key,
                                            java.lang.String defvalue,
                                            java.sql.Connection dbConn,
                                            java.lang.String table)
                                     throws DimxException

Throws:

DimxException

getSystemDir

public static java.lang.String getSystemDir(javax.servlet.ServletContext context)

getWaysSorted

public static Dict getWaysSorted(Dict things,
                                 java.lang.String from,
                                 java.lang.String facing)

instr

public static int instr(java.lang.String target,
                        java.lang.String searchfor,
                        int startpos,
                        boolean ignoreCase)

Parameters:

target -

searchfor -

startpos -

ignoreCase -

Returns:

-1 if not found. If searchfor = null or "" also returns -1

instr

public static int instr(java.lang.String target,
                        java.lang.String searchfor,
                        boolean ignoreCase)

Parameters:

target -

searchfor -

ignoreCase -

Returns:

-1 if not found. If searchfor = null or "" also returns -1

instrCount

public static int instrCount(java.lang.String target,
                             char searchfor)

instrCount

public static int instrCount(java.lang.String target,
                             java.lang.String searchfor,
                             boolean ignoreCase)

instrRev

public static int instrRev(java.lang.String target,
                           java.lang.String searchfor,
                           boolean ignoreCase)

isIn

public static boolean isIn(java.lang.String s,
                           java.lang.String[] v)

isInCsens

public static boolean isInCsens(java.lang.String s,
                                java.lang.String[] v)

array_merge

public static java.lang.String[] array_merge(java.lang.String[] pa,
                                             java.lang.String[] pb)

arrayToString

public static java.lang.String arrayToString(java.lang.String[] v)

isIn

public static boolean isIn(java.lang.String s,
                           Dict v)

indexOf

public static int indexOf(Token t,
                          Dict v,
                          boolean caseSensitive)

indexOf

public static int indexOf(java.lang.String s,
                          java.lang.String[] v)

isIn

public static boolean isIn(java.lang.String searchfor,
                           java.lang.String target)

isIn

public static boolean isIn(java.lang.String s,
                           java.util.Vector v)

leadingZeroes

public static java.lang.String leadingZeroes(int n,
                                             int howmany)

nextFace

protected static java.lang.String nextFace(java.lang.String face,
                                           java.lang.String direction)

rotate

public static java.lang.String rotate(AdvObject r,
                                      java.lang.String origFacing,
                                      java.lang.String direction)

saveSettingDB

public static boolean saveSettingDB(java.lang.String key,
                                    java.lang.String value,
                                    java.sql.Connection con,
                                    java.lang.String table)
                             throws DimxException

Throws:

DimxException

setCookie

public void setCookie(java.lang.String key,
                      java.lang.String value)
               throws DimxException

Throws:

DimxException

stringFlatten

public static java.lang.String stringFlatten(java.lang.String str)

getParentFolder

public static java.lang.String getParentFolder(java.lang.String ofFolder)

getRidOfParentFolder

public static java.lang.String getRidOfParentFolder(java.lang.String ofFolder)

fetch

public static java.lang.String fetch(java.lang.String filePath,
                                     java.lang.String encoding)
                              throws DimxException

Fetches a file from DimensioneX from disk or from the net. The file must be encoded in UTF-8. Also ANSI ASCII is OK, but localised characters will not be recognised correctly (use UTF-8 for this).

Parameters:

filePath - complete path of the file to be fetched. For network fetch, must begin with "http://"

Returns:

the fetched file, as a single String

Throws:

DimxException - in case of problems

fetchIncludes

public static java.lang.String fetchIncludes(java.lang.String filePath,
                                             java.lang.String encoding)
                                      throws DimxException

Fetches a file from DimensioneX from disk or from the net. The file must be encoded in UTF-8. Also ANSI ASCII is OK, but localised characters will not be recognised correctly (use UTF-8 for this). Supports 'Include "filename"' to recursively fetch "included" files. However, Include statements are ignored inside SCRIPTS and EVENTS tags to retain existing functionality. The Included FILENAME specification is assumed to be relative to the original filePath. That is, it is assumed to be in the same directory.

Parameters:

filePath - complete path of the file to be fetched. For network fetch, must begin with "http://"

Returns:

the fetched file, as a single String

Throws:

DimxException - in case of problems

removeWayFacing

public static void removeWayFacing(Dict waysV,
                                   java.lang.String thisRoomId,
                                   java.lang.String direction)

encodeURL

public static java.lang.String encodeURL(java.lang.String value)
                                  throws DimxException

Throws:

DimxException

decodeURL

public static java.lang.String decodeURL(java.lang.String value)
                                  throws DimxException

Throws:

DimxException

deflate

public static java.lang.String deflate(java.lang.String aStr)

escapeChars

public static java.lang.String escapeChars(java.lang.String str,
                                           java.lang.String escaped)

unescapeChars

public static java.lang.String unescapeChars(java.lang.String str,
                                             java.lang.String escaped)

getFilesByMask

public DictSorted getFilesByMask(java.lang.String folder,
                                 java.io.FilenameFilter filter)