Index

A  B  C  D  E  F  G  H  I  J  M  N  O  P  R  S  T  U  V  W  X 

---

A

action tags

forward tag, 1-21

getProperty tag, 1-19

include tag, 1-20

overview, 1-18

param tag, 1-20

plugin tag, 1-22

setProperty tag, 1-18

useBean tag, 1-18

addclasspath, ojspc option, 6-18

alias translation, JServ

alias_translation configuration parameter, 9-10

overview, 9-23

application events

with globals.jsa, 9-31

with JspScopeListener, 5-2

application framework for JServ, 9-22

application object (implicit), 1-16

application root functionality, 3-2

application scope (JSP objects), 1-15

application support

overview, 3-4

through globals.jsa, 9-27

application_OnEnd tag, globals.jsa, 9-32

application_OnStart tag, globals.jsa, 9-31

application-relative path, 1-9

appRoot, ojspc option, 6-18

---

B

batch updates--see update batching

binary data, reasons to avoid in JSP, 4-16

binary file deployment, 6-27

binary file location, ojspc d option, 6-19

bypass_source config param, 9-10

---

C

call servlet from JSP, JSP from servlet, 3-5

checker pages, 4-9

class loader issues, 4-20

class naming, translator, 6-5

class reloading, dynamic, 4-25

classes files for JDBC, 9-4

classpath

classpath and class loader issues, 4-20

classpath config param, 9-11

configuration, JServ, 9-4

configuration, JSWDK, A-3

configuration, Tomcat, A-4

Web server classpath configuration, A-2

code, generated by translator, 6-2

comments (in JSP code), 1-14

compilation

javaccmd config param, 9-13

ojspc noCompile option, 6-21

config object (implicit), 1-17

configuration

classpath and class loader issues, 4-20

classpath, JSWDK, A-3

classpath, Tomcat, A-4

config param descriptions, 9-10

config params, summary table, 9-7

map file name extensions, JServ, 9-6

map file name extensions, JSWDK, A-5

map file name extensions, Tomcat, A-5

map JSP file name extensions, A-4

optimization of execution, 4-19

setting parameters, JServ, 9-18

setting parameters, JSWDK, A-8

setting parameters, Tomcat, A-8

Web server and servlet environment, A-2

Web server classpath, A-2

connection caching, overview, 4-3

content type settings

dynamic (setContentType method), 8-4

static (page directive), 8-2

context-relative path, 1-9

custom tags--see tag libraries

---

D

d, ojspc option (binary output dir), 6-19

debugging

debug, ojspc option, 6-20

debug_mode config param, 9-12

emit_debuginfo config param, 9-13

through JDeveloper, 2-7

declarations

global declarations, globals.jsa, 9-37

member variables, 1-12

method variable vs. member variable, 4-11

deployment, general considerations

deploying pages with JDeveloper, 6-29

deployment of binary files only, 6-27

doc root, JServ, 6-29

general pre-translation without execution, 6-27

overview, 6-27

use of ojspc pre-translation tool, 6-13

developer_mode config param, 9-12

directives

global directives, globals.jsa, 9-36

include directive, 1-11

overview, 1-10

page directive, 1-10

taglib directive, 1-11

directory alias translation--see alias translation

doc root

for JServ, 6-29

functionality, 3-2

dynamic class reloading, 4-25

dynamic forward, special support for JServ, 9-20

dynamic include

action tag, 1-20

for large static content, 4-10

logistics, 4-7

special support for JServ, 9-20

vs. static include, 4-6

dynamic page reloading, 4-25

dynamic page retranslation, 4-24

---

E

emit_debuginfo config param, 9-13

error processing

at runtime, 3-16

send_error config param, 9-15

event handling

with globals.jsa, 9-31

with HttpSessionBindingListener, 3-10

with JspScopeListener, 5-2

exception object (implicit), 1-17

execution models for Oracle JSP, 2-14

execution of a JSP page, 1-7

explicit JSP objects, 1-15

expressions, 1-12

extend, ojspc option, 6-20

extensions

extended functionality for servlet 2.0, 2-5

overview of data-access JavaBeans, 2-12

