JSP CUSTOM TAG LIBRARIES

Core Domino JSP tags
The following core tags serve as the primary means of accessing Domino data when used either within frames or as content in a dynamically generated page:
documentRepresents a Domino document or database record.
formProvides a schema for document creation.
ftsearchEnables a full text search on a page.
mailtoSends a mail message via Domino mail.
runagentRuns a specified agent on the server.
viewDisplays a list of documents to select from.

session tag

If you are including more than one of these core tags in a page, use the session tag. This initializes and dismantles the Domino session only once, improving performance.

db tag

To ensure that all subsequent tags are running off the same database, use the db tag first.

Containment hierarchy

The following table illustrates the hierarchy you can implement to create a more scalable JSP page:

session tag
db tag for abc.nsf databasedb tag for def.nsf database
view tags for Customer and Sales views in abc.nsf databasepage tag for a Welcome page in abc.nsf databaseform tag for Contact form in def.nsf databaseview tag for Address view in def.nsf database
If you only want to include one view, for example, in a JSP, use a view tag only. If you want to include two views and a page from the abc.nsf database, use a db tag to wrap the views and page tags in. If you want to include views and a page from the abc.nsf database and a form and view from the def.nsf database, as the table illustrates, use the session tag first, then one db tag for each database that is storing the data you want to access using the core tags. Wrapping multiple core tags increases the efficiency of your JSP page.
The tags automatically handle database failover. If a specified database is not available, the system fails over to a server in the cluster that hosts an available replica of the database.

See Also