Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Portal Server 6 2005Q1 Developer's Guide 

Preface

This Developer’s Guide provides a high-level overview of the Sun JavaTM System Portal Server software APIs. This book explains how to extend and customize the software APIs.


Who Should Use This Book

This Developer’s Guide is intended for use by developers and individuals who are responsible for customizing the software APIs and creating custom providers and portlets for use with their deployment environment.

Portal Server developers should already understand the following technologies:

Also, this book assumes that you already know the basics of the Solaris Operating Environment and UNIX command-line utilities and administrative tasks.


Before You Read This Book

Portal Server is a component of Sun Java Enterprise System, a software infrastructure that supports enterprise applications distributed across a network or Internet environment. You should be familiar with the documentation provided with Sun Java Enterprise System, which can be accessed online at http://docs.sun.com/coll/entsys_05q1.

Because the Portal Server software components work together with Sun JavaTM System Access Manager for user, service, and policy management and authentication, single sign-on, and logging services, you should be familiar with the documentation provided with that product. Access Manager software documentation can be accessed online at http://docs.sun.com/doc.

Because Sun JavaTM System Directory Server is used as the data store for primary configuration information and user profile data in a Portal Server deployment, you should be familiar with the documentation provided with that product. Directory Server software documentation can be accessed online at http://docs.sun.com/coll/DirectoryServer_05q1.


How This Book Is Organized

The first chapter of this book provides an introduction to the Portal Server APIs. The rest of the book is divided into parts. The following table summarizes the content of this book.


Table 0-1  How This Book Is Organized  

Chapter

Description

 

This chapter provides an introduction to the Portal Server APIs.

Part I, "Overview"

Provides an overview of the various public extensible set of classes in the Portal Server software. The chapters provide:

  • An introduction to the base PAPI interfaces, classes, exceptions, and an overview of the DesktopServlet, and introduction to the building-block leaf and container providers.
  • A description of the development process for a Portal Server software provider. It touches on the public APIs available for integrating an application with the Portal Server software Desktop via the provider.

Part II, "Extending the Providers"

Provides instructions for

  • Implementing a custom provider by extending the PAPI base classes.
  • Customizing the methods in the leaf provider and container provider classes.
  • Developing a custom ContainerProvider and with sample instructions for developing a custom RouterContainerProvider.

Part III, "Portlets"

Provides:

  • An overview of the portlets
  • Instructions for developing portlets by extending the GenericPortlet class.
  • Information for converting providers to portlets

Part IV, "WSRP"

Provides instructions for creating custom registration validators.

Part V, "Search Engine Robot"

Describes the:

  • Search Engine Robot
  • Application Programming Interface (API) used to create plug-in robot application functions (RAFs).

Part VI, "Using the SOIF API to Work with SOIF Objects"

Describes the use of the search engine SOIF API to work with SOIF objects in C.

Part VII, "Using the RDM API to Access the Search Engine and Database in C"

Describes the use of the Search Engine RDM API to access the Search Engine and its database.

Part VIII, "Using Java To Access the Search Engine Database"

Describes how to:

  • Submit queries
  • Add entries to the Search Engine database by using the Java programming language.

Part IX, "Localizing Sun Java System Portal Server"

Provides instructions for localizing the customizeable parts of the Portal Server software.

Conventions Used in This Book

The tables in this section describe the conventions used in this book.

Typographic Conventions

The following table describes the typographic changes used in this book.

Table 2  Typographic Conventions 

Typeface

Meaning

Examples

AaBbCc123
(Monospace)

API and language elements, HTML tags, web site URLs, command names, file names, directory path names, onscreen computer output, sample code.

Edit your.login file.

Use ls -a to list all files.

% You have mail.

AaBbCc123
(Monospace bold)

What you type, when contrasted with onscreen computer output.

% su
Password:

AaBbCc123
(Italic)

Book titles, new terms, words to be emphasized.

A placeholder in a command or path name to be replaced with a real name or value.

Read Chapter 6 in the User’s Guide.

These are called class options.

Do not save the file.

The file is located in the install-dir/bin directory.

Symbols

The following table describes the symbol conventions used in this book.

Table 3  Symbol Conventions 

