diff --git a/nGit.md b/nGit.md index 30d35e4..369fddf 100644 --- a/nGit.md +++ b/nGit.md @@ -42,8 +42,7 @@ Un court texte par l'un des contributeurs de GitHub présentant la philosophie d ### [Git is simpler than you think](http://nfarina.com/post/9868516270/git-is-simpler) -L'auteur décrit en détail la structure de l'archive Git, les différents objets constitutifs de la base de données et la manière dont git gère les différentes branches et les heads. - +L'auteur décrit en détail la structure de l'archive Git, les différents objets constitutifs de la base de données et la manière dont git gère les différentes branches et les heads. En bref : le pourquoi du comment nécessaire pour comprendre. Ouvrages @@ -55,3 +54,30 @@ L'ouvrage de Scott Chacon examine l'ensemble des fonctionnalités du système de ### [Git Magic](http://www-cs-students.stanford.edu/~blynn/gitmagic/intl/fr/) + + +### [Git User's Manual](https://www.kernel.org/pub/software/scm/git/docs/user-manual.html) + + +Quelques références sur Git et les DH +--------- + + +Travailler avec Github +--------- + +Workflows, etc. + + +### [The illustrated guide to recover commits](http://www.programblings.com/2008/06/07/the-illustrated-guide-to-recovering-lost-commits-with-git/) + +Parceque c'est parfois nécessaire... + + +### [Section "The Workflow" du Git user manual](https://www.kernel.org/pub/software/scm/git/docs/user-manual.html#the-workflow) + + +Rédiger avec Git +---------- + + diff --git a/nWSDL.md b/nWSDL.md new file mode 100644 index 0000000..7646a92 --- /dev/null +++ b/nWSDL.md @@ -0,0 +1,71 @@ +--- +title: note WSDL +filename: nWSDL.md +date: 2014-03-05 +version: 1.0 +--- + +WSDL ou WADL +========== + +imaginer une extension de xqDoc pour une doc en WSDL 2.0 ou WADL d'un service RESTXQ + + + +WSDL +----- + +WSDL est un langage XML pour la description formelle de services web. +WSDL, depuis la version 2.0 prend en charge de HTTP. +WSDL est une recommandation du W3C de 2007. + +WSDL présente les contrats d'interface pour les clients. La description WSDL spécifie l'adresse, les mécanisme de communication autorisés, l'interface et le type des messages d'un service web. En somme une description WSDL fournit toutes les informations nécessaires à un client pour utiliser un service web. + +WSDL permet de renseigner +- l'URL du service +- les mécanismes de communication qu'il comprend +- les opérations qu'il peut réaliser +- la structure de ses messages + +Squelette d'un document WSDL 2.0 : + +WSDL est un langage XML dans l'espace de nom http://www.w3.org/ns/wsdl +L'élément racine d'un document WSDL est `description`. +Il accepte quatre éléments fils qui rassemblent les détails sur le service web. +- types +- interface +- binding +- service + +```xml + + + + + + +``` + +L'élément `type` contient toutes les informations de schéma XML et les définitions de type qui décrivent les messages du service web. + +L'élément `interface` définit les opérations du web service, y compris les sorties et les entrées spécifiques, ainsi que les messages d'erreurs qui doivent être passés, et leur ordre. + +L'élément `binding` définit comment un client peut communiquer avec un service web. Dans le cas de service REST, un binding spécifie que le client peut communiquer en utilisant HTTP. + +L'élément `service` associe une adresse pour le service web avec une interface spécifique et un binding. + +WSDL 2.0 définit deux espaces de noms supplémentaires qui peuvent être employés pour des services REST : + +- Un espace de nom HTTP http://www.w3.org/ns/wsdl/http qui inclue l'élément binding HTTP +- un espace de nom d'extensions http://www.w3.org/ns/wsdl-extensions qui inclue les définitions de trois attributs : deux d'entre eux sont utilisés pour associer un hyperlien dans un document XML avec la description d'un service web, et le troisième pour décrire l'opération d'un web service comme sûre. + + +Source +------- + +- [Describe REST Web services with WSDL 2.0, IBM developerWorks, 2008](http://www.ibm.com/developerworks/webservices/library/ws-restwsdl/) +- [Web Services Description Language (WSDL) Version 2.0 Part 0: Primer](http://www.w3.org/TR/2007/REC-wsdl20-primer-20070626/) +- [Describing RESTful Applications](http://www.infoq.com/articles/subbu-allamaraju-rest) +- [WADL](http://fr.wikipedia.org/wiki/Web_Application_Description_Language) +- http://bitworking.org/news/193/Do-we-need-WADL +- http://www.w3.org/Submission/wadl