Issue Details (XML | Word | Printable)

Key: DOL-144
Type: Task Task
Status: Open Open
Priority: Major Major
Assignee: Dierk Koenig
Reporter: Dierk Koenig
Votes: 0
Watchers: 0
Operations

If you were logged in you would be able to see more operations.
Dolphin

make sure the solution for deprecation warnings are easy to access from any kind of code

Created: 27/Jan/15 11:36 AM   Updated: 27/Jan/15 11:36 AM
Component/s: Documentation
Affects Version/s: 0.11
Fix Version/s: 1.0
Security Level: public

Time Tracking:
Not Specified


 Description  « Hide
from the mailing list:

would it be possible to add/generate some javadoc from groovy classes?
Groovy sources are not included in the src jar, which makes it much harder to determine proper api usage for groovy bases code compared to the java based code.

example:
JFXBinder.bind(World.PROP_ONLINE).of(world).to("visible").of(statusOfflineImage, (Converter<Boolean,Boolean>) (Boolean value) -> !value);

shows a deprecation warning for of.
of is a method of BindPojoTargetOfAble which has no javadoc and attached source shows:

@Deprecated
public void of(Object target, Converter converter) { compiled code }

The actual source is located at subprojects/shared/src/main/groovy/org/opendolphin/binding/Binder.groovy opposed to exptected BindPojoTargetOfAble.groovy
which can make it a bit hard to locate:

@Deprecated // TODO (DOL-93) remove legacy code
void of(Object target, Converter converter) {
if (log.isLoggable(Level.WARNING)) { log.warning("bind(<property>).of(<source>).to(<property>).of(<target>, <converter>) is deprecated! Please use: bind(<property>).of(<source>).using(<converter>).to(<property>).of(<target>)"); }

At which point I can conclude I should have used .using method instead.

Cheers,
Timon



 All   Comments   Work Log   Change History      Sort Order: Ascending order - Click to sort in descending order
There are no comments yet on this issue.