domenica 4 novembre 2012

PRIMO PROGRAMMA IN JAVA.DOC

Primo programma in java creato dal nostro professore, in grado di introdurci nel universo di questo linguaggio
/** automobile utilizzata per far capire la costruzione di un oggetto
/
class Automobile {
private int velocita=0;
public String colore;
public String modello;
/**primo costruttore
/
public Automobile() {
velocita=0;
System.out.println(“Macchina costruita”);
}
/** secondo costruttore
/
public Automobile( int v) { velocita=v; System.out.println(“Macchina costruita e viaggia alla velocità” + v );
}

public int accelera() {
velocita=velocita+5;
return 1;
}
/**  accellera() serve per leggere la velocità ed incrementarla di 5 m/s
@return=1 serve per restituire 1m/s se l'auto accelera come richiesto
/
public int girare(int dx, int sx) {
if (dx>0)
{
System.Out.Println(“Automobile gira a sinistra”);
}
else
{
System.Out.Println(“Automobile gira a destra”);
}
return 1;
}
}

JAVA.DOC

JavaDoc nacque come strumento interno utilizzato dai ricercatori della Sun che stavano lavorando alla creazione del linguaggio Java e delle sue librerie; la grande mole di sorgenti spinse alcuni membri del team a creare un programma per la generazione automatica di documentazione HTML. Questo formato infatti consente una navigazione molto efficace e veloce, è molto conosciuto dai programmatori ed è facilmente indicizzabile dai motori di ricerca. Tuttavia, la creazione e manutenzione di una tale mole di pagine web non sarebbe stata pensabile senza l'aiuto di un sistema automatico: basti pensare alla quantità di riferimenti incrociati che ci sono fra le classi (ereditarietà fra classi, firme dei metodi, riferimenti a package solo per citarne alcuni) e agli inevitabili errori di battitura a cui si va incontro scrivendo documentazione. JavaDoc nacque quindi per permettere ai programmatori di inserire dei frammenti HTML nei commenti (ignorati quindi dal compilatore): già con le prime versioni si potevano inserire le descrizioni di ogni classe e dei suoi metodi, nonché il significato dei parametri e delle variabili membro.

CLASSE OBJECT
Tramite questa estensione, è possibile trattare qualunque tipo di oggetto nello stesso identico modo

Javadoc, corrisponde ad tipo di documentazione semi-automatica, capace di creare programmi in linguaggio HTML, dove bisogna inserire commenti associandoli ad un metodo.