IOSProcessContainer (SAFS API DOCUMENT)

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - java.awt.Window
    - - java.awt.Frame
      - javax.swing.JFrame
        
        org.safs.ios.IOSProcessContainer

All Implemented Interfaces:

java.awt.event.ActionListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.lang.Runnable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.event.DocumentListener, javax.swing.RootPaneContainer, javax.swing.WindowConstants
```
public class IOSProcessContainer
extends javax.swing.JFrame
implements java.awt.event.ActionListener, javax.swing.event.DocumentListener, java.lang.Runnable
```
Provides Process Container functionality in the SAFS/IOS Instruments environment.

Launch Trace Template (CheckBox)
Select if ProcessContainer should launch Instruments with the Trace Template provided below.
Find Template (Button)
File browser to locate desired Instruments Trace Template, if enabled.
Trace Template (TextField)
The path to the Trace Template used to launch Instruments, if enabled.
Set Device and AppName (CheckBox/TextField)
OS X Lion and other scenarios may require the automation to forceably select the desired Device and App Name from the "Choose Target" menu system in the XCode Instruments application if Instruments does not honor the settings stored in the saved Trace Template. Values for the device name and the app name must be entered exactly as they appear in the Instruments menus for proper selection.
IOS Instruments Project Path (TextField)
The path to the Instruments project where Instruments output will be written.
Window Recognition Method (TextField)
The recognition string identifying the topmost Window to process.
Object Recognition Method (TextField)
The recognition string identifying a particular object within the Window to process. To process all components in the Window this recognition string must be the same as the Window Recognition Method.
Process Children (CheckBox)
Process the full hierarchy of children of the object to be processed. This can be time consuming on complex containers. If not selected we will not delve into processing the children.
Window/Object Name (TextField)
The name to give the object to be processed. This is primarily for App Map and other forms of output that attempt to provide friendly names for objects.
Short Strings (CheckBox)
Shorten recognition strings. Do not include each and every layer of the object hierarchy in the recognition strings generated for App Maps.
Process Properties (CheckBox)
Capture and output the list of all available properties on each object that is processed. This can be VERY VERY time consuming, so enable this only when you really want it.
Object Description (TextField)
A short description of the object being processed.
Output Directory (TextField)
The directory where output files should be written.
XML Output (CheckBox)
Output object information in XML format which better shows object hierarchy as well as provides for additional XSL Transformations, if desired. This format cannot currently be imported into an App Map directly.
Output Filename Prefix (TextField)
The root name to give the object output files. The tool will append "Obj.txt" or "Obj.xml" to this root to form the complete filenames for output.
Output Filename (Labels)
Display of the filename that will be output based on the Output Directory and Output Filename Prefix provided.
Append App Map (CheckBox)
If selected we will append all App Map output to the file specified in App Map File. Skips generating App Map output if this is not selected.
App Map File (TextField)
The full path filename to a text-based App Map. The App Map will be created if it does not already exist. It will be appended if it does. Nothing happens if Append App Map is not selected.
Add Component Info (CheckBox)
Component "Type" information will be appended to each object recognition string output. This is useful when using the App Map output to import component information into other tools. However, this information is not compatible with normal App Map usage (during testing) because the recognition string is no longer properly formed.
Map JPG (CheckBox)(Disabled Future Feature)
Attempts to screenshot the window being processed and provide special HTML output allowing the user to interactively examine the snapshot for component information. This can be a time consuming process just like Process Properties.
Run (Button)
Click to begin processing object(s).
Cancel (Button)
Cancels any object processing that may be in progress.
Help (Button)
Displays this document.

The IOSProcessContainer can be successfully launched and used with a command line like:
args -- command-line args to main(). These can be overridden by System property setting using -Dsetting on the command-line. Consult the doc for each individual args setting in the Field and Method details of this document.
Generally, the System property arg is in the format
- "ini=<path to INI initialization file>"
- "map=<path to MAP output file>"
- "out=<path to detailed output file>"
- "doLaunch=false"
- "launchTimeout=30"
- "template=<path to template>"
- "doDeviceapp=false"
- "deviceapp=<-d device menu item -app appname>"
- "iosproject=<path to instruments project>"
- "windowRec=Type=Window;Caption={*}"
- "objectRec=\;Type=Window;Caption={*}"
- "objectName=<objectname>"
- "objectDesc=<object description>"
- "outputviewer=<file viewer/editor>"
- "doChildren=true"
- "doProperties=false"
- "outDir=<path to output directory>"
- "doXMLOut=false"
- "outPrefix=<objectname>"
- "appendMap=false"
- "addInfo=false"
- "mapJPG=false"
- "shortRecognition=false"
- "ignoreChildrenInListTableCombobox=true"
- "delayToRun=4"
- "rsStrategy.qualifier=true"
- "rsStrategy.useName=true"
- "rsStrategy.useid=false"
- "rsStrategy.useGenericType=false"
Author:

Carl Nagle AUG 22, 2011 Original

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

class IOSProcessContainer.RunThread

class IOSProcessContainer.ShutdownListener
- Nested classes/interfaces inherited from class javax.swing.JFrame
  javax.swing.JFrame.AccessibleJFrame
- Nested classes/interfaces inherited from class java.awt.Frame
  java.awt.Frame.AccessibleAWTFrame
- Nested classes/interfaces inherited from class java.awt.Window
  java.awt.Window.AccessibleAWTWindow, java.awt.Window.Type
