📄 oracle webserver
字号:
作者：孤独求败
日期：00-1-14 3:57:45
当Web Agent试图判断调用哪些过程，它将不能分辨二者并生成错误。
这个限制受HTML-表格数据类型较少的影响，但不会有明显的限制，PL/SQL类型VARCHAR2作为最大的PL/SQL数据类型，最大长度限制为32767字节。值在存储过程里被
显式地转换到NUMBER, DATE,或LONG。（使用TO_NUMBER或TO_DATE-LONG不需转换）。
存取CGI环境变量
Oracle Web Listener遵守通用网关接口（CGI）1.1说明书。因此，所有此说明书包含
的CGI环境变量Oracle Web Listener都将传递给Web Agent。Web Agent也让PL/SQL访
问所有的相关变量。
Web Agent有效的CGI环境变量见表3 - 2.
Variable 变量 Variable Meaning 变量意义
AUTH_TYPE Method used to validate user
校验用户的类型。
GATEWAY_INTERFACE The revision of the CGI specification to which the server complies
服务器兼容的CGI说明书的版本。
HTTP_USER_AGENT The browser the client is using to send the request
客户端用来发送请求的浏览器。
PATH_INFO Extra path information given by the client
客户端给出的额外的路径信息。
PATH_TRANSLATED Translated version of PATH_INFO provided by server for mapping. This consists of the document root concatenated to the PATH_INFO.
服务器提供的映射用的PATH_INFO的翻译版本。
REMOTE_HOST Hostname making the request if it can be determined
发出请求的主机名，如果它可以判断的话
REMOTE_ADDR IP address of the remote host making the request
发出请求的远程主机IP地址
REMOTE_USER Used to authenticate user
用于鉴别用户
REMOTE_IDENT Set to the remote username retrieved from the server
设置由服务器检索出的远程用户名
SERVER_PROTOCOL Name and revision of the information protocol used in the request
请求使用的信息协议的名称和版本
SERVER_SOFTWARE Name and version of information server software answering the request
回答请求的信息服务器软件的名称和版本。
SERVER_NAME The server's hostname, or IP address
主机名或IP地址
SERVER_PORT Port number on which the server is running
服务器所运行的端口
SCRIPT_NAME Virtual path to the script being executed, used for self-referencing URL
将执行脚本的虚拟路径，用于自引用URL。
表 3 - 2. CGI 环境变量
这些环境变量可在PL/SQL里用函数owa_util.get_cgi_env获得。参见,"The Oracle WebServer Developer's Toolkit".
Oracle Web Agent 错误处理
Oracle Web Agent处理的错误有两种：
application errors 应用错误
system errors 系统错误
应用错误
应用错误特指PL/SQL应用。程序员写的所有应用在生成相应输出的PL/SQL过程中应包
括他们的例外处理。
因为Oracle Web Agent不读HTML输出来判断它的内容，所以错误处理是透明的。Web
Agent 所关心的是是否PL/SQL生成HTML输出，操作是否成功。用户必须知道如何处理
PL/SQL过程的例外信息。
系统错误
系统错误是由Oracle Web Agent自己检测到的。这些错误当Web Agent不能启动PL/SQL
过程，或有存储过程未处理的PL/SQL例外，导致例外作为一个系统错误传播给Web
Agent时发生。这导致一个标准HTML错误文档被返给浏览器。
例如，如果Oracle Web gent不能连接到Oracle7服务器，PL/SQL过程不能运行，发生
一个系统错误。Web Agent有HTTP服务器返回一个缺省报错页面到浏览器，或者返回
一个用户化的HTML报错页面（如果在配置Web Agent服务时指定了OWA_ERR_PAGE
参数的话）。
Web Agent 如何知道生成什么报错页面
Web Agent检查OWA服务的配置的报错页面字段。如果在那里发现了值，Web Agent即
在文件系统中寻找指定的页面。如果发现，页面被返回到Web客户端。如果寻找失败，
缺省的报错信息被返回到Web客户端。
Creating Error Pages建立报错页面
Oracle WebServer允许管理员建立自定义的报错页面，用于一旦Web Agent遇到系统错误
就返回该页。自定义报错页面的目的是告诉用户采取什么动作。
当Web Agent遇到系统错误时，每个服务只能返回一个自定义报错页面。
用任何你喜欢的文本或HTML编辑器来建立自定义的HTML报错页面。
以下是一个用户自定义的系统错误的HTML报错页面的例子：
<HTML>
<HEAD>
<TITLE>ERROR</TITLE>
</HEAD>
<BODY>
<HR>
<H1>Your Request Failed</H1>
<HR>
Bob's Big Bulldozer Company could not process your request. Please try again later, or call us at 1-800-TRACTOR.
Thanks, Bob
</BODY>
</HTML>
自定义的HTML报错页面建立以后，Web Agent服务配置文件里的OWA error page项必须
反映新HTML报错页面的存储位置。使用Web Service管理页面来插入或更改OWA error
page项。
必须为自定义的HTML报错页面指定完全路径。如果未指定路径，Web Agent将在Web
Agent执行程序的目录下寻找。
详细信息见"建立和维护Web Agent 服务,", "Oracle WebServer管理工具"。
Error Log File 出错日志文件
Oracle Web Agent保留了一个由OWA服务名和该服务的OWA Log目录值定义的错误
日志文件。文件名为service_name.err。一旦Oracle Web Agent遇到一个错误，此文
件中便增加一项。此错误日志记录了所有相关信息，例如日期，错误号和URL。
记住，每个Web Agent服务只有一个错误日志。然而如果Web Agent不能得出服务的名
字，又未配置OWA_DEFAULT_SERVICE，则将错误写入缺省日志目录下的OWA.err文
件中。
下面是一个错误日志的例子，以及文件中每一行的相应的意义：
Wed Jun 28 08:14:27 1995 /*时间戳*/
OWS-05100: Agent : unable to connect due to Oracle error 1017
ORA-01017: invalid username/password; logon denied /*错误栈*/
OWA SERVICE: HR /*Web Agent Service*/
PROCEDURE: hrinfo.emp /*调用的PL/SQL过程*/
PARAMETERS: /*过程使用的参数*/
============
ENAME:
RayBorque
Oracle Web Agent 版本号
找出什么版本的Oracle Web Agent 安装在你的操作系统，可用以下过程：
在命令行输入: (仅UNIX)
$ORACLE_HOME/ows/bin/owa -v
命令将返回如下结果（你的结果可能不同）：
Oracle Web Agent Release 1.0.0.0.0
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -