Можно ли повторно использовать описания @param в JavaDoc? - PullRequest
Новая
       2

Можно ли повторно использовать описания @param в JavaDoc?

2 голосов
/ 24 июня 2009

У меня есть удобный класс для кодирования URI. В нем я создал три метода, которые я использую в зависимости от того, насколько конкретно я должен быть. Мне интересно, есть ли умный способ повторно использовать @param описания в этом случае, используя JavaDoc? (Я не нашел) 

public class URLCreator {
    public static String getURLString(String host, int port, String path) {
        return getURLString("http", host, port, path, null);
    }
    public static String getURLString(String scheme, String host, int port, String path) {
        return getURLString(scheme, host, port, path, null);
    }
    public static String getURLString(String scheme, String host, int port, String path, String fragment) {
        try {
            URI uri = new URI(scheme, null, host, port, path, null, fragment);
            return uri.toString();
        } catch (URISyntaxException e) {
            throw new RuntimeException(e);
        }
    }
}

1 Ответ

0 голосов
/ 25 июня 2009

Нет. Копирование работает для переопределенных, но не для перегруженных методов. http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/javadoc.html#inheritingcomments

...