The JSP tags can throw the following exception class:

lotus.domino.taglib.DominoTagException

This section defines the following:

• DominoTagException class
• DominoTagException Interface
• DominoTagException error messages
• Validation errors

The DominoTagException contains an id and text attribute. You can retrieve exception objects using the following methods:

Method	Retrieves
getMessage()	Run-time error messages triggered in tag processing.
getNotesException()	Associated exception thrown by a Java back-end class, if applicable.
getException()	Other kinds of associated exceptions, if applicable (IOExceptions, for example).

DominoTagException Interface

You can use the following Domino Tag Error interface to retrieve exception objects:

public class DominoTagException extends JspException {

public int  id;

public String  text;

//Returns the associated NotesException object.

//If none, returns null.

public NotesException getNotesException();

//Returns the associated Exception object.

//If none, returns null.

public Exception getException();

//Overrides getMessage() to return the text attribute.

public String getMessage();

DominoTagException error messages

The following table lists the different error messages generated by the id attribute of the DominoTagException class:

Id value	Indicates
INVALID_CONTEXT	Structural error. You may have: -used the specified tag outside its required context -specified conflicting attribute values This error is thrown at translation time.
VIEW_NOT_FOUND	Runtime error. Specifies that the named view was not found in the database.
DOMINO_ERROR	Catch all for any NotesExceptions thrown that do not have a value-added context. You can retrieve the Exception object using the getNotesException() method.
IO_ERROR	Indicates that an IOException occurred while writing output to the page. You can retrieve the IOException object using the getException() method.
JAVA_ERROR	Catch all for any Java exceptions thrown. You can retrieve the Exception object using the getException() method.
DB_NOT_FOUND	Runtime error. Specifies that the named database could not be found.
INVALID_FORMAT	Indicates that the format string passed to the format attribute is invalid.
INVALID_STATE	Indicates that you have lost the session state.
ITEM_NOT_FOUND	Indicates that the named item could not be found in the view.
INVALID_ATTRIBUTE	Indicates that an attribute value is invalid.
AGENT_NOT_FOUND	Specifies that the named agent could not be found.

Validation errors

Validation errors are collected and displayed by the validatesummary tag. The validatesummary tag loops through the page collecting the error messages generated when validation executed by any of the following validation tags fails:

Validation tag name	Checks if the user input consists of:
validatecc	a valid credit card number
validatedate	a valid date or datetime value (You can set minimum and maximum date requirements.)
validatelength	the specified character length (You can set minimum and maximum length requirements.)
validatepattern	the specified pattern of data types
validaterange	the specified range
validaterequired	an entry (No datatype checking is done with this tag.)
validatewith	a value that matches a specified constant value or another field input value according to the specified comparison operator

See Also

Using Domino JSP tags

Glossary