- Nested classes/interfaces inherited from class java.awt.Container
  java.awt.Container.AccessibleAWTContainer
- Nested classes/interfaces inherited from class java.awt.Component
  java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Nested Classes
Modifier and Type	Class and Description
`class`	`IOSProcessContainer.RunThread`
`class`	`IOSProcessContainer.ShutdownListener`

Field Summary

Fields
Modifier and Type	Field and Description
`(package private) javax.swing.JCheckBox`	`addInfo`
`(package private) java.lang.String`	`ADDINFO_ACTION`
`(package private) javax.swing.JCheckBox`	`appendMap`
`(package private) java.lang.String`	`APPENDMAP_ACTION`
`(package private) javax.swing.JTextField`	`appMapFile`
`(package private) java.lang.String`	`APPMAPFILE_ACTION`
`(package private) javax.swing.JButton`	`appMapFileShow`
`(package private) java.lang.String`	`APPMAPFILESHOW_ACTION`
`protected static java.lang.String[]`	`args` Passed in from static void main()
`(package private) javax.swing.JButton`	`cancel`
`(package private) java.lang.String`	`CANCEL_ACTION`
`(package private) javax.swing.JPanel`	`center`
`(package private) java.lang.String`	`CHILDREN_ACTION`
`(package private) boolean`	`closemap`
`(package private) boolean`	`closeout`
`static boolean`	`DEFAULT_ADDINFO` 'false'
`static boolean`	`DEFAULT_APPENDMAP` 'false'
`static java.lang.String`	`DEFAULT_DELAY_TO_RUN`
`static boolean`	`DEFAULT_DOCHILDREN` 'true'
`static boolean`	`DEFAULT_DOPROPERTIES` 'false'
`static boolean`	`DEFAULT_DOXMLOUT` 'false'
`static java.lang.String`	`DEFAULT_INI_SECTION` null
`static boolean`	`DEFAULT_MAPJPG` 'false'
`static java.lang.String`	`DEFAULT_OBJECTDESC` "WindowName Object"
`static java.lang.String`	`DEFAULT_OBJECTNAME` "WindowName"
`static java.lang.String`	`DEFAULT_OBJECTREC` "Class=UIAWindow;Index=1"
`static java.lang.String`	`DEFAULT_WINDOWREC` "Class=UIAWindow;Index=1"
`(package private) java.lang.String`	`DELAY_TO_RUN`
`(package private) java.lang.String`	`DELAY_TO_RUN_TEXT`
`(package private) java.lang.String`	`DELAY_TO_RUN_TOOLTIP`
`static java.lang.String`	`DELAYING_TEXT`
`(package private) javax.swing.JLabel`	`delayToRunLabel`
`(package private) javax.swing.JTextField`	`delayToRunTextField`
`protected java.lang.String`	`deviceapp` Any device name and app name needed to initialize Instruments upon launch.
`(package private) java.lang.String`	`DEVICEAPP_ACTION`
`(package private) javax.swing.JTextField`	`deviceappPath`
`(package private) javax.swing.JCheckBox`	`doChildren`
`(package private) javax.swing.JCheckBox`	`doDeviceapp`
`(package private) java.lang.String`	`DODEVICEAPP_ACTION`
`(package private) javax.swing.JButton`	`doFindProject`
`(package private) javax.swing.JButton`	`doFindTemplate`
`(package private) javax.swing.JCheckBox`	`doLaunch`
`(package private) javax.swing.JCheckBox`	`doProperties`
`(package private) javax.swing.JCheckBox`	`doShortStrings`
`(package private) javax.swing.JCheckBox`	`doXMLOut`
`(package private) java.lang.String`	`DOXMLOUT_ACTION`
`(package private) javax.swing.JFileChooser`	`filediag`
`(package private) java.lang.String`	`FIND_PROJECT_ACTION`
`(package private) java.lang.String`	`FIND_TEMPLATE_ACTION`
`static java.lang.String`	`FINISHED_TEXT`
`(package private) javax.swing.JButton`	`help`
`(package private) java.lang.String`	`HELP_ACTION`
`(package private) INIFileReadWrite`	`inifile`
`protected java.lang.String`	`inipath` Provided path to initialization file.
`(package private) boolean`	`iniVsTreeFormat`
`(package private) javax.swing.JLabel`	`iosProjectLabel`
`(package private) javax.swing.JTextField`	`iosProjectPath`
`protected boolean`	`launch` True if Process Container should launch Instruments when processing.
`(package private) java.lang.String`	`LAUNCH_ACTION`
`static java.lang.String`	`LAUNCH_TIMEOUT`
`protected int`	`launchTimeout` Seconds to watch for initial Instruments Output before issuing failure.
`static java.lang.String`	`line_separator`
`(package private) java.io.BufferedWriter`	`map`
`(package private) javax.swing.JCheckBox`	`mapJPG`
`(package private) java.lang.String`	`MAPJPG_ACTION`
`protected java.lang.String`	`mappath` Provided path to app map output file.
`(package private) javax.swing.JPanel`	`north`
`(package private) javax.swing.JTextField`	`objectDesc`
`(package private) java.lang.String`	`OBJECTDESC_ACTION`
`(package private) javax.swing.JLabel`	`objectDescLabel`
`(package private) javax.swing.JTextField`	`objectRec`
`(package private) java.lang.String`	`OBJECTREC_ACTION`
`(package private) javax.swing.JLabel`	`objectRecLabel`
`(package private) java.io.BufferedWriter`	`out`
`(package private) java.lang.String`	`OUTFILE_ACTION`
`(package private) java.lang.String`	`OUTFILE_VIEW_ACTION`
`protected java.lang.String`	`outpath` Provided path to detailed output file.
`(package private) javax.swing.JTextField`	`outPrefix`
`(package private) java.lang.String`	`OUTPREFIX_ACTION`
`static java.lang.String`	`OUTPUT_VIEWER_KEY`
`(package private) javax.swing.JTextField`	`outputDir`
`(package private) java.lang.String`	`OUTPUTDIR_ACTION`
`(package private) javax.swing.JLabel`	`outputDirLabel`
`(package private) javax.swing.JButton`	`outputFullname`
`(package private) javax.swing.JLabel`	`outputNameLabel`
`(package private) java.lang.String`	`outputViewer`
`static java.lang.String`	`pathSep` "->"
`(package private) java.lang.String`	`PROJECT_PATH_ACTION`
`(package private) java.lang.String`	`PROPERTIES_ACTION`
`static java.lang.String`	`READY_TEXT` "Click to Run"
`(package private) javax.swing.JButton`	`run`
`(package private) java.lang.String`	`RUN_ACTION`
`static java.lang.String`	`RUNNING_TEXT` "Running..."
`(package private) java.lang.String`	`SHORTEN_ACTION`
`(package private) boolean`	`shortenGeneralRecognition` true if recognition strings should be stripped of intermediate parent recognition info that may be deemed unnecessary.
`(package private) javax.swing.JPanel`	`south`
`static java.lang.String`	`STAF_PROCESS_CONTAINER_PROCESS` "IOSProcessContainer"
`static java.lang.String`	`STAF_PROCESS_CONTAINER_TITLE` "IOS Process Container"
`(package private) javax.swing.JLabel`	`status`
`(package private) java.lang.String`	`TEMPLATE_PATH_ACTION`
`protected java.lang.String`	`templatePath` Provided path to Instruments Trace Template.
`protected boolean`	`theAddInfo` Provided addInfo.
`protected boolean`	`theAppendMap` Provided appendMap.
`protected java.lang.String`	`theDelayToRun` Time to delay before IOSPC starts to search.
`protected boolean`	`theDoChildren` Provided doChildren.
`protected boolean`	`theDoProperties` Provided doProperties.
`protected boolean`	`theDoXMLOut` Provided doXMLOut.
`protected java.lang.String`	`theIosProjectPath` Provided path to Instruments project where log output occurs.
`protected boolean`	`theMapJPG` Provided mapJPG.
`protected java.lang.String`	`theObjectDesc` Provided objectDesc.
`protected java.lang.String`	`theObjectName` Provided objectName.
`protected java.lang.String`	`theObjectRec` Provided objectRec.
`protected java.lang.String`	`theOutDir` Provided output directory.
`protected java.lang.String`	`theOutPrefix` Provided output file prefix.
`protected java.lang.String`	`theWindowRec` Provided windowRec.
`(package private) javax.swing.JLabel`	`traceTemplateLabel`
`(package private) javax.swing.JTextField`	`traceTemplatePath`
`protected boolean`	`usedeviceapp` True if Process Container should set device and app menu items when launching Instruments.
`(package private) boolean`	`weLaunchedSTAF`
`(package private) javax.swing.JTextField`	`windowName`
`(package private) java.lang.String`	`WINDOWNAME_ACTION`
`(package private) javax.swing.JLabel`	`windowNameLabel`
`(package private) javax.swing.JTextField`	`windowRec`
`(package private) java.lang.String`	`WINDOWREC_ACTION`
`(package private) javax.swing.JLabel`	`windowRecLabel`
`(package private) boolean`	`withCommentsAndBlankLines`

