Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "ToString() generation"
m (Added examples and ContentAssist integration) |
(Moved down to Community proposals) |
||
| Line 28: | Line 28: | ||
* Option to ignore default toString() of arrays and list elements instead | * Option to ignore default toString() of arrays and list elements instead | ||
* Option to set the maximum number of elements to list from arrays/Collections | * Option to set the maximum number of elements to list from arrays/Collections | ||
| − | |||
=== Nice to have === | === Nice to have === | ||
| − | * Ability to add different implementations of the toString generator (e.g. extension points) | + | * Ability to add different implementations of the toString generator (e.g. extension points) |
* Change hashCode and equals generators to optionally use getters | * Change hashCode and equals generators to optionally use getters | ||
| Line 39: | Line 38: | ||
Feel free to add your ideas | Feel free to add your ideas | ||
| − | + | * Should: Support multiple styles | |
| + | ** Apache Commons-Lang ToStringBuilder | ||
| + | ** Spring Framework's ToStringCreator | ||
| + | ** StringBuilder/StringBuffer | ||
| + | ** String.format() | ||
| + | ** String concatenation (unrecommended) | ||
| + | ** Single return value (e.g. if only one field is chosen, for existing primary keys or Objects with 'names') | ||
| + | * Nice to have: Accessible through quickfix/content assistant | ||
| + | * Nice to have: Support options for include/exclude hashcode, super.toString(), class name, use System.identityHashCode() or Object's hashCode() | ||
[[Category:SOC]] | [[Category:SOC]] | ||
Revision as of 13:42, 4 May 2008
Contents
About
The toString() method is widely used to represent objects as human-readable text and practically every class should implement it. Usually it is very simple: generated string contains the object type and lists values of the most important fields. That's why process of writing such methods can easilly be automated. Eclipse, as the best java IDE in the world, should include functionality of automatic toString() method generation to make its users lives even simpler. Implementing it is the aim of this project.
There were many bugs posted regarding this problem, see bug 26070 for details.
This project is part of 2008 Google Summer of Code.
Participants:
- Student: Mateusz Matela (IRC: mmati)
- Mentor: Markus Alexander Kuppe (IRC: lemmy)
Planned features
Must have
- Integration with 'Generate hashCode() and equals()' dialog
- Changing the string format with templates
- Changing the order of the fields
- Turning generators on/off separately
Should have
- Option to use getters instead of accessing the fields directly
- Option to skip fields with null value
- Option to ignore default toString() of arrays and list elements instead
- Option to set the maximum number of elements to list from arrays/Collections
Nice to have
- Ability to add different implementations of the toString generator (e.g. extension points)
- Change hashCode and equals generators to optionally use getters
Community proposals
Feel free to add your ideas
- Should: Support multiple styles
- Apache Commons-Lang ToStringBuilder
- Spring Framework's ToStringCreator
- StringBuilder/StringBuffer
- String.format()
- String concatenation (unrecommended)
- Single return value (e.g. if only one field is chosen, for existing primary keys or Objects with 'names')
- Nice to have: Accessible through quickfix/content assistant
- Nice to have: Support options for include/exclude hashcode, super.toString(), class name, use System.identityHashCode() or Object's hashCode()