Debugger (P2J - Progress 4GL to Java Conversion and Runtime)

java.lang.Object
- com.goldencode.p2j.util.Debugger

```
public class Debugger
extends java.lang.Object
```
DEBUGGER legacy resource implementation.
FWD just implements stub methods for the DEBUGGER attributes/methods - in case an attribute or a method returns a logical, a false value will be returned.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

private static class Debugger.WorkArea
Stores global data relating to the state of the current context.

Nested Classes
Modifier and Type	Class and Description
`private static class`	`Debugger.WorkArea` Stores global data relating to the state of the current context.

Field Summary

Fields
Modifier and Type Field and Description

private static ContextLocal<Debugger.WorkArea> work
Context-local instance.

Fields
Modifier and Type	Field and Description
`private static ContextLocal<Debugger.WorkArea>`	`work` Context-local instance.

Constructor Summary

Constructors
Constructor and Description

Debugger()

Constructors
Constructor and Description
`Debugger()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static handle`	`asHandle()` Get a the instance for the DEBUGGER system handle.
`static logical`	`cancelBreak()` Definition of the DEBUGGER:CANCEL-BREAK() method.
`static logical`	`cancelBreak(character procName)` Definition of the DEBUGGER:CANCEL-BREAK() method.
`static logical`	`cancelBreak(character procName, int64 line)` Definition of the DEBUGGER:CANCEL-BREAK() method.
`static logical`	`cancelBreak(character procName, long line)` Definition of the DEBUGGER:CANCEL-BREAK() method.
`static logical`	`cancelBreak(java.lang.String procName)` Definition of the DEBUGGER:CANCEL-BREAK() method.
`static logical`	`cancelBreak(java.lang.String procName, int64 line)` Definition of the DEBUGGER:CANCEL-BREAK() method.
`static logical`	`cancelBreak(java.lang.String procName, long line)` Definition of the DEBUGGER:CANCEL-BREAK() method.
`static logical`	`clear()` Returns the resource to it's clear state.
`static logical`	`debug()` Definition of the DEBUGGER:DEBUG() method.
`static logical`	`displayMessage(character msg)` Definition of the DEBUGGER:DISPLAY-MESSAGE() method.
`static logical`	`displayMessage(java.lang.String msg)` Definition of the DEBUGGER:DISPLAY-MESSAGE() method.
`static java.lang.Long`	`id()` Get this resource's ID.
`static void`	`id(long id)` Set this resource's ID.
`static logical`	`initiate()` Definition of the DEBUGGER:INITIATE() method.
`static handle`	`instantiatingProcedure()` Getter for the INSTANTIATING-PROCEDURE attribute.
`static logical`	`isVisible()` Get the VISIBLE writable attribute.
`static void`	`readOnlyError(java.lang.String attribute)` API needed to implement read-only attribute assignment (a 4GL "feature").
`static void`	`readOnlyError(java.lang.String attribute, java.lang.Object expr)` API needed to implement read-only attribute assignment (a 4GL "feature").
`static character`	`resourceType()` Get the type of its associated handle.
`static logical`	`setBreak()` Definition of the DEBUGGER:SET-BREAK() method.
`static logical`	`setBreak(character procName)` Definition of the DEBUGGER:SET-BREAK() method.
`static logical`	`setBreak(character procName, int64 line)` Definition of the DEBUGGER:SET-BREAK() method.
`static logical`	`setBreak(character procName, long line)` Definition of the DEBUGGER:SET-BREAK() method.
`static logical`	`setBreak(java.lang.String procName)` Definition of the DEBUGGER:SET-BREAK() method.
`static logical`	`setBreak(java.lang.String procName, int64 line)` Definition of the DEBUGGER:SET-BREAK() method.
`static logical`	`setBreak(java.lang.String procName, long line)` Definition of the DEBUGGER:SET-BREAK() method.
`static void`	`setVisible(boolean visible)` Set the VISIBLE writable attribute.
`static void`	`setVisible(logical visible)` Set the VISIBLE writable attribute.
`static boolean`	`unknown()` Implementation for the `WrappedResource.unknown()` API.
`static boolean`	`valid()` Implementation for the `WrappedResource.valid()` API.

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

- Field Detail
  - work
```
private static final ContextLocal<Debugger.WorkArea> work
```
    Context-local instance.
- Constructor Detail
  - Debugger
```
public Debugger()
```
- Method Detail
  - asHandle
```
public static handle asHandle()
```
    Get a the instance for the DEBUGGER system handle. Is obtained using a call to the StaticProxy.obtain(Class, Class[]), using the DebuggerResource interface and its methods implemented by these classes: Debugger.
    
    Returns:
    
    See above.
  - id
```
public static java.lang.Long id()
```
    Get this resource's ID.
    
    Returns:
    
    The resource's ID.
  - id
```
public static void id(long id)
```
    Set this resource's ID.
    This is a no-op for system handles.
    
    Parameters:
    
    id - The resource's ID.
  - resourceType
```
public static character resourceType()
```
    Get the type of its associated handle.
    
    Returns:
    
    Always return the PSEUDO-WIDGET value.
  - valid
```
public static boolean valid()
```
    Implementation for the WrappedResource.valid() API.
    
    Returns:
    
    Always true.
  - unknown
```
public static boolean unknown()
```
    Implementation for the WrappedResource.unknown() API.
    
    Returns:
    
    Always false.
  - instantiatingProcedure
```
public static handle instantiatingProcedure()
```
    Getter for the INSTANTIATING-PROCEDURE attribute.
    
    Returns:
    
    Always unknown value.
  - isVisible
```
public static logical isVisible()
```
    Get the VISIBLE writable attribute.
    
    Returns:
    
    FWD must always return false.
  - setVisible
```
public static void setVisible(boolean visible)
```
    Set the VISIBLE writable attribute.
    
    Parameters:
    
    visible - The new value for the VISIBLE attribute.
  - setVisible
```
public static void setVisible(logical visible)
```
    Set the VISIBLE writable attribute.
    
    Parameters:
    
    visible - The new value for the VISIBLE attribute.
  - clear
```
public static logical clear()
```
    Returns the resource to it's clear state.
    
    Returns:
    
    FWD must always return false.
  - cancelBreak
```
public static logical cancelBreak()
```
    Definition of the DEBUGGER:CANCEL-BREAK() method.
    
    Returns:
    
    FWD must always return false.
  - cancelBreak
```
public static logical cancelBreak(character procName)
```
    Definition of the DEBUGGER:CANCEL-BREAK() method.
    
    Parameters:
    
    procName - The target procedure name.
    
    Returns:
    
    FWD must always return false.
  - cancelBreak
```
public static logical cancelBreak(java.lang.String procName)
```
    Definition of the DEBUGGER:CANCEL-BREAK() method.
    
    Parameters:
    
    procName - The target procedure name.
    
    Returns:
    
    FWD must always return false.
  - cancelBreak
```
public static logical cancelBreak(character procName,
                                  int64 line)
```
    Definition of the DEBUGGER:CANCEL-BREAK() method.
    
    Parameters:
    
    procName - The target procedure name.
    
    line - The line number on which the breakpoint must be unset.
    
    Returns:
    
    FWD must always return false.
  - cancelBreak
```
public static logical cancelBreak(character procName,
                                  long line)
```
    Definition of the DEBUGGER:CANCEL-BREAK() method.
    
    Parameters:
    
    procName - The target procedure name.
    
    line - The line number on which the breakpoint must be unset.
    
    Returns:
    
    FWD must always return false.
  - cancelBreak
```
public static logical cancelBreak(java.lang.String procName,
                                  int64 line)
```
    Definition of the DEBUGGER:CANCEL-BREAK() method.
    
    Parameters:
    
    procName - The target procedure name.
    
    line - The line number on which the breakpoint must be unset.
    
    Returns:
    
    FWD must always return false.
  - cancelBreak
```
public static logical cancelBreak(java.lang.String procName,
                                  long line)
```
    Definition of the DEBUGGER:CANCEL-BREAK() method.
    
    Parameters:
    
    procName - The target procedure name.
    
    line - The line number on which the breakpoint must be unset.
    
    Returns:
    
    FWD must always return false.
  - debug
```
public static logical debug()
```
    Definition of the DEBUGGER:DEBUG() method.
    
    Returns:
    
    FWD must always return false.
  - displayMessage
```
public static logical displayMessage(character msg)
```
    Definition of the DEBUGGER:DISPLAY-MESSAGE() method.
    
    Parameters:
    
    msg - The message to be shown.
    
    Returns:
    
    FWD must always return false.
  - displayMessage
```
public static logical displayMessage(java.lang.String msg)
```
    Definition of the DEBUGGER:DISPLAY-MESSAGE() method.
    
    Parameters:
    
    msg - The message to be shown.
    
    Returns:
    
    FWD must always return false.
  - initiate
```
public static logical initiate()
```
    Definition of the DEBUGGER:INITIATE() method.
    
    Returns:
    
    FWD must always return false.
  - setBreak
```
public static logical setBreak()
```
    Definition of the DEBUGGER:SET-BREAK() method.
    
    Returns:
    
    FWD must always return false.
  - setBreak
```
public static logical setBreak(character procName)
```
    Definition of the DEBUGGER:SET-BREAK() method.
    
    Parameters:
    
    procName - The target procedure name.
    
    Returns:
    
    FWD must always return false.
  - setBreak
```
public static logical setBreak(java.lang.String procName)
```
    Definition of the DEBUGGER:SET-BREAK() method.
    
    Parameters:
    
    procName - The target procedure name.
    
    Returns:
    
    FWD must always return false.
  - setBreak
```
public static logical setBreak(character procName,
                               int64 line)
```
    Definition of the DEBUGGER:SET-BREAK() method.
    
    Parameters:
    
    procName - The target procedure name.
    
    line - The line number on which the breakpoint must be set.
    
    Returns:
    
    FWD must always return false.
  - setBreak
```
public static logical setBreak(character procName,
                               long line)
```
    Definition of the DEBUGGER:SET-BREAK() method.
    
    Parameters:
    
    procName - The target procedure name.
    
    line - The line number on which the breakpoint must be set.
    
    Returns:
    
    FWD must always return false.
  - setBreak
```
public static logical setBreak(java.lang.String procName,
                               int64 line)
```
    Definition of the DEBUGGER:SET-BREAK() method.
    
    Parameters:
    
    procName - The target procedure name.
    
    line - The line number on which the breakpoint must be set.
    
    Returns:
    
    FWD must always return false.
  - setBreak
```
public static logical setBreak(java.lang.String procName,
                               long line)
```
    Definition of the DEBUGGER:SET-BREAK() method.
    
    Parameters:
    
    procName - The target procedure name.
    
    line - The line number on which the breakpoint must be set.
    
    Returns:
    
    FWD must always return false.
  - readOnlyError
```
public static void readOnlyError(java.lang.String attribute)
```
    API needed to implement read-only attribute assignment (a 4GL "feature").
    
    Parameters:
    
    attribute - The attribute's name.
    
    See Also:
    
    handle.readOnlyError(handle, String)
  - readOnlyError
```
public static void readOnlyError(java.lang.String attribute,
                                 java.lang.Object expr)
```
    API needed to implement read-only attribute assignment (a 4GL "feature").
    
    Parameters:
    
    attribute - The attribute's name.
    
    expr - The value which is attempted to be assigned to the read-only attribute.
    
    See Also:
    
    handle.readOnlyError(handle, String, Object)

Class Debugger

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

work

Constructor Detail

Debugger

Method Detail

asHandle

id

id

resourceType

valid

unknown

instantiatingProcedure

isVisible

setVisible

setVisible

clear

cancelBreak

cancelBreak

cancelBreak

cancelBreak

cancelBreak

cancelBreak

cancelBreak

debug

displayMessage

displayMessage

initiate

setBreak

setBreak

setBreak

setBreak

setBreak

setBreak

setBreak

readOnlyError

readOnlyError