blob: e37b5819899ebde543358c4c946eb718270eff03 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
<head>
<title>web.xml Visual Editor: Welcome Files</title>
<link rel="stylesheet" href="ide.css" title="Oracle BLAFDoc" type="text/css"/>
</head>
<body>
<p><a id="dd_multiview_pages_welcomeFilesNode" name="dd_multiview_pages_welcomeFilesNode"></a></p>
<div id="NBCSH3815"><!-- infolevel="all" infotype="General" --><a id="sthref516" name="sthref516"></a>
<h1>web.xml Visual Editor: Welcome Files</h1>
<a name="BEGIN" id="BEGIN"></a>
<p>Use the Welcome Files section to add, remove, and view your web application's welcome files. A welcome file is a JSP file, HTML file, or servlet that is displayed when the web application is deployed. <a href="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1114">In the Visual Editor, click <b>Pages</b> at the top of the editor to open the Pages view. Click the Welcome Files header to open the Welcome Files section. How?</a></p>
<table summary="User interface elements and descriptions" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0">
<col width="24%" />
<col width="*" />
<thead>
<tr align="left" valign="top">
<th align="left" valign="bottom" id="r1c1-t12">Element</th>
<th align="left" valign="bottom" id="r1c2-t12">Description</th>
</tr>
</thead>
<tbody>
<tr align="left" valign="top">
<td align="left" id="r2c1-t12" headers="r1c1-t12">
<p>Welcome Files</p>
</td>
<td align="left" headers="r2c1-t12 r1c2-t12">Specifies the path to a welcome file.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r3c1-t12" headers="r1c1-t12">
<p>Browse</p>
</td>
<td align="left" headers="r3c1-t12 r1c2-t12">Click to find and select the welcome file of your choice. You can choose more than one welcome file, but only the first existing welcome file is used as the web application's welcome file. You can register other files as welcome files for testing and debugging purposes.</td>
</tr>
</tbody>
</table>
<br />
<!-- -->
<p>To define one ore more JSP files, HTML files, or servlets as welcome files, you can register them in the <code dir="ltr">web.xml</code> file.
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1114">
<param name="text" value="<html><u>How?</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>
<p>Before you can register a welcome file in the <code dir="ltr">web.xml</code> file, you must create the JSP file, HTML file, or servlet or import it from your existing sources.</p>
<p>During development time only, you can specify the application's welcome file by right-clicking the project node in the Projects window, choosing Properties, clicking <b>Run</b>, and typing it in the Relative URL text box. Note that the welcome file specified in the Project Properties dialog box is the welcome file that is used first. If no welcome file is defined in the Project Properties dialog box, the first existing welcome file defined in the <code dir="ltr">web.xml</code> file is used.</p>
<a id="NBCSH3818" name="NBCSH3818"></a>
<hr><p><b>Related Topics</b></p>
<p><i>Developing Applications with NetBeans IDE</i>,
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG2812">
<param name="text" value="<html><u>&quot;About Deployment Descriptors&quot;</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>
<p><i>Developing Applications with NetBeans IDE</i>,
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1111">
<param name="text" value="<html><u>&quot;Configuring a Web Application&quot;</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>
<!-- -->
<!-- Start Footer -->
<table summary="" cellspacing="0" cellpadding="0" width="100%">
<tr>
<td align="left" width="86%"><a href="legal_notice.htm">
Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements; and to You under the Apache License, Version 2.0.</a>
</td>
</tr>
</table>
<!-- -->
</body>
</html>