bea.com | products | dev2dev | support | askBEA
 Download Docs   Site Map   Glossary 
Search

Fast Track Procedures for Web Applications

This page provides basic instructions for deploying JSP files, HTML files, images, and servlets. These procedures are not recommended for production environments. Instead, use the Java™ Two Enterprise Edition (J2EE™) model for application deployment to develop your application. The J2EE™ application model enables you to develop and deploy applications that are consistent, portable, and easily maintained.

For additional information on developing applications for WebLogic Server, see Developing WebLogic Server Applications.

For more about deploying WebLogic Server applications, see Deploying WebLogic Server Applications.

Complete the WebLogic Server Installation before using these Fast Track procedures.

 

JSP Fast Track

To deploy a simple JSP:

  1. Make sure your JSP file does not reference a tag library or other external resources -- such resources require additional steps to deploy that are beyond the scope of these Fast Track procedures.

    If you do not have a JSP available, you can copy the HTML code from the example in Programming WebLogic JSP into a file with a *.jsp extension, such as HelloWorld.jsp.

  2. Start a WebLogic Server. Windows NT users can use the Start Menu shortcut labeled Launch Examples Server.

  3. Copy your JSP file into the
    mydomain\applications\DefaultWebApp directory.

    (Where mydomain is the name of the domain you created during installation. If you did not create a domain at installation, you can create one using the instructions in Creating Domains and Servers.)

  4. In a Web browser, request the JSP file using the following URL:

    http://localhost:port/myJSPfile.jsp

    where:

    localhost is the host name of the machine running WebLogic Server.

    port is the port number where WebLogic Server is listening for requests.

    myJSPfile.jsp is the JSP file you copied in step 3.


What's Going On?

The directory into which you copied your JSP file is the root directory of a default Web Application that is preconfigured in your WebLogic Server installation. A Web Application is a J2EE deployment unit that ties together resources of a Web-based application. The root directory of a Web Application is analogous to the document root of many Web servers.

You can deploy JSP files by simply copying them into the root directory of a deployed Web Application. JSPs do not require specific registrations, as do servlets.


Additional Resources

HTML Fast Track

To deploy an HTML page:

  1. Start WebLogic Server. Windows NT users can use the Start Menu shortcut labeled Launch Examples Server.

  2. Copy your HTML file into the
    mydomain\applications\DefaultWebApp directory of your WebLogic Server installation.

    (Where mydomain is the name of the domain you created during installation. If you did not create a domain at installation, you can create one using the instructions in Creating Domains and Servers.)

  3. If you have any image files or other files linked to your HTML page, also copy those into the DefaultWebApp directory. If necessary, you can create subdirectories to handle relative links, such as image files.

  4. In a Web browser, request the HTML file using the following URL:

    http://localhost:port/myFile.html

    where:

    localhost is the host name of the machine running WebLogic Server

    port is the port number where WebLogic Server is listening for requests.

    myFile.html is the HTML file you copied in step 2.


What's Going On?

The directory into which you copied your HTML file is the root directory of a default Web Application that is preconfigured in your WebLogic Server installation. A Web Application is a J2EE deployment unit that ties together resources of a Web-based application. The root directory of a Web Application is analagous to the document root of many Web servers.


Additional Resources

Servlet Fast Track

To deploy a servlet:

  1. Create a subdirectory called classes under the following directory:
    mydomain\applications\
     DefaultWebApp\WEB-INF\
    .

    (Where mydomain is the name of the domain you created during installation. If you did not create a domain at installation, you can create one using the instructions in Creating Domains and Servers.)

  2. Copy your servlet class file into the following directory:
    mydomain\applications\
     DefaultWebApp\WEB-INF\classes
    .

    If your servlet class has a package statement, create an additional subdirectory for each level of the package statement. For example, if your package statement is package color.blue, then place your servlet class in the following directory:
    mydomain\applications\DefaultWebApp
     \WEB-INF\classes\color\blue
    .

    If you do not have a servlet class to use for this Fast Track procedure, follow the instructions in Programming WebLogic HTTP Servlets to create a simple one.

  3. Modify the web.xml file located in the mydomain\applications\DefaultWebApp\
     WEB-INF\
    directory of your domain by adding the following, in between the <web-app> and </web-app> tags:

    <servlet>
      <servlet-name>
        myServlet
      </servlet-name>
      <servlet-class>
        package.name.myServlet
      </servlet-class>
    </servlet>
    
    <servlet-mapping>
      <servlet-name>
        myServlet
      </servlet-name>
      <url-pattern>
        quickStartServlet
      </url-pattern>
    </servlet-mapping>

    where:
    myServlet is the name of your servlet class file.

    package.name.myServlet is the full package name of your servlet class.

  4. Save the web.xml file.

  5. Start WebLogic Server. Windows NT users can use the Start Menu shortcut labeled Launch Examples Server.

  6. Call your servlet from a Web browser with the following URL:

    http://localhost:port/quickStartServlet

    where:
    localhost is the host name of the machine running WebLogic Server

    port is the port number where WebLogic Server is listening for requests.

    quickStartServlet is the value of the <url-pattern> element that you defined in the web.xml file in step 3.


What's Going On?

The web.xml file that you edited is the deployment descriptor for a Web Application called DefaultWebApp. A Web Application is a J2EE deployment unit that ties together resources of a Web-based application. The DefaultWebApp Web Application is preconfigured in your WebLogic Server installation.

In the deployment descriptor you defined the class name of the servlet (the <servlet-class> element) and the URL that is used to resolve requests for the servlet (the <url-pattern> element).


Additional Resources