POO Lab Lucrarea 3

Noțiuni și cunoștințe necesare

• Paradigma Obiect-Orientare; Clase și obiecte
• Noțiuni despre Java
• Realizarea și execuția unui program Java
• Sintaxa limbajului Java; Structura lexicală a unui program
• Convenții de programare
• Noțiuni avansate de programare obiect-orientată
• Java Application Programming Interface (API)
• Tratarea excepțiilor
• Stream-uri de Input/Output

Cerințe

1. Realizați o clasă numită ServerConfig care are ca rol citirea dintr-un fișier de configurare a unor parametri, pe care îi vom folosi ulterior în aplicația server. Această clasă trebuie să respecte următoarele constrângeri:
   • Clasa trebuie să dispună de doi constructori:
     1. Unul cu un argument de tip String care va reprezenta fișierul de configurare citit
     2. Unul fără argumente, care va considera implicit fișierul de configurare ca fiind server.conf.
   • Obiectele de tip ServerConfig trebuie să citească fișierul de configurare și apoi să expună parametrii citiți din fișier prin metode.
   • Metodele din clasa ServerConfig trebuie să arunce excepții dacă apar probleme la citirea sau interpretarea fișierului de configurare:
     1. IOException dacă fișierul specificat nu există sau nu se poate citi (această excepție este aruncată de către metodele care aparțin claselor de tip stream, deci nu este necesară decât aruncarea ei mai departe).
     2. InvalidFormatException dacă cel puțin o linie din fișier nu corespunde formatului așteptat (acest tip de excepție nu există și va trebui creat).
     3. UnknownKeyException dacă în fișier există configurată o proprietate necunoscută (acest tip de excepție nu există și va trebui creat).
     4. MissingKeyException dacă din fișier lipsește una din proprietățile așteptate (acest tip de excepție nu există și va trebui creat).
   • Clasa trebuie să fie imutabilă.
2. Următoarele proprietăți sunt singurele valide, care trebuie să existe în fișierul de configurare:
   • TCP_PORT - reprezintă portul TCP pe care server-ul e configurat să accepte conexiuni.
   • MAX_CLIENTS - reprezintă numărul maxim de clienți pe care serverul îl poate deservi.
3. Realizați un test pentru această clasă (care constă în citirea unui fișier și afișarea pe ecran a valorilor citite) pe care să-l plasați în metoda main din clasa Main.

Fișierul de configurare citit de clasa ServerConfig este un fișier text, format din linii de forma următoare:

PROPERTY=value

• Orice linie care începe cu caracterul #, precedat sau nu de spații sau caractere "tab", se consideră a fi comentariu și nu se ia în considerare.
• Liniile din fișier care nu conțin nici un caracter printabil, ci doar spații și/ sau tab-uri, nu se iau în considerare.
• Nu se iau în considerare spațiile (sau tab-urile) de la începutul sau sfârșitul liniilor.

Un exemplu de fișier de configurare:

#this is a config file for the chat server!
      #   this is made by ME!
MAX_CLIENTS=100
       TCP_PORT=9000

Note:

• Cele trei tipuri de excepții care trebuie definite au implementări foarte simple. Trebuie definite ca niște clase care extind clasa Exception, și nu este nevoie să conțină decât definiția unui constructor cu un argument de tip String care nu face altceva decât să apeleze constructorul superclasei.
• Fișierele predate vor fi implementările Java a următoarelor clase: ServerConfig, Main, Message, PrivateMessage, InvalidFormatException, UnknownKeyException și MissingKeyException.
• Următoarele clase și metode vă pot fi de folos în realizarea temei. Căutați-le în documentația API:
  • String.trim
  • String.charAt
  • String.contains
  • String.startsWith
  • String.equals
  • String.split
  • Integer.parseInt
  • BufferedReader.readLine
• Din cauza faptului că puteți avea două obiecte de tip String diferite (cu referințe diferite) dar care conțin același text, iar operatorul == compară referințele, modul corect prin care se compară două String-uri este prin apelarea metodei equals:

String a = "abc";
String b = new String(a);
if(a == b) { // <- incorect, evaluarea va întoarce false
  //...
}
if(a.equals(b)) { // <- corect, evaluarea va întoarce true
  //...
}

Predare:

• Tema se predă atașând exclusiv fișierele sursă Java unui e-mail trimis la adresa radu.hobincu@upb.ro.
• Subiectul email-ului va fi: [POO_3]
• Corpul email-ului va conține numele și grupa expeditorului, și orice alt comentariu pe care doriți să-l faceți despre temă.
• Atenție: Orice nerespectare ale indicațiilor de predare poate duce la pierderea în totalitate a punctajului.