Fields inherited from class javax.swing.JFrame
accessibleContext, EXIT_ON_CLOSE, rootPane, rootPaneCheckingEnabled

Fields inherited from class java.awt.Frame
CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR

Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface javax.swing.WindowConstants
DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, HIDE_ON_CLOSE

Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors
Constructor and Description

IOSProcessContainer()
Constructor for ProcessContainer.

Constructors
Constructor and Description
`IOSProcessContainer()` Constructor for ProcessContainer.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`actionPerformed(java.awt.event.ActionEvent event)` Launches separate execution Processor when the RUN button is clicked.
`void`	`changedUpdate(javax.swing.event.DocumentEvent event)` Monitor TextField DocumentChanged Events.
`protected void`	`closeMapPathStream()` Close the Map output file if possible.
`protected void`	`closeOutPathStream()` Close the detailed output file if possible.
`protected void`	`configureUI()` Configures/Toggles UI components based on current/stored settings.
`protected void`	`documentChanged(javax.swing.event.DocumentEvent event)`
`protected void`	`finalize()` shutdown finalization
`protected java.lang.String`	`getArg(java.lang.String argid)` Attempt to retrieve an arg String value via our specific search chain.
`protected boolean`	`getBooleanArg(java.lang.String argid)`
`protected java.lang.String`	`getINIValue(java.lang.String section, java.lang.String item)` Retrieve an item out of the initialization file if such a file was identified.
`protected int`	`getIntegerArg(java.lang.String argid, int defaultValue)`
`void`	`insertUpdate(javax.swing.event.DocumentEvent event)`
`boolean`	`isInterrupted()`
`boolean`	`isStopped()`
`static void`	`main(java.lang.String[] args)` main
`protected java.lang.String`	`makeFullObjPath()`
`protected java.lang.String`	`makeFullPrefix(java.lang.String theDir, java.lang.String thePrefix)` Add the prefix to our stored directory info adding(or not) the File.separator if needed.
`protected void`	`openINIReadWrite()` Open/Process the initialization file if it is found and appears to be valid.
`protected void`	`openMapPathStream()` Open the map output file if possible.
`protected void`	`openOutPathStream()` Open the detailed output file if possible.
`protected void`	`populateFrame()` Build the JFrame GUI for viewing.
`void`	`removeUpdate(javax.swing.event.DocumentEvent event)`
`void`	`run()` 'Runnable' Shutdown Hook registered with JVM to do finalization on exit.
`protected void`	`saveINIFileData(boolean closeit)` Output our current settings to the provided INI file.
`void`	`setInterrupt(boolean _interrupted)`
`void`	`setStopped(boolean _stop)`
`protected void`	`statInfo(java.lang.String info)` Display a status message.
`protected void`	`takeFocus()`

