Variable (Google Cloud Debugger API v2 (Rev. 8) 1.22.0)

java.lang.Object
- java.util.AbstractMap<java.lang.String,java.lang.Object>
- - com.google.api.client.util.GenericData
  - - com.google.api.client.json.GenericJson
    - - com.google.api.services.clouddebugger.v2.model.Variable

All Implemented Interfaces:

java.lang.Cloneable, java.util.Map<java.lang.String,java.lang.Object>
```
public final class Variable
extends com.google.api.client.json.GenericJson
```
Represents a variable or an argument possibly of a compound object type. Note how the following variables are represented: 1) A simple variable: int x = 5 { name: "x", value: "5", type: "int" } // Captured variable 2) A compound object: struct T { int m1; int m2; }; T x = { 3, 7 }; { // Captured variable name: "x", type: "T", members { name: "m1", value: "3", type: "int" }, members { name: "m2", value: "7", type: "int" } } 3) A pointer where the pointee was captured: T x = { 3, 7 }; T* p = { // Captured variable name: "p", type: "T*", value: "0x00500500", members { name: "m1", value: "3", type: "int" }, members { name: "m2", value: "7", type: "int" } } 4) A pointer where the pointee was not captured: T* p = new T; { // Captured variable name: "p", type: "T*", value: "0x00400400" status { is_error: true, description { format: "unavailable" } } } The status should describe the reason for the missing value, such as ``, ``, ` `. Note that a null pointer should not have members. 5) An unnamed value: int* p = new int(7); { // Captured variable name: "p", value: "0x00500500", type: "int*", members { value: "7", type: "int" } } 6) An unnamed pointer where the pointee was not captured: int* p = new int(7); int** pp = { // Captured variable name: "pp", value: "0x00500500", type: "int**", members { value: "0x00400400", type: "int*" status { is_error: true, description: { format: "unavailable" } } } } } To optimize computation, memory and network traffic, variables that repeat in the output multiple times can be stored once in a shared variable table and be referenced using the `var_table_index` field. The variables stored in the shared table are nameless and are essentially a partition of the complete variable. To reconstruct the complete variable, merge the referencing variable with the referenced variable. When using the shared variable table, the following variables: T x = { 3, 7 }; T* p = T& r = x; { name: "x", var_table_index: 3, type: "T" } // Captured variables { name: "p", value "0x00500500", type="T*", var_table_index: 3 } { name: "r", type="T&", var_table_index: 3 } { // Shared variable table entry #3: members { name: "m1", value: "3", type: "int" }, members { name: "m2", value: "7", type: "int" } } Note that the pointer address is stored with the referencing variable and not with the referenced variable. This allows the referenced variable to be shared between pointers and references. The type field is optional. The debugger agent may or may not support it.
This is the Java data model class that specifies how to parse/serialize into the JSON that is transmitted over HTTP when working with the Google Cloud Debugger API. For a detailed explanation see: https://developers.google.com/api-client-library/java/google-http-java-client/json

Author:

Google, Inc.

Nested Class Summary
- Nested classes/interfaces inherited from class com.google.api.client.util.GenericData
  com.google.api.client.util.GenericData.Flags
- Nested classes/interfaces inherited from class java.util.AbstractMap
  java.util.AbstractMap.SimpleEntry<K,V>, java.util.AbstractMap.SimpleImmutableEntry<K,V>
- Nested classes/interfaces inherited from interface java.util.Map
  java.util.Map.Entry<K,V>

Constructor Summary

Constructors
Constructor and Description

Variable()

Constructors
Constructor and Description
`Variable()`

Method Summary

