web_plsql 0.5.1 → 0.6.0

package/README.md

@@ -15,141 +15,154 @@ Please feel free to try and suggest any improvements. Your thoughts and ideas ar
 # Release History
 See the [changelog](https://github.com/doberkofler/web_plsql/blob/master/CHANGELOG.md).
 
-# Installation
+# Prerequisites
+The connection to the Oracle Database uses the node-oracledb Driver for Oracle Database. 
+Please visit the [node-oracledb](https://node-oracledb.readthedocs.io/en/latest/index.html) documentation for more information.
 
-## Prerequisites
-There are several prerequisites needed to both compile and run the Oracle database driver.
-Please visit the [node-oracledb INSTALL.md](https://oracle.github.io/node-oracledb/INSTALL.html) page for more information.
-On where Oracle is looking for the client consult: https://oracle.github.io/node-oracledb/doc/api.html#oracleclientloading
-
-## Installing
+# Installing
 * Create and move to a new directory
-* Create a new npm project (`npm init`)
-* Install package (`npm install web_plsql`)
-* Install the PL/SQL examples (`sqlplus node_modules/web_plsql/examples/sql/install.sql`)
-* Start the sample server (`node node_modules/web_plsql/examples/sample`)
-* Invoke a browser and open the page `http://localhost:8000/base`
+* Create a new npm project (`npm i`)
+* Install package (`npm i --omit=dev web_plsql`)
+
+# Example
+* Change to the `examples/sql` directory, start SQLPLus, connect to the database as SYS specifying the SYSDBA roleInstall and install the sample schema `@examples/sql/install.sql`.
+* Start the sample server using `node examples/server_sample.js` after having set the ORACLE_SERVER environment variable to the database where you just installed the sample schema.
+* Invoke a browser and open the page `http://localhost/sample`.
+
+# Running
+There are 2 main options on how to use the mod_plsql Express middleware:
 
-# Configuration
+## Make a copy of the `server_sample.js` sample script and configure it accordingly to your needs.
+
+The the default server implemented in `src/server.js` and has the following configuration options:
+```
+/**
+ * @typedef {'basic' | 'debug'} errorStyleType
+ */
+export const z$errorStyleType = z.enum(['basic', 'debug']);
+
+/**
+ * @typedef {{alias: string, procedure: string}} pathAliasType
+ */
+
+/**
+ * @typedef {object} configStaticType
+ * @property {string} route - The Static route path.
+ * @property {string} directoryPath - The Static directory.
+ */
+
+/**
+ * @typedef {object} configPlSqlType
+ * @property {string} route - The PL/SQL route path.
+ * @property {string} user - The Oracle username.
+ * @property {string} password - The Oracle password.
+ * @property {string} connectString - The Oracle connect string.
+ * @property {string} defaultPage - The default page.
+ * @property {pathAliasType} [pathAlias] - The path alias.
+ * @property {string} documentTable - The document table.
+ */
+
+/**
+ * @typedef {object} configType
+ * @property {number} port - The server port number.
+ * @property {configStaticType[]} routeStatic - The static routes.
+ * @property {configPlSqlType[]} routePlSql - The PL/SQL routes.
+ * @property {errorStyleType} errorStyle - The error style.
+ * @property {string} loggerFilename - name of the request logger filename or '' if not required.
+ * @property {boolean} monitorConsole - Enable console status monitor.
+ */
+```
 
-## How does a mod_plsql DAD configuration compare to the web_plsql app
+The following mod_plsql DAD configuration translates to the configuration options as follows:
 
+**DAD**
 ```
 <Location /pls/sample>
-  SetHandler                    pls_handler
-  Order                         deny,allow
-  Allow                         from all
-  PlsqlDatabaseUsername         sample
-  PlsqlDatabasePassword         sample
-  PlsqlDatabaseConnectString    ORCL
-  PlsqlAuthenticationMode       Basic
-  PlsqlDefaultPage              sample.pageindex
-  PlsqlDocumentTablename        doctable
-  PlsqlErrorStyle               DebugStyle
-  PlsqlNlsLanguage              AMERICAN_AMERICA.UTF8
+  SetHandler                     pls_handler
+  Order                          deny,allow
+  Allow                          from all
+  PlsqlDatabaseUsername          sample
+  PlsqlDatabasePassword          sample
+  PlsqlDatabaseConnectString     localhost:1521/ORCL
+  PlsqlDefaultPage               sample_pkg.pageIndex
+  PlsqlDocumentTablename         doctable
+  PlsqlPathAlias                 myalias
+  PlsqlPathAliasProcedure        sample_pkg.page_path_alias
+  PlsqlExclusionList             sample_pkg.page_exclusion_list
+  PlsqlRequestValidationFunction sample_pkg.request_validation_function
+  PlsqlErrorStyle                DebugStyle
+  PlsqlNlsLanguage               AMERICAN_AMERICA.UTF8
 </Location>
 ```
 
-```javascript
-const fs = require('fs');
-const path = require('path');
-const express = require('express');
-const bodyParser = require('body-parser');
-const multipart = require('connect-multiparty');
-const cookieParser = require('cookie-parser');
-const compression = require('compression');
-const morgan = require('morgan');
-
-const oracledb = require('oracledb');
-const webplsql = require('../lib');
-
-/*
-*	Allocate the Oracle database pool
-*/
-
-const databasePool = oracledb.createPool({
-	user: 'sample',
-	password: 'sample',
-	connectString: 'ORCL',
-	poolMin: 10,
-	poolMax: 1000,
-	poolIncrement: 10,
-	queueRequests: false,
-	queueTimeout: 1000
-});
-
-databasePool.catch(e => {
-	console.error(`Unable to create database pool.\n${e.message}`);
-	process.exit(1);
-});
-
-/*
-*	Start the server
-*/
-
-const PORT = 8000;
-const PATH = '/pls/sample';
-const OPTIONS = {
-	defaultPage: 'sample.pageIndex',
-  doctable: 'docTable',
-  errorStyle: 'debug'
-};
-
-// create express app
-const app = express();
-
-// add middleware
-app.use(multipart());
-app.use(bodyParser.json());
-app.use(bodyParser.urlencoded({extended: true}));
-app.use(cookieParser());
-app.use(compression());
-app.use(morgan('combined', {stream: fs.createWriteStream(path.join(process.cwd(), 'access.log'), {flags: 'a'})}));
-
-// add the oracle pl/sql express middleware
-app.use(PATH + '/:name?', webplsql(databasePool, OPTIONS));
-
-// serving static files
-app.use('/static', express.static(path.join(process.cwd(), 'examples/static')));
-
-// listen on port
-console.log(`Waiting on http://localhost:${PORT}${PATH}`);
-app.listen(PORT);
+**mod_plsql**
+```
+{
+	port: 80,
+	routeStatic: [
+		{
+			route: '/static',
+			directoryPath: 'examples/static',
+		},
+	],
+	routePlSql: [
+		{
+			route: '/sample',
+			user: 'sample', // PlsqlDatabaseUserName
+			password: 'sample', // PlsqlDatabasePassword
+			connectString: 'localhost:1521/ORCL', // PlsqlDatabaseConnectString
+			defaultPage: 'sample_pkg.page_index', // PlsqlDefaultPage
+			documentTable: 'doctable', // PlsqlDocumentTablename
+			exclusionList: ['sample_pkg.page_exclusion_list'], // PlsqlExclusionList
+			requestValidationFunction: 'sample_pkg.request_validation_function', // PlsqlRequestValidationFunction
+			pathAlias: 'myalias', // PlsqlPathAlias
+			pathAliasProcedure: 'sample_pkg.page_path_alias', // PlsqlPathAliasProcedure
+			errorStyle: 'debug', // PlsqlErrorStyle
+		},
+	],
+	loggerFilename: 'access.log', // PlsqlLogEnable and PlsqlLogDirectory
+	monitorConsole: false,
+}
 ```
 
-# Missing features
-
-## Supported mod_plsql configuration options:
-- PlsqlDatabaseConnectString -> specified when creating the oracledb connection pool
-- PlsqlDatabaseUserName -> specified when creating the oracledb connection pool
-- PlsqlDatabasePassword -> specified when creating the oracledb connection pool
-- PlsqlDefaultPage -> use the "doctable" configuration option
-- PlsqlDocumentTablename -> use the "defaultPage" configuration option
-- PlsqlErrorStyle -> use the "errorStyle" configuration option
-- PlsqlLogEnable -> use a HTTP request logger middleware for node.js like morgan
-- PlsqlLogDirectory -> use a HTTP request logger middleware for node.js like morgan
-- PlsqlPathAlias -> use the "pathAlias.alias" configuration option
-- PlsqlPathAliasProcedure -> use the "pathAlias.procedure" configuration option
-
-## Features in mod_plsql that are planned t be available in web_plsql:
-- PlsqlDocumentPath
-- PlsqlDocumentProcedure
-- PlsqlExclusionList
-- PlsqlRequestValidationFunction
-- Support for APEX 5.
+## Create a custom Express application based on the default server implemented in `src/server.js`.
+
+...
+
+# Configuration options
+
+## Supported mod_plsql configuration options
+- PlsqlDatabaseConnectString
+- PlsqlDatabaseUserName
+- PlsqlDatabasePassword
+- PlsqlDefaultPage
+- PlsqlDocumentTablename
+- PlsqlErrorStyle
+- PlsqlLogEnable
+- PlsqlLogDirectory
+- PlsqlPathAlias
+- PlsqlPathAliasProcedure
 - Default exclusion list.
+- PlsqlRequestValidationFunction
+- PlsqlExclusionList
 - Basic and custom authentication methods, based on the OWA_SEC package and custom packages.
 
+## Features that are planned to be available in web_plsql
+- Support for APEX 5 or greater.
+
 ## Configuration options that will not be supported:
-- PlsqlIdleSessionCleanupInterval
+- PlsqlDocumentProcedure
 - PlsqlAfterProcedure
 - PlsqlAlwaysDescribeProcedure
 - PlsqlBeforeProcedure
 - PlsqlCGIEnvironmentList
+- PlsqlDocumentPath
+- PlsqlIdleSessionCleanupInterval
 - PlsqlSessionCookieName
 - PlsqlSessionStateManagement
 - PlsqlTransferMode
 
+
 # License
 
 [MIT](LICENSE)

package/examples/server_apex.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+
+import {startServer} from '../src/index.js';
+
+void startServer({
+	port: 80,
+	routeStatic: [
+		{
+			route: '/i/',
+			directoryPath: 'apex/images',
+		},
+	],
+	routePlSql: [
+		{
+			route: '/apex',
+			user: 'APEX_PUBLIC_USER',
+			password: 'secret',
+			connectString: process.env.ORACLE_SERVER ?? '',
+			defaultPage: 'apex',
+			pathAlias: 'r',
+			pathAliasProcedure: 'wwv_flow.resolve_friendly_url',
+			documentTable: 'wwv_flow_file_objects$',
+			errorStyle: 'debug',
+		},
+	],
+	loggerFilename: 'access.log',
+	monitorConsole: false,
+});

package/examples/server_sample.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+
+import {startServer} from '../src/index.js';
+
+void startServer({
+	port: 80,
+	routeStatic: [
+		{
+			route: '/static',
+			directoryPath: 'examples/static',
+		},
+	],
+	routePlSql: [
+		{
+			route: '/sample',
+			user: 'sample', // PlsqlDatabaseUserName
+			password: 'sample', // PlsqlDatabasePassword
+			connectString: process.env.ORACLE_SERVER ?? '', // PlsqlDatabaseConnectString
+			defaultPage: 'sample_pkg.page_index', // PlsqlDefaultPage
+			documentTable: 'doctable', // PlsqlDocumentTablename
+			exclusionList: ['sample_pkg.page_exclusion_list'], // PlsqlExclusionList
+			requestValidationFunction: 'sample_pkg.request_validation_function', // PlsqlRequestValidationFunction
+			pathAlias: 'myalias', // PlsqlPathAlias
+			pathAliasProcedure: 'sample_pkg.page_path_alias', // PlsqlPathAliasProcedure
+			errorStyle: 'debug', // PlsqlErrorStyle
+		},
+	],
+	loggerFilename: 'access.log', // PlsqlLogEnable and PlsqlLogDirectory
+	monitorConsole: false,
+});

package/examples/sql/{doc_table.sql → doctable.sql}

@@ -2,7 +2,7 @@ DROP TABLE docTable;
 
 CREATE TABLE docTable
 (
-	NAME			VARCHAR(128) UNIQUE NOT NULL,
+	NAME			VARCHAR(128) PRIMARY KEY,
 	MIME_TYPE		VARCHAR(128),
 	DOC_SIZE		NUMBER,
 	DAD_CHARSET		VARCHAR(128),

package/examples/sql/install.sql

@@ -1,3 +1,5 @@
+set echo on termout on
+
 -- set the username
 define SAMPLE_USER=sample
 
@@ -12,20 +14,15 @@ GRANT create view TO &&SAMPLE_USER;
 GRANT create sequence TO &&SAMPLE_USER;
 GRANT create procedure TO &&SAMPLE_USER;
 GRANT execute on dbms_lob TO &&SAMPLE_USER;
-GRANT execute on dbms_output TO &&SAMPLE_USER;
-GRANT execute on dbms_lock TO &&SAMPLE_USER;
 
 -- change schema
 ALTER SESSION SET CURRENT_SCHEMA=&&SAMPLE_USER;
 
 -- install document table
-@doc_table.sql
+@doctable.sql
 
--- install demo
-@sample.pks
+-- install package
+@sample_package.sql
 show errors
-@sample.pkb
+@sample_package_body.sql
 show errors
-
--- show errors
-select * from user_errors;

package/examples/sql/sample_package.sql

@@ -0,0 +1,27 @@
+CREATE OR REPLACE
+PACKAGE sample_pkg IS
+
+TYPE vc_arr IS TABLE OF VARCHAR2(2000) INDEX BY BINARY_INTEGER;
+
+FUNCTION emptyArray RETURN vc_arr;
+
+PROCEDURE page_index(p IN VARCHAR2 DEFAULT NULL);
+PROCEDURE pag_simple(text IN VARCHAR2 DEFAULT NULL);
+PROCEDURE page_flexible(name_array IN owa.vc_arr, value_array IN owa.vc_arr);
+PROCEDURE page_array(text IN vc_arr);
+PROCEDURE page_cgi;
+PROCEDURE page_cookie;
+PROCEDURE page_form;
+PROCEDURE page_form_process(firstname IN VARCHAR2 DEFAULT NULL, lastname IN VARCHAR2 DEFAULT NULL, age IN VARCHAR2 DEFAULT NULL, sex IN VARCHAR2 DEFAULT NULL, vehicle IN vc_arr  DEFAULT emptyArray);
+PROCEDURE page_file_upload;
+PROCEDURE page_file_uploaded(name_array IN owa.vc_arr, value_array IN owa.vc_arr);
+PROCEDURE page_redirect;
+PROCEDURE page_location;
+PROCEDURE page_other;
+PROCEDURE page_path_alias(p_path IN VARCHAR2);
+PROCEDURE page_exclusion_list;
+PROCEDURE page_request_validation_function;
+FUNCTION request_validation_function(p_proc_name IN VARCHAR2) RETURN BOOLEAN;
+
+END sample_pkg;
+/

package/examples/sql/sample_package_body.sql

@@ -0,0 +1,245 @@
+CREATE OR REPLACE
+PACKAGE BODY sample_pkg IS
+
+PROCEDURE open_page(title IN VARCHAR2);
+PROCEDURE close_page;
+
+FUNCTION emptyArray RETURN vc_arr
+IS
+	arr vc_arr;
+BEGIN
+	RETURN arr;
+END emptyArray;
+
+PROCEDURE page_index(p IN VARCHAR2 DEFAULT NULL)
+IS
+BEGIN
+	open_page('web_plsql - Index Page');
+	htp.p('<ul>');
+	htp.p('<li><a href="sample_pkg.pag_simple?text=some-text">Simple page</a></li>');
+	htp.p('<li><a href="sample_pkg.page_array?text=some-text'||CHR(38)||'text=more-text'||CHR(38)||'text=last-text">Array passing</a></li>');
+	htp.p('<li><a href="!sample_pkg.page_flexible?p1=v1'||CHR(38)||'p2=v2'||CHR(38)||'p3=v3.1'||CHR(38)||'p3=v3.2"">Flexible parameter passing</a></li>');
+	htp.p('<li><a href="sample_pkg.page_cgi">CGI</a></li>');
+	htp.p('<li><a href="sample_pkg.page_cookie">Cookies</a></li>');
+	htp.p('<li><a href="sample_pkg.page_form">Form</a></li>');
+	htp.p('<li><a href="sample_pkg.page_file_upload">File upload</a></li>');
+	htp.p('<li><a href="sample_pkg.page_redirect">Redirect</a></li>');
+	htp.p('<li><a href="sample_pkg.page_location">Change location</a></li>');
+	htp.p('<li><a href="myalias">pathAlias configuration setting</a></li>');
+	htp.p('<li><a href="sample_pkg.page_exclusion_list">Custom exclusion list</a></li>');
+	htp.p('<li><a href="sample_pkg.page_request_validation_function">Request validation function</a></li>');
+	htp.p('</ul>');
+	close_page();
+END page_index;
+
+PROCEDURE pag_simple(text IN VARCHAR2 DEFAULT NULL)
+IS
+BEGIN
+	open_page('web_plsql - Simple page');
+	htp.p('<p>'||text||'</p>');
+	close_page();
+END pag_simple;
+
+PROCEDURE page_array(text IN vc_arr)
+IS
+BEGIN
+	open_page('web_plsql - Array parameter passing');
+	htp.p('<table>');
+	htp.p('<tr><th>value</th></tr>');
+	FOR i IN 1 .. text.COUNT LOOP
+		htp.p('<tr><td>'||text(i)||'</td></tr>');
+	END LOOP;
+	htp.p('</table>');
+	close_page();
+END page_array;
+
+PROCEDURE page_flexible(name_array IN owa.vc_arr, value_array IN owa.vc_arr)
+IS
+BEGIN
+	open_page('web_plsql - Flexible parameter passing');
+	htp.p('<table>');
+	htp.p('<tr><th>name</th><th>value</th></tr>');
+	FOR i IN 1 .. name_array.COUNT LOOP
+		htp.p('<tr><td>'||name_array(i)||'</td><td>'||value_array(i)||'</td></tr>');
+	END LOOP;
+	htp.p('</table>');
+	close_page();
+END page_flexible;
+
+PROCEDURE page_cgi
+IS
+BEGIN
+	open_page('web_plsql - CGI');
+	htp.p('<table>');
+	htp.p('<tr><th>name</th><th>value</th></tr>');
+	FOR i IN 1 .. owa.num_cgi_vars LOOP
+		htp.p('<tr><td>'||owa.cgi_var_name(i)||'</td><td>'||owa.cgi_var_val(i)||'</td></tr>');
+	END LOOP;
+	htp.p('</table>');
+	close_page();
+END page_cgi;
+
+PROCEDURE page_cookie
+IS
+	names		owa_cookie.vc_arr;
+	vals		owa_cookie.vc_arr;
+	num_vals	INTEGER;
+BEGIN
+	owa_cookie.get_all(names=>names, vals=>vals, num_vals=>num_vals);
+
+	owa_util.mime_header('text/html', FALSE);
+	owa_cookie.send('demoCookie', TO_CHAR(SYSDATE, 'YYYY.MM.DD HH24:MI:SS'));
+	owa_util.http_header_close;
+
+	open_page('web_plsql - Cookies');
+	htp.p('<table>');
+	htp.p('<tr><th>name</th><th>value</th></tr>');
+	FOR i IN 1 .. num_vals LOOP
+		htp.p('<tr><td>'||names(i)||'</td><td>'||vals(i)||'</td></tr>');
+	END LOOP;
+	htp.p('</table>');
+	close_page();
+END page_cookie;
+
+PROCEDURE page_form
+IS
+BEGIN
+	open_page('web_plsql - Form');
+	htp.p('<form method="POST" action="sample_pkg.page_form_process">');
+	htp.p('<table>');
+	htp.p('<tr><td>First name:</td><td><input type="text" name="firstname"></td></tr>');
+	htp.p('<tr><td>Last name:</td><td><input type="text" name="lastname"></td></tr>');
+	htp.p('<tr><td>Age:</td><td><input type="text" name="age"></td></tr>');
+	htp.p('<tr><td colspan="2"><input type="radio" name="sex" value="male">Male</td></tr>');
+	htp.p('<tr><td colspan="2"><input type="radio" name="sex" value="female">Female</td></tr>');
+	htp.p('<tr><td colspan="2"><input type="checkbox" name="vehicle" value="Bike">I have a bike</td></tr>');
+	htp.p('<tr><td colspan="2"><input type="checkbox" name="vehicle" value="Car">I have a car </td></tr>');
+	htp.p('<tr><td colspan="2"><input type="submit" value="Submit"></td></tr>');
+	htp.p('</table>');
+	htp.p('</form>');
+	close_page();
+END page_form;
+
+PROCEDURE page_form_process(firstname IN VARCHAR2 DEFAULT NULL, lastname IN VARCHAR2 DEFAULT NULL, age IN VARCHAR2 DEFAULT NULL, sex IN VARCHAR2 DEFAULT NULL, vehicle IN vc_arr  DEFAULT emptyArray)
+IS
+	PROCEDURE line(name IN VARCHAR2, value IN VARCHAR2)
+	IS
+	BEGIN
+		htp.p('<tr><th>'||name||'</th><td>'||value||'</td></tr>');
+	END line;
+BEGIN
+	open_page('web_plsql - Form processed');
+	htp.p('<table>');
+	line('firstname', firstname);
+	line('lastname', lastname);
+	line('age', age);
+	line('sex', sex);
+	FOR i IN 1 .. vehicle.COUNT LOOP
+		line('vehicle '||i, vehicle(i));
+	END LOOP;
+	htp.p('</table>');
+	close_page();
+END page_form_process;
+
+PROCEDURE page_file_upload
+IS
+BEGIN
+	open_page('web_plsql - File upload');
+	htp.p('<form enctype="multipart/form-data" method="POST" action="!sample_pkg.page_file_uploaded">');
+	htp.p('<p>File 1: <input type="file" name="file1" /></p>');
+	htp.p('<p>File 2: <input type="file" name="file2" /></p>');
+	htp.p('<p>File 3: <input type="file" name="file3" /></p>');
+	htp.p('<p><input type="submit" name="submit" value"Upload" /></p>');
+	htp.p('</form>');
+	close_page();
+END page_file_upload;
+
+PROCEDURE page_file_uploaded(name_array IN owa.vc_arr, value_array IN owa.vc_arr)
+IS
+BEGIN
+	open_page('web_plsql - File uploaded');
+	htp.p('<table>');
+	htp.p('<tr><th>name</th><th>value</th></tr>');
+	FOR i IN 1 .. name_array.COUNT LOOP
+		htp.p('<tr><td>'||name_array(i)||'</td><td>'||value_array(i)||'</td></tr>');
+	END LOOP;
+	htp.p('</table>');
+	close_page();
+END page_file_uploaded;
+
+PROCEDURE page_redirect
+IS
+BEGIN
+	owa_util.mime_header('text/html', FALSE);
+	owa_cookie.send('fromPage', 'sample_pkg.page_redirect');
+	owa_util.redirect_url(curl=>'sample_pkg.page_other', bclose_header=>FALSE);
+	owa_util.http_header_close;
+END page_redirect;
+
+PROCEDURE page_location
+IS
+BEGIN
+	open_page('web_plsql - page_location');
+	htp.p('<script>self.top.location.replace("sample_pkg.page_other");</script>');
+	close_page();
+END page_location;
+
+PROCEDURE page_other
+IS
+BEGIN
+	open_page('web_plsql - Other page');
+	close_page();
+END page_other;
+
+PROCEDURE page_path_alias(p_path IN VARCHAR2)
+IS
+BEGIN
+	open_page('web_plsql - pathAlias page');
+	htp.p('<p>p_path: "'||p_path||'"</p>');
+	close_page();
+END page_path_alias;
+
+PROCEDURE page_exclusion_list
+IS
+BEGIN
+	open_page('web_plsql - page_exclusion_list');
+	close_page();
+END page_exclusion_list;
+
+PROCEDURE page_request_validation_function
+IS
+BEGIN
+	open_page('web_plsql - page_request_validation_function');
+	close_page();
+END page_request_validation_function;
+
+FUNCTION request_validation_function(p_proc_name IN VARCHAR2) RETURN BOOLEAN
+IS
+BEGIN
+	RETURN LOWER(p_proc_name) != 'sample_pkg.page_request_validation_function';
+END request_validation_function;
+
+PROCEDURE open_page(title IN VARCHAR2)
+IS
+BEGIN
+	htp.p('<!DOCTYPE html>');
+	htp.p('<html>');
+	htp.p('<head>');
+	htp.p('<title>'||title||'</title>');
+	htp.p('<meta charset="utf-8">');
+	htp.p('<link rel="stylesheet" type="text/css" href="/static/sample.css" />');
+	htp.p('</head>');
+	htp.p('<body>');
+	htp.p('<h1>'||title||'</h1>');
+	htp.p('<p><a href="sample_pkg.page_index">Menu</a></p>');
+END open_page;
+
+PROCEDURE close_page
+IS
+BEGIN
+	htp.p('</body>');
+	htp.p('</html>');
+END close_page;
+
+END sample_pkg;
+/

package/examples/static/sample.css

@@ -3,23 +3,24 @@ body {
 }
 
 table {
-    color: #333;
-    width: 640px;
-    border-collapse:
-    collapse; border-spacing: 0;
+	color: #333;
+	width: 640px;
+	border-collapse: collapse;
+	border-spacing: 0;
 }
 
-td, th {
-	border: 1px solid #CCC;
+td,
+th {
+	border: 1px solid #ccc;
 	height: 30px;
 }
 
 th {
-	background: #F3F3F3;
-    font-weight: bold;
+	background: #f3f3f3;
+	font-weight: bold;
 }
 
 td {
-    background: #FAFAFA;
-    text-align: center;
+	background: #fafafa;
+	text-align: center;
 }