Preface

Oracle Application Server 10g MapViewer User's Guide describes how to install and use MapViewer, a tool that renders maps showing different kinds of spatial data.

This preface contains these topics:

• Audience

• Documentation Accessibility

• Organization

• Related Documentation

• Conventions

Audience

This document is intended primarily for programmers who develop applications that require maps to be drawn. You should understand Oracle database concepts and the major concepts associated with XML, including DTDs. You should also be familiar with Oracle Spatial or Oracle Locator concepts, or at least have access to Oracle Spatial User's Guide and Reference.

This document is not intended for end users of Web sites or client applications.

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle Corporation is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/

Accessibility of Code Examples in Documentation

JAWS, a Windows screen reader, may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle Corporation does not own or control. Oracle Corporation neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Organization

This guide contains the following elements:

Chapter 1, "Introduction to MapViewer"

Explains what MapViewer is, and how to install and configure it.

Chapter 2, "MapViewer Concepts"

Explains important concepts that you must understand to use MapViewer.

Chapter 3, "MapViewer Map Requests"

Explains how to submit XML requests to MapViewer, and it describes the XML document type definitions (DTDs) for the requests (input) and responses (output).

Chapter 4, "MapViewer JavaBean-Based API"

Explains how to use the JavaBean-based MapViewer API, which exposes all capabilities of MapViewer through a single JavaBean.

Chapter 5, "MapViewer JSP Tag Library"

Explains how to submit requests to MapViewer using JavaServer Pages (JSP) tags in an HTML file.

Chapter 6, "MapViewer Administrative Requests"

Explains how to submit various administrative (non-map) requests, such as to add a data source, through the MapViewer XML API.

Chapter 7, "Map Definition Tool"

Explains the console (Map Definition Tool) interface to MapViewer, which you can use to manage mapping metadata (styles, themes, and maps) used by MapViewer.

Appendix A, "XML Format for Styles, Themes, and Base Maps"

Explains the XML format for defining each type of style. (This is intended only for advanced users of MapViewer.)

Appendix B, "Creating and Registering a Custom Image Renderer"

Explains how to implement and register a custom image renderer for use with an image theme.

Appendix C, "Using the Flash Mapping Client"

Explains how to use the Macromedia Flash mapping client to allow users of Flash applications to interact with maps.

Appendix D, "Connection Pools and Java Object Cache in MapViewer"

Describes how MapViewer uses Java Database Connectivity (JDBC) connection pooling and caching of Java objects to provide efficient performance.

Related Documentation

For more information, see the following documents in the Oracle Database documentation set:

• Oracle Spatial User's Guide and Reference

• Oracle9i Database Concepts

Printed documentation is available for sale in the Oracle Store at

http://oraclestore.oracle.com/

To download free release notes, installation documentation, white papers, or other collateral, please visit the Oracle Technology Network (OTN). You must register online before using OTN; registration is free and can be done at

http://otn.oracle.com/membership

If you already have a username and password for OTN, then you can go directly to the documentation section of the OTN Web site at

http://otn.oracle.com/documentation

Conventions

In examples, an implied carriage return occurs at the end of each line, unless otherwise noted. You must press the Return key at the end of a line of input.

The following conventions are also used in this manual:

Convention	Meaning
. . .	Vertical ellipsis points in an example mean that information not directly related to the example has been omitted.
. . .	Horizontal ellipsis points in statements or commands mean that parts of the statement or command not directly related to the example have been omitted.
boldface	Boldface type indicates a term defined in the text.
italic	Italic type is used for book titles, emphasis, and some special terms.
monospace	Monospace type is used for the names of parameters, elements, attributes, styles, themes, files, and directory paths. It is also used for code examples.
monospace italic	Monospace italic type is used to represent placeholders as variables.
< >	Angle brackets enclose user-supplied names.
[ ]	Brackets enclose optional clauses from which you can choose one or none.