Java proglamlama dili üç tür açıklamayı destekler: tek satır açıklamalar // ile, çok-satır açıklamalar "/* ve */" ile, ve javadoc açıklamalar "/** ve */" ile gösterilir. İlk iki tür basit açıklamalar, ve üçüncüsü javadoc aracı ile işlenen programın gömülmüş belgelemesi için kullanılır.

Tek satır açıklamalar // şekli kullanılarak, programın herhangi bir yerine konabilir. Açıklama ilk // ile başlar ve satır sonuna kadar devam eder. Aşağıdakiler tek satır açıklamalara örnektir:

int i=7; // bir tek satır açıklama
i=i*7;
// başka bir tek satır açıklama
i=1;
						

Çok-satır açıklama, bir programda açıklama birden fazla satıra yayıldığında kullanılır. Derleyici başlangıç biçim imi /* ile ilk bitiş imi */ arasındaki herşeyi atacaktır. Aşağıdakiler çok-satır açıklamalara örnektir:

int i=7;
/* bir 
açıklama */
i=i*7; /*
başka bir
açıklama
*/
i=i+1;
						

Javadoc açıklamalar birçok satıra yayılabilir ve derleyici başlangıç biçim imi /** ile ilk bitiş imi */ arasındaki herşeyi atacaktır. Javadoc özelliği javadoc açıklamalarını okuyup HTML belgesine çevirebilir.

Sınıf ve arayüz seviyesinde javadoc açıklamalar ekleyebilirsiniz, yöntem, kurucu ve alan seviyesinde ekleyebileğiniz gibi. Her açıklama ilişkin varlıktan hemen önce görünür ve bir veya daha fazla imle izlenen bir tanımdan oluşur. Eğer isterseniz javadoc açıklamalarınızda HTML biçimlendirmesi kullanabilirsiniz. Javadoc açıklamasının genel biçimi aşağıdaki gibidir:

/** 
  * Bir sınıf betimlemesi
  *
  * @imadı betimleyici metin
  * ...
  * @imadı betimleyici metin
  */
public class DocTest {
  /** Bir değişken betimlemesi*/
  public int i;
/** 
  * Bir yöntem betimlemesi
  *
  * @imadı betimleyici metin
  * ...
  * @imadı betimleyici metin
  */
  public void f() {}
}