"a" - a fast guide to effective Java programming

/** 
 * VAROITUS: Tämä tiedosto on kommentoitu versio tiedostosta a.java. Tämän
 * kääntyvyyttä ja/tai toimivuutta ei ole tarkistettu, eikä sitä ole vaadittu.
 * Kommentoituja kohtia on syytä verrata tiedoston a.java vastaaviin kohtiin.
 * Olennaisesti tiedosto a.java on kommentoitu tässä
 */
import java.awt.*;
import java.awt.event.*;
import java.util.*;

/**
 * Laivanupotuspeliappletin kommenttitiedosto Janne Kalliolan järjestämään
 * koodintiivistämiskilpailuun.
 * @author Panu.Tuominen@hut.fi
 */
public class a extends java.applet.Applet implements ActionListener{
  
  // i = dummy, s = ampumattomien laivojen lkm, l[] (käytössä (1)2-26) =
  // >0 tarkoittaa "laiva on ko. ruudussa".
  int i,s,l[];
  // b = dummy, n[] (käytössä (1)2-26) = viittaukset nappulaolioihin
  // labelin muuttamista varten.
  Button b,n[]=new Button[27];
  TextField t;
  // Satunnaisluvut generoidaan seuraavasta satunnaislukugeneraattorista.
  // Ohjelma lyhenisi merkittävästi, jos satunnaislukuihin käytettäisiin
  // suoraan muotoa (new java.util.Random()).nextInt(), mutta tällöin jokainen
  // satunnaisluku perustuisi vain yhteen iteraatioon systeemikellosta,
  // jota ei voida pitää tehtävänannon mukaisena _satunnaisena_. 
  Random R=new Random();
  
  /**
   * Alustaa laivanupotuspeliappletin.
   * init-metodi on valmisteltu siten, että sitä kutsumalla voidaan suorittaa
   * myös pelin uudelleen aloittaminen.
   */	
  public void init(){
    // Poistaa appletin paneelissa jo olevat vehkeet. Tarvitaan Start!-
    // näppäimen takia kutsuttaessa.
    removeAll();
    setLayout(new GridLayout(0,5));
    // Seuraavassa on syytä huomioida käskyjen suoritusjärjestys. For-loopin
    // alustuslauseessa tyhjennetään samalla laivojen sijoitusruudukko.
    // Viimeinen nappula saa labelin Start!, mutta ActionCommand asetetaan 
    // kuitenkin numeromerkkijonoksi. Rivin jälkeen i==0.
    for(l=new int[i=27];i-->1;b.setActionCommand(""+i),(n[i]=b).addActionListener(this))add(b=new Button(i<2?"Start!":""));
    // Luo informointitekstikentän. Se on editoitavissa, mutta eipä sitä
    // kielletty.
    add(t=new TextField("A new game"));
    // Arpoo viisi laivaa. Ensimmäisellä kierroksella i==0, siksi uusi i
    // arvotaan, vaikka randomi on vasta inkrementointilauseessa. Alustuslause
    // pienentää fontin tekstikentässä siten, että se mahtuu 300 x 300 -
    // applettiin näkymään kokonaan valitulla layoutilla:
    for(t.setFont(new Font("Serif",s=0,8));s<5;i=R.nextInt()%27)if(i>1&&l[i]<1)l[i]=++s;
    // Päivitää appletin paneelin. Olennainen Start!-näppäimen painalluksen
    // yhteydessä.
    validate();
  }
  
  /**
   * Suorittaa olennaisesti näppäintenpainelutapahtumat.
   * Näppäimet tunnistetaan niiden actionCommand:iin asetetusta numeroa
   * esittävästä Stringistä.
   * @param e tapahtunut tapahtuma
   */
  public void actionPerformed(ActionEvent e){
    // Tulkitaan näppäimen numero ja oliko jo ammuttu ruutu. Byte.parseByte
    // on lyhyempi kuin Integer.parseInt ja kaastaus intiksi on automaattinen
    if(l[i=Byte.parseByte(e.getActionCommand())]<6){
      // Tutki mahdollinen osuma ja ilmoita siitä.
      // Pelikentällä ruutuihin tulee pääsääntöisesti sama teksti kuin
      // tekstikenttään, joka täyttää vaatimukset ammuttujen ruutujen
      // osumien ja hutien ilmaisusta.
      String T="Missed";
      if(l[i]>0){
	T="Hit!";
	s--;
      }
      n[i].setLabel(T);
      // Kuitenkin jos kaikki on jo ammuttu, niin tekstikenttä pysyy
      // arvossa "Found all".
      t.setText(s<1?"Found all":T);
      l[i]=6;
    }
    // jos olikin Start!, niin kaikki edellä olikin turhaa, alusta uusi peli.
    if(i<2)init();
  }
}