playframeworkAan de slag met playframework


Opmerkingen

Deze sectie geeft een overzicht van wat playframework is en waarom een ontwikkelaar het misschien wil gebruiken.

Het moet ook alle grote onderwerpen binnen het spelwerk vermelden en naar de gerelateerde onderwerpen verwijzen. Aangezien de documentatie voor speelwerk nieuw is, moet u mogelijk eerste versies van die gerelateerde onderwerpen maken.

Aan de slag met Play 2.4.x / 2.5.x - Windows, Java

installaties

Download en installeer:

  1. Java 8 - download de relevante installatie van de Oracle-site .

  2. Activator - download zip van www.playframework.com/download en pak bestanden uit in de doelmap Play, bijvoorbeeld om:

    c:\Play-2.4.2\activator-dist-1.3.5
     
  3. sbt - downloaden van www.scala-sbt.org .

Definieer omgevingsvariabelen:

  1. JAVA_HOME , bijvoorbeeld:

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

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

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

Voeg pad toe aan alle drie geïnstalleerde programma's aan de padvariabelen:

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

Play 2.5 installatie fix

Installatie van Play 2.5.3 (de laatste 2.5 stabiele release) heeft een klein probleem. Om het te repareren:

  1. Bewerk het bestand activator-dist-1.3.10 \ bin \ activator.bat en voeg het teken "%" toe aan het einde van regel 55. De juiste regel moet er zo uitzien : set SBT_HOME =% BIN_DIRECTORY%
  2. Maak een submap conf aan onder de activator root directory activator-dist-1.3.10 .
  3. Maak in de map conf een leeg bestand met de naam sbtconfig.txt .

Een nieuwe applicatie maken met CLI

Start de cmd vanuit de map, waar een nieuwe toepassing moet worden gemaakt. De kortste manier om een nieuwe applicatie via CLI te maken, is een applicatienaam en sjabloon als CLI-argumenten op te geven:

  activator new my-play-app play-java
 

Het is mogelijk om gewoon te rennen:

  activator new
 

In dit geval wordt u gevraagd om de gewenste sjabloon en de naam van een toepassing te selecteren.

Voor Play 2.4 handmatig toevoegen aan project / plugins.sbt :

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

Vervang hier 2.4.x door de exacte versie die u wilt gebruiken. Play 2.5 genereert deze lijn automatisch.

Zorg ervoor dat de juiste sbt- versie wordt vermeld in project / build.properties. Het moet overeenkomen met de sbt- versie, geïnstalleerd op uw machine. Voor Play2.4.x zou het bijvoorbeeld moeten zijn:

sbt.version=0.13.8
 

Dat is alles, er kan nu een nieuwe applicatie worden gestart:

  cd my-play-app
  activator run
 

Na een tijdje wordt de server gestart en verschijnt de volgende prompt op de 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...)
 

De server luistert standaard op poort 9000. U kunt deze bij een browser aanvragen via de URL http: // localhost: 9000 . Je krijgt zoiets als dit:

voer hier de afbeeldingsbeschrijving in

Activeringsprogramma op een andere poort uitvoeren

Standaard voert de activator een applicatie uit op poort 9000 voor http of 443 voor https. Een toepassing uitvoeren op de andere poort (http):

activator "run 9005"
 

Installeren via `sbt`

Als je sbt al hebt geïnstalleerd, vind ik het eenvoudiger om een minimaal Play-project te maken zonder activator . Hier is hoe.

# create a new folder
mkdir myNewProject
# launch sbt
sbt
 

Wanneer vorige stappen zijn voltooid, bewerkt u build.sbt en voegt u de volgende regels toe

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/"
 

Tenslotte maakt u een map project en in een bestand build.properties met de verwijzing naar de versie van Play u gebruik wenst te maken

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

Dat is het! Uw project is klaar. U kunt het starten met sbt . Vanuit sbt hebt u toegang tot dezelfde opdrachten als bij activator .

Speel 1 installatie

voorwaarden

Om het Play-framework uit te voeren, hebt u Java 6 of hoger nodig. Als je Play vanaf de bron wilt bouwen, heb je de Git source control-client nodig om de broncode op te halen en Ant om deze te bouwen.

Zorg ervoor dat Java in het huidige pad staat (voer java --version om dit te controleren)

Play gebruikt de standaard Java of degene die beschikbaar is op het $ JAVA_HOME pad, indien gedefinieerd.

Het opdrachtregelprogramma Play gebruikt Python. Het zou dus meteen moeten werken op elk UNIX-systeem (het vereist echter minstens Python 2.5).

Installatie vanuit het binaire pakket

Algemene instructies

Over het algemeen zijn de installatie-instructies als volgt.

  1. Installeer Java.
  2. Download het nieuwste binaire pakket Play en pak het archief uit.
  3. Voeg de opdracht 'play' toe aan uw systeempad en zorg ervoor dat het uitvoerbaar is.

Mac OS X

Java is ingebouwd of automatisch geïnstalleerd, zodat u de eerste stap kunt overslaan.

  1. Download het nieuwste binaire Play-pakket en pak het uit in /Applications .
  2. Bewerk /etc/paths en voeg de regel /Applications/play-1.2.5 (bijvoorbeeld).

Een alternatief op OS X is:

  1. HomeBrew installeren
  2. Voer brew install play

Linux

Als u Java wilt installeren, moet u Sun-JDK of OpenJDK gebruiken (en niet gcj, de standaard Java-opdracht op veel Linux-distributies)

ramen

Download en installeer het nieuwste JDK-pakket om Java te installeren. U hoeft Python niet afzonderlijk te installeren, omdat een Python-runtime wordt meegeleverd met het framework.