Preface

This section is currently a draft, and is subject to change.

Legal

This documentation and the accompanying materials are made available under the terms of the Eclipse Public License v. 2.0,which is available athttps://www.eclipse.org/legal/epl-2.0.

SPDX-License-Identifier: EPL-2.0

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

About this Tutorial

This tutorial explains how to use the features of the Jakarta EE Platform to build cloud-native applications,such as microservices, "right sized" services, and server-based web applications.

Prerequisites

Jakarta EE applications use the Java Platform, and are usually written in the Java programming language.All the examples in this tutorial are written in Java.If you’re new to Java, spend some time getting up to speed on the language and platform;a good place to start isdev.java/learn.

Each topic in this tutorial provides some background information,but in general,we assume you have a basic understanding of the technologies each Jakarta EE feature works with.For example, in the Jakarta Persistence chapter,we assume you have a basic understanding of relational databases.

Conventions

Throughout this tutorial, we use the following typographic conventions:

Convention Meaning Example

Convention	Meaning	Example
Boldface	Boldface type indicates a term defined in text or graphical user interface elements associated with an action.	Acache is a copy stored locally. From theFile menu, chooseOpen Project.
`Monospace`	Monospace type indicates the names of files and directories, commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.	Edit your`.login` file. Use`ls -a` to list all files. `machine_name% you have mail.`
Italic	Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.	Read Chapter 6 in theUser’s Guide. Donot save the file. The command to remove a file is`rmfilename`.

Boldface

Boldface type indicates a term defined in text or graphical user interface elements associated with an action.

Acache is a copy stored locally.

From theFile menu, chooseOpen Project.

Monospace

Monospace type indicates the names of files and directories, commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

Edit your.login file.

Usels -a to list all files.

machine_name% you have mail.

Italic

Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.

Read Chapter 6 in theUser’s Guide.

Donot save the file.

The command to remove a file isrmfilename.

Default Paths and File Names

We are working on a fresh, updated Jakarta EE Tutorial. This section hasn’t yet been updated.

The following table describes the default paths and file names that areused in this book.

Placeholder	Description	Default Value
`as-install`	Represents the base installation directory for GlassFish Server.	Installations on the Linux, UNIX, or macOS: `user’s-home-directory/glassfish6/glassfish` Windows, all installations: `SystemDrive:\glassfish6\glassfish`
`as-install-parent`	Represents the parent of the base installation directory for GlassFish Server.	Installations on UNIX/Linux/macOS: `user’s-home-directory/glassfish6` Windows: `SystemDrive:\glassfish6`
`jakartaee-examples`	Represents the base installation directory for the Jakarta EE Tutorial examples project after you download or clone it.	`user’s-home-directory/jakartaee-examples`
`domain-dir`	Represents the directory in which a domain’s configuration is stored.	`as-install/domains/domain1`

Movatterモバイル変換