[Java] Oracle Java API 버그 제보하기

작년에 Java 11의 java.net패키지에 있는 HttpURLConnection 클래스 내부의 코드를 읽어보다가 Java Doc에 작은 오타가 있는 것을 발견했습니다. 그래서 Oracle Java SE 커뮤니티의 Bug Report를 활용해서 오타를 제보했었는데, 그 경험을 공유하기 위해 글을 작성하였습니다.

Index

1. 버그 제보 결과
2. 버그 제보 방법

 

1. 버그 제보 결과

HttpURLConnection클래스에 getResponseCode() 메소드의 Java Doc에 'If we can't a status-line then re-throw any exception' 이라는 문구가 있었습니다. 'can't'와 'a' 사이에 동사가 빠져있는 오타가 있었고, 이 자리에 'find'가 들어가면 적절할 것이라고 판단했습니다. 비록 개발하는 데에는 문제가 없는 작은 오타지만 더 완벽하고 나은 Java 플랫폼을 위해 버그를 제보해야겠다고 생각했습니다.

제가 제보했던 오타는 https://bugs.java.com/bugdatabase/view_bug.do?bug_id=JDK-8255675  에서 확인할 수 있습니다.

Bug ID: JDK-8255675 Typo in java.net.HttpURLConnection

 

Description란에 설명을 작성했고, Comments에 두개의 댓글이 달렸습니다. 하나의 댓글은 더 자연스러운 영어로 설명을 작성해준 댓글이었고, 다른 하나는 수정사항이 반영된 OpenJDK 깃허브의 링크가 있는 댓글이었습니다.

이 변경사항은 JDK 16에 반영되었습니다.

 

2. 버그 제보 방법

그럼 이제 버그를 제보하는 방법에 대해 알려드리겠습니다. 

버그를 제보하기 전에 두 가지를 만족하는지 확인해야 합니다.

1. 버그가 최신 버전의 Java SE에 있어야 합니다.
2. Bug Database에 같은 내용의 버그가 이미 제보되었는지 확인해야 합니다. 아래의 버그 데이터베이스 링크에서 키워드와 버그 번호로 버그를 검색할 수 있습니다. https://bugs.java.com/bugdatabase/

Bug Database

 

위의 두 가지 사항을 만족한다면, 아래의 링크에서 버그를 제보할 수 있습니다. https://bugreport.java.com/bugreport/ 

Bug Report

 

Start a New Report 버튼을 누릅니다.

그리고 버그의 종류, 버그를 발견한 운영체제 환경, Java 버전 등을 선택합니다.

그리고 제목과 함께 버그에 대한 설명을 영어로 작성하시면 됩니다.

다 작성하셨다면, 버그 제보를 완료하시면 됩니다.

 

버그를 제보하고 나면 OpenJDK 프로젝트에 반영이 되고, 추후에 다음 버전에서 반영될 것입니다.