Conception

RAML 1.0 est disponible

Plus de 6 mois après l'annonce de RAML RC1, RAML GA est enfin disponible ! Le projet RAML profite de cette annonce pour faire un rapide tour d'horizon des nouvelles fonctionnalités. Sur le blog de Restlet, Guillaume Laforge rappelle la présentation de Michael Stowe sur RAML : Et surtout, il liste les quelques changements qui rendent RAML et incompatibles. Il ne reste plus qu'à attendre que les outils de l'éco-système RAML supportent cette nouvelle version de façon stable.
Lire d'avantage
Conception

Swagger est mort, vive l’Open API Initiative !

Aujourd'hui, nous n'allons pas parler de RAML mais plutôt de Swagger. Ce framework se compose d'une spécification ainsi qu'un ensemble d'implémentations pour décrire, produire, consommer et visualiser des APIs RESTful. Même si l'adoption de RAML progresse, Swagger reste la solution la plus connue et répandue pour documenter vos APIs RESTful. Ce ne sont d'ailleurs pas les seuls solutions car il existe bien d'autres DSL d'APIs RESTful. Alors que RAML permet d'avoir une approche Top-Down (Contract-First), Swagger est initialement orienté Bottom-Up…
Lire d'avantage
Conception

RAML – bientôt en version 1.0

Le projet RAML vient d'annoncer la Release Candidate de la version La spécification RAML est disponible sur le site officiel. Si vous de connaissez pas encore RAML, il n'est pas encore trop tard. C'est un langage de description d'une API RESTful. Si Swagger est une des solutions la plus pertinente et la plus utilisée pour documenter une API existante, ce n'est pas le cas pour une nouvelle API. RAML a été créé pour combler ce manque et se place au…
Lire d'avantage
Développement

Guzzle – mocking HTTP en PHP

Aujourd'hui, nous allons parler des tests unitaires, mocks, client HTTP et PHP ! :-o Tests unitaires Les tests unitaires automatisés sont un outil essentiel pour garantir la stabilité d'un développement et accélérer les phases de correction, d'évolution ou refactoring. Cependant, pour qu'un test unitaire soit efficace, il doit s'assurer de respecter quelques recommandations (liste non-exhaustive) : être très rapide à exécuter : pour le lancer le plus souvent possible et avoir un feedback presque instantané être rejouable indéfiniment : pour…
Lire d'avantage

Spring MVC – support du CSV

S'il y a quelque chose que j'apprécie particulièrement dans Spring MVC, c'est bien la facilité et la rapidité à mettre en place des API REST. Par défaut, Spring MVC propose le support du XML, JSON, RSS, Atom et images. L'ajout du support d'un nouveau format est extrêmement simple. Pour cela, il suffi d'implémenter l'interface AbstractHttpMessageConverter. Voici ci-dessous l'implémentation pour le support des messages HTTP au format CSV : @Component public class CsvMessageConverter extends AbstractHttpMessageConverter<List<?>> { public static final MediaType MEDIA_TYPE…
Lire d'avantage