You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: app/views/blog/graal.scala.html
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -23,7 +23,7 @@ <h1>@title</h1>
23
23
<p>There is also another edition called the Enterprise Edition which is not open source and you need to acquire a license to use it in production, but according to the docs it’s safe to use for development and evaluation. The Enterprise Edition is currently available for macOS and Linux, it has further benefits (comes with a smaller footprint and has more sandbox capabilities).</p>
24
24
<p>In the future the Graal team will probably present us with more options regarding the operating system. For our blog post we stick to the Community Edition on Linux.</p>
25
25
<h3id="play-production-mode">Play Production Mode</h3>
26
-
<p>Running Play or any Scala application on Graal is probably as easy as just switching to another Java VM. We will build the <ahref="https://example.lightbend.com/v1/download/play-scala-starter-example">Play example project</a>, via <ahref="https://www.playframework.com/documentation/2.6.x/Deploying#Using-the-SBT-assembly-plugin">sbt-assembly</a> and copy the production JAR to a regular server.</p>
26
+
<p>Running Play or any Scala application on Graal is probably as easy as just switching to another Java VM. We will build the <ahref="https://github.com/playframework/play-samples/tree/HEAD/play-scala-starter-example">Play example project</a>, via <ahref="https://www.playframework.com/documentation/2.6.x/Deploying#Using-the-SBT-assembly-plugin">sbt-assembly</a> and copy the production JAR to a regular server.</p>
27
27
<p>After downloading Graal and unpacking it, one can just run the application via <code>$GRAAL_HOME/bin/java -Xms3G -Xmx3G -XX:+UseG1GC -jar play-scala-starter-example-assembly-1.0-SNAPSHOT.jar</code>. Keep in mind for a production run, one would use a service manager or run the application inside an orchestration system like Kubernetes.</p>
28
28
<p>The Play application started without any problem and one could use <code>curl</code> to ensure it is running via <code>curl http://graalserver:9000/</code> and it will print the Play “hello world page”.</p>
29
29
<h2id="-performance-of-graal">“Performance” of Graal</h2>
Play uses <ahref="//opencollective.com/playframework">Open Collective</a> to collect donations from sponsors. These funds are used to pay contributors and cover project costs, openly and transparently.
26
26
Individuals and companies alike can support Play financially by <ahref="@routes.Application.sponsors">becoming backers or premium sponsors</a>.
@@ -30,58 +38,82 @@ <h3><span>»</span> Learn whether Play Framework is right for your project<
30
38
</div>
31
39
</div>
32
40
<divclass="try-option">
33
-
<h3><span>»</span> Try the Hello World Tutorial</h3>
41
+
<h3><span>»</span> Try a Hello World Tutorial</h3>
34
42
<divclass="try-option-content">
35
-
<p>The Java and Scala Hello World projects are self-contained tutorials that include a distribution of the sbt build tool.</p>
36
-
<p>Play requires Java 8 or higher. Check your version with the <code>java -version</code> command and if needed, install it from <ahref="https://adoptium.net/" rel="noopener">Adoptium</a>.</p>
37
-
<p>To try the tutorial, first download the Java or Scala project:</p>
38
-
<table>
43
+
<p>The Play Java and Play Scala "Hello World" projects are self-contained tutorials that are part of the <ahref="https://github.com/playframework/play-samples">play-samples repository</a>. To try a tutorial, you can either clone the repository and check out the respective branch or download its contents as a zip file:</p>
44
+
<table>
39
45
@examples.sections.map { case (version, section) =>
40
46
<tbody>
41
-
<tr><th><h4>Play @version Hello World Projects</h4></th></tr>
47
+
<tr><thcolspan="3"><h4>Play @version Hello World Projects (Built on @{renderBaseTech(version)})</h4></th></tr>
<li>Unzip the project in a convenient location.</li>
54
-
<li>In a command window, change to the top-level project directory.</li>
57
+
<blockquote>
58
+
<p>
59
+
Besides replacing Akka with Pekko, Play 3.0 is identical to Play 2.9. If you don't know what Akka or Pekko is, we recommend using Play 3.0. For more details on which version to use, read <ahref="@reverseRouter.latest(None, "General#How-Play-Deals-with-Akkas-License-Change")" target="_blank">"How Play Deals with Akka’s License Change"</a>.
60
+
</p>
61
+
</blockquote>
62
+
<p>To run a tutorial follow the <code>README</code> file instructions in the respective folder. In short:</p>
63
+
<ol>
64
+
<li>Please check <ahref="@reverseRouter.latest(None, "Requirements")" target="_blank">the requirements for using Play</a>: Java and sbt needs to be installed.</li>
65
+
<li>Clone or unzip the repo in a convenient location.</li>
66
+
<li>In a command window, change to the project directory of the desired tutorial.</li>
55
67
<li>Enter <code>sbt run</code>.</li>
56
68
<li>After the message <code>Server started, ...</code> displays, enter the following URL in a browser: <ahref="http://localhost:9000">http://localhost:9000</a></li>
69
+
<li>The tutorial welcome page displays.</li>
57
70
</ol>
58
-
<p>The tutorial welcome page displays.</p>
59
71
</div>
60
72
</div>
61
73
</div>
62
74
63
75
<divclass="try-section">
64
76
<h2>Already know a bit about Play?</h2>
65
-
<p>There are a variety of <ahref="https://github.com/playframework/play-samples">Play example projects for Java and Scala</a> that are focused on a particular use case. These include everything you need, including <ahref="//www.scala-sbt.org/index.html">sbt</a>, Play Framework, and an HTTP server. The examples also support <ahref="//gradle.github.io/playframework/">Gradle</a>.</p>
66
-
<p>If you are ready to start your own project and have sbt installed, you can create a Play project from the command line.</p>
77
+
<p>There are a variety of <ahref="https://github.com/playframework/play-samples">Play example projects for Java and Scala</a> that focus on specific use cases. To run these sample projects, please check <ahref="@reverseRouter.latest(None, "Requirements")" target="_blank">the requirements for using Play</a>: Java and sbt needs to be installed.</p>
78
+
<p>If you are ready to start your own project and have sbt and Java installed, you can create a Play project from the command line.</p>
67
79
68
80
<divclass="try-option">
69
-
<h3><span>»</span> Create a Play Java or Scala project using <code>sbt new</code></h3>
81
+
<h3><span>»</span> Create a new Play Java or Scala project using <code>sbt new</code></h3>
70
82
<divclass="try-option-content">
71
-
<p>In a command window, enter one of the following and respond to the prompts to create a new project:</p>
72
-
73
-
<h4>Java seed template</h4>
74
-
<pre>sbt new playframework/play-java-seed.g8</pre>
75
-
76
-
<h4>Scala seed template</h4>
77
-
<pre>sbt new playframework/play-scala-seed.g8</pre>
78
-
79
-
<p>After the template creates the project:</p>
83
+
<p>In a command window, enter the following:</p>
84
+
<pre>sbt new</pre>
85
+
<p>
86
+
In the interactive menu choose:
87
+
<ul>
88
+
<li><code>playframework/play-scala-seed.g8</code> for a Play Scala project</li>
89
+
<li><code>playframework/play-java-seed.g8</code> for a Play Java project</li>
90
+
</ul>
91
+
</p>
92
+
<p>
93
+
Then respond to the prompts. After the project got created:</p>
80
94
<ol>
81
95
<li>Change into the top level project directory.</li>
82
96
<li>Enter <code>sbt run</code> to download dependencies and start the system.</li>
83
97
<li>In a browser, enter <ahref="http://localhost:9000">http://localhost:9000</a> to view the welcome page.</li>
84
98
</ol>
99
+
100
+
<h4>Using the Java seed template directly instead</h4>
101
+
<p>Enter:</p>
102
+
<pre>sbt new playframework/play-java-seed.g8</pre>
103
+
To create a Play Java 2.9 project:
104
+
<pre>sbt new playframework/play-java-seed.g8 --branch 2.9.x</pre>
105
+
106
+
<h4>Using the Scala seed template directly instead</h4>
107
+
<p>Enter:</p>
108
+
<pre>sbt new playframework/play-scala-seed.g8</pre>
109
+
To create a Play Scala 2.9 project:
110
+
<pre>sbt new playframework/play-scala-seed.g8 --branch 2.9.x</pre>
111
+
112
+
<blockquote>
113
+
<p>
114
+
Besides replacing Akka with Pekko, Play 3.0 is identical to Play 2.9. If you don't know what Akka or Pekko is, we recommend using Play 3.0. For more details on which version to use, read <ahref="@reverseRouter.latest(None, "General#How-Play-Deals-with-Akkas-License-Change")" target="_blank">"How Play Deals with Akka’s License Change"</a>.
Copy file name to clipboardExpand all lines: app/views/index.scala.html
+4-4Lines changed: 4 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -54,7 +54,7 @@ <h1>Play Framework makes it easy to build web applications with Java & Scala
54
54
Play is based on a lightweight, stateless, web-friendly architecture.
55
55
</p>
56
56
<p>
57
-
Built on Akka, Play provides predictable and minimal resource consumption (CPU, memory, threads) for highly-scalable applications.
57
+
Built on Pekko (Play 3) and Akka (Play 2), Play provides predictable and minimal resource consumption (CPU, memory, threads) for highly-scalable applications.
58
58
</p>
59
59
</article>
60
60
<articleclass="feature developer">
@@ -91,12 +91,12 @@ <h6>Play instances usage</h6>
91
91
</div>
92
92
<h2>Scale predictably.</h2>
93
93
<p>
94
-
Underneath the covers Play uses a fully asynchronous model built on top of Akka. Combined with being stateless, Play scales simply and predictably.
94
+
Underneath the covers Play uses a fully asynchronous model built on top of Pekko (Play 3) and Akka (Play 2). Combined with being stateless, Play scales simply and predictably.
95
95
</p>
96
96
<ul>
97
97
<li>Stateless Web Tier</li>
98
98
<li>Non-blocking I/O</li>
99
-
<li>Built on Akka</li>
99
+
<li>Built on Pekko (Play 3) and Akka (Play 2)</li>
Copy file name to clipboardExpand all lines: app/views/sponsors.scala.html
+1-2Lines changed: 1 addition & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ <h1>@title</h1>
11
11
<article>
12
12
<h1>Why sponsor Play?</h1>
13
13
<p>
14
-
At the end of 2021 <ahref="//www.lightbend.com/">Lightbend</a>, the company that sponsored and lead the development of the Play Framework for almost a decade, <ahref="//discuss.lightbend.com/t/on-the-future-of-play-framework/8920">handed over the project to the community</a>.
14
+
At the end of 2021 <ahref="//www.lightbend.com/">Lightbend</a>, the company that sponsored and lead the development of the Play Framework for almost a decade, <ahref="//web.archive.org/web/20221219111211/https://discuss.lightbend.com/t/on-the-future-of-play-framework/8920">handed over the project to the community</a>.
15
15
Since then the Play Framework uses <ahref="//opencollective.com/playframework">Open Collective</a> to gather money to pay contributors and to cover other project expenses in <ahref="//opencollective.com/how-it-works">the most transparent way possible</a>.
0 commit comments