playframeworkDémarrer avec playframework


Remarques

Cette section fournit une vue d'ensemble de ce qu'est playframework et pourquoi un développeur peut vouloir l'utiliser.

Il devrait également mentionner tous les sujets importants dans le cadre de jeu et établir un lien avec les sujets connexes. La documentation de playframework étant nouvelle, vous devrez peut-être créer des versions initiales de ces rubriques connexes.

Démarrer avec Play 2.4.x / 2.5.x - Windows, Java

Installations

Télécharger et installer:

  1. Java 8 - téléchargez l'installation appropriée à partir du site Oracle .

  2. Activator - téléchargez le fichier zip depuis www.playframework.com/download et extrayez les fichiers dans le dossier de lecture cible, par exemple pour:

    c:\Play-2.4.2\activator-dist-1.3.5
     
  3. sbt - télécharger à partir de www.scala-sbt.org .

Définir les variables d'environnement:

  1. JAVA_HOME , par exemple:

    c:\Program Files\Java\jdk1.8.0_45
     
  2. PLAY_HOME , par exemple:

    c:\Play-2.4.2\activator-dist-1.3.5;
     
  3. SBT_HOME par exemple:

    c:\Program Files (x86)\sbt\bin;  
     

Ajoutez le chemin d'accès aux trois programmes installés aux variables de chemin:

 %JAVA_HOME%\bin;%PLAY_HOME%;%SBT_HOME%;
 

Lecture du correctif d'installation 2.5

L'installation de Play 2.5.3 (la dernière version stable 2.5) est accompagnée d'un problème mineur. Réparer:

  1. Editez le fichier activator-dist-1.3.10 \ bin \ activator.bat et ajoutez le caractère "%" à ​​la fin de la ligne 55. La ligne correcte doit être la suivante: set SBT_HOME =% BIN_DIRECTORY%
  2. Créez le sous-répertoire conf sous le répertoire racine de l'activateur activator-dist-1.3.10 .
  3. Créez dans le répertoire conf un fichier vide nommé sbtconfig.txt .

Créer une nouvelle application avec CLI

Démarrez le cmd du répertoire où une nouvelle application doit être créée. Le moyen le plus court de créer une nouvelle application via l'interface de ligne de commande consiste à fournir un nom et un modèle d'application en tant qu'arguments CLI:

  activator new my-play-app play-java
 

Il est possible de courir juste:

  activator new
 

Dans ce cas, vous serez invité à sélectionner le modèle souhaité et un nom d'application.

Pour Play 2.4, ajoutez manuellement à project / plugins.sbt :

// Use the Play sbt plugin for Play projects
addSbtPlugin("com.typesafe.play" % "sbt-plugin" % "2.4.x")
 

Veillez à remplacer 2.4.x ici par la version exacte que vous souhaitez utiliser. Play 2.5 génère cette ligne automatiquement.

Assurez-vous que la version sbt appropriée est mentionnée dans project / build.properties. Il devrait correspondre à la version de sbt , installée sur votre machine. Par exemple, pour Play2.4.x, cela devrait être:

sbt.version=0.13.8
 

Ça y est, une nouvelle application peut maintenant être lancée:

  cd my-play-app
  activator run
 

Après un certain temps, le serveur démarrera et l'invite suivante devrait apparaître sur la console:

  [info] p.c.s.NettyServer - Listening for HTTP on /0:0:0:0:0:0:0:0:9000
  (Server started, use Ctrl+D to stop and go back to the console...)
 

Le serveur écoute par défaut sur le port 9000. Vous pouvez le demander à un navigateur via l'URL http: // localhost: 9000 . Vous obtiendrez quelque chose comme ceci:

entrer la description de l'image ici

Activateur en cours d'exécution sur un autre port

Par défaut, l'activateur exécute une application sur le port 9000 pour http ou 443 pour https. Pour exécuter une application sur un port différent (http):

activator "run 9005"
 

Installation via `sbt`

Si vous avez déjà installé sbt il est plus facile de créer un projet Play minimal sans activator . Voici comment.

# create a new folder
mkdir myNewProject
# launch sbt
sbt
 

Lorsque les étapes précédentes sont terminées, éditez build.sbt et ajoutez les lignes suivantes

name := """myProjectName"""

version := "1.0-SNAPSHOT"

offline := true

lazy val root = (project in file(".")).enablePlugins(PlayScala)
scalaVersion := "2.11.6"
# add required dependencies here .. below a list of dependencies I use
libraryDependencies ++= Seq(
  jdbc,
  cache,
  ws,
  filters,
  specs2 % Test,
  "com.github.nscala-time" %% "nscala-time" % "2.0.0",
  "javax.ws.rs" % "jsr311-api" % "1.0",
  "commons-io" % "commons-io" % "2.3",
  "org.asynchttpclient" % "async-http-client" % "2.0.4",
  cache
)


resolvers += "scalaz-bintray" at "http://dl.bintray.com/scalaz/releases"

resolvers ++= Seq("snapshots", "releases").map(Resolver.sonatypeRepo)

resolvers += "Typesafe Releases" at "http://repo.typesafe.com/typesafe/maven-releases/"
 

Enfin, créez un project dossier et créez un fichier build.properties avec la référence à la version de Play que vous souhaitez utiliser

 addSbtPlugin("com.typesafe.play" % "sbt-plugin" % "2.4.3")
 

C'est tout! Votre projet est prêt. Vous pouvez le lancer avec sbt . Depuis sbt vous avez accès aux mêmes commandes qu'avec activator .

Play 1 Installation

Conditions préalables

Pour exécuter l'infrastructure Play, vous avez besoin de Java 6 ou version ultérieure. Si vous souhaitez construire Play à partir de la source, vous aurez besoin du client de contrôle de source Git pour récupérer le code source et Ant pour le générer.

Assurez-vous d'avoir Java dans le chemin actuel (entrez java --version pour vérifier)

Play utilisera le Java par défaut ou celui disponible sur le chemin $ JAVA_HOME si défini.

L'utilitaire de ligne de commande de lecture utilise Python. Donc, tout système UNIX devrait être prêt à l'emploi (il faut au moins Python 2.5).

Installation à partir du paquet binaire

Instructions génériques

En général, les instructions d'installation sont les suivantes.

  1. Installez Java.
  2. Téléchargez le dernier package binaire Play et extrayez l'archive.
  3. Ajoutez la commande 'play' à votre chemin système et assurez-vous qu'il est exécutable.

Mac OS X

Java est intégré ou installé automatiquement, vous pouvez donc sauter la première étape.

  1. Téléchargez le dernier package binaire Play et extrayez-le dans /Applications .
  2. Éditez /etc/paths et ajoutez la ligne /Applications/play-1.2.5 (par exemple).

Une alternative à OS X est:

  1. Installer HomeBrew
  2. Exécuter le brew install play

Linux

Pour installer Java, assurez-vous d'utiliser Sun-JDK ou OpenJDK (et non gcj qui est la commande Java par défaut sur de nombreuses distributions Linux)

les fenêtres

Pour installer Java, téléchargez et installez le dernier package JDK. Vous n'avez pas besoin d'installer Python séparément, car un environnement d'exécution Python est fourni avec la structure.