Methods
Modifier and Type	Method and Description
`Variable`	`clone()`
`java.util.List<Variable>`	`getMembers()` Members contained or pointed to by the variable.
`java.lang.String`	`getName()` Name of the variable, if any.
`StatusMessage`	`getStatus()` Status associated with the variable.
`java.lang.String`	`getType()` Variable type (e.g.
`java.lang.String`	`getValue()` Simple value of the variable.
`java.lang.Integer`	`getVarTableIndex()` Reference to a variable in the shared variable table.
`Variable`	`set(java.lang.String fieldName, java.lang.Object value)`
`Variable`	`setMembers(java.util.List<Variable> members)` Members contained or pointed to by the variable.
`Variable`	`setName(java.lang.String name)` Name of the variable, if any.
`Variable`	`setStatus(StatusMessage status)` Status associated with the variable.
`Variable`	`setType(java.lang.String type)` Variable type (e.g.
`Variable`	`setValue(java.lang.String value)` Simple value of the variable.
`Variable`	`setVarTableIndex(java.lang.Integer varTableIndex)` Reference to a variable in the shared variable table.

Methods inherited from class com.google.api.client.json.GenericJson
getFactory, setFactory, toPrettyString, toString

Methods inherited from class com.google.api.client.util.GenericData
entrySet, get, getClassInfo, getUnknownKeys, put, putAll, remove, setUnknownKeys

Methods inherited from class java.util.AbstractMap
clear, containsKey, containsValue, equals, hashCode, isEmpty, keySet, size, values

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Variable
```
public Variable()
```
- Method Detail
  - getMembers
```
public java.util.List<Variable> getMembers()
```
    Members contained or pointed to by the variable.
    
    Returns:
    value or null for none
  - setMembers
```
public Variable setMembers(java.util.List<Variable> members)
```
    Members contained or pointed to by the variable.
    
    Parameters:
    members - members or null for none
  - getName
```
public java.lang.String getName()
```
    Name of the variable, if any.
    
    Returns:
    value or null for none
  - setName
```
public Variable setName(java.lang.String name)
```
    Name of the variable, if any.
    
    Parameters:
    name - name or null for none
  - getStatus
```
public StatusMessage getStatus()
```
    Status associated with the variable. This field will usually stay unset. A status of a single variable only applies to that variable or expression. The rest of breakpoint data still remains valid. Variables might be reported in error state even when breakpoint is not in final state. The message may refer to variable name with `refers_to` set to `VARIABLE_NAME`. Alternatively `refers_to` will be set to `VARIABLE_VALUE`. In either case variable value and members will be unset. Example of error message applied to name: `Invalid expression syntax`. Example of information message applied to value: `Not captured`. Examples of error message applied to value: * `Malformed string`, * `Field f not found in class C` * `Null pointer dereference`
    
    Returns:
    value or null for none
  - setStatus
```
public Variable setStatus(StatusMessage status)
```
    Status associated with the variable. This field will usually stay unset. A status of a single variable only applies to that variable or expression. The rest of breakpoint data still remains valid. Variables might be reported in error state even when breakpoint is not in final state. The message may refer to variable name with `refers_to` set to `VARIABLE_NAME`. Alternatively `refers_to` will be set to `VARIABLE_VALUE`. In either case variable value and members will be unset. Example of error message applied to name: `Invalid expression syntax`. Example of information message applied to value: `Not captured`. Examples of error message applied to value: * `Malformed string`, * `Field f not found in class C` * `Null pointer dereference`
    
    Parameters:
    status - status or null for none
  - getType
```
public java.lang.String getType()
```
    Variable type (e.g. `MyClass`). If the variable is split with `var_table_index`, `type` goes next to `value`. The interpretation of a type is agent specific. It is recommended to include the dynamic type rather than a static type of an object.
    
    Returns:
    value or null for none
  - setType
```
public Variable setType(java.lang.String type)
```
    Variable type (e.g. `MyClass`). If the variable is split with `var_table_index`, `type` goes next to `value`. The interpretation of a type is agent specific. It is recommended to include the dynamic type rather than a static type of an object.
    
    Parameters:
    type - type or null for none
  - getValue
```
public java.lang.String getValue()
```
    Simple value of the variable.
    
    Returns:
    value or null for none
  - setValue
```
public Variable setValue(java.lang.String value)
```
    Simple value of the variable.
    
    Parameters:
    value - value or null for none
  - getVarTableIndex
```
public java.lang.Integer getVarTableIndex()
```
    Reference to a variable in the shared variable table. More than one variable can reference the same variable in the table. The `var_table_index` field is an index into `variable_table` in Breakpoint.
    
    Returns:
    value or null for none
  - setVarTableIndex
```
public Variable setVarTableIndex(java.lang.Integer varTableIndex)
```
    Reference to a variable in the shared variable table. More than one variable can reference the same variable in the table. The `var_table_index` field is an index into `variable_table` in Breakpoint.
    
    Parameters:
    varTableIndex - varTableIndex or null for none
  - set
```
public Variable set(java.lang.String fieldName,
           java.lang.Object value)
```
    Overrides:
    
    set in class com.google.api.client.json.GenericJson
  - clone
```
public Variable clone()
```
    Overrides:
    
    clone in class com.google.api.client.json.GenericJson

Google Cloud Debugger API v2 (revision 8)

Class Variable

Nested Class Summary

Nested classes/interfaces inherited from class com.google.api.client.util.GenericData

Nested classes/interfaces inherited from class java.util.AbstractMap

Nested classes/interfaces inherited from interface java.util.Map

Constructor Summary

Method Summary

Methods inherited from class com.google.api.client.json.GenericJson

Methods inherited from class com.google.api.client.util.GenericData

Methods inherited from class java.util.AbstractMap

Methods inherited from class java.lang.Object

Constructor Detail

Variable

Method Detail

getMembers

setMembers

getName

setName

getStatus

setStatus

getType

setType

getValue

setValue

getVarTableIndex

setVarTableIndex

set

clone