xgiovio/project-unisa-for-shop-management-file-based-gui
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Javadoc aggiunta a tutti i metodi di tutte le classi.

Browse Source
This commit is contained in:
Simone Argenziano
2014-01-25 14:46:30 +01:00
parent c1581db721
commit 7e1fe5023b
16 changed files with 369 additions and 206 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
it/unisa/info13d/Articoli/BeniDiConsumo.java
View File

@@ -21,9 +21,9 @@ public class BeniDiConsumo extends Utilizzabile implements Serializable {
* Costruttore che inizializza i valori del bene di consumo
*
* @param idBene
* @param descrizioneBene
* @param prezzoBene
* @param beniInStock
* @param descrizioneBene - descrizione del bene
* @param prezzoBene - prezzo del bene
* @param beniInStock - quantita' del bene da vendere
*/
public BeniDiConsumo(int idBene, String descrizioneBene, double prezzoBene, int beniInStock, String in_fornitore, int in_giudizio){
this.idBene=idBene;
@@ -43,80 +43,86 @@ public class BeniDiConsumo extends Utilizzabile implements Serializable {
/**
* @return - id bene
* @return - id bene.
*/
public int getIdBene() {
return idBene;
}
/**
* @return - descrizione bene
* @return - descrizione bene.
*/
public String getDescrizioneBene() {
return descrizioneBene;
}
/**
* @return - prezzo del bene
* @return - prezzo del bene.
*/
public double getPrezzoBene() {
return prezzoBene;
}
/**
* @return - la quantita dei beni da vendere
* @return - la quantita' dei beni da vendere.
*/
public int getBeniInStock() {
return beniInStock;
}
/**
* @return - numero di oggetti venduti
* @return - numero di oggetti venduti.
*/
public int getBeniVenduti() {
return beniVenduti;
}
/**
* @param descrizioneBene - descrizione del bene
* @param descrizioneBene - descrizione del bene.
*/
public void setDescrizioneBene(String descrizioneBene) {
this.descrizioneBene = descrizioneBene;
}
/**
* @param prezzoBene - prezzo del bene
* @param prezzoBene - prezzo del bene.
*/
public void setPrezzoBene(double prezzoBene) {
this.prezzoBene = prezzoBene;
}
/**
* @param beniInStock - quantita' del bene disponibile per la vendita
* @param beniInStock - quantita' del bene disponibile per la vendita.
*/
public void setBeniInStock(int beniInStock) {
this.beniInStock = beniInStock;
}
/**
* @return - la scadenza del bene (viene considerata una data a lungo termine)
* @return - la scadenza del bene (viene considerata una data a lungo termine).
*/
public GregorianCalendar getScadenza() {
return scadenza;
}
/**
* Questo metodo setta i beni venduti, decrementa la quantita in magazzino e incrementa il numero di oggeti venduti
* Questo metodo setta i beni venduti, decrementa la quantita' in magazzino e incrementa il numero di oggeti venduti.
*/
public void setBeniVenduti() {
beniInStock--;
beniVenduti++;
}
/**
* @return - Il giudizio dato al fornitore.
*/
public int getGiudizioFornitore() {
return giudizioFornitore;
}
/**
* @return - Il nome del fornitore.
*/
public String getFornitore() {
return fornitore;
}

50
it/unisa/info13d/Articoli/CeneInRistoranti.java
View File

@@ -18,16 +18,16 @@ import java.util.GregorianCalendar;
public class CeneInRistoranti extends Utilizzabile implements Serializable{
/**
*Genera una nuova cena da inserire all'interno del catalogo
*
* @param idCena - l'id della cena
* @param nomeRistorante - il ristorante in cui usufruire dell'offerta
* @param luogo - Ubicazione del ristorante
* @param descrizione_cena - descrizione della cena (cosa viene offerto dal ristorante)
* @param costoPerPersona - costo per singola persona
* @param dataScadenzaOffertaCena - scadenza dell'offerta
* @param numCenedaVendere - offerte disponibile per la cena
* @param idCena - l'id della cena.
* @param nomeRistorante - il ristorante in cui usufruire dell'offerta .
* @param luogo - Ubicazione del ristorante.
* @param descrizione_cena - descrizione della cena (cosa viene offerto dal ristorante).
* @param costoPerPersona - costo per singola persona.
* @param dataScadenzaOffertaCena - scadenza dell'offerta.
* @param numCenedaVendere - offerte disponibili per la cena.
*/
public CeneInRistoranti(int idCena, String nomeRistorante, String luogo, String descrizione_cena, double costoPerPersona, GregorianCalendar dataScadenzaOffertaCena, int numCenedaVendere){
this.idCena=idCena;
this.nomeRistorante=nomeRistorante;
@@ -46,105 +46,105 @@ public class CeneInRistoranti extends Utilizzabile implements Serializable{
}
/**
* @return - l'id della cena
* @return - l'id della cena.
*/
public int getIdCena() {
return idCena;
}
/**
* @return - in nome del ristorante
* @return - in nome del ristorante.
*/
public String getNomeRistorante() {
return nomeRistorante;
}
/**
* @return - l'ubicazione del ristorante
* @return - l'ubicazione del ristorante.
*/
public String getLuogo() {
return luogo;
}
/**
* @return - descrizione della cena
* @return - descrizione della cena.
*/
public String getDescrizione_cena() {
return descrizione_cena;
}
/**
* @return - il costo per ogni singola persona
* @return - il costo per ogni singola persona.
*/
public double getCostoPerPersona() {
return costoPerPersona;
}
/**
* @return - data di scadenza dell'offerta
* @return - data di scadenza dell'offerta.
*/
public GregorianCalendar getDataScadenzaOffertaCena() {
return dataScadenzaOffertaCena;
}
/**
* @return - il numero di cene ancora disponibili per la vendita
* @return - il numero di cene ancora disponibili per la vendita.
*/
public int getNumCenedaVendere() {
return numCenedaVendere;
}
/**
* @return - il numero di cene vendute
* @return - il numero di cene vendute .
*/
public int getCeneVendute() {
return ceneVendute;
}
/**
* @param nomeRistorante - setta il nome del ristorante
* @param nomeRistorante - setta il nome del ristorante.
*/
public void setNomeRistorante(String nomeRistorante) {
this.nomeRistorante = nomeRistorante;
}
/**
* @param luogo - setta il l'ubicazione del ristorante
* @param luogo - setta il l'ubicazione del ristorante.
*/
public void setLuogo(String luogo) {
this.luogo = luogo;
}
/**
* @param descrizione_cena - setta la descrizione della cena (Esempio: pizza margherita, patate e dolce)
* @param descrizione_cena - setta la descrizione della cena (Esempio: pizza margherita, patate e dolce).
*/
public void setDescrizione_cena(String descrizione_cena) {
this.descrizione_cena = descrizione_cena;
}
/**
* @param costoPerPersona - setta il costo per singola persona
* @param costoPerPersona - setta il costo per singola persona.
*/
public void setCostoPerPersona(double costoPerPersona) {
this.costoPerPersona = costoPerPersona;
}
/**
* @param dataScadenzaOffertaCena - setta la data di scadenza per l'offerta
* @param dataScadenzaOffertaCena - setta la data di scadenza per l'offerta.
*/
public void setDataScadenzaOffertaCena(GregorianCalendar dataScadenzaOffertaCena) {
this.dataScadenzaOffertaCena = dataScadenzaOffertaCena;
}
/**
* @param numCenedaVendere - setta il numero di cene da vendere
* @param numCenedaVendere - setta il numero di cene da vendere.
*/
public void setNumCenedaVendere(int numCenedaVendere) {
this.numCenedaVendere = numCenedaVendere;
}
/**
* Questo metodo all'atto dell'acquisto da parte di un utente, decrementa le cene da vendere ed incrementa quelle vendute
* Questo metodo all'atto dell'acquisto da parte di un utente, decrementa le cene da vendere ed incrementa quelle vendute.
*/
public void setCeneVendute()
{
@@ -154,8 +154,8 @@ public class CeneInRistoranti extends Utilizzabile implements Serializable{
@Override
/**
* Questo metodo stabilisce se <EFBFBD> possibile applicare o meno uno sconto alle cene.
* @return Restitisce il prezzo originale se la politica di socnto non <EFBFBD> applicabile, altrienti restituisce il prezzo scontato del 10%.
* Questo metodo stabilisce se e possibile applicare o meno uno sconto alle cene.
* @return Restitisce il prezzo originale se la politica di socnto non e' applicabile, altrienti restituisce il prezzo scontato del 10%.
*/
public double get_prezzo_scontato() {
GregorianCalendar dataOdierna = new GregorianCalendar();

52
it/unisa/info13d/Articoli/Global.java
View File

@@ -9,15 +9,13 @@ package it.unisa.info13d.Articoli;
/**
*
* Classe che raccoglie tutti i metodi statici (globali) da usare nel progetto
*
*
*/
public class Global {
/**
/**
*
* @return il seguente id disponibile all'aggiunta di un nuovo prodotto
* @return il seguente id disponibile all'aggiunta di un nuovo prodotto.
*/
public static int get_next_id (){
general_counter++;
@@ -25,7 +23,7 @@ public class Global {
}
/**
* Questo metodo setta il contatore generale degli id dei prodotti
* Questo metodo setta il contatore generale degli id dei prodotti.
*
* @param general_counter - contatore id
*/
@@ -42,45 +40,69 @@ public class Global {
}
/**
* E' il contatore statico privato
* Questo metodo setta i parametri per la politica di sconto relativa alla quantit<69> di articoli venduti in un singolo acquisto.
*
* @param num - numero di articoli da acquistare per poter applicare lo sconto.
* @param sconto - Quantit<69> di sconto da applicare.
*/
public static void set_sconto_min_articoli (int num, double sconto){
min_num_articoli_per_sconto = num;
sconto_per_min_num_articoli = sconto;
}
/**
* Questo metodo setta la quantita' di sconto da applicare agli articoli che si trovano nell'ultima settimana di scadenza.
* @param sconto_ultima_settimana - Quantit<69> di sconto da applicare.
*/
public static void setSconto_ultima_settimana(double sconto_ultima_settimana) {
Global.sconto_ultima_settimana = sconto_ultima_settimana;
}
/**
* Questo metodo setta la quantita' di sconto per le cene che hanno superato il 50% delle vendite.
*
* @param sconto_cene_sup_50 - Quantit<69> di sconto.
*/
public static void setSconto_cene_sup_50(double sconto_cene_sup_50) {
Global.sconto_cene_sup_50 = sconto_cene_sup_50;
}
/**
*
* @return - il numero di articoli necessari per applicare lo sconto in quantit<69>.
*/
public static int getMin_num_articoli_per_sconto() {
return min_num_articoli_per_sconto;
}
/**
*
* @return - ritorna la quantita' di sconto applicata alla politica dello sconto in quantita'.
*/
public static double getSconto_per_min_num_articoli() {
return sconto_per_min_num_articoli;
}
/**
*
* @return - ritorna lo sconto applicabile agli articoli che si trovano nell'ultima settimana di scadenza.
*/
public static double getSconto_ultima_settimana() {
return sconto_ultima_settimana;
}
/**
*
* @return - ritorna lo sconto applicato alla politica di sconto delle cene.
*/
public static double getSconto_cene_sup_50() {
return sconto_cene_sup_50;
}
private static int min_num_articoli_per_sconto = 0;
private static double sconto_per_min_num_articoli = 0;
private static double sconto_per_min_num_articoli = 0;
private static double sconto_ultima_settimana = 0;
private static double sconto_cene_sup_50 = 0;
private static int general_counter;
}
private static int general_counter;
}

87
it/unisa/info13d/Articoli/PrestazioniDopera.java
View File

@@ -2,11 +2,23 @@ package it.unisa.info13d.Articoli;
import java.util.GregorianCalendar;
/**
*
* Classe che rappresenta una prestazione d'opera all'interno del catalogo.
*
*/
public class PrestazioniDopera extends Utilizzabile {
/**
* Genera una nuova prestazione d'opera da inserire all'interno del catalogo.
*
* @param in_id - id della prestazione
* @param in_localita - localit<69> della prestazione
* @param in_descrizione - descrizione della prestazione d'opera
* @param in_fornitore - fornitore della prestazione
* @param in_giudizio - giudizio del fornitore della prestazione
* @param in_prezzo - prezzo della prestazione
*/
public PrestazioniDopera(int in_id, String in_localita, String in_descrizione, String in_fornitore, int in_giudizio, double in_prezzo){
idPrOpera = in_id;
@@ -18,7 +30,6 @@ public class PrestazioniDopera extends Utilizzabile {
}
@Override
public boolean eAcquistabile() {
return true;
@@ -30,60 +41,116 @@ public class PrestazioniDopera extends Utilizzabile {
return prezzoPrestazione; //Nessuno sconto applicabile
}
/**
*
* @return - Ritorna l'id dell'opera.
*/
public int getIdPrOpera() {
return idPrOpera;
}
/**
*
* @return - Ritorna il giudizio dato al fornitore della prestazione.
*/
public int getGiudizioFornitore() {
return giudizioFornitore;
}
/**
* Questo metodo setta il giudizio dal fornitore della prestazione.
* @param giudizioFornitore
*/
public void setGiudizioFornitore(int giudizioFornitore) {
this.giudizioFornitore = giudizioFornitore;
}
/**
*
* @return - Ritorna il numero di prestazioni vendute.
*/
public int getPrestazioniVendute() {
return prestazioniVendute;
}
/**
*
*Questo metodo incrementa il numero di prestazioni vendute.
*/
public void setPrestazioniVendute() {
prestazioniVendute++;
}
/**
* @return - Ritorna il prezzo della prestazione.
*/
public double getPrezzoPrestazione() {
return prezzoPrestazione;
}
/**
* Questo metodo setta il prezzo della prestazione.
*
* @param prezzoPrestazione
*/
public void setPrezzoPrestazione(double prezzoPrestazione) {
this.prezzoPrestazione = prezzoPrestazione;
}
/**
* @return - il nome della localita' in cui si pu<70> fruire della prestazione.
*/
public String getLocalita() {
return Localita;
}
/**
* Questo metodo setta la localita' della prestazione.
*
* @param localita - localit<69> della prestazione
*/
public void setLocalita(String localita) {
Localita = localita;
}
/**
* @return - Ritorna la descrizione della prestazione.
*/
public String getDescrizione() {
return Descrizione;
}
/**
* Questo metodo setta la descrizione della prestazione.
*
* @param descrizione - descrizione della prestazione.
*/
public void setDescrizione(String descrizione) {
Descrizione = descrizione;
}
/**
* @return - Ritorna il nome del fornitore della prestazione.
*/
public String getFornitore() {
return Fornitore;
}
/**
* Questo metodo setta il fornitore della prestazione.
*
* @param fornitore - nome del fornitore
*/
public void setFornitore(String fornitore) {
Fornitore = fornitore;
}
/**
* @return - la data di scadenza della prestazione.
*/
public GregorianCalendar getScadenza() {
return scadenza;
}
private int idPrOpera;
private int giudizioFornitore; // varia da 1 a 5
@@ -92,9 +159,5 @@ public class PrestazioniDopera extends Utilizzabile {
private String Localita;
private String Descrizione;
private String Fornitore;
private GregorianCalendar scadenza = new GregorianCalendar(99999,0,1);
public GregorianCalendar getScadenza() {
return scadenza;
}
private GregorianCalendar scadenza = new GregorianCalendar(99999,0,1);
}

11
it/unisa/info13d/Articoli/Utilizzabile.java
View File

@@ -12,10 +12,17 @@ import java.io.Serializable;
public abstract class Utilizzabile implements Serializable {
public abstract boolean eAcquistabile();
/**
* Metodo per definire se un prodotto e acqustabile
*
* @return - ritorna true se e' acquistabile false se non lo e'
*/
public abstract boolean eAcquistabile();
/**
* Metodo per l'applicazione delle politiche di sconto relative ad un articolo.
*
* @return metodo per l'applicazione delle politiche di sconto relative ad un articolo.
* @return - prezzo scontato dell'articolo.
*/
public abstract double get_prezzo_scontato();

28
it/unisa/info13d/Articoli/Vacanze.java
View File

@@ -9,10 +9,14 @@ import java.util.GregorianCalendar;
* Date: 16/12/13
* Time: 18.45
*/
/**
* Classe che rappresenta una vacanza all'interno del catalogo.
*/
public class Vacanze extends Utilizzabile implements Serializable{
/**
* Costruttore per inizialiazzare una Vacanza
* Costruttore per inizialiazzare una Vacanza.
*
* @param idViaggio
* @param localitaViaggio
@@ -36,77 +40,77 @@ public class Vacanze extends Utilizzabile implements Serializable{
}
/**
* @return - id del viaggio
* @return - id del viaggio.
*/
public int getIdViaggio() {
return idViaggio;
}
/**
* @return - localita' del viaggio
* @return - localita' del viaggio.
*/
public String getLocalitaViaggio() {
return localitaViaggio;
}
/**
* @return - data di partenza
* @return - data di partenza.
*/
public GregorianCalendar getDataPartenzaViaggio() {
return dataPartenzaViaggio;
}
/**
* @return - data di scadenza dell'offerta
* @return - data di scadenza dell'offerta.
*/
public GregorianCalendar getScadenzaOfferta() {
return scadenzaOfferta;
}
/**
* @return - il prezzo per singola persona
* @return - il prezzo per singola persona.
*/
public double getPrezzoPSingola() {
return prezzoPSingola;
}
/**
* @return - il numero di viaggi venduti
* @return - il numero di viaggi venduti.
*/
public int getViaggiVenduti() {
return viaggiVenduti;
}
/**
* @param localitaViaggio - setta la localit' del viaggio
* @param localitaViaggio - setta la localita' del viaggio.
*/
public void setLocalitaViaggio(String localitaViaggio) {
this.localitaViaggio = localitaViaggio;
}
/**
* @param dataPartenzaViaggio - setta la data di patenza del viaggio
* @param dataPartenzaViaggio - setta la data di patenza del viaggio.
*/
public void setDataPartenzaViaggio(GregorianCalendar dataPartenzaViaggio) {
this.dataPartenzaViaggio = dataPartenzaViaggio;
}
/**
* @param scadenzaOfferta - setta la data di scadenza dell'offerta della vacanza
* @param scadenzaOfferta - setta la data di scadenza dell'offerta della vacanza.
*/
public void setScadenzaOfferta(GregorianCalendar scadenzaOfferta) {
this.scadenzaOfferta = scadenzaOfferta;
}
/**
* @param prezzoPSingola - setta il prezzo per singola persona
* @param prezzoPSingola - setta il prezzo per singola persona.
*/
public void setPrezzoPSingola(double prezzoPSingola) {
this.prezzoPSingola = prezzoPSingola;
}
/**
* Questo metodo incrementa, dopo ogni acquisto, il numero di viaggi venduti
* Questo metodo incrementa, dopo ogni acquisto, il numero di viaggi venduti.
*/
public void setViaggiVenduti()
{