Найти авторов документации класса стандартной библиотеки Java

для моего исследования я хотел бы знать авторов некоторых классов стандартной библиотеки Java, таких как Сокет. Я попробовал это с openjdk, но не очень успешно. Я хотел бы видеть, какой автор написал какую часть документации API.


person Selphiron    schedule 30.08.2016    source источник
comment
есть аннотация @author unascribed.   -  person DimaSan    schedule 30.08.2016
comment
Если у вас есть какие-либо проблемы с API, вы, вероятно, можете сообщить об ошибке здесь - bugreport.java.com   -  person Fairoz    schedule 30.08.2016
comment
Используйте Ide Like netbeans или eclipse, введите какой-нибудь код и нажмите ctlr+правую кнопку мыши на Like ArrayList, чтобы узнать, что вы ищете.   -  person Bibek Shakya    schedule 30.08.2016
comment
@DimaSan Где ты это нашел? Согласно это без подписи означает, что автор неизвестен. Неужели авторы класса Socket и его документации неизвестны?   -  person Selphiron    schedule 30.08.2016
comment
@Selphiron Да, это так. Джош Блох несколько раз говорил (в том числе на Devoxx несколько лет назад), что он проектировал какие-то части API, но не помнит точно, кто что для чего написал. Так что, даже если вы назовете это именем, автор, возможно, не сможет на самом деле сказать «да», это написал я.   -  person Olivier Grégoire    schedule 30.08.2016


Ответы (1)


Я нашел это в JavaDoc для класса java.net.Socket:

/**
 * This class implements client sockets (also called just
 * "sockets"). A socket is an endpoint for communication
 * between two machines.
 * <p>
 * The actual work of the socket is performed by an instance of the
 * {@code SocketImpl} class. An application, by changing
 * the socket factory that creates the socket implementation,
 * can configure itself to create sockets appropriate to the local
 * firewall.
 *
 * @author  unascribed
 * @see     java.net.Socket#setSocketImplFactory(java.net.SocketImplFactory)
 * @see     java.net.SocketImpl
 * @see     java.nio.channels.SocketChannel
 * @since   JDK1.0
 */
public
class Socket implements java.io.Closeable

Таким же образом можно получить автора класса SocketChannel:

* @author Mark Reinhold
* @author JSR-51 Expert Group
* @since 1.4

И SocketImplFactory интерфейс:

* @author  Arthur van Hoff
* @see     java.net.Socket
* @see     java.net.ServerSocket
* @since   JDK1.0

Видите ли, этот класс был включен в версию JDK 1.0, выпущенную в 1996 году. Вероятно, была группа авторов, и они не указывают свои имена в JavaDoc.

ОБНОВЛЕНИЕ. Как обнаружил @Selphiron, существуют репозитории OpenJDK Mercurial. В левом верхнем углу много полезной технической информации, такой как логи, ветки, теги и так далее.

Пример для Gregorian Calendar класса.

person DimaSan    schedule 30.08.2016
comment
А, кажется, спасибо. Это почти то, что мне нужно. Теперь есть способ увидеть, какой автор что сделал? (при условии, что авторов несколько). Может в истории файла? Где я мог это найти? - person Selphiron; 30.08.2016
comment
Вы знаете, где я могу найти журнал SVN? Возможно, если есть что-то вроде Python Mercurial, Я могу вручную узнать, сколько авторов внесли свой вклад в документацию по API. - person Selphiron; 30.08.2016
comment
Вы можете найти такую ​​информацию для каждого общедоступного репозитория GitHub. Но я не знаю об источниках JDK. Если вы найдете какую-либо информацию о нем, пожалуйста, дайте мне знать. Я также сообщу вам, если я что-то найду. - person DimaSan; 30.08.2016
comment
Думаю, я нашел это. Java, похоже, использует Mercurial, как и Python, в качестве общедоступного репозитория. Посмотрите здесь. Изменить: вам нужно перемещаться по системе. Вот, например, класс GregorianCalendar Edit2: в левом нижнем углу есть аннотации и журнал файлов, что довольно близко к тому, что мне нужно. Вы можете добавить это к своему ответу, чтобы я мог отметить его как правильный (в конце концов, я нашел это с вашей помощью) - person Selphiron; 30.08.2016
comment
да, в журналах действительно много информации об истории. Отличная работа! Спасибо @Selphiron, но на самом деле ВЫ нашли эту полезную информацию, не уверен, что я оказал большую услугу за ваш ответ. - person DimaSan; 30.08.2016
comment
Хорошо, я пометил это как ответ, так что кто-нибудь еще с такой же проблемой, возможно, тоже прочитает комментарии и будет доволен решением. - person Selphiron; 30.08.2016
comment
Я обновил его, теперь я уверен, что этот пост будет полезен всем, кто ищет такую ​​информацию. - person DimaSan; 30.08.2016