Goélette Cardabela/Sommaire du livre
__NOEDITSECTION__
Goélette Cardabela/Notes et références
Notes et références.
Annexes du livre "La goélette Cardabela, (De 1979 à 1999), tout pour la re-construire". Téléchargeables sur :
Les leçons de la navigation :
La goélette Cardabela - Collection des livrets techniques :

Wikilivres/Pourquoi écrire sur Wikibooks ?

Wikibooks pourrait devenir une grande bibliothèque pédagogique, où le meilleur du savoir serait donné à tous et renouvelé en permanence. Les avantages pour les auteurs sont nombreux :
Lorsqu'on cite un wikilivre dans un article de Wikipédia, dans une rubrique de lectures complémentaires, les wikipédiens ne sont pas obligés d'accepter. Si la référence est inappropriée, elle doit bien sûr être supprimée. Mais même si elle est appropriée, un wikipédien peut pointer un conflit d'intérêts, si un auteur de Wikibooks veut placer sur Wikipédia un de ses livres, surtout s'il est signé. Il n'est donc pas toujours facile d'être cité sur Wikipédia, même pour les wikilivres.

Wikilivres/Créer un compte utilisateur
Pour lire et écrire sur Wikilivres, la création d'un compte utilisateur n'est pas obligatoire, mais elle est recommandée. Il suffit de choisir un nom d'utilisateur et un mot de passe après avoir cliqué sur l'onglet "Se connecter" en haut à droite de la page. Le nom d'utilisateur peut être un pseudonyme ou un vrai nom, pourvu qu'il n'ait pas déjà été utilisé par un autre. Il sert à identifier toutes les contributions de l'utilisateur, qui sont sinon identifiées par leur adresse IP. Une fois le compte créé, le nom d'utilisateur apparaît en rouge dans un onglet haut à gauche. En cliquant dessus, l'utilisateur peut alors créer sa page d'utilisateur, mais il n'est pas obligé de le faire. Il peut aussi créer cette page et la laisser blanche. 
La création d'un compte utilisateur offre plusieurs avantages :

Framework Spring/Création d'un projet simple

Le but de cette section est de créer un projet simple à partir de STS sans pour l'instant faire appel à Spring.
= Structure du projet =
En créant un projet intitulé "SimpleJavaProject" de type Spring Legacy Project - Simple Java on doit obtenir l'arborescence suivante :
Le S indiqué sur le projet signifie qu'il s'agit là d'un projet Spring. Le répertoire src contient les futurs fichiers sources. L'arborescence JRE, Java RunTime Environment, constitue les libraires permettant l’exécution du programme par la JVM, Java Virtual Machine. Plus d'informations ici
Le résultat de ce projet sous l'explorateur est le suivant :
Le répertoire .settings est caché et sert de configuration pour Eclipse, il contient le fichier org.springframework.ide.eclipse.beans.core.prefs :
 eclipse.preferences.version=1
 org.springframework.ide.eclipse.beans.core.ignoreMissingNamespaceHandler=false
Ce fichier correspond à la configuration de Spring dans STS :
En autorisant des propriétés spécifiques pour le projet courant, un nouveau fichier org.springframework.ide.eclipse.core.prefs est créé dans .settings qui rassemble de nombreuses informations à propos de la configuration du projet.
Fichier .classpath.
Par défaut le fichier .classpath contient les informations suivantes :
 <?xml version="1.0" encoding="UTF-8"?>
 <classpath>
 <classpathentry kind="src" path="src"/>
 <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.7"/>
 <classpathentry kind="output" path="bin"/>
 </classpath>
Cela va permettre à STS de savoir ce qu'il faut compiler et vers où générer le résultat. La propriété kind="src" indique que pour récupérer un fichier de classpath, la valeur indiquée sera prise en compte comme chemin. Ainsi en utilisant ClassPathXmlApplicationContext("Beans.xml"), le fichier Beans.xml sera cherché dans le répertoire "src" à la racine du projet.
Un classpath peut être ajouté graphiquement, il suffit de sélectionner un répertoire créé :
Fichier .project.
Le fichier .project contient la description du projet, les outils utilisés pour le construire ainsi que le type de projet.
 <?xml version="1.0" encoding="UTF-8"?>
 <projectDescription>
 <name>SimpleJavaProject</name>
 <comment></comment>
 <projects>
 </projects>
 <buildSpec>
 <buildCommand>
 <name>org.eclipse.jdt.core.javabuilder</name>
 <arguments>
 </arguments>
 </buildCommand>
 <buildCommand>
 <name>org.springframework.ide.eclipse.core.springbuilder</name>
 <arguments>
 </arguments>
 </buildCommand>
 </buildSpec>
 <natures>
 <nature>org.springframework.ide.eclipse.core.springnature</nature>
 <nature>org.eclipse.jdt.core.javanature</nature>
 </natures>
 </projectDescription>
fichier .springBeans.
Ce fichier contient la configuration des beans de Spring :
 <?xml version="1.0" encoding="UTF-8"?>
 <beansProjectDescription>
 <version>1</version>
 <pluginVersion><![CDATA[3.7.3.201602250914-RELEASE]]></pluginVersion>
 <configSuffixes>
 <configSuffix><![CDATA[xml]]></configSuffix>
 </configSuffixes>
 <enableImports><![CDATA[false]]></enableImports>
 <configs>
 </configs>
 <autoconfigs>
 </autoconfigs>
 <configSets>
 </configSets>
 </beansProjectDescription>
= Conversion en projet Maven =
Afin d'obtenir plus facilement les librairies il est pertinent d'ajouter les fonctionnalités de Maven. Pour cela il est nécessaire de faire un clique droit sur le projet et d'aller dans le sous-menu Configure :
On obtient alors une fenêtre de création du pom :
= Fichier pom.xml =
Lors de la conversion en projet maven, un fichier pom.xml est généré à la racine du projet :
 <project xmlns="http://maven.apache.org/POM/4.0.0" 
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 <modelVersion>4.0.0</modelVersion>
 <groupId>SimpleJavaProject</groupId>
 <artifactId>SimpleJavaProject</artifactId>
 <version>0.0.1-SNAPSHOT</version>
 <build>
 <sourceDirectory>src</sourceDirectory>
 <plugins>
 <plugin>
 <artifactId>maven-compiler-plugin</artifactId>
 <version>3.3</version>
 <configuration>
 < source/>
 <target/>
 </configuration>
 </plugin>
 </plugins>
 </build>
 </project>
Le fichier POM signifie Project Object Model, il va contenir l'ensemble des informations pour permettre la construction du projet. Tous les fichiers POM héritent d'un super POM. Il contient toujours une balise project avec les informations minimales.
Plus d'informations sur le site de maven.
= Création d'un package =
Avant de pouvoir écrire du code il est nécessaire de créer un package contenant les futures classes. En faisant un clique droit sur le répertoire sources on obtient ce menu :
= Création de la classe principale =
En faisant un clique droit sur le package principal on peut ajouter des classes, on va créer la classe contenant le main qui est le point d'entrée d'un programme java. La génération de la méthode main peut être réalisée directement avec l'interface :
Cela donne ainsi le code suivant :
 package mainPackage;
 public class MainClass 
 public static void main(String[] args) 
 // TODO Auto-generated method stub
Ceci constitue le programme Java fonctionnel le plus simple ne faisant pas ici encore appel à Spring.

Framework Spring/Mise en place de l'environnement