本章描述组成Oracle WebServer工具箱的 超文本过程，超文本函数和实用程序。 |99cy?6<R  
　　 M(u@b{d  
　　Oracle Web Agent的主要目标之一就是PL/SQL程序员熟悉World Wide Web技术。 aO.6qKBs  
　　 }Te-> !<M  
　　从这一点，Oracle WebServer包括了由几个PL/SQL组成的开发包以以最小化程序员对HTML语法的要求。虽然程序员仍然要求有HTML的工作知识，但使用工具包，他们不需要在PL/SQL过程中写HTML标记实际语法的的硬编码。例如，程序员要求实现一个必要的锚，但他不需要知道生成一个锚的字符的实际序列。 wg^ 2&!#  
　　 { Un <n  
　　Oracle WebServer开发包包括下列PL/SQL包： PA"tMqz  
　　 6+[!Wo[L  
　　超文本过程 (HTP) sb)PS ;C  
　　一个超文本过程 在HTML文档中生成包含与其名字相对应的HTML标记的一行。例如，htp.anchor过程生成一个锚标记。HTP包是三者之中最常用的包。 超文本函数 (HTF) ,1)@i`]8  
　　 G)9uEV  
　　一个超文本函数返回与其名字相应的HTML标记。然而， 因为HTML标记不能通过Web Agent，所以不能直接调用HTF函数本身。HTF函数的输出必须通过htp.print，才能真正成为HTML文档的一部分。所以，下面一行： ")L lY  
　　　　　　　　　 htp.print(htf.italic(''Title'')); CTO[ VO$  
　　功能上等价于 ： npMK).a  
　　　　　　　　　 htp.italic(''Title''); p9zkoC4  
　　每个超文本函数(HTF)有一个相对应的超文本过程(HTP)。所以HTF函数通常仅用于编程时需要嵌套调用的情况，例如： &$ BEa_dfj  
　　　　　　　　　 htp.header(1,htf.italic(''Title'')); +(  2|D  
　　此例中，''htf.italic''将生成如下字符串： $:"&wAEE  
　　　　　　　　　 Title KaE6 %  
　　该字符串传给过程''htp.header''后，在格式化的HTML文档中将出现如下行： U3aW'FuL$  
　　　　　　　　　 l
$^sYd6
 
Title /`Ckn\[  
_s "en4X  
　　OWA Utilities (OWA_UTIL) OWA实用程序一个有用的实用过程和函数的集合。他们的目的包括从在HTML页上打印一个符号标记到简便地把Oracle表格式化为HTML格式。 },/<]bF]y  
　　　 (:^i48gT  
　　OWA OFTVKwCT  
　　一个仅供Oracle Web Agent自己调用的过程集合。此包中的任何子程序都不能在用户开发的PL/SQL中直接调用。 OS"xR ly  
　　 hhgF H  
　　4.1 安装Oracle WebServer开发者工具箱 "y,?r`I}Da  
　　 bdB+PNmn(  
　　开发者工具箱的安装，使用OWA服务管理表格。在服务建立和修改页面上均有是否安装开发者工具箱的检查框选择。选择它并提交表格将做如下事情： #vwG;!i  
　　 \DlH w  
　　将CONNECT和RESOURCE角色授权给OWA数据库用户。 zm N
35q  
　　 __ e'_g  
　　执行SQL脚本OWAINS.SQL，该文件可以在OWS管理目录下找到。若手动运行，应使用 SQL*DBA或Server Manager。若想在SQL*Plus里运行，看脚本头去找步骤。 ,A
[ :pF  
　　 2o0RF=-m  
　　脚本 OWAINS.SQL 将安装开发者工具箱的所有包。 fW2Q2>c  
　　　 ehL -z/q|  
　　优化多服务的安装 >XV *{)  
　　如果你的站点有多个Web Agent服务, 你可以按照下列步骤来最小化存储空间的占用量并增强PL/SQL的性能： >@
EG` 4=  
　　　 ,jopbVm  
　　1.在一个数据库用户的模式下安装开发者工具箱，这个用户就是工具箱的拥有者。 X*cCLb  
　　　 dc/w8aQB  
　　2.从其他Web Agent服务的OWA数据库用户的模式下删除工具箱的PL/SQL包，如果 ' [W#  
　　你已经安装了这些包的话。 *[l ? j  
　　connect / )'`[]K\`  
　　drop package HTF;　 A b)d]  
　　drop package HTP;　 g#m;_q:  
　　drop package OWA_UTIL;　 9N)E:R#g  
　　drop package OWA; DIe #L2y!*  
　　3. 向其他Web Agent服务的OWA数据库用户授与在这些PL/SQL包上的EXECUTE权限。 P f8^n*S7  
　　connect / (qK!%9F  
　　grant execute on HTF to ;　 J+r
t1  
　　grant execute on HTP to ;　 >i'Izyr  
　　grant execute on OWA_UTIL to ;　 [Z U)X 63  
　　grant execute on OWA to ; (,H#+X3Lm  
　　4. 在所有的OWA数据库用户中建立工具箱PL/SQL包的同义词。 u UodnM  
　　connect / q'VDO
04  
　　create synonym HTF for .HTF;　 Pg2W[}X  
　　create synonym HTP for .HTP;　 .w#V1zLU  
　　create synonym OWA_UTIL for .OWA_UTIL;　 d1}taQ  
　　create synonym OWA for .OWA; <DtS  
　　Security Note 安全要点 vZo'SL]s9  
　　PL/SQL 过程以PL/SQL代码的创建者的权限运行。对于Developer''s Toolkit, 这只关系到owa_util包. 两个子程序, showsource和tableprint,存取用户的数据。此包上的执行权限只能授给允许访问owa_util拥有者的表，视图和PL/SQL存储代码的拥护。 fN[pP(  
　　 {C4*?  
　　如果你的安装要考虑安全问题，为每个OWA数据库用户安装独立的owa_util包。 @{Gggl=  
　　 mSWp73U=;5  
　　作此事的脚本如下： ^-H F5p-  
　　 [umQCc,Fp  
　　PUBUTIL.SQL DO6*9\  
　　PRIVUTIL.SQL bx{(_gcqjo  
　　它们都在OWS管理目录下，应按所列的顺序执行。 <]0=(E~  
　　List Tags 列表标记 R cyI#y /  
　　List tags allow you to display information in any of the following ways: } h*K:xF]  
　　 Y$C`m  
　　ordered: these lists have numbered items 'dQFSCh|'  
　　unordered: these lists have bullets to mark each item !'m9l=  
　　definition: these lists alternate a term with its definition r!Cqmb>oU  
　　Note: All the hypertext procedures (HTP) shown in this section are also available as hypertext functions (HTF). ]p ?Ibw1  
　　 -OjW I/{  
　　htp.listHeader G+>Z#mZ8%q  
　　语法 htp.listHeader (ctext, cattributes); hZ%;wkD  
　　作用 Prints an HTML tag at the beginning of the list E\WqIT.xo:  
　　参数 ctext in varchar2 S%Jz>U3->  
　　cattributes in varchar2 DEFAULT NULL {i$P+td  
　　Generates ctext X3mjF{,}R%  
　　 Y _(1c  
　　htp.listItem .BF)]5d
I  
　　语法 htp.listItem (ctext, cclear, cdingbat, csrc, cattributes); eGU@2_(rE  
　　作用 Prints an HTML tag that formats a listed item. #(]~8.M  
　　参数 ctext in varchar2 DEFAULT NULL 4o[
]h"  
　　cclear in varchar2 DEFAULT NULL H&]f4C6p]  
　　cdingbat in varchar2 DEFAULT NULL Zx{(Tj._  
　　csrc in varchar2 DEFAULT NULL 0OR] h3!;w  
　　cattributes in varchar2 DEFAULT NULL ?iOe,erC  
　　Generates |ui+4mg|  
ctext =\b1JVy  
　　 IBwFrtNS  
　　htp.ulistOpen /o(v#@GMV  
　　语法 htp.ulistOpen (cclear, cwrap, cdingbat, csrc, cattributes); =4hiQpvTV  
　　作用 Prints an HTML tag that is used to open an unordered list that presents listed items separated by white space and marked off by bullets. 3oe@x-l  
　　参数 cclear in varchar2 DEFAULT NULL t6=x6s  
　　cwrap in varchar2 DEFAULT NULL  RsAch<  
　　cdingbat in varchar2 DEFAULT NULL pS|V
,,/=  
　　csrc in varchar2 DEFAULT NULL ($#U9 (  
　　cattributes in varchar2 DEFAULT NULL O6/LMx ku  
　　Generates 8:ncSa  
] H~ni G\  
　　 @?u: ;P+1  
　　htp.ulistClose pL1!||]{K  
　　语法 htp.ulistClose; JP=4I9._h  
　　作用 Prints an HTML tag that ends the unordered list. # M 6 rM^s  
　　参数 none B@I5#" x  
　　Generates TO bM.;NW  
n&,mxNRKm  
　　 `w0LK[ce0  
　　htp.olistOpen a_+%U$  
　　语法 htp.olistOpen (cclear, cwrap, cattributes); w|"6  
　　作用 Prints an HTML tag that is used to open an ordered list that presents listed items marked off with numbers. u~^F O  
　　参数 cclear in varchar2 DEFAULT NULL P9{5Y-  
　　cwrap in varchar2 DEFAULT NULL pN/:5N(/r  
　　cattributes in varchar2 DEFAULT NULL O>C7q]|  
　　Generates ,gh*m{1 0  
-1
+;8dr&  
　　 Dg;s,;8H  
　　htp.olistClose 4FsCa  
　　语法 htp.olistClose; C 6'` y  
　　作用 Prints an HTML tag that ends an ordered list. k(0=NqE  
　　参数 none Rr!*BS%  
　　Generates vV3u8 QA  
D}M ttr!  
　　 ;*RK/eo  
　　htp.dlistOpen 7CX4diJ  
　　语法 htp.dlistOpen (cclear, cattributes); M{ ?
[5]  
　　作用 Prints an HTML tag that starts a definition list $:#F 4\5  
　　参数 cclear in varchar2 DEFAULT NULL ;<G_6Cq.  
　　cattributes in varchar2 DEFAULT NULL @j=>D=Wfd  
　　Generates }yTW FA  
>[<;7k?>  
　　 JtoRwdc  
　　htp.dlistClose NGcD&AB-  
　　语法 htp.dlistClose 2:Or7 &&4  
　　作用 Prints an HTML tag that Ends a definition list `"!EU|E)(  
　　参数 none $}Vs%+]y  
　　Generates 3(z2QcCS&  
iHg
;kMR  
　　 iTaF8*-fq  
　　htp.dlistDef S29D_jNU  
　　语法 htp.dlistDef (ctext, cclear, cattributes); CdDac0x  
　　作用 Prints an HTML tag that is used to insert terms, and their corresponding definitions in an indented list format. The htp.dlistTerm must immediately follow this tag. 55(@/6*  
　　参数 ctext in varchar2 DEFAULT NULL h6 N'@
}g  
　　clear in varchar2 DEFAULT NULL $! cN\ys  
　　cattributes in varchar2 DEFAULT NULL IN%HE'  
　　Generates +U U<Enh(^  
ctext Cb#3=R>^~  
　　 'OM;v  
　　htp.dlistTerm *S#Vq-  
　　语法 htp.dlistTerm (ctext, cclear, cattributes); a5>%D/<Ud,  
　　作用 Prints an HTML tag used to insert the definition term inside the definition list. This tag must immediately follow the htp.dlistDef. ~dkg/r~'p_  
　　参数 ctext in varchar2 DEFAULT NULL #pYt
<CW  
　　cclear in varchar2 DEFAULT NULL Fw@-:Kp@|  
　　cattributes in varchar2 DEFAULT NULL ir g*n8{%  
　　Generates [fQ=-Y5l3C  
ctext , UqDK  
　　 7() Mu  
　　htp.menulistOpen YMa!}9<)  
　　语法 htp.menulistOpen; b%K>:   
　　作用 Prints an HTML tag that begins a list that presents one line per item, and appears more compact than an unordered list. The htp.listItem will follow this tag. %w(PwRD  
　　参数 none l` WjC.2q  
　　Generates gDW !\5(  
+{- >jf  
　　 _K]u wR  
　　htp.menulistClose J5nmX,`  
　　语法 htp.menulistClose; A19I3
=  
　　作用 Prints an HTML tag that ends a menu list. o\f/] hD  
　　Paramenters none
:7!5EH  
　　Generates O;U#4"gjf  
dw>%+   
　　 ~"vbtuO}}  
　　htp.dirlistOpen Dl1JBr  
　　语法 htp