Methods inherited from class javax.swing.JFrame
addImpl, createRootPane, frameInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setIconImage, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update

Methods inherited from class java.awt.Frame
addNotify, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setBackground, setCursor, setExtendedState, setMaximizedBounds, setMenuBar, setOpacity, setResizable, setShape, setState, setTitle, setUndecorated

Methods inherited from class java.awt.Window
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, setVisible, show, toBack, toFront

Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

Methods inherited from interface java.awt.MenuContainer
getFont, postEvent

- Field Detail
  - STAF_PROCESS_CONTAINER_TITLE
```
public static final java.lang.String STAF_PROCESS_CONTAINER_TITLE
```
    "IOS Process Container"
    
    See Also:
    
    Constant Field Values
  - STAF_PROCESS_CONTAINER_PROCESS
```
public static final java.lang.String STAF_PROCESS_CONTAINER_PROCESS
```
    "IOSProcessContainer"
    
    See Also:
    
    Constant Field Values
  - line_separator
```
public static java.lang.String line_separator
```
  - filediag
```
javax.swing.JFileChooser filediag
```
  - out
```
java.io.BufferedWriter out
```
  - map
```
java.io.BufferedWriter map
```
  - closeout
```
boolean closeout
```
  - closemap
```
boolean closemap
```
  - inifile
```
INIFileReadWrite inifile
```
  - withCommentsAndBlankLines
```
boolean withCommentsAndBlankLines
```
  - iniVsTreeFormat
```
boolean iniVsTreeFormat
```
  - shortenGeneralRecognition
```
boolean shortenGeneralRecognition
```
    true if recognition strings should be stripped of intermediate parent recognition info that may be deemed unnecessary. If false, recognition will be FPSM (FullPathSearchMode). JVM Command-Line: -Dsafs.processcontainer.shortRecognition= System Property:safs.processcontainer.shortRecognition= INI File Setting: shortRecognition= main() ARGS Parm: shortRecognition=
    An ARGS Parm overrides the System Property which overrides any INI file setting.
  - args
```
protected static java.lang.String[] args
```
    Passed in from static void main()
  - inipath
```
protected java.lang.String inipath
```
    Provided path to initialization file. JVM Command-Line: -Dsafs.processcontainer.ini= System Property: safs.processcontainer.ini= main() ARGS Parm: ini=
  - launch
```
protected boolean launch
```
    True if Process Container should launch Instruments when processing. JVM Command-Line: -Dsafs.processcontainer.doLaunch= System Property: safs.processcontainer.doLaunch= main() ARGS Parm: doLaunch=
  - usedeviceapp
```
protected boolean usedeviceapp
```
    True if Process Container should set device and app menu items when launching Instruments. JVM Command-Line: -Dsafs.processcontainer.doDeviceapp= System Property: safs.processcontainer.doDeviceapp= main() ARGS Parm: doDeviceapp=
  - launchTimeout
```
protected int launchTimeout
```
    Seconds to watch for initial Instruments Output before issuing failure.
  - LAUNCH_TIMEOUT
```
public static final java.lang.String LAUNCH_TIMEOUT
```
    See Also:
    
    Constant Field Values
  - templatePath
```
protected java.lang.String templatePath
```
    Provided path to Instruments Trace Template. JVM Command-Line: -Dsafs.processcontainer.template= System Property: safs.processcontainer.template= main() ARGS Parm: template=
  - deviceapp
```
protected java.lang.String deviceapp
```
    Any device name and app name needed to initialize Instruments upon launch. This setting, if present, should be in the form "-d device menu item -app appname". The values for -d and -app should be exactly as they appear in the Instruments "Choose Target" menus. JVM Command-Line: -Dsafs.processcontainer.deviceapp= System Property: safs.processcontainer.deviceapp= main() ARGS Parm: deviceapp=
  - theIosProjectPath
```
protected java.lang.String theIosProjectPath
```
    Provided path to Instruments project where log output occurs. JVM Command-Line: -Dsafs.processcontainer.iosproject= System Property: safs.processcontainer.iosproject= main() ARGS Parm: iosproject=
  - mappath
