原文：http://docs.oracle.com/javaee/7/tutorial/doc/preface.htm
翻译：石卓林 shizhuolin@hotmail.com
Preface
This tutorial is a guide to developing enterprise applications for the Java Platform, Enterprise Edition 7 (Java EE 7) using GlassFish Server Open Source Edition.
Oracle GlassFish Server, a Java EE compatible application server, is based on GlassFish Server Open Source Edition, the leading open-source and open-community platform for building and deploying next-generation applications and services. GlassFish Server Open Source Edition, developed by the GlassFish project open-source community at https://glassfish.java.net/, is the first compatible implementation of the Java EE 7 platform specification. This lightweight, flexible, and open-source application server enables organizations not only to leverage the new capabilities introduced within the Java EE 7 specification, but also to add to their existing capabilities through a faster and more streamlined development and deployment cycle. Oracle GlassFish Server, the product version, and GlassFish Server Open Source Edition, the open-source version, are hereafter referred to as GlassFish Server.
The following topics are addressed here:
- Audience
- Documentation Accessibility
- Before You Read This Book
- Related Documentation
- Conventions
- Default Paths and File Names
前言
本教程是使用GlassFish Server Open Source Edition和Java EE 7开发基于Java 平台的企业应用程序指南.
Oracle GlassFish Server是一个兼容Java EE的应用服务器, 是基于GlassFish Server Open Source Edition构建和部署的下一代应用和服务, GlassFish Server Open Source Edition是https://glassfish.java.net/GlassFish社区开发的第一个兼容实现了Java EE 7规范且 轻巧，灵活的开源应用服务器,使企业不仅利用了Java EE 7规范中引入的新功能,还可以通过一个更快，更简化的开发和部署周期提高其现有能力.以下将Oracle GlassFish Server和GlassFish Server Open Source Edition及后续版本都简称GlassFish Server.
这里有以下话题：
- 读者
- 可访问文档
- 阅读本书之前
- 相关文档
- 约定
- 默认路径和文件名
Audience
This tutorial is intended for programmers interested in developing and deploying Java EE 7 applications. It covers the technologies comprising the Java EE platform and describes how to develop Java EE components and deploy them on the Java EE Software Development Kit (SDK).
读者
本教程面向那些对开发和部署Java EE 7应用程序感兴趣的程序员,教程包含Java EE平台技术细节描述以及如何使用Java EE Software Development Kit(SDK)开发和部署Java EE组件.
Documentation Accessibility
For information about Oracle’s commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.
可访问文档
如需了解更多有关Oracle 的信息，可访问Oracle 辅助计划网站http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.
Access to Oracle Support
Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.
访问Oracle支持
Oracle客户通过访问”My Oracle Support”获取电子支持,更多信息请访问http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info 或 http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs(如果有听力障碍).
Before You Read This Book
Before proceeding with this tutorial, you should have a good knowledge of the Java programming language. A good way to get to that point is to work through the Java Tutorials (http://docs.oracle.com/javase/tutorial/index.html).
阅读本书之前
阅读本书可能需要对Java程序语言有一个比较好的了解，一个可行的办法是先阅读Java 教程(http://docs.oracle.com/javase/tutorial/index.html).
Related Documentation
The GlassFish Server documentation set describes deployment planning and system installation. To obtain documentation for GlassFish Server Open Source Edition, go to https://glassfish.java.net/docs/.
The Java EE 7 API specification can be viewed at http://docs.oracle.com/javaee/7/api/ and is also provided in the Java EE 7 SDK.
Additionally, the Java EE Specifications at http://www.oracle.com/technetwork/java/javaee/tech/index.html might be useful.
For information about creating enterprise applications in the NetBeans Integrated Development Environment (IDE), see http://www.netbeans.org/kb/.
For information about the Java DB database for use with the GlassFish Server, see http://www.oracle.com/technetwork/java/javadb/overview/index.html.
The GlassFish Samples project is a collection of sample applications that demonstrate a broad range of Java EE technologies. The GlassFish Samples are bundled with the Java EE Software Development Kit (SDK) and are also available from the GlassFish Samples project page at https://glassfish-samples.java.net/.
相关文档
GlassFish Server文档集合介绍了部署计划和系统安装，要获得GlassFish Server Open Source Edition文档，请访问https://glassfish.java.net/docs/.
在 http://docs.oracle.com/javaee/7/api/或Java EE 7 SDK 查看Java EE 7 API 规范.
另外,Java EE 规范在 http://www.oracle.com/technetwork/java/javaee/tech/index.html可能也有提到.
关于在 NetBeans 集成开发环境中创建企业应用程序的信息可以查看http://www.netbeans.org/kb/.
关于在GlassFish Server中使用Java DB数据库的信息可以查看http://www.oracle.com/technetwork/java/javadb/overview/index.html.
GlassFish 项目示例是包含多种Java EE技术的应用程序示例集合,GlassFish示例被捆绑在Java EE SoftWare Development Kit(SDK)中，也可以从GlassFish 示例页面获得https://glassfish-samples.java.net/.
Conventions
The following table describes the typographic conventions that are used in this book.
| Convention | Meaning | Example |
|---|---|---|
| Boldface | Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary. | From the File menu, select Open Project.A cache is a copy that is stored locally. |
| 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 the User’s Guide.Do not save the file.The command to remove a file is rm filename. |
约定
下表介绍了本书中使用的印刷约定.
| 约定 | 含意 | 示例 |
|---|---|---|
| 粗黑体 | 黑体字表示与动作相关联的图形用户界面元素， 或以文字或术语表定义的术语。 | 从 文件 菜单中选择 打开项目.高速 缓存 是存储在本地的副本。 |
| 单一间隔 | 单一间隔指示文件和目录的名称，一个段落，网址，在示例代码中，在屏幕上显示的文本，或者您输入文本中的命令。 | 编辑你的 .login 文件.使用 ls –a 列出所有文件.machine_name% 你有邮件 |
| 斜体 | 斜体字表示书名，强调，或为您提供特定的值的占位符变量。 | 请阅读用户指南第6章.请勿保存文件.删除文件的命令为rm filename. |
Default Paths and File Names
The following table describes the default paths and file names that are used in this book.
| Placeholder | Description | Default Value |
|---|---|---|
| as-install | Represents the base installation directory for the GlassFish Server or the SDK of which the GlassFish Server is a part. | Installations on the Solaris operating system, Linux operating system, and Mac operating system:user’s-home-directory/glassfish4/glassfishWindows, all installations:SystemDrive:\glassfish4\glassfish |
| as-install-parent | Represents the parent of the base installation directory for GlassFish Server. | Installations on the Solaris operating system, Linux operating system, and Mac operating system:user’s-home-directory/glassfish4Windows, all installations:SystemDrive:\glassfish4 |
| tut-install | Represents the base installation directory for the Java EE Tutorial after you install the GlassFish Server or the SDK and run the Update Tool. | as-install-parent/docs/javaee-tutorial |
| domain-dir | Represents the directory in which a domain’s configuration is stored. | as-install/domains/domain1 |
默认路径和文件名
下表描述了本书中使用的默认路径和文件名.
| 占位符 | 描述 | 默认值 |
| as-install | 表示GlassFish应用服务器或作为SDK一个组成部分的的GlassFish应用服务器的基本安装目录 | 安装在Solaris,Linux,Mac操作系统上：user’s-home-directory/glassfish4/glassfish Windows 安装：SystemDrive:\glassfish4\glassfish |
| as-install-parent? | 表示GlassFish Server基本安装目录的父目录 | 安装在Solaris,Linux,Mac操作系统上:user’s-home-directory/glassfish4Windows安装:SystemDrive:\glassfish4 |
| tut-install | 表示安装GlassFish Server或SDK和运行Update Tool后的安装的Java EE 教程的基本安装目录 | As-install-parent/docs/javaee-tutorial |
| domain-dir | 表示存储域配置的目录 | As-install/domains/domain1 |
Leave a Reply