Colocviu 2

Pentru rezolvarea subiectelor propuse în cadrul colocviului 2, sunt necesare:

• un cont Github personal, pe care să existe drepturi de citire și de scriere;
• SDK-ul de Android (cu o imagine pentru nivelul de API 16 - Jelly Bean 4.1);
• mediul de dezvoltare integrat Eclipse, împreună cu plugin-ul Android Developer Tools;
• un dispozitiv mobil:
  • fizic (bring your own device);
  • virtual: Genymotion, AVD.

În situația în care este necesară procesarea codului sursă (în format HTML) al paginii Internet furnizat ca răspuns la cererea transmisă către un serviciu web, se poate folosi biblioteca Jsoup. Integrarea sa în mediul integrat pentru dezvoltare Eclipse Luna SR1a (4.4.1) se face prin plasarea fișierului corespunzător în directorul libs al proiectului. Acesta devine vizibil în momentul în care se accesează operația Refresh din meniul contextual, disponibilă și prin tasta F5. Ulterior, pentru a fi inclus în classpath, este necesar ca din meniul contextual asociat fișierului jsoup-1.8.2.jar (disponibil pe butonul drept al mouse-ului) să se acceseze Build Path → Add to Build Path.

După ce biblioteca a fost integrată în cadrul mediului integrat pentru dezvoltare Eclipse Luna SR1a (4.4.1), aceasta va putea fi vizualizată în secțiunea Referenced Libraries din proiectul corespunzător.

În situația în care este necesară procesarea unui document JSON furnizat ca răspuns la cererea transmisă către un serviciu web, se vor utiliza clasele JSONObject, respectiv JSONArray, din cadrul SDK-ului Android. Pentru vizualizare, se poate folosi utilitarul JSON Formatter & Validator, prin care structura documentului JSON poate fi inspectată cu ușurință.

Proiectul Eclipse corespunzător aplicației Android ce conține rezolvările complete ale cerințelor colocviului este disponibil pe contul de Github al disciplinei.

1. Se accesează Github și se realizează autentificarea în contul personal, prin intermediul butonului Sign in.

Se creează o zonă de lucru corespunzătoare unui proiect prin intermediului butonului New Repository.

Configurarea depozitului la distanță presupune specificarea:

• unei denumiri;
• unei descrieri (opțional);
• tipului de director (public sau privat - doar contra cost!!!);
• modului de inițializare:
  • local, prin git init;
  • la distanță, prin git clone - depozitul la distanță nu trebuie să fie vid, în această situațoe
• unui fișier README (opțional);
• extensiilor ignorate (corespunzătoare limbajului de programare folosit, în cazul de față - Android) - incluse în fișierul .gitignore;
• tipului de licență sub care este publicat codul sursă.

2. Prin intermediul comenzii git clone se poate descărca întregul conținut în directorul curent (de pe discul local), inclusiv istoricul complet al versiunilor anterioare (care poate fi ulterior reconstituit după această copie, în cazul coruperii informațiilor stocate pe serverul la distanță).

student@pdsd2015:~$ git clone https://www.github.com/perfectstudent/PracticalTest02

3. Se urmăresc indicațiile disponibile în secțiunea Crearea unei aplicații Android în Eclipse Luna SR1a (4.4.1).

4. Pentru implementarea interfeței grafice, se vor defini controalele care asigură interacțiunea cu utilizatorul pentru fiecare dintre componentele aplicației Android:

• serverul
  • un câmp text pentru specificarea portului pe care va accepta conexiuni de la clienți;
  • un buton pentru lansarea în execuție;
• clientul
  • câmpuri text pentru precizarea parametrilor de conexiune la server:
    • adresa Internet (se va folosi localhost sau 127.0.0.1);
    • port;
  • elemente grafice pentru indicarea informațiilor solicitate:
    • un câmp text pentru oraș;
    • o listă populată cu datele meteorologice care se doresc a fi furnizate (temperature, wind_speed, condition, pressure, humidity, all); ca alternativă, se poate folosi tot un câmp text, cu restricția ca valorile introduse să facă parte din mulțimea acceptată;
  • un buton pentru trimiterea cererii și primirea răspunsului, condiționată de completarea anterioară a tuturor celorlalte informații.