```
protected java.lang.String mappath
```
    Provided path to app map output file. JVM Command-Line: -Dsafs.processcontainer.map= System Property:safs.processcontainer.map= INI File Setting: map= main() ARGS Parm: map=
    An ARGS Parm overrides the System Property which overrides any INI file setting.
  - outpath
```
protected java.lang.String outpath
```
    Provided path to detailed output file. JVM Command-Line: -Dsafs.processcontainer.out= System Property:safs.processcontainer.out= INI File Setting: out= main() ARGS Parm: out=
    An ARGS Parm overrides the System Property which overrides any INI file setting.
  - DEFAULT_WINDOWREC
```
public static final java.lang.String DEFAULT_WINDOWREC
```
    "Class=UIAWindow;Index=1"
    
    See Also:
    
    Constant Field Values
  - theWindowRec
```
protected java.lang.String theWindowRec
```
    Provided windowRec. Defaults to DEFAULT_WINDOWREC JVM Command-Line: "-Dsafs.processcontainer.windowRec=Class=UIAWindow;Index=1" System Property:safs.processcontainer.windowRec="Class=UIAWindow;Index=1" INI File Setting: windowRec="Class=UIAWindow;Index=1" main() ARGS Parm: windowRec="Class=UIAWindow;Index=1"
    An ARGS Parm overrides the System Property which overrides any INI file setting.
  - DEFAULT_OBJECTREC
```
public static final java.lang.String DEFAULT_OBJECTREC
```
    "Class=UIAWindow;Index=1"
    
    See Also:
    
    Constant Field Values
  - theObjectRec
```
protected java.lang.String theObjectRec
```
    Provided objectRec. Defaults to DEFAULT_OBJECTREC JVM Command-Line: "-Dsafs.processcontainer.objectRec=Class=UIAWindow;Index=1" System Property:safs.processcontainer.objectRec="Class=UIAWindow;Index=1" INI File Setting: objectRec="Class=UIAWindow;Index=1" main() ARGS Parm: objectRec="Class=UIAWindow;Index=1"
    An ARGS Parm overrides the System Property which overrides any INI file setting.
  - DEFAULT_OBJECTNAME
```
public static final java.lang.String DEFAULT_OBJECTNAME
```
    "WindowName"
    
    See Also:
    
    Constant Field Values
  - theObjectName
```
protected java.lang.String theObjectName
```
    Provided objectName. Defaults to WindowName JVM Command-Line: "-Dsafs.processcontainer.objectName=WindowName" System Property:safs.processcontainer.objectName="WindowName" INI File Setting: objectName="WindowName" main() ARGS Parm: "objectName=WindowName"
    An ARGS Parm overrides the System Property which overrides any INI file setting.
  - DEFAULT_OBJECTDESC
```
public static final java.lang.String DEFAULT_OBJECTDESC
```
    "WindowName Object"
    
    See Also:
    
    Constant Field Values
  - theObjectDesc
```
protected java.lang.String theObjectDesc
```
    Provided objectDesc. Defaults to WindowName Object JVM Command-Line: "-Dsafs.processcontainer.objectDesc=WindowName Object" System Property:safs.processcontainer.objectDesc="WindowName Object" INI File Setting: objectDesc="WindowName Object" main() ARGS Parm: "objectDesc=WindowName Object"
    An ARGS Parm overrides the System Property which overrides any INI file setting.
  - DEFAULT_DOCHILDREN
```
public static final boolean DEFAULT_DOCHILDREN
```
    'true'
    
    See Also:
    
    Constant Field Values
  - theDoChildren
```
protected boolean theDoChildren
```
    Provided doChildren. Defaults to true. JVM Command-Line: "-Dsafs.processcontainer.doChildren=true" System Property:safs.processcontainer.doChildren="true" INI File Setting: doChildren="true" main() ARGS Parm: "doChildren=true"
    An ARGS Parm overrides the System Property which overrides any INI file setting.
  - DEFAULT_DOPROPERTIES
```
public static final boolean DEFAULT_DOPROPERTIES
```
    'false'
    
    See Also:
    
    Constant Field Values
  - theDoProperties
```
protected boolean theDoProperties
```
    Provided doProperties. Defaults to false. JVM Command-Line: "-Dsafs.processcontainer.doProperties=true" System Property:safs.processcontainer.doProperties="true" INI File Setting: doProperties="true" main() ARGS Parm: "doProperties=true"
    An ARGS Parm overrides the System Property which overrides any INI file setting.
  - DEFAULT_DOXMLOUT
```
public static final boolean DEFAULT_DOXMLOUT
```
    'false'
    
    See Also:
    
    Constant Field Values
  - theDoXMLOut
```
protected boolean theDoXMLOut
```
    Provided doXMLOut. Defaults to false. JVM Command-Line: "-Dsafs.processcontainer.doXMLOut=false" System Property:safs.processcontainer.doXMLOut="false" INI File Setting: doXMLOut="false" main() ARGS Parm: "doXMLOut=false"
    An ARGS Parm overrides the System Property which overrides any INI file setting.
  - theOutDir
```
protected java.lang.String theOutDir
```
    Provided output directory. Defaults to user current directory. JVM Command-Line: "-Dsafs.processcontainer.outDir=<current directory>" System Property:safs.processcontainer.outDir="<current directory>" INI File Setting: outDir="<current directory>" main() ARGS Parm: "outDir=<current directory>"
    An ARGS Parm overrides the System Property which overrides any INI file setting.
  - theOutPrefix
