Java basics

Scopul acestui laborator este familiarizarea studenților cu noțiunile de bază ale programării în Java.

Aspectele urmărite sunt:

• organizarea unui proiect Java
• familiarizarea cu IDE-ul
• definirea noțiunilor de clasă, câmpuri, proprietăți, metode, specificatori de acces
• folosirea unor tipuri de date

În cadrul acestui laborator veți avea de ales între a folosi IntelliJ IDEA (tutorial instalare) folosind contul de mail de la facultate (tutorial activare) sau Eclipse (tutorial instalare). Primul pas este să vă familiarizați cu structura unui proiect și a unui fișier sursă Java.

Înainte de a începe orice implementare, trebuie să vă gandiți cum grupați logica întregului program pe unități. Elementele care se regăsesc în același grup trebuie să fie conectate în mod logic, pentru o ușoară implementare și înțelegere ulterioară a codului. În cazul Java, aceste grupuri logice se numesc pachete și se reflectă pe disc conform ierarhiei din cadrul proiectului. Pachetele pot conține atât alte pachete, cât și fișiere sursă.

Următorul pas este delimitarea entităților din cadrul unui grup, pe baza unor trăsături individuale. În cazul nostru, aceste entități vor fi clasele. Pentru a crea o clasă, trebuie mai întâi să creăm un fișier aparținând proiectului nostru și unui pachet (dacă este cazul și proiectul este prea simplu pentru a-l împărți în pachete). În cadrul acestui fișier definim una sau mai multe clase, conform urmatoarelor reguli:

• dacă dorim ca această clasă să fie vizibilă din întreg proiectul, îi vom pune specificatorul public (vom vorbi despre specificatori de acces mai în detaliu în cele ce urmează); acest lucru implică însă 2 restricții:
  • fișierul și clasa publică trebuie să aibă același nume
  • nu poate exista o altă clasă/interfață publică în același fișier (vom vedea în laboratoarele următoare ce sunt interfețele)
• pot exista mai multe clase în același fișier sursă, cu condiția ca maxim una să fie publică

Pentru mai multe informații despre cum funcționează mașina virtuală de Java (JVM) precum și o aprofundare în POO și Java, consultați acest link.

Pentru un exemplu de creare a unui proiect, adăugare de pachete și fișiere sursă, consultați acest link pentru IntelliJ Idea si acest link pentru Eclipse.

Conform POO, orice este un obiect, însă din motive de performanță, Java suportă și tipurile de bază, care nu sunt clase.

boolean isValid = true;
 
char nameInitial = 'L';
 
byte hexCode = (byte)0xdeadbeef;
 
short age = 23;
 
int credit = -1;
 
long userId = 169234;
 
float percentage = 0.42;
 
double money = 99999;

Biblioteca Java oferă clase wrapper (“ambalaj”) pentru fiecare tip primitiv. Avem astfel clasele Char, Integer, Float etc. Un exemplu de instanțiere este următorul:

 new Integer(0); 

Clasele reprezintă tipuri de date definite de utilizator sau deja existente în sistem (din class library - set de biblioteci dinamice oferite pentru a asigura portabilitatea, eliminând dependența de sistemul pe care rulează programul). O clasă poate conține:

• membri (variabile membru (câmpuri) și proprietăți, care definesc starea obiectului)
• metode (functii membru, ce reprezintă operații asupra stării).

Prin instanțierea unei clase se înțelege crearea unui obiect care corespunde unui șablon definit. În cazul general, acest lucru se realizează prin intermediul cuvântului cheie new.

Procesul de inițializare implică: declarare, instanțiere și atribuire. Un exemplu de inițializare este următorul:

 Integer myZero = new Integer(0);

Un alt exemplu de clasă predefinita este clasa String. Ea se poate instanția astfel (nu este necesară utilizarea new):

 String s1, s2; 
 
 s1 = "My first string"; 
 s2 = "My second string"; 

Aceasta este varianta preferată pentru instanțierea string-urilor. De remarcat că și varianta următoare este corectă, dar ineficientă, din motive ce vor fi explicate ulterior.

 s = new String("str"); 

Un câmp este un obiect având tipul unei clase sau o variabilă de tip primitiv. Dacă este un obiect atunci trebuie inițializat înainte de a fi folosit (folosind cuvântul cheie new).

 class DataOnly { 
     int i; 
     float f; 
     boolean b; 
     String s; 
 } 
 

Declarăm un obiect de tip DataOnly și îl inițializăm:

 DataOnly d = new DataOnly(); 
 
 // set the field i to the value 1 
 d.i = 1; 
 
 // use that value 
 System.out.println("Field i of the object d is " + d.i); 
 

Observăm că pentru a utiliza un câmp/funcție membru dintr-o funcție care nu aparține clasei respective, folosim sintaxa:

 classInstance.memberName 
 

