Creating Display Servlet JSP Files
You can create your
own JSP files using the RTView tag library to show any number
of
display (.rtv) files. The RTView
tag library defines two tags:
|
setup |
This tag must be included once on each
JSP page that uses the RTView tag library. It will insert references to
Javascript files and CSS files required by the Display Server. The setup tag
must be included in the JSP page before the first display tag. This tag has no
attributes. Example:
<rtv:setup/>
|
|
display |
This tag inserts an HTML DIV tag
containing an RTView display. The display tag has the following
attributes:
| Attribute |
Description |
| id |
Required. The ID for this tag. This
must be unique on the JSP page. An id must start with a letter and may contain
only letters and digits. |
|
displayname |
Required. The
string specifying an RTView display (.rtv) file name. This should
correspond to the name of a display (.rtv) file accessible by the Display
Server. |
|
refresh |
Optional. A
positive number defining the rate, in seconds, at which the display inside this
DIV should be refreshed. If zero, the DIV is not periodically refreshed. NOTE:
This refresh rate overrides the rtvRefreshInterval property.
If no refresh rate is specified, the interval
defined in the rtvdisplay.properties file will be
used unless you have set a value for rtvRefreshInterval. |
| style |
Optional. The CSS style to be used for
this DIV.
|
Example:
<rtv:display id="d1" displayname="MyDisplay" refresh=0"/>
|
Requirements
There are THREE requirements for JSP pages
using the RTView tag library:
1. Tag library definition
The tag library must be defined at the top of the JSP page. For example:
<%@ taglib prefix="rtv" uri="rtv.tld" %>
NOTE: The file rtv.tld is contained in
rtvdisplay.war.
2. RTView mouse
and key events
For proper operation of the RTView
menu, the onmousedown and onkeydown event handler of the page's BODY must be
defined. For example:
<BODY onmousedown="rtvBodyMouseDown(event)"
onkeydown="rtvBodyKeyDown(event)">
If other functions are already assigned to
these event handlers, then those functions must call rtvBodyMouseDown and
rtvBodyKeyDown.
3. RTView menu
Each JSP page must include the RTView menu. For example:
<jsp:include page="rtvmenu.html"/>
This is typically added near the end of the
page's BODY, and should not be enclosed in any elements other than <BODY>.
Example
The following is a simple JSP page using the
RTView tag library.
<%@ page contentType="text/html;charset=UTF-8"%>
<%@ taglib prefix="rtv" uri="rtv.tld" %>
<HTML>
<BODY topmargin='0' leftmargin='0'
onmousedown="rtvBodyMouseDown(event)"
onkeydown="rtvBodyKeyDown(event)">
<rtv:setup/>
<rtv:display id="d1" displayname="MyDisplay" refresh="0"/>
<rtv:display id="d2" displayname="AnotherDisplay" refresh="30"/>
<jsp:include page="rtvmenu.html"/>
</BODY>
</HTML>
Limitations
A separate timer is used for each <rtv:display/>
tag that has a nonzero refresh rate. If all of the display tags on a page use
the same refresh rate, they may still be refreshed at slightly different times.
A display's timer is restarted when a drill down is performed in the display,
which may offset its refresh timer from other refresh timers on the page.
|