```
protected java.lang.String theOutPrefix
```
    Provided output file prefix. Defaults to WindowName. JVM Command-Line: "-Dsafs.processcontainer.outPrefix=WindowName" System Property:safs.processcontainer.outPrefix="WindowName" INI File Setting: outPrefix="WindowName" main() ARGS Parm: "outPrefix=WindowName"
    An ARGS Parm overrides the System Property which overrides any INI file setting.
  - DEFAULT_APPENDMAP
```
public static final boolean DEFAULT_APPENDMAP
```
    'false'
    
    See Also:
    
    Constant Field Values
  - theAppendMap
```
protected boolean theAppendMap
```
    Provided appendMap. Defaults to false. JVM Command-Line: "-Dsafs.processcontainer.appendMap=false" System Property:safs.processcontainer.appendMap="false" INI File Setting: appendMap="false" main() ARGS Parm: "appendMap=false"
    An ARGS Parm overrides the System Property which overrides any INI file setting.
  - DEFAULT_ADDINFO
```
public static final boolean DEFAULT_ADDINFO
```
    'false'
    
    See Also:
    
    Constant Field Values
  - theAddInfo
```
protected boolean theAddInfo
```
    Provided addInfo. Defaults to false. JVM Command-Line: "-Dsafs.processcontainer.addInfo=false" System Property:safs.processcontainer.addInfo="false" INI File Setting: addInfo="false" main() ARGS Parm: "addInfo=false"
    An ARGS Parm overrides the System Property which overrides any INI file setting.
  - DEFAULT_MAPJPG
```
public static final boolean DEFAULT_MAPJPG
```
    'false'
    
    See Also:
    
    Constant Field Values
  - theMapJPG
```
protected boolean theMapJPG
```
    Provided mapJPG. Defaults to false. JVM Command-Line: "-Dsafs.processcontainer.mapJPG=false" System Property:safs.processcontainer.mapJPG="false" INI File Setting: mapJPG="false" main() ARGS Parm: "mapJPG=false"
    An ARGS Parm overrides the System Property which overrides any INI file setting.
  - DEFAULT_DELAY_TO_RUN
```
public static final java.lang.String DEFAULT_DELAY_TO_RUN
```
    See Also:
    
    Constant Field Values
  - theDelayToRun
```
protected java.lang.String theDelayToRun
```
    Time to delay before IOSPC starts to search. Defaults to 2. JVM Command-Line: "-Dsafs.processcontainer.delayToRun=2" System Property:safs.processcontainer.delayToRun="2" INI File Setting: delayToRun="2" main() ARGS Parm: "delayToRun=2"
    An ARGS Parm overrides the System Property which overrides any INI file setting.
  - DEFAULT_INI_SECTION
```
public static final java.lang.String DEFAULT_INI_SECTION
```
    null
  - pathSep
```
public static final java.lang.String pathSep
```
    "->"
    
    See Also:
    
    Constant Field Values
  - north
```
javax.swing.JPanel north
```
  - center
```
javax.swing.JPanel center
```
  - south
```
javax.swing.JPanel south
```
  - traceTemplateLabel
```
javax.swing.JLabel traceTemplateLabel
```
  - iosProjectLabel
```
javax.swing.JLabel iosProjectLabel
```
  - windowRecLabel
```
javax.swing.JLabel windowRecLabel
```
  - objectRecLabel
```
javax.swing.JLabel objectRecLabel
```
  - windowNameLabel
```
javax.swing.JLabel windowNameLabel
```
  - objectDescLabel
```
javax.swing.JLabel objectDescLabel
```
  - outputDirLabel
```
javax.swing.JLabel outputDirLabel
```
  - outputNameLabel
```
javax.swing.JLabel outputNameLabel
```
  - doLaunch
```
javax.swing.JCheckBox doLaunch
```
  - LAUNCH_ACTION
```
java.lang.String LAUNCH_ACTION
```
  - doDeviceapp
```
javax.swing.JCheckBox doDeviceapp
```
  - DODEVICEAPP_ACTION
```
java.lang.String DODEVICEAPP_ACTION
```
  - doFindTemplate
```
javax.swing.JButton doFindTemplate
```
  - FIND_TEMPLATE_ACTION
```
java.lang.String FIND_TEMPLATE_ACTION
```
  - traceTemplatePath
```
javax.swing.JTextField traceTemplatePath
```
  - TEMPLATE_PATH_ACTION
```
java.lang.String TEMPLATE_PATH_ACTION
```
  - deviceappPath
```
javax.swing.JTextField deviceappPath
```
  - DEVICEAPP_ACTION
```
java.lang.String DEVICEAPP_ACTION
```
  - doFindProject
```
javax.swing.JButton doFindProject
```
  - FIND_PROJECT_ACTION
```
java.lang.String FIND_PROJECT_ACTION
```
  - iosProjectPath
```
javax.swing.JTextField iosProjectPath
```
  - PROJECT_PATH_ACTION
```
java.lang.String PROJECT_PATH_ACTION
```
  - outputFullname
```
javax.swing.JButton outputFullname
```
  - OUTFILE_ACTION
```
java.lang.String OUTFILE_ACTION
```
  - OUTFILE_VIEW_ACTION