O proprietate este un câmp (membru) căruia i se atașează două metode ce îi pot expune sau modifica starea. Aceste doua metode se numesc getter si setter.

 class PropertiesExample {      
     String myString;
 
     String getMyString() {
         return myString;
     }
 
     void setMyString(String s) {
         myString = s;
     }
 } 
 

Declarăm un obiect de tip PropertiesExample și îi inițializăm membrul myString astfel:

 PropertiesExample pe = new PropertiesExample(); 
 
 pe.setMyString("This is my string!");
 
 System.out.println(pe.getMyString()); 
 

Putem modifica programul anterior astfel:

 String s1, s2; 
 
 s1 = "My first string"; 
 s2 = "My second string"; 
 
 System.out.println(s1.length()); 
 System.out.println(s2.length()); 

Va fi afișată lungimea în caractere a șirului respectiv. Se observă că pentru a aplica o funcție a unui obiect, se folosește sintaxa:

 classInstance.methodName(param1, param2, ..., paramN); 

Funcțiile membru se declară asemănător cu funcțiile din C.

În limbajul Java (şi în majoritatea limbajelor de programare de tipul OOP), orice clasă, atribut sau metodă posedă un specificator de acces, al cărui rol este de a restricţiona accesul la entitatea respectivă, din perspectiva altor clase. Există specificatorii:

Încapsularea se referă la acumularea atributelor şi metodelor caracteristice unei anumite categorii de obiecte într-o clasă. Pe de altă parte, acest concept denotă şi ascunderea informaţiei de stare internă a unui obiect, reprezentată de atributele acestuia, alături de valorile aferente, şi asigurarea modificării lor doar prin intermediul metodelor.

Încapsularea conduce la izolarea modului de implementare a unei clase (atributele acesteia şi cum sunt manipulate) de utilizarea acesteia. Utilizatorii unei clase pot conta pe funcţionalitatea expusă de aceasta, indiferent de implementarea ei internă (chiar şi dacă se poate modifica în timp).

Clasa VeterinaryReport este o versiune micșorată a clasei care permite unui veterinar să țină evidența animalelor tratate, pe categorii (câini/pisici):

 public class VeterinaryReport { 
     int dogs; 
     int cats; 
 
     public int getAnimalsCount() { 
         return dogs + cats;
     } 
 
     public void displayStatistics() { 
         System.out.println("Total number of animals is " + getAnimalsCount());
     } 
 } 
 

Clasa VeterinaryTest ne permite să testăm funcționalitatea oferită de clasa anterioară.

 public class VeterinaryTest { 
     public static void main(String[] args) { 
         VeterinaryReport vr = new VeterinaryReport();
 
         vr.cats = 99;
         vr.dogs = 199; 
 
         vr.displayStatistics();
         System.out.println("The class method says there are " + vr.getAnimalsCount() + " animals"); 
     } 
 } 
 

Obiectele au fiecare propriul spațiu de date: fiecare câmp are o valoare separată pentru fiecare obiect creat. Codul următor arată această situație:

 public class VeterinaryTest { 
     public static void main(String[] args) { 
         VeterinaryReport vr = new VeterinaryReport(); 
         VeterinaryReport vr2 = new VeterinaryReport();
 
         vr.cats = 99; 
         vr.dogs = 199; 
         vr2.dogs = 2; 
 
         vr.displayStatistics(); 
         vr2.displayStatistics(); 
 
         System.out.println("The first class method says there are " + vr.getAnimalsCount() + " animals");
         System.out.println("The second class method says there are " + vr2.getAnimalsCount() + " animals");
     }
 }

Se observă că:

• Deși câmpul dogs aparținând obiectului vr2 a fost actualizat la valoarea 2, câmpul dogs al obiectului vr1 a rămas la valoarea inițiala (199). Fiecare obiect are spațiul lui pentru date!

• System.out.println(…) este metoda utilizată pentru a afișa la consola standard de ieșire

• Operatorul '+' este utilizat pentru a concatena două șiruri

• Având în vedere cele două observații anterioare, observăm că noi am afișat cu succes șirul “The first/second class method says there are ” + vr.getAnimalsCount() + “ animals”, deși metoda getAnimalsCount() întoarce un întreg. Acest lucru este posibil deoarece se apelează implicit o metodă care convertește numărul întors de metodă în șir de caractere. Apelul acestei metode implicite atunci când chemăm System.out.println se întâmplă pentru orice obiect și primitivă, nu doar pentru întregi.

Vectorii sunt utilizați pentru a stoca mai multe valori într-o singură variabilă. Un vector este de fapt o matrice (array) unidimensională.

Exemplu definire vector de String-uri cu valorile deja cunoscute

String[] cars = { "Volvo", "BMW", "Ford" };

Exemplu creare și populare vector cu valori de la 1 la 20

int[] intArray = new int[20];
for (int i = 0; i < intArray.length; i++) {
	intArray[i] = i + 1;
}

