Question

I would like to make one of my methods “deprecated” = not used anymore.

But still I would like to have it in my API. I just want to show “warning” to anyone using that method.

How can I achieve that?

Answer 1

Use @Deprecated on method.
Don’t forget to add the @deprecated Javadoc tag:

/**
 * Does some thing in old style.
 *
 * @deprecated use {@link #new()} instead.  
 */
@Deprecated
public void old() {
// ...
}