overview of extended globalization support, 2-10

overview of extended types, 2-11

overview of globals.jsa (application support), 2-10

overview of JML tag library, 2-12

overview of JspScopeListener, 2-10

overview of Oracle-specific extensions, 2-9

overview of portable extensions, 2-11

overview of programmatic extensions, 2-9

overview of SQL tag library, 2-12

overview of SQLJ support, 2-9

overview of XML/XSL support, 2-11

external resource file

for static text, 4-10

through external_resource parameter, 9-13

through ojspc extres option, 6-21

external_resource config param, 9-13

extres, ojspc option, 6-21

---

F

fallback tag (with plugin tag), 1-23

Feiner, Amy (welcome), 1-3

file name extensions, mapping, A-4

files

generated by translator, 6-7

locations, ojspc d option, 6-19

locations, ojspc srcdir option, 6-23

locations, page_repository_root config param, 9-14

locations, translator output, 6-8

forward tag, 1-21

---

G

generated code, by translator, 6-2

generated output names, by translator, 6-3

getProperty tag, 1-19

globalization support

content type settings (dynamic), 8-4

content type settings (static), 8-2

multibyte parameter encoding, 8-5

overview, 8-1

sample depending on translate_params, 8-8

sample not depending on translate_params, 8-10

globals.jsa

application and session lifecycles, 9-28

application deployment, 9-27

application events, 9-31

distinct applications and sessions, 9-27

event handling, 9-31

example, declarations and directives, 9-38

extended support for servlet 2.0, 9-26

file contents, structure, 9-37

global declarations, 9-37

global JavaBeans, 9-37

global JSP directives, 9-36

overview of functionality, 9-26

overview of syntax and semantics, 9-28

sample application, application and session events, 9-42

sample application, application events, 9-39

sample application, global declarations, 9-45

sample applications, 9-39

session events, 9-33

---

H

HttpSessionBindingListener, 3-10

---

I

implement, ojspc option, 6-21

implicit JSP objects

overview, 1-15

using implicit objects, 1-17

include directive, 1-11

include tag, 1-20

inner class for static text, 6-3

interaction, JSP-servlet, 3-5

invoke servlet from JSP, JSP from servlet, 3-5

---

J

JavaBeans

global JavaBeans, globals.jsa, 9-37

use for separation of business logic, 1-5

use with useBean tag, 1-18

vs. scriptlets, 4-2

javaccmd config param, 9-13

JDBC in JSP pages

performance enhancements, 4-3

required files, 9-4

JDeveloper

Oracle JSP support, 2-7

use for deploying JSP pages, 6-29

JServ

Apache "mods", 2-4

classpath configuration, 9-4

config, map file name extensions, 9-6

mod_jserv module, 2-4

Oracle JSP application framework, 9-22

Oracle JSP dynamic include support, 9-20

overview of JSP-servlet session sharing, 9-23

overview of special considerations, 9-20

setting configuration parameters, 9-18

support for Oracle JSP, 2-8

JSP containers, overview, 1-7

jsp fallback tag (with plugin tag), 1-23

jsp forward tag, 1-21

jsp getProperty tag, 1-19

jsp include tag, 1-20

jsp param tag, 1-20

jsp plugin tag, 1-22

jsp setProperty tag, 1-18

JSP translator--see translator

jsp useBean tag, 1-18

JspScopeEvent class, event handling, 5-2

JspScopeListener, event handling, 5-2

JSP-servlet interaction

invoking JSP from servlet, request dispatcher, 3-6

invoking servlet from JSP, 3-5

passing data, JSP to servlet, 3-6

passing data, servlet to JSP, 3-8

sample code, 3-8

JSWDK

classpath configuration, A-3

config, map file name extensions, A-5

setting configuration parameters, A-8

support for Oracle JSP, 2-8

---

M

mapping JSP file name extensions, A-4

member variable declarations, 4-11

method variable declarations, 4-11

multibyte parameter encoding, globalization support, 8-5

---

N

National Language Support--see Globalization Support

NLS--see Globalization Support

noCompile, ojspc option, 6-21

---

O

objects and scopes (JSP objects), 1-14