• Fiecare versiune de Java aduce și concepte noi, dar codul rămâne cross-compatible (cod scris pt Java 8 va compila si rula cu Java 12). Dintre lucrurile adaugate in versiuni recente avem declararea variabilelor locale folosind var, ceea ce face implicit inferarea tipului. Codul devine astfel mai ușor de urmărit (Detalii și exemple)

var labString = "lab 1" // type String

• Când folosiți biblioteci third-party o să observați că pachetele au denumiri de forma com.organizationname.libname. Acesta este modul recomandat pentru a le denumi, vedeți mai multe detalii pe pagina oficială. Există situații în care acest stil este obligatoriu, de exemplu o aplicație Android nu poate fi publicată pe Play Store dacă numele pachetelor sale nu respectă aceasta convenție.

• Codul Java este scris în interiorul claselor, enum-urilor și interfețelor (todo link lab cu interfete)
• Un fișier de tip java poate conține mai multe clase
• Numele singurei clase publice dintr-un fișier trebuie să fie același cu numele fișierului (fără extensia .java)
• Fișierele sunt grupate în pachete
• În interiorul unei clase declarăm
  • variabile
  • metode
  • alte clase (lab clase interne)
• Clasele și metodele ar trebui să aibă o singură responsabilitate. Evitați metodele lungi și clase cu mai mult de un rol. Nu puneți toată logica în metoda main. Metoda main ar trebui să conțină doar câteva linii cu instațieri si apeluri de metodele specializate.
• În declarația claselor, câmpurilor, metodelor putem adăuga specificatori de acces sau diverse keywords pe care le vom studia în următoarele laboratoare
  • specificatori de access: public, private, default, protected
• Java are coding style-ul său și este importantă respectarea lui, altfel proiectele, mai ales cele cu mulți dezoltatori ar arăta haotic.
• Tipuri de date primitive: int, long, boolean, float, double, byte, char, short. Câmpurile primitive se inițializează automat la instanțierea unei clase cu valori default: e.g. 0 pentru int.
• Clasa String oferă multe metode pentru manipularea șirurilor de caractere.

Prerequisites

• Java JDK 12 instalat
• IDE (Intellij, eclipse) instalat
• Verificat din linia de comandă versiunea de java:
  • javac -version - comanda javac este folosită pentru compilare
  • java -version - comanda java este folosită pentru rulare

Task 1 (3p)

1. Creați folosind IDE-ul un nou proiect și adăugați codul din secțiunea Exemplu de implementare. Rulați codul din IDE.
2. Folosind linia de comandă, compilați și rulați codul din exemplu
3. Mutați codul într-un pachet task1 (sau alt nume pe care il doriți să îl folosiți). Folosiți-vă de IDE, de exemplu Refactor → Move pentru IntelliJ. Observați ce s-a schimbat în fiecare fișier mutat.

Task 2 (5p)

Creați un pachet task2 (sau alt nume pe care îl doriți să îl folosiți). În el creați clasele:

• Student cu proprietățile: name (String), year (Integer)
• Course
  • cu proprietățile: title (String), description (String), students (array de clase Student - exemplu arrays).
  • cu metoda: filterYear care întoarce o listă de studenți care sunt intr-un an dat ca parametru.
• Nu folosiți vreun modificator de acces pentru variabile (aka “nu puneți nimic în fața lor în afară de tip”)
• Test cu metoda main. La rulare, ca argument în linia de comandă se va da un integer reprezentând anul în care este un student
  1. creați un obiect Course și 3-4 obiecte Student. Populați obiectul Course.
  2. afișați toți studenții din anul dat ca parametru. Hint: folositi Arrays.toString(listStudenti). In clasa Student folositi IDE-ul pentru a genera metoda toString (pt Intellij Code→Generate…)
  3. rulați atât din IDE (modificati run configuration) cât și din linie de comandă
• Opțional, în loc de arrays pentru filterYear puteți să folosiți și obiecte de tip List, e.g. ArrayList (exemplu)

Task 3 (1p)

1. Creați două obiecte Student cu aceleași date în ele. Afișați rezultatul folosirii equals() între ele. Discutați cu asistentul despre ce observați și pentru a vă explica mai multe despre această metodă.
   • documentație

Task 4 (1p)

1. Adăugați modificatorul de acces 'private' tuturor variabilelor claselor Student și Course (e.g. private String name;)
2. Rezolvați erorile de compilare adăugând metode getter și setter acestor variabile.
   1. Ce ați făcut acum se numește încapsulare (encapsulation) și este unul din principiile de bază din programarea orientată pe obiecte. Prin această restricționare protejați accesarea și modificarea variabilelor.
      • Hint: pentru a vă eficientiza timpul, folosiți IDE-ul pentru a generarea aceste metode
        • Eclipse: Source → Generate Getters and Setters
        • IntelliJ: Code → Generate… → Getters and Setters

• Soluție
• Exerciții din alți ani
• POO și Java
• Organizarea surselor și modificatori de acces