JUG Nantes - Telosys Tools - Avril 2014

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) @[email protected]

Benoit Wilcox (Commiter)@WilcoxBenoit

Ludovic Chaboud (Commiter) @ludovic_chaboud

Telosys Tools @telosys http://tools.telosys.org 2

@[email protected]

@[email protected]

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 »

MODELService

name

Port

name

0..n+port 0..nPort Type

nameBinding

name1

+binding

1

1

+type

1

Param

name

Output

Input

StartWithExtensions

BindingOperation

name

0..n+operation 0..n0..1 +input0..10..1+output 0..1

Operation

name0..1

+input

0..10..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

BindingFaultFault

name1

+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 simple Keep it simple Keep it simple Keep it simple and pragmaticand pragmaticand pragmaticand pragmatic


Plugin

Code Generator

Environnement de travail : Eclipse + plugin + templates

Model Editor

Workspace

Community templates

GitHub

downloadtemplates

installplugin


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 entitieswith 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 codegénéré non généré

Application

Code stéréotypé

& répétitif


� Estimer le gain de productivité

Démo1


AngularJSSpring 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éesrelationnelle

JPA

Spring

Data JPA

Spring

MVC

Web REST


Utilisateur


Présentation

Spring MVC

Service

JPA

Persistance

Spring

3 couches


Contrôleurs

Pages WebService DAO

Points de vigilance sur JPA (Java Persistence API)


Présentation

Spring MVC

Service

JPA

Persistance

Spring


Contrôleurs


Points de vigilance sur JPA (Java Persistence API)

• Concepts mal maîtrisés voir inconnus des développeu rs– 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


Persistance


Pages Web

Objets

d’affichageMapping 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 MVCfront-springmvc

Service

Présentation

Servicesservice-springdatajpa


Spring Data JPApersistence-springdatajpa

Database

Persistance

Database


Démo2


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 MVCfront-springmvc

Service

Présentation

AngularJSfront-angularjs

MVC Javascript

Service layer


Spring Data JPApersistence-springdatajpa

Database

Service

Persistance

Database

Service layerservice-springdatajpa


Démo2


RestfullSpring DataHATEOAS

3


Spring Data REST dans l'écosystème Spring

Spring Data REST

Spring MVCSpring Data

JPA

Spring Data

Neo4J

Spring Data

MongoDB

Spring Data Commons

Spring Data

Gemfire


Spring Data, un socle commun

Spring Data REST


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


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


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


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

BookRepositoryCrudRepository


Spring Data REST

Book@Entity


Spring Data REST@Controller, Dispatcher

Servlet…


Spring Data REST

Book@Entity


Spring Data REST@Controller, Dispatcher

Servlet…


API CRUD• GET

• POST

• PUT

• DELETE

Spring Data REST

Book@Entity


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





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




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 – theword, there's nopronounciation for. "


pronounciation for. "(Ben Hale, SpringOne2GX 2012)

HATEOAS ?

" HATEOAS – theword, there's nopronounciation for. "

(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 ?



SIREN


HATEOAS ?






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émo3


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 ?


JUG Nantes - Telosys Tools - Avril 2014

Software

Transcript of JUG Nantes - Telosys Tools - Avril 2014