Netscape Enterprise Server and Fasttrack Server 3.0/3.01
Notes for Java Programmers

The 3.0/3.01 versions of the Netscape web servers (Netscape Enterprise Server and Netscape FastTrack Server) include a Java runtime environment that lets you deploy Internet and intranet ready applications. Using Java on a Netscape web server, you can deploy applications to serve many purposes, such as database access, corporate intranet publishing, and electronic commerce. Your server-side Java applications are automatically portable, regardless of whether the server is running on a Unix or Windows system. If you want to run a Java application on the 3.0/3.01 versions of the Netscape Enterprise Server or Netscape FastTrack Server, you should read this document. It provides information not covered in other Netscape documents, as well as links to other documents containing relevant information.

CONTENTS

  • Using Java in Netscape Web Servers
  • Getting Started
  • Netscape's Java Runtime Environment
  • Class Libraries Included with Netscape Web Servers
  • Sample Code
  • Limitations
  • Appendix A: Classes Included and Supported
  • Appendix B: Classes Included But Not Supported
  • Appendix C: Additional Classes Included But Not Supported
  • Copyright Notice
    •  

    USING JAVA IN NETSCAPE WEB SERVERS

    There are three different ways to run Java applications on Netscape Enterprise Server 3.0/3.01 and Netscape FastTrack Server 3.01.
    1. You can use the Web Application Interface (WAI) for developing Java applications (you cannot use WAI with applets). See Writing Web Applications with WAI for information about
      • the interface definitions that facilitate WAI programming
      • examples that use the interfaces

    2. You can use the LiveConnect facility. If you are writing your application using both Java and JavaScript, see Writing Client/Server JavaScript Applications for information about using JavaScript and Java concurrently.

    3. Although this option is not recommended, you can use the server side applet (HttpApplet) interface and classes provided with Enterprise Server 2.0 for server-side Java programs. They are deprecated but are still supported for backward compatibility. Netscape does not plan further development on them; equivalent functionality is available to you through LiveConnect. The classes are documented in the book Programmer's Guide, Netscape Enterprise Server Version 2.0, (for Unix or for NT).

    Netscape also plans to support Servlets in a future release.

     

    GETTING STARTED

    This section contains information about configuring your environment, compiling Java classes, and executing your Java program for Netscape web servers. The information in this section pertains to Java via the LiveConnect facility or the HttpApplet interface only. For Java via WAI, please see Writing Web Applications with WAI..  

    NETSCAPE'S JAVA RUNTIME ENVIRONMENT

    The Java runtime environment that Netscape includes with Enterprise Server and FastTrack Server 3.0/3.01 is based on Sun's JDK 1.1, with additional features provided by Netscape.  

    ENTERPRISE SERVER 3.0 CLASS LIBRARIES

    The file serv3_0.zip contains the Java class libraries included with Enterprise Server and FastTrack Server 3.0/3.01 for deploying HttpApplet and LiveConnect applications. These packages and classes are listed below:

    Note: The HttpApplet API (the netscape.server.applet, netscape.server.base, netscape.server.frame packages) is deprecated.
    In addition, you should be aware of these sets of server-related Java classes that are included as part of Enterprise Server:  

    SAMPLE CODE

    For the HttpApplet interface, the sample Java applet in Chapter 3 of Programmer's Guide, Netscape Enterprise Server Version 2.0 Programmer's Guide, (for Unix or for NT). continues to work with Enterprise Server 3.0.

    For WAI,  see the code example WASP.java included in Writing Web Applications with WAI.

    For LiveConnect,  see the example bugbase.java included in  Writing Client/Server JavaScript Applications.   

    LIMITATIONS

    The following are known limitations in the Java VM included with the Enterprise Server and FastTrack Server 3.0/3.01 for HttpApplet and LiveConnect applications.  

    APPENDIX A: CLASSES INCLUDED AND SUPPORTED

    The following classes and interfaces are available for developers to use with the Java VM in Enterprise Server and FastTrack Server 3.0/3.01. These classes are in the serv3_0.zip file and include core JDK 1.1 classes as well as Netscape classes.  

    APPENDIX B: CLASSES INCLUDED BUT NOT SUPPORTED

    The following classes and interfaces from JDK 1.1 are included but not supported with the Enterprise Server and FastTrack Server 3.0/3.01.

    Please note that the packages, classes and interfaces in the java.awt and java.security hierarchies are not included in Enterprise Server and FastTrack Server.

    PACKAGES

    CLASSES FROM JAVA.LANG

    CLASSES FROM JAVA.UTIL  

    APPENDIX C: ADDITIONAL CLASSES INCLUDED BUT NOT SUPPORTED

    The following additional Sun classes are included but are not supported with Enterprise Server and FastTrack Server 3.0/3.01.

    PACKAGES

    Copyright Notice

    Netscape Communications Corporation ("Netscape") and its licensors retain all ownership rights to this document (the "Document"). Use of the Document is governed by applicable copyright law. Netscape may revise this Document from time to time without notice.

    THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IN NO EVENT SHALL NETSCAPE BE LIABLE FOR ANY LOSS OF PROFITS, LOSS OF BUSINESS, LOSS OF USE OR DATA, INTERRUPTION OF BUSINESS, OR FOR INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY KIND, ARISING FROM ANY ERROR IN THIS DOCUMENT.

    The Document is copyright © 1997 Netscape Communications Corporation. All rights reserved.

    The Software includes encryption software from RSA Data Security, Inc. Copyright © 1994, 1995 RSA Data Security, Inc. All rights reserved. Portions of the Software include technology used under license from Verity, Inc. and are copyrighted. Portions of the Software copyright © 1994, 1995 Sun Microsystems, Inc. All rights reserved. Portions of the Software copyright © 1995 PEER Networks, Inc. All rights reserved. Portions of the Software copyright © 1996 Mortice Kern Systems, Inc. All rights reserved. Portions of the Software copyright © 1996, 1997 Symantec Corporation. All rights reserved.

    The portion of the Software that provides the DBM function is copyright (c) 1990, 1993, 1994 The Regents of the University of California. All rights reserved. This code is derived from software contributed to Berkeley by Margo Seltzer. Redistribution and use in source and binary forms of the DBM code, with or without modification, are permitted provided that the following conditions are met:

    1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

    2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

    3. All advertising materials mentioning features or use of this software must display the following acknowledgement:

    This product includes software developed by the University of California, Berkeley and its contributors.

    4. Neither the name of the University nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

    THE SOFTWARE WHICH PROVIDES THE DBM FUNCTION IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ''AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    Netscape and Netscape Navigator are registered trademarks of Netscape Communications Corporation in the United States and other countries. Netscape's logos and Netscape product and service names are also trademarks of Netscape Communications Corporation, which may be registered in other countries. Other product and brand names are trademarks of their respective owners.

    The downloading, export or reexport of Netscape software or any underlying information or technology must be in full compliance with all United States and other applicable laws and regulations. Any provision of Netscape software or documentation to the U.S. Government is with restricted rights as described in the license agreement accompanying Netscape software.

    Any sample code included above is provided for your use on an "AS IS" basis, under the Netscape License Agreement - Terms of Use