activity_practical_test02_main.xml

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:orientation="vertical"
  tools:context="ro.pub.cs.systems.pdsd.practicaltest02.graphicuserinterface.PracticalTest02MainActivity" >
 
  <TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_gravity="center"
    android:textSize="25sp"
    android:textStyle="bold"
    android:text="@string/server" />
 
  <LinearLayout
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:baselineAligned="false">
 
    <ScrollView
      android:layout_width="0dp"
      android:layout_height="wrap_content"
      android:layout_weight="1">
 
      <EditText
        android:id="@+id/server_port_edit_text"
	android:layout_width="match_parent"
	android:layout_height="wrap_content"
	android:hint="@string/server_port" />
 
    </ScrollView>
 
    <ScrollView
      android:layout_width="0dp"
      android:layout_height="wrap_content"
      android:layout_weight="1">
 
      <Button
        android:id="@+id/connect_button"
	android:layout_width="wrap_content"
	android:layout_height="wrap_content"
	android:layout_gravity="center"
	android:text="@string/connect" />
 
    </ScrollView>
 
  </LinearLayout>
 
  <Space
    android:layout_width="wrap_content"
    android:layout_height="10dp" />
 
  <TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_gravity="center"
    android:textSize="25sp"
    android:textStyle="bold"
    android:text="@string/client" />
 
  <LinearLayout
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:baselineAligned="false">
 
    <ScrollView
      android:layout_width="0dp"
      android:layout_height="wrap_content"
      android:layout_weight="1">
 
      <EditText
        android:id="@+id/client_address_edit_text"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="@string/client_address" />
 
    </ScrollView>
 
    <ScrollView
      android:layout_width="0dp"
      android:layout_height="wrap_content"
      android:layout_weight="1">
 
      <EditText
        android:id="@+id/client_port_edit_text"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="@string/client_port" />
 
    </ScrollView>
 
  </LinearLayout>    
 
  <GridLayout
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:rowCount="2"
    android:columnCount="2">
 
    <EditText
      android:id="@+id/city_edit_text"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:ems="5"
      android:hint="@string/city"
      android:layout_row="0"
      android:layout_column="0" />
 
    <Spinner
      android:id="@+id/information_type_spinner"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:entries="@array/information_types"
      android:layout_row="1"
      android:layout_column="0" />
 
    <Button
      android:id="@+id/get_weather_forecast_button"
      android:layout_width="100dp"
      android:layout_height="wrap_content"
      android:layout_gravity="center"
      android:text="@string/get_weather_forecast"
      android:layout_row="0"
      android:layout_rowSpan="2"
      android:layout_column="1" />
 
  </GridLayout>
 
  <ScrollView
    android:layout_width="match_parent"
    android:layout_height="match_parent">
 
    <TextView
      android:id="@+id/weather_forecast_text_view"
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:singleLine="false"
      android:maxLines="10" />
 
  </ScrollView>
 
</LinearLayout>

5. Implementarea serverului presupune:

a) un fir de execuție care gestionează solicitările de conexiune de la clienți:

• se va instanția un obiect de tip ServerSocket care va primi ca parametru portul indicat de utilizator:

  try {
    serverSocket = new ServerSocket(port);
  } catch (IOException ioException) {
    Log.e(Constants.TAG, "An exception has occurred: " + ioException.getMessage());
    if (Constants.DEBUG) {
      ioException.printStackTrace();
    }
  }

• se va gestiona un obiect de tip Hashmap în care vor fi reținute informațiile meteorologice cu privire la diferite orașe care au fost interogate anterior, astfel încât acestea să fie furnizate de la nivel local, fără a mai fi necesară conexiunea la distanță (în acest sens trebuie definită și clasa model WeatherForecastInformation care să conțină datele meteorologice disponibile - temperatură, viteza vântului, stare generală, presiune, umiditate - implementând pentru fiecare dintre acestea metode de tip getter și setter):

  data = new HashMap<String, WeatherForecastInformation>();

