Ajout des tutoriels de Benoît

Geoffrey PREUD'HOMME
1 parent 2a07b829
Showing 5 changed files with 228 additions and 0 deletions Show diff stats
_layouts/tuto.html
_tutos/git.md
_tutos/jdbi.md
_tutos/spring.md
tutos.html
@@ -0,0 +1,22 @@
+---
+layout: default
+---
+
+<div class="home">
+
+    <h1 class="post-title">Tutoriel : {{ page.title }}</h1>
+    <p class="post-meta">
+        {% if page.author %}
+        <span itemprop="author" itemscope itemtype="http://schema.org/Person">
+            <span itemprop="name">{{ page.author }}</span>
+        </span>
+        {% endif %}
+        {% if page.author %}
+            (<a href="{{ page.license_url }}">{{ page.license }}</a>)
+        {% endif %}
+    </p>
+
+    {{content}}
+
+</div>
+
@@ -0,0 +1,93 @@
+---
+title: "Git"
+tags: git
+author: "Benoit 'badetitou' Verhaeghe"
+license: WTFPL
+license_url: http://www.wtfpl.net/
+---
+
+# Présentation
+
+Git est un outil de gestion de version
+
+Lors du développement d'une application, il arrive souvent que plusieurs personne travail sur le même projet. Le plus grand des problèmes est donc _Comment vais-je faire travailler tout le monde sans pour autant tout casse ?_ Mais aussi, si quelqu'un casse tout, comment revenir en arrière. Evidemment, le mail n'est pas la solution. _Qui a fait quoi ? Quand ? Tu es à quelle version ? Mince toi aussi tu as modifié le fichier ?_
+
+C'est pour cela que git existe. Il va nous permettre de développer un projet de manière **propre**
+
+# Mais comment ça fonctionne ?
+
+Vous avez un serveur git (local, ou en ligne). Vous avez un client git (généralement sur votre machine). Vous communiquez depuis votre client vers le serveur.
+
+_Comment ?_
+
+Lorsque vous créer des fichiers pour votre projet, vous dîtes à votre client de les ajoutés au projet. Ensuite, quand vous modifier un fichier, vous **commentez** vos modifications. Enfin, vous ajoutez les modifications sur le serveur.
+
+_Et la collaboration ?_
+
+Les personnes que vous avez autorisées peuvent télécharger le projet sur leur ordinateur avec un client git. Faire des modifications. Et envoyer des propositions de correction.
+
+_Mais si on modifie la même chose ?_
+
+On peut voir git comme un système de calque. Au début, on a un calque. Ensuite chacun copie la calque pour lui-même. On modifie tous notre calque et ensuite on combine l'ensemble des calques pour mettre à jour le premier. Dès qu'une modification est validé (par nous), on combine notre calque et le calque original. Un participant du projet peut copié le calque original à n'importe quelle moment (après ou avant des modifications). Si on veut combiner un calque que nous avons créer avec le calque original (qui a été modifié depuis). Et que des modifications se confronte, on doit créer un calque de correction qui permet de contenter les modifications de tout le monde.
+
+_Euh... Pourquoi git ? Ca fait beaucoup à apprendre_
+
+C'est vrai que git n'est pas facile à prendre en main. Mais vim non plus, et pourtant il n'y a rien de mieux. Plus sérieusement, apprendre git c'est un investissement au départ mais qui vous servira toute votre vie. Travail en équipe, gestion de version, mise en production par version (docker), résolution de bug,... En plus, les entreprises utilisent git.
+
+# Installation
+
+Installation de Git chez vous
+
+## Linux
+
+`apt install git`
+
+## Windows
+
+[msysgit executable](http://msysgit.github.io)
+
+## Mac
+
+[git osx installer](http://sourceforge.net/projects/git-osx-installer/)
+
+## Polytech Lille
+
+Git peut fonctionner grâce au protocole SSH et HTTPS. SSH ne peut pas être utilisé à Polytech (question de sécurité réseau). C'est pour cela que nous verrons l'utilisations avec HTTPS ici.
+
+L'utilisation de SSH reste similaire.
+
+Afin d'utiliser le proxy HTTPS de Polytech avec GIT vous devez executer la commande suivante dans un terminal. Vous pouvez evidemment simplifier la manipulation en ajoutant la ligne suivante dans votre ~/.bashrc.
+
+```bash
+export http_proxy=proxy.polytech-lille.fr:3128
+export https_proxy=$http_proxy
+export ftp_proxy=$http_proxy
+export rsync_proxy=$http_proxy
+export no_proxy="localhost,127.0.0.1,localaddress,.localdomain.com"
+```
+
+# Commandes de base
+
+## git init
+
+Permet de créer un repository sur la machine local. Contient l'ensemble du projet. C'est ce que l'on retrouve sur chaque machine possédant le projet.
+
+## git clone [url]
+
+Permet de récuperer un repository distant.
+
+## git pull
+
+Permet de mettre à jour un repository.
+
+## git add [nom de fichier/dossier]
+
+Permet d'ajouter un fichier ou projet au repository.
+
+## git commit -m "[commentaire]"
+
+Permet de commenter les modification effectuer et les prépares à la validation.
+
+## git push
+
+Permet de valider les modifications effectuées.
@@ -0,0 +1,47 @@
+---
+title: JDBI
+tags: jdbi java
+author: "Benoit 'badetitou' Verhaeghe"
+license: WTFPL
+license_url: http://www.wtfpl.net/
+---
+
+# Objectifs
+L'objectif de jdbi est de simplifier l'accès au base de donner en offrant un niveau d'abstraction supplémentaire à jdbc.
+
+Cette bibliothèque permet de se connecter à une base de données, effectuer des requetes sql sécurisées, et de convertir automatiquement les résultats en objet.
+
+Vous trouverez ici quelques outils pour mieux comprendre jdbi.
+
+# Annotations
+
+<table>
+    <thead>
+        <tr>
+            <th>Annotations</th>
+            <th>Définitions</th>
+        </tr>
+    </thead>
+    <tbody>
+        <tr>
+            <td>@SqlQuery(String myRequest)</td>
+            <td>A mettre au dessus du nom de la fonction voulu (pour une interface). Execute la requete de type Select defini" dans "myRequest".</td>
+        </tr>
+        <tr>
+            <td>@SqlUpdate(String myRequest)</td>
+            <td>A mettre au dessus du nom de la fonction voulu (pour une interface). Execute la requete de type Update (tout sauf les Select et les Procedures stockées) definit dans "myRequest".</td>
+        </tr>
+        <tr>
+            <td>@SqlUpdate(String myRequest)</td>
+            <td>A mettre au dessus du nom de la fonction voulu (pour une interface). Execute la requete de type Update (tout sauf les Select et les Procedures stockées) definit dans "myRequest".</td>
+        </tr>
+        <tr>
+            <td>@RegisterMapperFactory(BeanMapperFactory.class)</td>
+            <td>A mettre au dessus du nom de la fonction voulu (pour une interface). Permet de retourner l'objet correspondant au type de retour de la fonction. La correspondance se fait autmatiquement, l'object doit cependant avoir les même attributs que les colonnes retourner par la requete.</td>
+        </tr>
+        <tr>
+            <td>@GetGeneratedKeys</td>
+            <td>A mettre au dessus du nom de la fonction voulu (pour une interface). Permet de récuperer la clef primaire générée lors d'une insertion.</td>
+        </tr>
+    </tbody>
+</table>
@@ -0,0 +1,48 @@
+---
+title: "Spring"
+tags: spring java
+author: "Benoit 'badetitou' Verhaeghe"
+license: WTFPL
+license_url: http://www.wtfpl.net/
+---
+
+# Objectifs
+
+L'objectif de Spring est de fournir un ensemble d'outils permettant de compiler et déployer un serveur partout en se basant sur la JAVA machine.
+
+Avec Spring vous pouvez créer le serveur et le tester et le lancer n'importe où. Tout cela avec avec un model [REST](https://fr.wikipedia.org/wiki/Representational_state_transfer).
+
+Vous trouverez ici une partie des annotations SPRING et comment les utiliser
+
+# Annotations
+
+<table>
+    <thead>
+        <tr>
+            <th>Annotations</th>
+            <th>Définitions</th>
+        </tr>
+    </thead>
+    <tbody>
+        <tr>
+            <td>@SpringBootApplication</td>
+            <td>Classe de démarrage de Spring. C'est une compilation d'annotation. Elle permet entre autres de detecter les classes du même package définit comme controller Spring.</td>
+        </tr>
+        <tr>
+            <td>@EnableAutoConfiguration</td>
+            <td>Auto-configuration de Spring</td>
+        </tr>
+        <tr>
+            <td>@Controller</td>
+            <td>Definit une classe comme controller de Spring</td>
+        </tr>
+        <tr>
+            <td>@RestController</td>
+            <td>Definit une classe comme controller Spring pour faire du REST.</td>
+        </tr>
+        <tr>
+            <td>@RestMapping</td>
+            <td>Definit le chemin vers un élement d'une classe REST.</td>
+        </tr>
+    </tbody>
+</table>
@@ -0,0 +1,18 @@
+---
+title: Tutoriels
+tags: header
+---
+
+<p>Vous trouverez ici tous les tutoriels rédigés par nos membres. Peut-être y trouverez-vous votre bonheur !</p>
+
+<ul class="post-list">
+{% for my_tuto in site.tutos %}
+  <li>
+    <h2>
+      <a class="post-link" href="{{ my_tuto.url | relative_url }}">
+          Tutoriel : {{ my_tuto.title | escape }}
+      </a>
+    </h2>
+  </li>
+{% endfor %}
+</ul>