Before You Begin

This Getting Started Guide provides instructions for installing, setting up, and starting the Sun ONE Studio 5, Standard Edition integrated development environment (IDE). This book is designed for both system administrators and developers who install software. You should be experienced with basic installation procedures on your platform.

Screen shots and commands entered at the command line vary slightly from one platform to another. For example, a Microsoft Windows command might look like this:

c:>cd MyWorkDir\MyPackage

A UNIX^® command might look like this:

% cd MyWorkDir/MyPackage

Before You Read This Book

You should be familiar with installing and uninstalling software products on the platforms you choose to use with this release of the Sun ONE Studio 5 IDE. You need familiarity with system administration commands, such as:

su, xhost, pkginfo, pkgadd, and pkgrm utilities in the Solaris Operating System (Solaris OS)

Add/Remove Program utility on Microsoft Windows systems

rpm command in the Linux environment

If you are unsure about the system administration commands for your operating system, contact your system administrator for assistance with the instructions in this guide.

Before using this IDE, you should also be familiar with the following subjects:

Java programming language

Enterprise JavaBeans (EJB) technology concepts

Java Servlet API syntax

Syntax for drivers that support the JDBC API

HTML syntax

JavaServer Pages technology syntax

How to use JDBC databases

Java 2Enterprise Edition (J2EE⁾application assembly and deployment concepts

Web Services

Using application servers such as Sun ONE Application Server 7, Standard Edition

Using the Sun ONE Studio 5, Standard Edition IDE successfully requires a knowledge of J2EE concepts, as described in the following resources:

Java 2 Platform, Enterprise Edition Blueprints
http://java.sun.com/j2ee/blueprints

Java 2 Platform, Enterprise Edition Specification
http://java.sun.com/j2ee/download.html#platformspec

The J2EE Tutorial
http://java.sun.com/j2ee/tutorial

Java Servlet Specification Version 2.3
http://java.sun.com/products/servlet/download.html#specs

JavaServer Pages Specification Version 1.2
http://java.sun.com/products/jsp/download.html#specs

Familiarity with the Java API for XML-Based RPC (JAX-RPC) is helpful. For more information, see this web page:

http://java.sun.com/xml/jaxrpc

Note - Sun is not responsible for the availability of third-party web sites mentioned in this document and does not endorse and is not responsible or liable for any content, advertising, products, or other materials on or available from such sites or resources. Sun will not be responsible or liable for any damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services available on or through any such sites or resources.

Typographic Conventions

Typeface	Meaning	Examples
`AaBbCc123`	The names of commands, files, and directories; on-screen computer output	Edit your `.cvspass` file. Use `DIR` to list all files. `Search is complete.`
`AaBbCc123`	What you type, when contrasted with on-screen computer output	`>` `login` `Password:`
AaBbCc123	Book titles, new words or terms, words to be emphasized	Read Chapter 6 in the User's Guide. These are called class options. You must save your changes.
AaBbCc123	Command-line variable; replace with a real name or value	To delete a file, type `DEL` filename.

Related Documentation

Sun ONE Studio documentation includes books delivered in Acrobat Reader (PDF) format, release notes, online help, readme files for example applications, and Javadoc documentation.

Documentation Available Online

The documents described in this section are available from the docs.sun.com^SM web site and from the documentation page of the Sun ONE Studio Developer Resources portal at http://forte.sun.com/ffj/documentation.

The docs.sun.com web site (http://docs.sun.com) enables you to read, print, and buy Sun Microsystems manuals through the Internet. If you cannot find a manual, see the documentation index that is installed with the product on your local system or network.

Release notes (HTML format)

Available for each Sun ONE Studio edition. Describe last-minute release changes and technical notes.

Sun ONE Studio 5, Standard Edition Release Notes - part no. 817-2337-10

Getting Started guides (PDF format)

Describe how to install the Sun ONE Studio integrated development environment (IDE) on each supported platform and include other pertinent information, such as system requirements, upgrade instructions, application server information, command-line switches, installed subdirectories, database integration, and information on how to use the Update Center.

Sun ONE Studio 5, Standard Edition Getting Started Guide - part no. 817-2318-10

Sun ONE Studio 4, Mobile Edition Getting Started Guide - part no. 817-1145-10

Sun ONE Studio 5 Programming series (PDF format)

This series provides in-depth information on how to use various Sun ONE Studio features to develop well-formed J2EE applications.

Building Web Components - part no. 817-2334-10

Describes how to build a web application as a J2EE web module using JSP pages, servlets, tag libraries, and supporting classes and files.

Building J2EE Applications - part no. 817-2327-10

Describes how to assemble EJB modules and web modules into a J2EE application and how to deploy and run a J2EE application.

Building Enterprise JavaBeans Components - part no. 817-2330-10

Describes how to build EJB components (session beans, message-driven beans, and entity beans with container-managed persistence or bean-managed persistence) using the Sun ONE Studio EJB Builder wizard and other components of the IDE.

Building Web Services - part no. 817-2324-10

Describes how to use the Sun ONE Studio IDE to build web services, to make web services available to others through a UDDI registry, and to generate web service clients from a local web service or a UDDI registry.

Using Java DataBase Connectivity - part no. 817-2332-10

Describes how to use the JDBC productivity enhancement tools of the Sun ONE Studio IDE, including how to use them to create a JDBC application.

Sun ONE Studio tutorials (PDF format)

These tutorials demonstrate how to use the major features of Sun ONE Studio 5, Standard Edition:

Sun ONE Studio 5 Web Application Tutorial - part no. 817-2320-10

Provides step-by-step instructions for building a simple J2EE web application.

Sun ONE Studio 5 J2EE Application Tutorial - part no. 817-2322-10

Provides step-by-step instructions for building an application using EJB components and web services technology.

Sun ONE Studio 4, Mobile Edition Tutorial - part no. 816-7873-10

Provides step-by-step instructions for building a simple application for a wireless device, such as a cellular phone or personal digital assistant (PDA). The application you build is compliant with the Java 2 Platform, Micro Edition (J2ME platform) and conforms to the Mobile Information Device Profile (MIDP) and Connected, Limited Device Configuration (CLDC).

You can also find the completed tutorial applications at: http://forte.sun.com/ffj/documentation/tutorialsandexamples.html

Online Help

Online help is available in the Sun ONE Studio IDE. You can open help by pressing the help key (F1 in Microsoft Windows and Linux environments, Help key in the Solaris environment), or by choosing Help right arrow Contents. Either action displays a list of help topics and a search facility.

Examples

You can download examples that illustrate a particular Sun ONE Studio feature, as well as completed tutorial applications, from the Sun ONE Studio Developer Resources portal at:

http://forte.sun.com/ffj/documentation/tutorialsandexamples.html

The site includes the applications that are used in this document.

Javadoc Documentation

Javadoc documentation is available within the IDE for many Sun ONE Studio modules. Refer to the release notes for instructions on installing this documentation.

Documentation in Accessible Formats

The documentation is provided in accessible formats that are readable by assistive technologies for users with disabilities. You can find accessible versions of documentation as described in the following table.

Type of Documentation	Format and Location of Accessible Version
Books and tutorials	HTML at `http://docs.sun.com`
Mini-tutorials	HTML at `http://forte.sun.com/ffj/tutorialsandexamples.html`
Integrated example readmes	HTML in the example subdirectories of s1studio-install-directory`/examples`
Release notes	HTML at `http://docs.sun.com`

Contacting Sun Technical Support

If you have technical questions about this product that are not answered in this document, go to:

http://www.sun.com/service/contacting

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. Email your comments about this book to Sun at this address:

docfeedback@sun.com

Please include the part number (817-2318-10) of this document in the subject line of your email.