ojspc pre-translation tool

command-line syntax, 6-17

general use, 6-13

option descriptions, 6-18

option summary table, 6-15

output files, locations, related options, 6-25

overview, 6-13

overview of functionality, 6-14

ojsp.jar, required file, 9-2

ojsputil.jar, optional file, 9-2

on-demand translation (runtime), 1-7, 2-14

optimization

not checking for retranslation, 4-19

not using HTTP session, 4-20

unbuffering a JSP page, 4-19

Oracle HTTP Server

role with Oracle JSP, 2-3

with mod_jserv, 2-4

Oracle JSP translator--see translator

out object (implicit), 1-17

output files

generated by translator, 6-7

locations, 6-8

locations and related options, ojspc, 6-25

ojspc d option (binary location), 6-19

ojspc srcdir option (source location), 6-23

page_repository_root config param, 9-14

output names, conventions, 6-3

---

P

package naming

by translator, 6-5

ojspc packageName option, 6-22

packageName, ojspc option, 6-22

page directive

characteristics, 4-13

contentType setting for globalization support, 8-2

overview, 1-10

page events (JspScopeListener), 5-2

page implementation class

generated code, 6-2

overview, 1-7

sample code, 6-9

page object (implicit), 1-16

page reloading, dynamic, 4-25

page retranslation, dynamic, 4-24

page scope (JSP objects), 1-15

page_repository_root config param, 9-14

pageContext object (implicit), 1-16

page-relative path, 1-9

param tag, 1-20

plugin tag, 1-22

portability of Oracle JSP, 2-5

prefetching rows--see row prefetching

pre-translation

general use of ojspc tool, 6-13

without execution, general, 6-27

---

R

reloading classes, dynamic, 4-25

reloading page, dynamic, 4-25

request dispatcher (JSP-servlet interaction), 3-6

request events (JspScopeListener), 5-2

request object (implicit), 1-16

request scope (JSP objects), 1-15

RequestDispatcher interface, 3-6

requesting a JSP page, 1-8

resource management

application (JspScopeListener), 5-2

overview of Oracle JSP extensions, 3-15

page (JspScopeListener), 5-2

request (JspScopeListener), 5-2

session (JspScopeListener), 5-2

standard session management, 3-10

response object (implicit), 1-16

retranslation of page, dynamic, 4-24

row prefetching, overview, 4-5

rowset caching, overview, 4-5

runtime considerations

dynamic class reloading, 4-25

dynamic page reloading, 4-25

dynamic page retranslation, 4-24

runtimeXX.zip, required file for SQLJ, 9-4

---

S

S, ojspc option (for SQLJ options), 6-22

sample applications

custom tag definition and use, 7-15

data access, starter sample, 3-19

globalization, depending on translate_params, 8-8

globalization, not depending on translate_params, 8-10

globals.jsa samples, 9-39

globals.jsa, application and session events, 9-42

globals.jsa, application events, 9-39

globals.jsa, global declarations, 9-45

HttpSessionBindingListener sample, 3-11

JSP-servlet interaction, 3-8

page implementation class code, 6-9

SQLJ example, 5-3

scopes (JSP objects), 1-15

scripting elements

comments, 1-14

declarations, 1-12

expressions, 1-12

overview, 1-12

scriptlets, 1-13

scripting variables (tag libraries)

defining, 7-8

scopes, 7-9

scriptlets

overview, 1-13

vs. JavaBeans, 4-2

send_error config param, 9-15

servlet 2.0 environments

added support through globals.jsa, 9-26

globals.jsa sample applications, 9-39

Oracle JSP application root functionality, 3-3

overview of Oracle JSP functionality, 2-5

servlet library, 9-3

servlet.jar

required file, 9-2

versions, 9-3

servlet-JSP interaction

invoking JSP from servlet, request dispatcher, 3-6

invoking servlet from JSP, 3-5

passing data, JSP to servlet, 3-6

passing data, servlet to JSP, 3-8

sample code, 3-8

servlets

session sharing, JSP, JServ, 9-23

wrapping servlet with JSP page, 9-20

session events

with globals.jsa, 9-33

