Adding an embedded file to a JSP page

You can add embedded files to your web pages by using the jsp:include action.

Before you begin

Create a Web page, selecting JSP in the Template list.

About this task

This is especially useful when creating page templates. For example, you can use JSP includes to embed separate JSP files as a header or footer for your page templates. You can edit the embedded JSP file directly without having to open it.

Procedure

  1. Click the JSP Tags drawer on the palette.
  2. Drag and drop the Include element to your web page.
  3. Click Browse to specify the file to embed.
  4. Add any parameters to the Parameters list. For example, you could add parameters for a user ID and password to be passed to the embedded page.
  5. Click OK. The embedded file appears in the Design pane and is also visible in the Preview pane. You can now edit the embedded file directly by clicking the Browse icon in the Properties view and selecting Edit.
    Edit option in the Properties view for the jsp:include tag

What to do next

If you do not want the embedded file to display in the Design pane, you can turn this setting off by selecting JSP > Show Embedded Documents Inline. The embedded page is replaced by a small icon.
Note: Page Designer cannot display embedded documents properly in the Design page when the parent document and embedded document are ill-formed. "Ill-formed" means that a HTML tag's start tag and end tag are located in separate files. Though they can work properly with an application server, Page Designer cannot display such embedded documents properly. Page Designer also cannot show embedded documents properly in the Design page when the embedded document has a <frame> or <frameset> tag.
Related concepts:
JavaServer Pages (JSP) technology
Related tasks:
Creating Web pages
Debugging JSP files
Testing web pages on a server
Editing JSP files
Feedback