SAS 9.1.3 Integration Technologies » SAS Web Infrastructure Kit: Developer's Guide


Developing Custom Portlets
Development Steps
Creating a Deployment Descriptor
Creating Display Resources Files
Developing the Presentation JSP Page
Creating Action Classes
Implementing Portlet Help
Creating a PAR File
Use Cases
Simple Display Portlet
Localized Portlet
Portlet Template (Editable Portlet)
Remote Portlet
Tips and Best Practices
Using the Portlet API
Sample Portlets
Localized Display Portlet (Welcome)
Interactive Form Portlet (FormExample)
Portlet Template, or Editable Portlet (DisplayURL)
Web Application (HelloUserWikExample)
Remote Portlet (HelloUserRemote
Portlet
Sample: Localized Display Portlet (Welcome Portlet)

Step 1: Create the Directory Structure

The following directory structure was used to create the Welcome portlet:

Directory structure for Welcome portlet

This structure includes the following directories and subdirectories:

Directory Contents
Work (root)

This directory serves as a development area for the portlet.
Portlet deployment descriptor file portlet.xml

The name of the portlet deployment descriptor file must be portlet.xml.
/Welcome
This is the main portlet directory. It does not contain any files. The directory name must not have any spaces, and it must match the name of the portlet as specified in the name attribute of the <local-portlet> element in portlet.xml.
/Welcome/classes Display resource files: portletDisplayResources_de.properties, portletDisplayResources_en.properties, portletDisplayResources_es.properties, and so on.
/Welcome/classes/com/sas/portal/
portlets/welcome
The action class called WelcomeAction.class.
/Welcome/classes/com/sas/portal/
portlets/welcome/res
Resource bundles:
Resources.properties, Resources_de.properties, Resources_es.properties, Resources_fr.properties, and so on.

Note: Alternatively, the resource bundles could be placed in the same directory as the action class.
/Welcome/content This directory contains the display page called Welcome.jsp.

Each portlet can have only one content location directory, and the directory name must be content. However, the content location directory can have an unlimited number of subdirectories.

The following rules apply when you set up the directory structure:

  • Neither portlet names nor their paths can contain spaces.

  • The portlet identifier (which consists of the name and the path) must be unique. Developers should devise a convention to ensure unique name-spaces, similar to the conventions used for naming Java packages.

    For example, the Sales division of a company named ABCD could create portlets in the path ABCD/Sales, and the Purchasing division could create portlets in the path ABCD/Purchasing. Then, both Sales and Purchasing could have different portlets named Welcome.