diskussING rapport (PDF)




File information


Author: Utilisateur de Microsoft Office

This PDF 1.5 document has been generated by Microsoft® Word 2016, and has been sent on pdf-archive.com on 30/09/2017 at 22:39, from IP address 77.56.x.x. The current document download page has been viewed 276 times.
File size: 1.11 MB (14 pages).
Privacy: public file
















File preview


Programmation

RAPPORT D’EXERCICE

CPLN-ET

DiskussING – utilisation d’une API REST
Auteur
Enseignant
Classe
Date

:
:
:
:

Dany Oliveira da Costa
M. Droz
3M4I2C
26.09.17

Programmation

RAPPORT D’EXERCICE

CPLN-ET

Table des matières

1.

Introduction ................................................................................................................................... 3

2.

L’API diskuss ................................................................................................................................... 3

3.

DiskussING ..................................................................................................................................... 3

4.

Explications détaillées du projet ...................................................................................................... 3

5.

Analyse .......................................................................................................................................... 8
5.1

Définition des conventions applicables.............................................................................................. 8

5.2

Cas d’utilisation ................................................................................................................................. 8

5.3

Maquette ........................................................................................................................................... 9

6.

Conception ................................................................................................................................... 10
6.4

Diagramme de classe....................................................................................................................... 10

6.5

Représentation des méthodes en pseudocode ................................................................................ 10

7.

Développement ............................................................................................................................ 11
7.6

Structure .......................................................................................................................................... 11

7.7

Frontend et backend ........................................................................................................................ 11

8.

Problèmes et obstacles rencontrés ................................................................................................ 13

9.

Conclusion .................................................................................................................................... 13

10.

Bibliographie ............................................................................................................................ 14

diskussING - rapport.docx

Page 2/14

DDC : 26/09/17

Programmation

RAPPORT D’EXERCICE

CPLN-ET

1. Introduction
Dans cet exercice, l’objectif est de développer un client avec la technologie de notre choix pour
interagir avec l’API diskuss. Diskuss est un serveur de chat open-source créé par M. Droz.
Le but de cet exercice est de nous apprendre à utiliser une API et de créer un projet en respectant
les démarches d’analyses, de conceptions et de développements.
Les ressources nécessaires à la réalisation de ce travail nous ont été fournies par le professeur via
Realto (plateforme pour formation professionnelle).
La majeure partie de ce travail se fait en classe pendant les périodes d’ateliers mais de l’avance
peut être faîte à la maison.
La date de reddition de ce travail est le mardi 26 septembre 2017 à 12h15.

2. L’API diskuss
Diskuss est un serveur open-source créé par M. Droz. Le projet est disponible sur GitHub. C’est une
API dîtes RESTful. RESTful est une architecture propre et polyvalente reposant sur les protocoles
de communications HTTP. L’échange d’informations est basé sur des requêtes client-serveur. Son
fonctionnement est le suivant : le client envoie une requête au serveur, le serveur la reçoit et
l’analyse et renvoie une réponse au client.
Diskuss est un serveur de chat qui peut accueillir des utilisateurs dans des salons. Les utilisateurs
peuvent interagir avec les autres utilisateurs en envoyant des messages. Il supporte également
plusieurs fonctions comme la modération (kick/ban).

3. DiskussING
DiskussING, c’est le nom donné à mon client. C’est une webextension navigateur. Cela veut dire
que l’on n’accède pas à diskussING en rentrant une URL mais en cliquant simplement sur son icone
directement implantée dans le navigateur.
DiskussING est open-source. Cela signifie que son code est public et que tout le monde peut le
consulter, modifier ou suggérer des modifications. Le projet est accessible sur GitHub. Par ailleurs,
beaucoup d’informations complémentaires sont fournies sur le repo qui ne seront pas forcément
détaillées dans ce document.
DiskussING est conçu en langage web (HTML/CSS/JavaScript). Comme toutes les autres
webextension d’ailleurs.