```
java.lang.String OUTFILE_VIEW_ACTION
```
  - doProperties
```
javax.swing.JCheckBox doProperties
```
  - PROPERTIES_ACTION
```
java.lang.String PROPERTIES_ACTION
```
  - doChildren
```
javax.swing.JCheckBox doChildren
```
  - CHILDREN_ACTION
```
java.lang.String CHILDREN_ACTION
```
  - appendMap
```
javax.swing.JCheckBox appendMap
```
  - APPENDMAP_ACTION
```
java.lang.String APPENDMAP_ACTION
```
  - addInfo
```
javax.swing.JCheckBox addInfo
```
  - ADDINFO_ACTION
```
java.lang.String ADDINFO_ACTION
```
  - mapJPG
```
javax.swing.JCheckBox mapJPG
```
  - MAPJPG_ACTION
```
java.lang.String MAPJPG_ACTION
```
  - doShortStrings
```
javax.swing.JCheckBox doShortStrings
```
  - SHORTEN_ACTION
```
java.lang.String SHORTEN_ACTION
```
  - windowRec
```
javax.swing.JTextField windowRec
```
  - WINDOWREC_ACTION
```
java.lang.String WINDOWREC_ACTION
```
  - windowName
```
javax.swing.JTextField windowName
```
  - WINDOWNAME_ACTION
```
java.lang.String WINDOWNAME_ACTION
```
  - objectRec
```
javax.swing.JTextField objectRec
```
  - OBJECTREC_ACTION
```
java.lang.String OBJECTREC_ACTION
```
  - objectDesc
```
javax.swing.JTextField objectDesc
```
  - OBJECTDESC_ACTION
```
java.lang.String OBJECTDESC_ACTION
```
  - outputDir
```
javax.swing.JTextField outputDir
```
  - OUTPUTDIR_ACTION
```
java.lang.String OUTPUTDIR_ACTION
```
  - outPrefix
```
javax.swing.JTextField outPrefix
```
  - OUTPREFIX_ACTION
```
java.lang.String OUTPREFIX_ACTION
```
  - doXMLOut
```
javax.swing.JCheckBox doXMLOut
```
  - DOXMLOUT_ACTION
```
java.lang.String DOXMLOUT_ACTION
```
  - appMapFile
```
javax.swing.JTextField appMapFile
```
  - APPMAPFILE_ACTION
```
java.lang.String APPMAPFILE_ACTION
```
  - appMapFileShow
```
javax.swing.JButton appMapFileShow
```
  - APPMAPFILESHOW_ACTION
```
java.lang.String APPMAPFILESHOW_ACTION
```
  - delayToRunLabel
```
javax.swing.JLabel delayToRunLabel
```
  - delayToRunTextField
```
javax.swing.JTextField delayToRunTextField
```
  - DELAY_TO_RUN_TEXT
```
java.lang.String DELAY_TO_RUN_TEXT
```
  - DELAY_TO_RUN_TOOLTIP
```
java.lang.String DELAY_TO_RUN_TOOLTIP
```
  - DELAY_TO_RUN
```
java.lang.String DELAY_TO_RUN
```
  - run
```
javax.swing.JButton run
```
  - RUN_ACTION
```
java.lang.String RUN_ACTION
```
  - cancel
```
javax.swing.JButton cancel
```
  - CANCEL_ACTION
```
java.lang.String CANCEL_ACTION
```
  - help
```
javax.swing.JButton help
```
  - HELP_ACTION
```
java.lang.String HELP_ACTION
```
  - status
```
javax.swing.JLabel status
```
  - weLaunchedSTAF
```
boolean weLaunchedSTAF
```
  - outputViewer
```
java.lang.String outputViewer
```
  - OUTPUT_VIEWER_KEY
```
public static final java.lang.String OUTPUT_VIEWER_KEY
```
    See Also:
    
    Constant Field Values
  - READY_TEXT
```
public static final java.lang.String READY_TEXT
```
    "Click to Run"
    
    See Also:
    
    Constant Field Values
  - RUNNING_TEXT
```
public static final java.lang.String RUNNING_TEXT
```
    "Running..."
    
    See Also:
    
    Constant Field Values
  - DELAYING_TEXT
```
public static final java.lang.String DELAYING_TEXT
```
    See Also:
    
    Constant Field Values
  - FINISHED_TEXT
```
public static final java.lang.String FINISHED_TEXT
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - IOSProcessContainer
```
public IOSProcessContainer()
```
    Constructor for ProcessContainer.
- Method Detail
  - setInterrupt
```
public void setInterrupt(boolean _interrupted)
```
  - isInterrupted
```
public boolean isInterrupted()
```
  - setStopped
```
public void setStopped(boolean _stop)
```
  - isStopped
```
public boolean isStopped()
```
  - openOutPathStream
```
protected void openOutPathStream()
```
    Open the detailed output file if possible. Otherwise we keep the System.out default.
  - closeOutPathStream
```
protected void closeOutPathStream()
```
    Close the detailed output file if possible. Otherwise we keep the System.out default.
  - openMapPathStream
```
protected void openMapPathStream()
```
    Open the map output file if possible. Otherwise we keep the System.out default.
  - closeMapPathStream
```
protected void closeMapPathStream()
```
    Close the Map output file if possible. Otherwise we keep the System.out default.
  - openINIReadWrite
```
protected void openINIReadWrite()
```
    Open/Process the initialization file if it is found and appears to be valid.
  - getINIValue
```
protected java.lang.String getINIValue(java.lang.String section,
                                       java.lang.String item)
