Lezione 5 Namespace e JavaDoc

Transcript

1 Lezione 5 Namespace e JavaDoc Vittorio Corso di Programmazione Distribuita Laurea di I livello in Informatica Università degli Studi di Salerno Organizzazione della lezione Il namespace di Java: i package Supporto alla documentazione: JavaDoc 2 A.A Università di Salerno 1

2 Organizzazione della lezione Il namespace di Java: i package Supporto alla documentazione: JavaDoc Ereditarietà Polimorfismo Binding dinamico Casting e conversioni di tipo Classi astratte Interfacce motivazioni, modalità di uso e proprietà 3 Spazio di indirizzamento (Namespace) Java è costruito per il caricamento dinamico delle classi, anche da rete Non esistono variabili globali ogni campo e metodo sono all'interno di classi Ogni classe è all'interno di un package I package hanno un nome univoco Il problema dell' indirizzamento è trattato con cura david.games.tetris.soundeffect.play() Package name Classe Metodo 4 A.A Università di Salerno 2

3 I package Servono per raggruppare classi Java La libreria Java è distribuita in package java.util, java.lang, etc. Organizzazione gerarchica: tutto la libreria sotto java.* e javax.* Non necessario strettamente per programmi piccoli: ma utile al crescere della dimensione del programma e, conseguentemente, al crescere del numero di classi 5 Motivazioni per i package Organizzazione di programmi in unità Permettono di fornire un nome unico per le classi: basato spesso sul dominio Internet, scritto in ordine inverso ad esempio: com.horstmann.corejava.example Permettono una ulteriore protezione di visibilità una classe può accedere a tutte le classi del suo package e a tutte le classi public degli altri package Servono per identificare le classi 6 A.A Università di Salerno 3

4 Uso dei package Accesso: inserimento del nome completo uso della istruzione import Istruzione import: non è possibile usarla così import java.*.* import java.l* java.util.date oggi = new java.util.date(); import java.util.*; Date oggi = new Date(); 7 Attenzione: import non è include include direttiva al preprocessore di inserire i file indicati all interno del sorgente tipicamente usata per utilizzare file header di interfaccia per libreria non eliminabile dall uso quotidiano import semplificazione nella specifica del nome delle classi di fatto, possibile non usarla 8 A.A Università di Salerno 4

5 Classi in un package Prima del codice inserire: package com.horstmann.corejava; class Qualsiasi { Se non si indica alcun package: i file fanno parte del package di default Associazione tra namespace e filesystem i file del package vanno inseriti in una sottodirectory corrispondente al nome completo del package esempio: com/horstmann/corejava è la directory del package com.horstmann.corejava 9 Un esempio: la classe PackageTest PackageTest.java import com.horstmann.corejava.*; public class PackageTest { public static void main (String [ ] args) { Employee impieg ; impieg=new Employee ( Gianni, 30000, 1987, 12, 10); impieg.raisesalary(5); System.out.println ( Nome: + impieg.getname() + Salario: + impieg.getsalary() + Assunto: + impieg.gethireday() ); Importa un package di cui usa la classe Employee Istanza di Employee Aumento stipendio Stampa 10 A.A Università di Salerno 5

6 Un esempio: la classe Employee Employee.java package com.horstmann.corejava; import java.util.*; public class Employee {.. // campi delle istanze della classe private String name; private double salary; private Date hireday; Appartenenza ad un package Importa un package Filesystem: PackageTest.java PackageTest.class com\ horstmann\ corejava\ Employee.java Employee.class 11 Localizzazione delle classi Di solito, preferibile non fare riferimento alla directory corrente Possibile selezionare directory che servono da punto di partenza per cercare le classi (per javac e java) percorso delle classi (CLASSPATH) Variabile di ambiente: CLASSPATH=.;C:\classes;D:\classes Su linea di comando di javac e java javac -classpath C:\classes ProgramJava.java Possibile inserire le classi in un archivio (JAR) 12 A.A Università di Salerno 6

7 Visibilità: l uso dei package Tra le visibilità: public (accessibile a tutte le classi) private (accessibile solamente alla classe)..esiste l ambito di package: quando una classe, un metodo, una variabile non sono cotrassegnate né public né private allora risultano visibili da tutte le classi dello stesso package Attenzione: mentre per i metodi questa strategia risulta accettabile per i campi va contro l incapsulamento dei dati 13 Organizzazione della lezione Il namespace di Java: i package Supporto alla documentazione: JavaDoc Ereditarietà Polimorfismo Binding dinamico Casting e conversioni di tipo Classi astratte Interfacce motivazioni, modalità di uso e proprietà 14 A.A Università di Salerno 7

8 La documentazione Specialmente nella programmazione orientata ad oggetti, la documentazione è fondamentale la suddivisione del programma in classi rende di difficile consultazione la documentazione per i numerosissimi metodi delle numerosi classi di cui si compone un programma Javadoc crea automaticamente documentazione se inserita dal programmatore con commenti particolari ( ) 15 Documentazione in Javadoc package com.horstmann.corejava; import java.util.*; Questa classe rappresenta un esempio di una classe appartenente ad un package. La classe definisce oggetti Impiegato che hanno nome, salario e data di assunzione come dati. Vengono forniti dei semplici metodi per il loro public class Employee {. 16 A.A Università di Salerno 8

9 Documentazione in Javadoc (2) public class Employee { Metodo costruttore inserito (con tutti i parametri). Da notare che i parametri passati per la data di assunzione sono anno, mese e giorno, ma che questi vengono rappresentati in maniera diversa all'interno del n (String) il nome s (double) il salario di year (int) l'anno di month (int) il mese di day (int) il giorno di assunzione public Employee(String n, double s, int year, int month, int day) {. 17 Documentazione in Javadoc (3) Metodo per accedere al campo nome restituisce il nome (String) public String getname() { return name; Metodo per accedere al campo salario restituisce il salario (double) public double getsalary() { return salary; 18 A.A Università di Salerno 9

10 Documentazione in Javadoc (4) Metodo per accedere alle informazioni sulla data di restituisce la data di assunzione (Date) public Date gethireday() { return hireday; Metodo per aumentare il salario dell'impiegato. Viene passata la percentuale di aumento e il salario risulta bypercent (double) percentuale di aumento public void raisesalary(double bypercent) { double raise = salary * bypercent / 100; salary += raise; 19 Documentazione in Javadoc (5) / ** Campo nome dell'impiegato private String name; Campo salario dell'impiegato private double salary; Campo data di assunzione dell'impiegato private Date hireday; 20 A.A Università di Salerno 10