with HttpSessionBindingListener, 3-10

with JspScopeListener, 5-2

session object (implicit), 1-16

session scope (JSP objects), 1-15

session sharing

overview, JSP-servlet, JServ, 9-23

session_sharing config param, 9-15

session support

default session requests, 3-4

overview, 3-4

through globals.jsa, 9-27

session_OnEnd tag, globals.jsa, 9-34

session_OnStart tag, globals.jsa, 9-33

session_sharing config param, 9-15

setContentType() method, globalization support, 8-4

setProperty tag, 1-18

setReqCharacterEncoding() method, multibyte parameter encoding, 8-5

source file location, ojspc srcdir option, 6-23

SQLJ

JSP code example, 5-3

ojspc S option for SQLJ options, 6-22

Oracle JSP support, 5-3

required files for use in JSP, 9-4

setting Oracle SQLJ options, 5-6

sqljcmd config param, 9-16

sqljsp files, 5-5

triggering SQLJ translator, 5-5

sqljcmd config param, 9-16

sqljsp files for SQLJ, 5-5

srcdir, ojspc option, 6-23

statement caching, overview, 4-4

static include

directive, 1-11

logistics, 4-6

vs. dynamic include, 4-6

static text

external resource file, 4-10

external resource, ojspc extres option, 6-21

external_resource parameter, 9-13

generated inner class, 6-3

workaround for large static content, 4-10

Sun Microsystems JSWDK--see JSWDK

syntax (overview), 1-10

---

T

tag handlers (tag libraries)

access to outer tag handlers, 7-10

overview, 7-4

sample tag handler class, 7-16

tags with bodies, 7-6

tags without bodies, 7-6

tag libraries

defining and using, end-to-end example, 7-15

overview, 1-23

overview of standard implementation, 7-2

runtime vs. compile-time implementations, 7-20

scripting variables, 7-7

standard framework, 7-2

strategy, when to create, 4-8

tag handlers, 7-4

tag library description files, 7-11

tag-extra-info classes, 7-7

taglib directive, 7-14

web.xml use, 7-12

tag library description files

defining shortcut URI in web.xml, 7-13

general features, 7-11

sample file, 7-18

tag-extra-info classes (tag libraries)

general use, getVariableInfo() method, 7-9

sample tag-extra-info class, 7-17

taglib directive

general use, 7-14

syntax, 1-11

use of full TLD name and location, 7-14

use of shortcut URI, 7-14

tips

avoid JSP use with binary data, 4-16

JavaBeans vs. scriptlets, 4-2

JSP page as servlet wrapper, 9-20

JSP preservation of white space, 4-14

key configuration issues, 4-19

method vs. member variable declaration, 4-11

page directive characteristics, 4-13

static vs. dynamic includes, 4-6

using a "checker" page, 4-9

when to create tag libraries, 4-8

workaround, large static content, 4-10

TLD file--see tag library description file

Tomcat

classpath configuration, A-4

config, map file name extensions, A-5

setting configuration parameters, A-8

support for Oracle JSP, 2-8

translate_params config param

code equivalent, 8-7

effect in overriding non-multibyte servlet containers, 8-7

general information, 9-17

globalization sample depending on it, 8-8

globalization sample not depending on it, 8-10

overview, multibyte parameter encoding, 8-6

translation

on-demand (runtime), 1-7

pre-translation without execution, 6-27

translator

generated class names, 6-5

generated code features, 6-2

generated files, 6-7

generated inner class, static text, 6-3

generated names, general conventions, 6-3

generated package names, 6-5

output file locations, 6-8

sample generated code, 6-9

translator.zip, required file for SQLJ, 9-4

types, overview of Oracle JSP type extensions, 2-11

---

U

unsafe_reload config param, 9-18

update batching, overview, 4-4

useBean tag, 1-18

---

V

verbose, ojspc option, 6-24

version, ojspc option, 6-24

---

W

web.xml, usage for tag libraries, 7-12

wrapping servlet with JSP page, 9-20

---

X

XML-alternative syntax, 4-17

xmlparserv2.jar, required file, 9-2

xsu12.jar or xsu111.jar, optional file, 9-2