Telosys tools jug-nantes-2014-v1.2

Development
accelerator
... ou comment faire
un « départ lancé »un « départ lancé »
JUG Nantes
14 avril 2014
Ver 1.2

Qui sommes nous ?
Laurent Guérin (Project Leader)
@ltguerin
laurent.guerin@sogeti.com
Benoit Wilcox (Commiter)
@WilcoxBenoit
Ludovic Chaboud (Commiter)
@ludovic_chaboud
Telosys Tools @telosys http://tools.telosys.org 2
@WilcoxBenoit
benoit.wilcox@sogeti.com
@ludovic_chaboud
ludovic.chaboud@sogeti.com
Telosys Team
http://labs.sogeti.com/

Un parcours en 3 étapes

Principes
Généraux
1

La juste part du développeur
Application
Framework 1 Framework 2
Code stéréotypé
& répétitif
Développeur Générateur
Plate-forme ( ie Java EE )
Comment réduire le volume de code à réaliser ?
Frameworks & « boilerplate » réduction du code technique
(code générique, « factorisable »)
Mais il reste toujours une partie du code qui est spécifique et
répétitive (et sans valeur ajoutée)
La génération de code permet d’automatiser cette partie

• Model Driven Architecture (cf OMG)
• Approche « Model First »
=> concevoir et maintenir un modèle
(UML, DSL, …)
Génération de code - Approche « MDA »
MODEL
Service
name
Port
name
0..n+port 0..n
Port Type
name
Binding
name
1
+binding
1
1
+type
1
Param
name
Output
Input
StartWithExtensions
BindingOperation
name
0..n+operation 0..n
0..1 +input0..1
0..1+output 0..1
Operation
name
0..1
+input
0..1
0..10..1
0..n+operation 0..n
11
X M I
( XML )
Code
Part
name
Message
name
0..n+part 0..n
1+message 1
Output
BindingFault
Fault
name
1
+message
11
name
0..n
name
0..1
+output
0..1
0..n+fault 0..n
11
1
+fault 0..n
Template TOOL
Processus lourd, ne permet pas un démarrage rapide

• Littéralement « échafaudage »
• Définition Wikipedia : (incomplète)
• Largement utilisé dans certains écosystèmes
Génération de code - Approche « Scaffolding »
Scaffolding is a meta-programming
method of building database-backed
software applications.
• Largement utilisé dans certains écosystèmes
– Ruby ( RoR - Ruby On Rails )
– Groovy ( Grails – Groovy on Rails )
• Et pour Java?
– Spring ROO (Boite noire, lié à Spring, AspectJ )
– DALI / Eclipse (JPA mapping only)
– AppFuse (command line + web)

• Approche « Database First »
• Efficace (permet un démarrage rapide)
• Outil de type « boite noire », généralement non adaptable
Génération de code - Approche « Scaffolding »
Database
TOOL
Code
Metadata
Pas de templates :
- Comment personnaliser la génération de code ?
Pas de modèle :
- Comment ajouter des informations (en + des méta-data) ?
- Comment modifier (durablement) les méta-data ?
noms/types des attributs Java,
règles de validation (min, max, regexp, …),
représentation des Booléens (1/0, "T"/"F", … ), etc

Telosys Tools: une nouvelle approche
« Database first » scaffolding avec un modèle léger et des templates
ADAPTABLE

Philosophie
Keep it simpleKeep it simpleKeep it simpleKeep it simple
and pragmaticand pragmaticand pragmaticand pragmatic

Plugin
Code Generator
Environnement de travail : Eclipse + plugin + templates
Model Editor
Workspace
Community templates
GitHub
download
templates
install
plugin
Code GeneratorModel Editor
Template Editor
Database Editor
Model Generator

Que peut-on générer ?
Tout fichier de type « texte » :
Java, XML, JSP, PHP, Scala, JavaScript, HTML, etc…
Principe :
1 entity N templates N targets
1 bean
N entities 1 template 1 target
model
(all entities
with links)
1 controller
1 web page
1 list