```
    Retrieve an item out of the initialization file if such a file was identified.
  - changedUpdate
```
public void changedUpdate(javax.swing.event.DocumentEvent event)
```
    Monitor TextField DocumentChanged Events.
    
    Specified by:
    
    changedUpdate in interface javax.swing.event.DocumentListener
  - insertUpdate
```
public void insertUpdate(javax.swing.event.DocumentEvent event)
```
    Specified by:
    
    insertUpdate in interface javax.swing.event.DocumentListener
  - removeUpdate
```
public void removeUpdate(javax.swing.event.DocumentEvent event)
```
    Specified by:
    
    removeUpdate in interface javax.swing.event.DocumentListener
  - documentChanged
```
protected void documentChanged(javax.swing.event.DocumentEvent event)
```
  - configureUI
```
protected void configureUI()
```
    Configures/Toggles UI components based on current/stored settings.
  - actionPerformed
```
public void actionPerformed(java.awt.event.ActionEvent event)
```
    Launches separate execution Processor when the RUN button is clicked. This will process all known top-level Windows.
    
    Specified by:
    
    actionPerformed in interface java.awt.event.ActionListener
  - populateFrame
```
protected void populateFrame()
```
    Build the JFrame GUI for viewing.
  - statInfo
```
protected void statInfo(java.lang.String info)
```
    Display a status message. This message is also forwarded to Log.info
    
    Parameters:
    
    info - status String to display and log to Log.info
  - makeFullPrefix
```
protected java.lang.String makeFullPrefix(java.lang.String theDir,
                                          java.lang.String thePrefix)
```
    Add the prefix to our stored directory info adding(or not) the File.separator if needed.
  - makeFullObjPath
```
protected java.lang.String makeFullObjPath()
```
  - saveINIFileData
```
protected void saveINIFileData(boolean closeit)
```
    Output our current settings to the provided INI file. If the file was not successfully opened, we will try to create it.
  - finalize
```
protected void finalize()
                 throws java.lang.Throwable
```
    shutdown finalization
    
    Overrides:
    
    finalize in class java.lang.Object
    
    Throws:
    
    java.lang.Throwable
  - getArg
```
protected java.lang.String getArg(java.lang.String argid)
```
    Attempt to retrieve an arg String value via our specific search chain. First try the command-line args directly for a match.
    If not found there try the the appropriate System property that would have been set on the command-line..
    If not found there try looking for a stored value in the INI file.
    Returns:
    
    String value of the arg or null if the value was not found.
  - getBooleanArg
```
protected boolean getBooleanArg(java.lang.String argid)
```
    Returns:
    
    true if arg String value equals ignoring case to "true". Any other String value will result in a return of false.
  - getIntegerArg
```
protected int getIntegerArg(java.lang.String argid,
                            int defaultValue)
```
    Returns:
    
    the integer value of the retrieved arg/ini value or the provided defaultValue. The value will be limited to >= 0.
  - run
```
public void run()
```
    'Runnable' Shutdown Hook registered with JVM to do finalization on exit. Users MUST NOT call this as it will execute the Object's finalize() method.
    
    Specified by:
    
    run in interface java.lang.Runnable
  - takeFocus
```
protected void takeFocus()
```
  - main
```
public static void main(java.lang.String[] args)
```
    main

Class IOSProcessContainer

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JFrame

Nested classes/interfaces inherited from class java.awt.Frame

Nested classes/interfaces inherited from class java.awt.Window

Nested classes/interfaces inherited from class java.awt.Container

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class javax.swing.JFrame

Fields inherited from class java.awt.Frame

Fields inherited from class java.awt.Component

Fields inherited from interface javax.swing.WindowConstants

Fields inherited from interface java.awt.image.ImageObserver

Constructor Summary

Method Summary

Methods inherited from class javax.swing.JFrame

Methods inherited from class java.awt.Frame

Methods inherited from class java.awt.Window

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

Methods inherited from interface java.awt.MenuContainer

Field Detail

STAF_PROCESS_CONTAINER_TITLE

STAF_PROCESS_CONTAINER_PROCESS

line_separator

filediag

out

map

closeout

closemap

inifile

withCommentsAndBlankLines

iniVsTreeFormat

shortenGeneralRecognition

args

inipath

launch

usedeviceapp

launchTimeout

LAUNCH_TIMEOUT

templatePath

deviceapp

theIosProjectPath

mappath

outpath

DEFAULT_WINDOWREC

theWindowRec

DEFAULT_OBJECTREC

theObjectRec

DEFAULT_OBJECTNAME

theObjectName

DEFAULT_OBJECTDESC

theObjectDesc

DEFAULT_DOCHILDREN

theDoChildren

DEFAULT_DOPROPERTIES

theDoProperties

DEFAULT_DOXMLOUT

theDoXMLOut

theOutDir

theOutPrefix

DEFAULT_APPENDMAP

theAppendMap

DEFAULT_ADDINFO

theAddInfo

DEFAULT_MAPJPG

theMapJPG

DEFAULT_DELAY_TO_RUN

theDelayToRun

DEFAULT_INI_SECTION

pathSep

north

center

south

traceTemplateLabel

iosProjectLabel

windowRecLabel

objectRecLabel

windowNameLabel