Skip to content

Standardizing Formatter Documentation for Improved Usability #546

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
JumpiiX wants to merge 14 commits into
base: main
Choose a base branch
from
Open

Standardizing Formatter Documentation for Improved Usability #546

Changes from 1 commit
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
07ee2ca
ArrayObjectFormatter
JumpiiX Mar 30, 2024
4240b29
BooleanFormatter
JumpiiX Mar 30, 2024
2ad2638
CharacterFormatter
JumpiiX Mar 30, 2024
415f2ba
ClassObjectFormatter
JumpiiX Mar 30, 2024
8a875eb
ITypeFormatter
JumpiiX Mar 30, 2024
031363c
NullObjectFormatter
JumpiiX Mar 30, 2024
24bb8b0
NumericFormatEnum
JumpiiX Mar 30, 2024
ccc4a6c
NumericFormatter
JumpiiX Mar 30, 2024
bf53d6d
ObjectFormatter
JumpiiX Mar 30, 2024
36eb08a
SimpleTypeFormatter
JumpiiX Mar 30, 2024
61fb970
StringObjectFormatter
JumpiiX Mar 30, 2024
2548835
TypeIdentifiers
JumpiiX Mar 30, 2024
83b4c45
refactor
JumpiiX Mar 30, 2024
86c5e58
refactor
JumpiiX Mar 30, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
BooleanFormatter
  • Loading branch information
@JumpiiX
JumpiiX committed Mar 30, 2024
commit 4240b29580739ce2a363ac5a9d6e774d02f79d09
30 changes: 29 additions & 1 deletion ....core/src/main/java/com/microsoft/java/debug/core/adapter/formatter/BooleanFormatter.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,13 +19,33 @@
import com.sun.jdi.Value;
import com.sun.jdi.VirtualMachine;

/**
* Formatter for boolean values in the Java Debug Interface (JDI).
* Implements the IValueFormatter interface to provide string representations
* and value conversions for boolean types.
*/
public class BooleanFormatter implements IValueFormatter {

/**
* Converts a JDI value object into its string representation.
*
* @param value The value to be formatted to string.
* @param options Additional options affecting the format; unused in this formatter.
* @return A string representation of the boolean value, or "null" if the value is null.
*/
@Override
public String toString(Object value, Map<String, Object> options) {
return value == null ? NullObjectFormatter.NULL_STRING : value.toString();
}

/**
* Determines if this formatter is applicable for the given type,
* specifically checking for boolean types.
*
* @param type The JDI type of the object.
* @param options Additional options that might influence the formatting; unused in this formatter.
* @return True if the type is a boolean, false otherwise.
*/
@Override
public boolean acceptType(Type type, Map<String, Object> options) {
if (type == null) {
Expand All @@ -35,9 +55,17 @@ public boolean acceptType(Type type, Map<String, Object> options) {
return signature0 == BOOLEAN;
}

/**
* Converts a string representation of a boolean into a JDI Value object.
*
* @param value The string value to convert.
* @param type The expected JDI type; used to fetch the VirtualMachine reference.
* @param options Additional conversion options; unused in this formatter.
* @return A JDI Value representing the boolean state indicated by the input string.
*/
@Override
public Value valueOf(String value, Type type, Map<String, Object> options) {
VirtualMachine vm = type.virtualMachine();
return vm.mirrorOf(Boolean.parseBoolean(value));
}
}
}