Ça ressemble à quoi un template ?
http://velocity.apache.org/
Objets du model
« entities »
Velocity Template Language (VTL)
• Références aux objets : $, ${…}
• Directives : #set, #if, #foreach, …
• Commentaire : ## #* .. *#
Objets de
l’environnement

Ce n’est pas magique
Ne pas chercher
à tout générer
(il faut savoir s’arrêter)
code code
généré non généré
Application
Code stéréotypé
& répétitif
Estimer le gain
de productivité

Démo
1

AngularJS
Spring MVC – JPA
2

• Fonctionnalités de CRUD :
– Création, Recherche, Modification, Suppression d’entités
• Internationalisation (i18n) :
– Libellés français / anglais
– Gestion des dates
Fonctionnalités

Architecture générale
Tomcat Server
Webapp
Spring MVC + JPA
bookstore-
spring
2 Projets
Base
de données
relationnelle
Spring MVC + JPA
Webapp
AngularJS
spring
bookstore-
angularjs

Application 1 :
Spring MVC
+
Spring MVC + AngularJS
+
Spring Data JPA

Application 1
Spring MVC + Spring Data JPA
Base de données
relationnelle
JPA
Spring
Data JPA
Spring
MVC
Web REST
Utilisateur

Présentation
Spring MVC
Service
JPA
Persistance
Spring
3 couches
Contrôleurs
Pages Web
Service DAO

Points de vigilance sur JPA (Java Persistence API)
Présentation
Spring MVC
Service
JPA
Persistance
Spring
Contrôleurs
Pages Web
Service DAO

Points de vigilance sur JPA (Java Persistence API)
• Concepts mal maîtrisés voir inconnus des développeurs
– Session Hibernate / Entity Manager :
• Objets « attachés » et « détachés »
• Mise à jour différée de la base de données
– Règles de persistance des liens entre les objets
• Notion « owning side » et « inverse side »
• Notion « owning side » et « inverse side »
• Problème de performances
– Chargement à la volée :
• problème du « N+1 requêtes »
• Erreurs techniques si l’objet est « détaché »
• Comportements masqués et objets « pollués »
– Chargement à la volée :
• Utilisation d’objets « proxy » et de collections « proxy »

Notre solution :
Isoler JPA dans la couche de persistance
Présentation Service
JPA
Contrôleurs
Pages Web
Service DAO
Persistance
Pages Web
Objets
d’affichage
Mapping Entités JPA
Transactions

Partie générée par Telosys :
« Controller »
BookController
« Service »
BookService
« DAO »
BookJpaRepository
Base de
données
relationnelle« Controller »
BookRestController
BookController
Utilisateur
REST
Pages
GET, POST,
PUT, DELETE
BookRestController
Web

Aspects techniques
• Web : Twitter bootstrap 3, Tiles
• RESTful : GET, POST, PUT, DELETE
• Tests unitaires : Couverture de 90%
• Analyse SONAR : Rules compliance : 91%

Organisation et dépendances des bundles
Spring MVC
front-springmvc
Service
Présentation
Services
service-springdatajpa
Spring Data JPA
persistence-springdatajpa
Database
Persistance
Database

Démo
2

Application 2 :
AngularJS
AngularJS + Spring MVC REST
AngularJS

• Fonctionnalités de CRUD :
– Création, Recherche, Modification, Suppression d’entités
• Internationalisation (i18n) :
– Libellés français / anglais
– Gestion des dates
Fonctionnalités

Application 1
Base de
données
relationnelle
JPA
Spring
Data JPA
Spring
MVC
REST
Application 2
relationnelle
AngularJS
Utilisateur
Web

URLs des services REST
• Récupérer la liste des entités :
– GET : /rest/[entity]
• Récupérer une entité :
– GET : /rest/[entity]/[id]
• Créer une entité :
– POST : /rest/[entity]
– POST : /rest/[entity]
• Modifier une entité :
– PUT : /rest/[entity]/[id]
• Supprimer une entité :
– DELETE : /rest/[entity]/[id]

Partie générée par Telosys :
« Controller »
BookCtrl
_____________________________________________
load
loadAll
save
delete
_____________________________________________
$scope.book
REST
« Service »
Book
______________________________________
get
getAll
create
update
delete GET,
$scope.book
$scope.books
delete
Page de modification
book_form.html
Page de recherche
book_list.html
GET,
POST,
PUT,
DELETE
Utilisateur
Web

