/n3rd_stack_java

je voudrais un truc léger pour mes SPA (frontend) un backend java pour faire comme les grands, avec du noSQL

Primary LanguageJavaScript

#N3rd.stack:[java]

N3rd.stack:[java] est une "petite" stack java agnostique (Qui peut s’adapter aux composants avec lesquels il interagit. Wikipedia).

N3rd.stack:[java] vous apporte la structure nécessaire pour faire des web apps de type "Single Page Application" en vous apportant les composants nécessaires aussi bien côté serveur que côté client, notamment les éléments pour mettre en oeuvre des interfaces "RESTful JSON".

##C'est quoi une stack ?

Selon moi, (je parle de stack technique), c'est un ensemble de composants, frameworks, ... qui une fois assemblés permettent de réaliser des projets de développement, tels des sites, des applications web, mobiles, etc. ... La réalisation de la stack doit demander le moins de développement possible, on fait juste de l'assemblage, et le résultat doit être un outil simple à utiliser.

##Pourquoi une nième stack ?

Alors je fais ça à titre d'exercice, ça me permet d'apprendre pas mal de choses, mais aussi ça me sert dans mon travail de tous les jours. Je suis amené régulièrement à réaliser des POC (Proof Of Concept) et de temps en temps je n'ai pas besoin de me ré-installer tout un attirail serveur par exemple. D'aucun me diront, prend Play2!> ou Play1!>, c'est en général mon choix. Mais là j'avais envie de m'amuser.

##Qu'est-ce qu'il y a dedans ?

Alors comme l'indique son nom, c'est du java, avec (entre autre chose) les composants suivants :

  • la base de la stack est le framework Spark http://www.sparkjava.com/
  • la partie base de données est assurée par CouchDB, mais vous verrez que vous pouvez facilement utiliser n'importe quoi, N3rd.stack:[java] est "framework agnostic" ... ou presque
  • N3rd.stack:[java] peut aussi utiliser Groovy (expérimental)
  • et d'autres composants que vous pouvez découvrir en lisant les explications pour créer N3rd.stack:[java] "from scratch"
  • il y a même un "bout de code" venant de Play!>2 pour la partie JSON ;)

Il y a aussi du javascript avec :

  • AngularJS
  • ... et c'est tout ;)

N3rd.stack:[java] est dédiée Webapp de type "Single Page Application, c'est pour cela que je n'inclus pas de moteur de template (pour le moment), mais vous verrez que cela peut se faire facilement.

N3rd.stack:[java] est pensée pour être le plus simple possible si si, j'ai essayé

N3rd.stack:[java] est une "façon de faire", vous pouvez tout changer, même la base Spark

##Mes inspirations ?

  • PlayFramework
  • RESThub
  • Ratpack
  • Node.js
  • Express.js

##Mes objectifs

  • Je ne ferais rien de génial, je vais quasiment juste me contenter d'assembler des composants.
  • Cela doit être le plus simple possible (un débutant doit s'y retrouver)
  • J'ai prévu de m'en servir dans la vrai vie pour mes POCS

##Avertissements

  • Je n'ai pas la prétention d'être un développeur Java, donc ne prenez pas ça pour un modèle
  • Cependant, si cela vous apprend quelque chose, j'en serais très heureux
  • Pull request acceptées, surtout si elles sont simples, et améliorent le "design" du code & de l'architecture

Les explications pour créer N3rd.stack:[java] "from scratch" sont ici : n3rd_stack_java/tree/master/doc

Attention le répertoire doc n'est pas le mode d'emploi de N3rd.stack:[java], mais l'explication de sa "création". Il y aura cependant un chapitre dédié à uniquement son utilisation en l'état... mais plus tard

J'ai fais tout ça avec IntelliJ car il y avait une grosse promo de décembre, mais sinon, avec Netbeans c'est tout à fait faisable

Si vous downloadez le projet ici : https://github.com/k33g/n3rd_stack_java/archive/master.zip vous pouvez très bien l'ouvrir avec la version Community d'IntelliJ.

Il y aura peut-être N3rd.stack:[Node]

##Utilisation

###Lancement mode "standalone"

  • Dans le répertoire, lancer la commande mvn exec:java -Dexec.maClass="Main" puis ouvrez http://localhost:9000 (c'est la méthode main de la classe Main qui est exécutée)

###Lancement mode "Web Server"

autre possibilité :

  • Dans le répertoire, lancer la commande mvn jetty:run puis ouvrez http://localhost:8080 (c'est la méthode init de la classe Main qui est exécutée)