CASA

java.lang.Object
- org.ksg.casa.CASA

```
public class CASA
extends Object
```
This class is teh

Author:

Rob Kremer

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

(package private) static class CASA.SilentPreferences

Nested Classes
Modifier and Type	Class and Description
`(package private) static class`	`CASA.SilentPreferences`

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`ENVIRONMENT`
`static int`	`SYSTEM`
`private static CASA.SilentPreferences`	`systemPreferences`
`private static boolean`	`systemPrefsFailureLogged` Set this to false if you want to attempt to write appropriate data to the System preferences, otherwise (if true) this will not bother to attempt to write to System preferences.
`static int`	`USER`
`private static CASA.SilentPreferences`	`userPreferences`

Constructor Summary

Constructors
Constructor and Description

CASA()

Constructors
Constructor and Description
`CASA()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected void`	`finalize()`
`static void`	`flush(int operation)` Flushes user and/or system preferences to make them persistent.
`static String`	`getBuildInfo()`
`static int`	`getLACdefaultport()`
`private static boolean`	`getPref(String name, boolean default_)`
`private static int`	`getPref(String name, int default_)`
`private static String`	`getPref(String name, String default_)`
`static boolean`	`getPreference(String prefName, boolean defaultValue, int function)` Specialized boolean version of `getPreference(String, String, int)`.
`static int`	`getPreference(String prefName, int defaultValue, int function)` Specialized int version of `getPreference(String, String, int)`.
`static long`	`getPreference(String prefName, long defaultValue, int function)` Specialized long version of `getPreference(String, String, int)`.
`static Map<String,String>`	`getPreference(String prefName, Map<String,String> defaultValue, int operation)`
`static String`	`getPreference(String prefName, String defaultValue, int operation)` Reads preferences from one of: System environment variables System user preferences System system preferences in that order.
`static String`	`getPutPreferenceIfAbsent()`
`static String`	`getRoot()`
`static String`	`getRouter()`
`static boolean`	`isDieOnLACExitDefault()`
`private static boolean`	`isPrefPresent(CASA.SilentPreferences p, String name)`
`static boolean`	`isSystemPrefsWorking(boolean verbose)`
`static void`	`putPreference(String prefName, boolean defaultValue, int operation)`
`static void`	`putPreference(String prefName, int defaultValue, int operation)`
`static void`	`putPreference(String prefName, Map<String,?> defaultValue, int operation)`
`static void`	`putPreference(String prefName, String defaultValue, int operation)`
`static void`	`putPreferenceIfAbsent(String prefName, int defaultValue, int operation)`
`static void`	`putPreferenceIfAbsent(String prefName, String defaultValue, int operation)`
`static void`	`removePreference(String prefName, int operation)`
`static void`	`setDieOnLACExitDefault(boolean dieOnLACExitDefault)`
`static void`	`setLACdefaultport(int lACdefaultport)`
`private static void`	`setPref(String name, boolean default_)`
`private static void`	`setPref(String name, int default_)`
`private static void`	`setPref(String name, String default_)`
`static void`	`setPutPreferenceIfAbsent(String putPreferenceIfAbsent)`
`static void`	`setRoot(String root)`
`static void`	`setRouter(String router)`
`void`	`setUp()`
`void`	`tearDown()`
`void`	`testPrefs()`
`static void`	`writeDefaultPrefs()` Write out the default preferences to both the user and system preferences.

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - userPreferences
```
private static final CASA.SilentPreferences userPreferences
```
  - systemPreferences
```
private static final CASA.SilentPreferences systemPreferences
```
  - ENVIRONMENT
```
public static int ENVIRONMENT
```
  - USER
```
public static int USER
```
  - SYSTEM
```
public static int SYSTEM
```
  - systemPrefsFailureLogged
```
private static boolean systemPrefsFailureLogged
```
    Set this to false if you want to attempt to write appropriate data to the System preferences, otherwise (if true) this will not bother to attempt to write to System preferences. Most systems will no longer let a non-root user to write to System preferences.
- Constructor Detail
  - CASA
```
public CASA()
```
- Method Detail
  - writeDefaultPrefs