Aspects techniques
• Basé sur le projet de démarrage « Seed »
de Angular :
– https://github.com/angular/angular-seed
• Gestion de l’internationalisation (i18n) :
• Gestion de l’internationalisation (i18n) :
– https://github.com/angular-translate/angular-translate
• Intégration de Twitter bootstrap 3 avec AngularStrap :
– http://mgcrea.github.io/angular-strap

Organisation et dépendances des bundles
Spring MVC
front-springmvc
Service
Présentation
AngularJS
front-angularjs
MVC Javascript
Service layer
Spring Data JPA
persistence-springdatajpa
Database
Service
Persistance
Database
Service layer
service-springdatajpa

Démo
2

Restfull
Spring Data
HATEOAS
3

Spring Data REST dans l'écosystème Spring
Spring Data REST
Spring MVC
Spring Data
JPA
Spring Data
Neo4J
Spring Data
MongoDB
Spring Data Commons
Spring Data
Gemfire

Spring Data, un socle commun
Spring Data REST
Spring MVC
Spring Data
JPA
Spring Data
Neo4J
Spring Data
MongoDB
Spring Data Commons
Spring Data
Gemfire
Spring Data Commons
• Couche d'abstraction partagée par les différents projets
•Ex : Repository, Génération dynamique des requêtes à
partir des nom de méthodes, audit …

Spring Data : Différents fournisseurs de données
• API de manipulation d'une source de données spécifiques
Spring Data REST
Spring MVC
Spring Data
JPA
Spring Data
Neo4J
Spring Data
MongoDB
Spring Data Commons
Spring Data
Gemfire
• API de manipulation d'une source de données spécifiques
• Implémentation implicite des opérations les plus courantes (CRUD)
• Plusieurs fournisseurs de données :
• JPA, MongoDB, Neo4J, Gemfire, Redis, Hadoop, SolR, Couchbase, elasticsearch,
cassandra et dynamoDB
• Supportés par Spring Data REST :
• JPA, MongoDB, Neo4J et Gemfire (cache distribué, VMWare)

Spring Data REST
Spring Data REST
Spring MVC
Spring Data
JPA
Spring Data
Neo4J
Spring Data
MongoDB
Spring Data Commons
Spring Data
Gemfire
Spring Data REST
• S'appui sur Spring MVC pour l'exposition de services.
• Les services exposés sont RESTful, approche HATEAOS
• S'appui sur les interfaces Repository pour la génération des services
CRUD et de l'API /search

Spring Data REST
Spring Data REST
Spring MVC
Spring Data
JPA
Spring Data
Neo4J
Spring Data
MongoDB
Spring Data Commons
Spring Data
Gemfire
Stack de l'application générée
• Spring Data REST 2.0.1.RELEASE
• Spring Data JPA 1.5.1.RELEASE
• Hibernate 4.2

Spring Data REST
Book
@Entity

Spring Data REST
Book
@Entity
BookRepository
CrudRepository

Spring Data REST
Book
@Entity
BookRepository
CrudRepository
Spring Data REST
@Controller, Dispatcher
Servlet…

Spring Data REST
Book
@Entity
BookRepository
CrudRepository
Spring Data REST
@Controller, Dispatcher
Servlet…
API CRUD
• GET
• POST
• PUT
• DELETE

Spring Data REST
Book
@Entity
BookRepository
CrudRepository
Spring Data REST
@Controller,
ServletDispatcher …
API CRUD
• GET
• POST
• PUT
• DELETE
API Search
/search
Toutes les méthodes
définies dans l'interface
BookRepository.

Spring Data REST
Book
@Entity
BookRepository
CrudRepository
Spring Data REST
@Controller,
API CRUD
• GET
• POST
• PUT
• DELETE
API Search
/search
BookRepository.
Json Schema
/schema
Description des
propriétés de l'entité.