4. Explications détaillées du projet
L’utilisateur peut, grâce au programme, interagir avec les autres clients à condition qu’ils utilisent
eux aussi l’API diskuss et qu’ils soient connectés au même serveur.
Pour accéder à diskussING, l’utilisateur n’a juste qu’à cliquer sur le petit icone en haut à droite de
son navigateur.

Une fois cliqué, le client s’ouvre et l’utilisateur rencontre la page de connexion. C’est ici que l’on
saisit les informations concernant la connexion avec le serveur diskuss :
diskussING - rapport.docx

Page 3/14

DDC : 26/09/17

Programmation

RAPPORT D’EXERCICE

CPLN-ET

Une fois la connexion établie, l’interface principale de diskussING s’ouvre :

Dans la partie gauche, en cliquant sur le menu hamburger, on accède à la liste des salons
disponibles sur le serveur :

diskussING - rapport.docx

Page 4/14

DDC : 26/09/17

Programmation

RAPPORT D’EXERCICE

CPLN-ET

Il suffit de cliquer sur le salon souhaité pour y rentrer :

Le chat du salon s’ouvre et l’utilisateur peut commencer à saisir des messages qui seront envoyés
dans le salon en question.

diskussING - rapport.docx

Page 5/14

DDC : 26/09/17

Programmation

RAPPORT D’EXERCICE

CPLN-ET

Si l’on s’intéresse maintenant à la partie de droite, le bouton « + » permet de créer un nouveau
salon.

Une fois créé, l’utilisateur sera automatiquement mené au salon précédemment créé. Ledit salon
sera également visible par les autres utilisateurs.

diskussING - rapport.docx

Page 6/14

DDC : 26/09/17

Programmation

RAPPORT D’EXERCICE

CPLN-ET

J’ai reçu l’aide d’Owen Gombas pour certaines parties de la conception de l’interface utilisateur
(CSS).

diskussING - rapport.docx

Page 7/14

DDC : 26/09/17

Programmation

RAPPORT D’EXERCICE

CPLN-ET

5. Analyse
Pour
la réalisation de ce projet, nous
devions
nous plier
à
analyse/conception/développement. Une image résumant les étapes nous est fourni :

l’approche

5.1 Définition des conventions applicables
Les variables sont écrites en anglais sous forme lowerCamelCase. Les noms des classes et des
méthodes sont écrits en anglais sous la forme CamelCase. L’interface utilisateur, elle, est écrite
en anglais.
5.2 Cas d’utilisation
Le diagramme ci-dessous détaille les actions que l’utilisateur peut réaliser avec diskussING.

diskussING - rapport.docx

Page 8/14

DDC : 26/09/17

Programmation

RAPPORT D’EXERCICE

CPLN-ET

Le scénario de chaque cas d’utilisation se trouve sur le wiki du GitHub (voir bibliographie).
5.3 Maquette
Cette maquette représente diskussING avec toutes les fonctionnalités qui avaient été prévues
d’être implémentées à la base. On remarque que l’édition de salon n’y est pas sur la version
fournie et que certaines options des salons sont également manquantes (voir problèmes et
obstacles rencontrés).

diskussING - rapport.docx

Page 9/14

DDC : 26/09/17






Download diskussING - rapport



diskussING - rapport.pdf (PDF, 1.11 MB)


Download PDF







Share this file on social networks



     





Link to this page



Permanent link

Use the permanent link to the download page to share your document on Facebook, Twitter, LinkedIn, or directly with a contact by e-Mail, Messenger, Whatsapp, Line..




Short link

Use the short link to share your document on Twitter or by text message (SMS)




HTML Code

Copy the following HTML code to share your document on a Website or Blog




QR Code to this page


QR Code link to PDF file diskussING - rapport.pdf






This file has been shared publicly by a user of PDF Archive.
Document ID: 0000679781.
Report illicit content