Contents Home Previous Next

 

Oracle Web Agent 错误处理 

Oracle Web Agent处理的错误有两种: 应用错误 

应用错误特指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

Contents Home Previous Next