Spring Data REST
Book
@Entity
BookRepository
CrudRepository
Spring Data REST
@Controller,
Partie générée par
Telosys Tools
• Entités
• Repositories
• "FindBy" pour Many-To-One
• Validators
• Configuration de l'application
API CRUD
• GET
• POST
• PUT
• PATCH
• DELETE
API Search
/search
BookRepository.
Json Schema
/schema
Description des
propriétés de l'entité.

HATEOAS ?
" HATEOAS – the
word, there's no
pronounciation for. "
(Ben Hale, SpringOne2GX 2012)

HATEOAS ?
" HATEOAS – the
word, there's no
(Ben Hale, SpringOne2GX 2012)
Hypermedia As The Engine Of Application State

HATEOAS ?
Model of RESTful maturity by L.Richardson

HATEOAS ?
Un format ? Un standard ?

HATEOAS ?
Collection+JSON – Hypermedia Type
HAL – Hypertext Application Language
Json-LD : JSON for Linking Data
W3C depuis 16/01/2014
SIREN
JSON Schema & JSON Hyper-Schema

HATEOAS ?
Un format ?
Un standard ?
W3C depuis 16/01/2014
SIREN

HATEOAS ?
W3C depuis 16/01/2014
SIREN

HAL : Hypertext Application Language

HAL : Hypertext Application Language : Example
{
"isbn": "2-212-12232-2",
"title": "Programmer en Java",
"price": 35,
"quantity": 23,
"discount": false,
"availability": true,
"bestSeller": true,
"_links": {
"_links": {
"self": {"href": "http://localhost:8080/bookstore-rest/books/1" },
"author": {"href": "http://localhost:8080/bookstore-rest/books/1/author"},
"page_extract": {
"href": "http://localhost:8080/bookstore-rest/books/1/author/extract{?page}",
"templated" : true
}
}
}

HAL : Hypertext Application Language : Example
{
"isbn": "2-212-12232-2",
"title": "Programmer en Java",
"price": 35,
"quantity": 23,
"discount": false,
"availability": true,
"bestSeller": true,
"_links": {
"_links": {
"self": {"href": "http://localhost:8080/bookstore-rest/books/1" },
"author": {"href": "http://localhost:8080/bookstore-rest/books/1/author"},
"page_extract": {
"href": "http://localhost:8080/bookstore-rest/books/1/author/extract{?page}",
"templated" : true
}
}
}
Liens,
actions

HAL : Hypertext Application Language
• Pour implémenter ou consommer des services "HAL" …

Démo
3

Arrivée
4

Et maintenant
à vous de jouer !
Vous pouvez…
Vous pouvez…
- Tester
- Créer vos templates
- Contribuer
- Supporter

Ressources en ligne
Tutorials : https://sites.google.com/site/telosystutorial/
Templates : https://github.com/telosys-tools
Templates : https://github.com/telosys-tools
Code généré : https://github.com/telosys-tools-demo
Applications déployées :
- http://bookstore-spring.telosys-tools-demo.cloudbees.net/
- http://bookstore-angularjs.telosys-tools-demo.cloudbees.net/

Roadmap
2014
Plugin :
- Modèle sans base de données ( DSL )
- Amélioration de l’IHM du plugin ( links, customization )
Nouveaux templates bundles :
- Spring JDBC
- Struts 2 (?)
- PHP / CodeIgniter (?)
- PHP / CodeIgniter (?)
2015
Telosys Tools Studio
(outil autonome / socle Eclipse )

Sondage / roadmap
Quels templates voudriez-vous ?
( pour quelles cibles de génération ) :
• Struts
• JSF
• Wicket
• Scala
• PHP
• autre…
• autre…
Gradle est-il une priorité ?
Un outil 100% en ligne de commande ?
Un outil 100% web (SaaS / cloud) ?
Vous pouvez répondre avec Twitter @telosys

Vous avez des questions ?

Telosys tools jug-nantes-2014-v1.2

Recommandé

Recommandé

Contenu connexe

Tendances

Tendances (19)

En vedette

En vedette (20)

Similaire à Telosys tools jug-nantes-2014-v1.2

Similaire à Telosys tools jug-nantes-2014-v1.2 (20)

Plus de Laurent Guérin

Plus de Laurent Guérin (12)

Telosys tools jug-nantes-2014-v1.2