Before You Begin

The Suntrademark Open Net Environment (Sun ONE) Studio 4 integrated development environment (the IDE) is documented in a series of books known as the Sun ONE Studio 4 Programming series. This book, Building J2EEtrademark Applications, explains how you use the IDE to assemble, deploy, and execute applications that conform to the architecture of the Javatrademark 2 Platform, Enterprise Edition (J2EEtrademark applications).

See the release notes for a list of environments in which you can create the examples in this book. The release notes are available on this web page:

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

Screen shots vary slightly from one platform to another. You should have no trouble translating the slight differences to your platform. Although almost all procedures use the interface of the Suntrademark ONE Studio 4 software, occasionally you might be instructed to enter a command at the command line. Here too, there are slight differences from one platform to another. For example, a Microsoft Windows command might look like this:

c:>cd MyWorkDir\MyPackage

To translate for UNIX® or Linux environments, simply change the prompt and use forward slashes:

% cd MyWorkDir/MyPackage


Before You Read This Book

This book is intended for anyone who uses the Sun ONE Studio 4 IDE to assemble, deploy, or execute J2EE applications. The first chapter summarizes the J2EE platform concepts of assembly and deployment, and it should benefit anyone seeking a general understanding of assembly and deployment.

This book assumes a familiarity with the following subjects:

  • Java programming language
  • J2EE concepts
  • Web and application server software

This book requires a knowledge of J2EE concepts, as described in the following resources:



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.




How This Book Is Organized

The J2EE platform is a component-oriented approach to developing enterprise applications. Business logic is encapsulated in Enterprise JavaBeanstrademark (EJBtrademark) components and web components. Components are assembled into modules, which become units of logic that perform recognizable business tasks. Modules are then assembled into J2EE applications, which perform entire business processes.

The J2EE platform provides a number of ways for the pieces of an application to communicate with each other, including Java RMI and the Java Messaging Service. This book is about using the Sun ONE Studio 4 development environment to assemble components into modules and modules into applications. The book relies on "scenarios" to present this information.

Chapter 1 summarizes the J2EE concepts of assembly and deployment. It also identifies the J2EE units of modules and applications, and examines module and application deployment descriptors. It also explains how to assemble modules and applications in the IDE. In particular, it explains how to use module and application property sheets to set up module and application deployment descriptors.

Chapter 2 is a scenario that shows how to assemble a web module. It presents a short example of how a web module can be used as the front end of a J2EE application and then shows how to program a web module that can be used in a J2EE application.

Chapter 3 is a scenario that shows how to assemble an EJB module. It presents a short example of how an EJB module can be used in a J2EE application and then shows how to program a module that contains several enterprise beans.

Chapter 4 is a scenario that shows how to assemble a J2EE application by combining a web module and an EJB module. It presents a short example of how the two kinds of modules can be used together in a J2EE application and then shows how to program the application. This scenario features synchronous interaction between the two modules, using Java RMI.

Chapter 5 is a scenario that shows how to set up asynchronous communications between modules using a message-driven enterprise bean, or MDB. It presents a short example of how asynchronous communication can be used in a business application and then shows how to program both the sending and receiving sides of the asynchronous communication. This scenario features a web module communicating with an EJB module, but the example can be applied to other combinations of modules.

Chapter 6 is a scenario that shows how to set up communications between a J2EE application client and a server-side J2EE application. It presents a short example of how an application client can be used in a business application and then shows how to program the application client. In this scenario, the application client uses Java RMI to invoke an enterprise bean's business method synchronously, but the example can be applied to application clients that use asynchronous communication as well.

Chapter 7 explains how to program container-managed transactions with the IDE.

Chapter 8 explains how to secure the resources in a J2EE application using the IDE. It shows how to set up security roles at the module level and how to use the roles to restrict access to web resources and enterprise bean methods. It also shows how to map the roles when the modules are combined into an application.

Chapter 9 explains how to deploy and execute assembled applications. In particular, it explains how to tailor an application for a specific server product and then deploy the application to that server.

Appendix A looks at the mechanism the IDE uses to interact with web and application servers. It includes a detailed account of the deployment process.


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 4 documentation includes books delivered in Acrobat Reader (PDF) format, release notes, online help, readme files for example applications, and Javadoctrademark documentation.

Documentation Available Online

The documents described in this section are available from the docs.sun.comSM web site and from the documentation page of the Sun ONE Studio Developer Resources portal (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 installed with the product on your local system or network.

  • Release notes (HTML format)
Available for each Sun ONE Studio 4 edition. Describe last-minute release changes and technical notes.
  • Getting Started guides (PDF format)
Describe how to install the Sun ONE Studio 4 integrated development environment (IDE) on each supported platform and include other pertinent information, such as system requirements, upgrade instructions, application server configuration instructions, command-line switches, installed subdirectories, database integration, and information on how to use the Update Center.
    • Sun ONE Studio 4, Community Edition Getting Started Guide - part no. 816-7871-10
    • Sun ONE Studio 4, Enterprise Edition for Java Getting Started Guide - part no. 816-7859-10
    • Sun ONE Studio 4, Mobile Edition Getting Started Guide - part no. 816-7872-10
  • Sun ONE Studio 4 Programming series (PDF format)
    • This series provides in-depth information on how to use various Sun ONE Studio 4 features to develop well-formed J2EE applications.Building Web Components - part no. 816-7869-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. 816-7863-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. 816-7864-10
Describes how to build EJB components (session beans, message-driven beans, and entity beans with container-managed or bean-managed persistence) using the Sun ONE Studio 4 EJB Builder wizard and other components of the IDE.
    • Building Web Services - part no. 816-7862-10
Describes how to use the Sun ONE Studio 4 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. 816-7870-10
Describes how to use the JDBC productivity enhancement tools of the Sun ONE Studio 4 IDE, including how to use them to create a JDBC application.
  • Sun ONE Studio 4 tutorials (PDF format)
These tutorials demonstrate how to use the major features of each Sun ONE Studio 4 edition.
    • Sun ONE Studio 4, Community Edition Tutorial - part no. 816-7868-10
Provides step-by-step instructions for building a simple J2EE web application.
    • Sun ONE Studio 4, Enterprise Edition for Java Tutorial - part no. 816-7860-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 will be compliant with the Java 2 Platform, Micro Edition (J2MEtrademark platform) and conform 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 inside the Sun ONE Studio 4 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 4 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 used in this document.

Javadoc Documentation

Javadoc documentation is available within the IDE for many Sun ONE Studio 4 modules. Refer to the release notes for instructions on installing this documentation. When you start the IDE, you can access this Javadoc documentation within the Javadoc pane of the Explorer.


Sun Welcomes Your Comments

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

docfeedback@sun.com

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