Free Chapter
Jakarta Servlet 4.0 is one the of biggest APIs of Jakarta EE 8. Since the very beginning of the Java EE platform (the old J2EE), the Servlet specification has always played a key role.
The coolest additions of this version are surely HTTP/2.0 and Server Push. Both of them bring performance improvements to your application.
This recipe will use Server Push to do one of the most basic tasks on a web page—load an image.
Let's add the dependencies that we need:
<dependency>
<groupId>jakarta.platform</groupId>
<artifactId>jakarta.jakartaee-api</artifactId>
<version>8.0.0</version>
</dependency>
You need to perform the following steps to try this recipe:
@WebServlet(name = "ServerPush", urlPatterns = {"/ServerPush"})
public class ServerPush extends HttpServlet {
@Override
protected void doGet(HttpServletRequest request,
HttpServletResponse
response) throws ServletException, IOException {
PushBuilder pb = request.newPushBuilder();
if (pb != null) {
pb.path("images/javaee-logo.png")
.addHeader("content-type", "image/png")
.push();
}
try (PrintWriter writer = response.getWriter();) {
StringBuilder html = new StringBuilder();
html.append("<html>");
html.append("<center>");
html.append("<img src='images/javaee-logo.png'><br>");
html.append("<h2>Image pushed by ServerPush</h2>");
html.append("</center>");
html.append("</html>");
writer.write(html.toString());
}
}
}
https://localhost:8181/ch01-servlet/ServerPush
Let's now see how this works.
We use the PushBuilder object to send an image to the client before it is requested by the img src tag. In other words, the browser doesn't need to do another request (what it usually does with img src) to have an image available for rendering.
It might seem as if it doesn't make too much difference for a single image, but it would with dozens, hundreds, or thousands of images. There's less traffic for your client and from your server. That's better performance for all!
If you are using JSF, you can get the benefits from Server Push for free! You don't even need to rewrite a single line of your code, as JSF relies on the Server Push specification.
Just make sure that you run it under the HTTPS protocol, as HTTP/2.0 only works under it.