• atâta vreme cât firul de execuție nu este întrerupt (aplicația Android nu a fost distrusă), sunt acceptate conexiuni de la clienți (prin invocarea metodei accept() apelată pe obiectul de tip ServerSocket, aceasta întorcând un obiect de tip Socket), comunicația dintre acestea fiind tratată pe un fir de execuție dedicat:

  @Override
  public void run() {
    try {
      while (!Thread.currentThread().isInterrupted()) {
        Log.i(Constants.TAG, "[SERVER] Waiting for a connection...");
        Socket socket = serverSocket.accept();
        Log.i(Constants.TAG, "[SERVER] A connection request was received from " + socket.getInetAddress() + ":" + socket.getLocalPort());
        CommunicationThread communicationThread = new CommunicationThread(this, socket);
        communicationThread.start();
      }
    } catch (ClientProtocolException clientProtocolException) {
      Log.e(Constants.TAG, "An exception has occurred: " + clientProtocolException.getMessage());
      if (Constants.DEBUG) {
        clientProtocolException.printStackTrace();
      }
    } catch (IOException ioException) {
      Log.e(Constants.TAG, "An exception has occurred: " + ioException.getMessage());
      if (Constants.DEBUG) {
        ioException.printStackTrace();
      }
    }
  }

De remarcat faptul că pentru un obiec de tip Socket se poate determina:

• adresa Internet, furnizată de metoda getInetAddress();
• portul, furnizat de metoda getLocalPort().

Pornirea firului de execuție corespunzător serverului va fi realizată pe metoda de callback a obiectului ascultător pentru evenimentul de tip apăsare a butonului aferent din interfața grafică:

private class ConnectButtonClickListener implements Button.OnClickListener {
  @Override
  public void onClick(View view) {
    String serverPort = serverPortEditText.getText().toString();
    if (serverPort == null || serverPort.isEmpty()) {
      Toast.makeText(
        getApplicationContext(),
        "Server port should be filled!",
        Toast.LENGTH_SHORT
      ).show();
      return;
    }
    serverThread = new ServerThread(Integer.parseInt(serverPort));
    if (serverThread.getServerSocket() != null) {
      serverThread.start();
    } else {
      Log.e(Constants.TAG, "[MAIN ACTIVITY] Could not creat server thread!");
    }
  }
}

@Override
protected void onDestroy() {
  if (serverThread != null) {
    serverThread.stopThread();
  }
  super.onDestroy();
}

public void stopThread() {
  if (serverSocket != null) {
    interrupt();
    try {
      if (serverSocket != null) {
        serverSocket.close();
      }
    } catch (IOException ioException) {
      Log.e(Constants.TAG, "An exception has occurred: " + ioException.getMessage());
      if (Constants.DEBUG) {
        ioException.printStackTrace();
      }
    }
  }
}

b)

6.

7. Pentru încărcarea codului în contextul depozitului din cadrul contului Github personal:

1. se transferă modificările din zona de lucru în zona de lucru în zona de așteptare prin intermediul comenzii git add, indicându-se și fișierele respective (pot fi folosite șabloane pentru a desemna mai multe fișiere);
2. se consemnează modificările din zona de așteptare în directorul Git prin intermediul comenzii git commit -m, precizându-se și un mesaj sugestiv:
3. se încarcă modificările la distanță, prin intermediul comenzii git push, care primește ca parametrii:
   1. sursa (prin eticheta origin se indică depozitul de unde au fost descărcat conținutul);
   2. destinația: ramificația curentă (implicit, aceasta poartă denumirea master).

student@pdsd2015:~/PracticalTest02$ git add *
student@pdsd2015:~/PracticalTest02$ git commit -m "finished tasks for PracticalTest02"
student@pdsd2015:~/PracticalTest02$ git push origin master

În cazul în care este necesar, vor fi configurați parametrii necesari operației de consemnare (numele de utilizator și adresa de poștă electronică):

student@pdsd2015:~/PracticalTest02$ git config --global user.name "Perfect Student"
student@pdsd2015:~/PracticalTest02$ git config --global user.email perfectstudent@cs.pub.ro

8.

9.

10.