```
public static void writeDefaultPrefs()
```
    Write out the default preferences to both the user and system preferences. Note that on some systems this might not work, for example in Mac OS/X Lion one cannot write the system prefs unless you are running under the root account.
  - isSystemPrefsWorking
```
public static boolean isSystemPrefsWorking(boolean verbose)
```
  - getPreference
```
public static String getPreference(String prefName,
                                   String defaultValue,
                                   int operation)
```
    Reads preferences from one of:
    1. System environment variables
    2. System user preferences
    3. System system preferences
    in that order. Detailed control is specified by the function integer, which is the disjunct of the flags ENVIRONMENT, USER, SYSTEM, #SAVE, and #REMOVE. The first three flags mean we should attempt to read from that source (in that order). The #SAVE flag indicates that, if we don't find the value in that source (or some error occurs), we should save the given defaultValue to that source (but only the first one, in order). However, this method will never overwrite a non-default value in the preferences store (although it can be used to remove an preference). Note that you cannot save a value to an environment variable, only to preferences. #REMOVE behaves similarly, but removes the value from that source.
    There are some special flag words:
    - 0 is taken the same as ENVIRONMENT|USER|SYSTEM (try all sources and don't save).
    - SAVE (only) will save to the user preferences.
    - REMOVE (only) will remove the user preference.
    If #SAVE and #REMOVE are used together, #SAVE will override. Note that to remove or save specifically either a user or system preference you should use only USER|REMOVE or only SYSTEM|REMOVE (or SAVE, as appropriate) -- this method works on only the first priority element found.
    In some systems, the system preferences may not work, in which case, this method silently falls back to using the user preferences instead (although, this fact was probably logged already by writeDefaultPrefs().
    Parameters:
    
    prefName - The name of the preference variable
    
    defaultValue - The default value
    
    operation - The flag word, which should be and disjuction (|) of one or more of ENVIRONMENT, USER, SYSTEM, #SAVE #REMOVE.
    
    Returns:
    
    The value found, or the defaultValue if a value is not found.
  - getPreference
```
public static Map<String,String> getPreference(String prefName,
                                               Map<String,String> defaultValue,
                                               int operation)
```
  - putPreference
```
public static void putPreference(String prefName,
                                 int defaultValue,
                                 int operation)
```
  - putPreference
```
public static void putPreference(String prefName,
                                 boolean defaultValue,
                                 int operation)
```
  - putPreference
```
public static void putPreference(String prefName,
                                 String defaultValue,
                                 int operation)
```
  - putPreference
```
public static void putPreference(String prefName,
                                 Map<String,?> defaultValue,
                                 int operation)
```
  - putPreferenceIfAbsent
```
public static void putPreferenceIfAbsent(String prefName,
                                         int defaultValue,
                                         int operation)
```
  - putPreferenceIfAbsent
```
public static void putPreferenceIfAbsent(String prefName,
                                         String defaultValue,
                                         int operation)
```
  - isPrefPresent
```
private static boolean isPrefPresent(CASA.SilentPreferences p,
                                     String name)
```
  - removePreference
```
public static void removePreference(String prefName,
                                    int operation)
```
  - getPreference
```
public static int getPreference(String prefName,
                                int defaultValue,
                                int function)
```
    Specialized int version of getPreference(String, String, int).
    
    Parameters:
    
    prefName - The name of the preference variable
    
    defaultValue - The default value
    
    function - The flag word, which should be and disjuction (|) of one or more of ENVIRONMENT, USER, SYSTEM, #SAVE #REMOVE.
    
    Returns:
    
    The value found, or the defaultValue if a value is not found.
    
    See Also:
    
    getPreference(String, String, int)
  - getPreference
```
public static boolean getPreference(String prefName,
                                    boolean defaultValue,
                                    int function)
```
    Specialized boolean version of getPreference(String, String, int).
    
    Parameters:
    
    prefName - The name of the preference variable
    
    defaultValue - The default value
    
    function - The flag word, which should be and disjuction (|) of one or more of ENVIRONMENT, USER, SYSTEM, #SAVE #REMOVE.
    
    Returns:
    
    The value found, or the defaultValue if a value is not found.
    
    See Also:
    
    getPreference(String, String, int)
  - getPreference
```
public static long getPreference(String prefName,
                                 long defaultValue,
                                 int function)
```
    Specialized long version of getPreference(String, String, int).
    
    Parameters:
    
    prefName - The name of the preference variable
    
    defaultValue - The default value
    
    function - The flag word, which should be and disjuction (|) of one or more of ENVIRONMENT, USER, SYSTEM, #SAVE #REMOVE.
    
    Returns:
    
    The value found, or the defaultValue if a value is not found.
    
    See Also:
    
    getPreference(String, String, int)
  - finalize
```
protected void finalize()
                 throws Throwable
```
    Overrides:
    
    finalize in class Object
    
    Throws:
    
    Throwable
  - flush
```
public static void flush(int operation)
                  throws IllegalAccessError
```
    Flushes user and/or system preferences to make them persistent.
    
    Parameters:
    
    operation - if the USER bit is set flushes user preferences, if the SYSTEM bit is set flushes system preferences, if neither or both are set then both are flushed.
    
    Throws:
    
    IllegalAccessError
  - setUp
```
public void setUp()
           throws Exception
```
    Throws:
    
    Exception
  - tearDown
```
public void tearDown()
              throws Exception
```
    Throws:
    
    Exception
  - testPrefs
```
public final void testPrefs()
```
  - getPref
```
private static String getPref(String name,
                              String default_)
```
  - getPref
```
private static int getPref(String name,
                           int default_)
```
  - getPref
```
private static boolean getPref(String name,
                               boolean default_)
```
  - setPref
```
private static void setPref(String name,
                            String default_)
```
  - setPref
```
private static void setPref(String name,
                            int default_)
```
  - setPref
```
private static void setPref(String name,
                            boolean default_)
```
  - getLACdefaultport
```
public static int getLACdefaultport()
```
    Returns:
    
    getPref("the lACdefaultport
  - setLACdefaultport
```
public static void setLACdefaultport(int lACdefaultport)
```
    Parameters:
    
    lACdefaultport - the lACdefaultport to set
  - getPutPreferenceIfAbsent
```
public static String getPutPreferenceIfAbsent()
```
    Returns:
    
    getPref("the putPreferenceIfAbsent
  - setPutPreferenceIfAbsent
```
public static void setPutPreferenceIfAbsent(String putPreferenceIfAbsent)
```
    Parameters:
    
    putPreferenceIfAbsent - the putPreferenceIfAbsent to set
  - getRouter
```
public static String getRouter()
```
    Returns:
    
    getPref("the synonymURLs
  - setRouter
```
public static void setRouter(String router)
```
    Parameters:
    
    synonymURLs - the synonymURLs to set
  - getRoot
```
public static String getRoot()
```
    Returns:
    
    getPref("the root
  - setRoot
```
public static void setRoot(String root)
```
    Parameters:
    
    root - the root to set
  - isDieOnLACExitDefault
```
public static boolean isDieOnLACExitDefault()
```
    Returns:
    
    getPref("the dieOnLACExitDefault
  - setDieOnLACExitDefault
```
public static void setDieOnLACExitDefault(boolean dieOnLACExitDefault)
```
    Parameters:
    
    dieOnLACExitDefault - the dieOnLACExitDefault to set
  - getBuildInfo
```
public static String getBuildInfo()
```

Class CASA

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

userPreferences

systemPreferences

ENVIRONMENT

USER

SYSTEM

systemPrefsFailureLogged

Constructor Detail

CASA

Method Detail

writeDefaultPrefs

isSystemPrefsWorking

getPreference

getPreference

putPreference

putPreference

putPreference

putPreference

putPreferenceIfAbsent

putPreferenceIfAbsent

isPrefPresent

removePreference

getPreference

getPreference

getPreference

finalize

flush

setUp

tearDown

testPrefs

getPref

getPref

getPref

setPref

setPref

setPref

getLACdefaultport

setLACdefaultport

getPutPreferenceIfAbsent

setPutPreferenceIfAbsent

getRouter

setRouter

getRoot

setRoot

isDieOnLACExitDefault

setDieOnLACExitDefault

getBuildInfo