Symbol

Description

Example

Meaning

[ ]

Contains optional command options.

ls [-l]

The -l option is not required.

{ | }

Contains a set of choices for a required command option.

-d {y|n}

The -d option requires that you use either the y argument or the n argument.

-

Joins simultaneous multiple keystrokes.

Control-A

Press the Control key while you press the A key.

+

Joins consecutive multiple keystrokes.

Ctrl+A+N

Press the Control key, release it, and then press the subsequent keys.

>

Indicates menu item selection in a graphical user interface.

File > New > Templates

From the File menu, choose New. From the New submenu, choose Templates.

Default Paths and File Names

The following table describes the default paths and file names used in this book.

Table 0-4  Default Paths and File Names  

Term

Description

PortalServer-base

Represents the base installation directory for Sun Java System Portal Server software. The Portal Server software default base installation and product directory depends on your specific platform:

Solaris™ systems: /opt/SUNWps

AccessManager-base

Represents the base installation directory for Sun Java System Access Manager software. The Access Manager software default base installation and product directory depends on your specific platform:

Solaris™ systems: /opt/SUNWam

DirectoryServer-base

Represents the base installation directory for Sun Java System Directory Server software. The Directory Server software default base installation is /var/opt/mps/serverroot.

ApplicationServer-base

Represents the base installation directory for Sun JavaTM System Application Server software. The Application Server software default base installation is /opt/SUNWappserver8.

WebServer-base

Represents the base installation directory for Sun JavaTM System Web Server software. The Web Server software default base installation is /opt/SUNWwbsvr.

PortalServer-ContentFiles

Represents the directory where JSPs, templates and property files, and tag libraries are installed. By default, this is /etc/opt/SUNWps.

PortalServer-SEdb

Represents the Portal Server software Search Engine database. By default, this is /var/opt/SUNWps.

Shell Prompts

The following table describes the various shell prompts.

Table 5  Shell Prompts

Shell

Prompt

C shell on UNIX or Linux

machine-name%

C shell superuser on UNIX or Linux

machine-name#

Bourne shell and Korn shell on UNIX or Linux

$

Bourne shell and Korn shell superuser on UNIX or Linux

#

Windows command line

C:\

Command-line prompts are not displayed in the examples. Depending on which operating system environment you are using, you will see a variety of different command-line prompts. However, you should enter the command as it appears in the document unless specifically noted otherwise.


Related Documentation

The http://docs.sun.comSM web site enables you to access Sun technical documentation online. You can browse the archive or search for a specific book title or subject.

Books in This Documentation Set

The following table summarizes the books included in the Portal Server software documentation set.

Table 6  Books in This Documentation Set 

Book Title

Description

Portal Server Administrator’s Guide

http://docs.sun.com/db/doc/817-7691

Describes how to administer the Portal Server software using the administration console and the command line.

Secure Remote Access Administrator’s Guide

http://docs.sun.com/db/doc/817-7693

Describes how to administer Portal Server Secure Remote Access software.

Portal Server Desktop Customization Guide

http://docs.sun.com/db/doc/817-7694

Describes how to customize the Portal Server software desktop.

Portal Server Technical Reference Guide

http://docs.sun.com/db/doc/817-7696

Provides detailed information on the Portal Server software technical concepts.

Portal Server Deployment Planning Guide

http://docs.sun.com/db/doc/817-7697

Describes how to plan for and deploy Portal Server software.

Portal Server Migration Guide

http://docs.sun.com/db/doc/817-7698

Describes how to migrate from previous releases of the Portal Server software to this release.

Other Server Documentation

For other server documentation, go to the following:


Accessing Sun Resources Online

For product downloads, professional services, patches and support, and additional developer information, go to the following:


Contacting Sun Technical Support

If you have technical questions about this product that are not answered in the product documentation, go to http://www.sun.com/service/contacting.


Related Third-Party Web Site References

Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.


Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions.

To share your comments, go to http://docs.sun.com and click Send Comments. In the online form, provide the document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document. For example, the title of this book is Sun Java System Portal Server Developer’s Guide and the part number is 817-7695.



Previous      Contents      Index      Next     


Part No: 817-7695.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.