WebGet 命令

在 Server.Load 脚本中用于从指定的 URL 中检索信息。

语法

Web 邮件负载 WEBGET 的用法:

WEBGET [-sumonly | -alldata]

{-url <urlname>   [-walk  <depth> <span>]    [-proxy <urlname>]   
[-mi | -mis  <msgsize> <numrecipients> [<nthIteration>] 
| -mir <numtoread> [<numtodel>] | -mp] }  | 
[ -holdtime <waitconn> <waitsend><waitrecv>]

iNotes® WEBGET 的工作负载的用法:

WEBGET [-sumonly | -alldata]

{ -url <urlname>   [-walk  <depth> <span>]    [-proxy <urlname>]   
[ -qp | -qi | -qt  | 
-qis <msgsize> <numrecipients> [<nthIteration>]  | 
-qir <numtoread> [<numtodel>] | 
-qca <msgsize> <duration> <mindaysaway> <maxdaysaway> [<nthIteration>] | 
-qci <msgsize> <duration> <mindaysaway> <maxdaysaway> <numrecipients>[<nthIteration>] | 
-qmr <num> [<nthIteration>] }  | 
[ -holdtime <waitconn> <waitsend><waitrecv>]

描述

[sumonly | alldata] 参数检索概要信息 (sumonly) 或实际数据,例如,指定 URL 的图像 (alldata)。概要信息使用 HTTP HEAD 命令检索;实际数据使用 HTTP GET 命令检索。要使 HTTP 服务器负载较轻时,概要方式很有用,因为概要信息通常少于 300 字节,而 HTML 文档或图像可以为任意大小。

[{-url <urlname> [-walk <depth> <span>] [-proxy <urlname>] } -[holdtime <ct> <st><waitrecv>] 

在从 URL(例如,-url www.ibm.com)中检索出 Web 内容以后,可以使用 -walk 开关遍历各个页面上的超链接。<depth> 参数表示对于给定页面以及所遍历的各个 HTML 文档要遍历的超链接的数量,并且递归地应用于该页面。<span> 参数表示对于给定链接来说,在返回初始请求页面以前可以遍历的页面的最大数量。

-walk 开关不会遍历先前已经遍历的链接(即不会选择“返回主页”链接);这可以防止出现无穷递归循环。-walk 命令也不会浏览指向其他 HTTP 服务器的链接(即不会选择位于 www.renovations.com 上指向 www.ibm.com 的链接),从而避免了无止境地浏览 HTTP 服务器。

-proxy 开关应当在指定的 URL 是外部站点(即必须通过指定的代理服务器访问的站点)时使用。

-holdtime 开关指定在完成 HTTP 事务之前 WebGet 将等待的时间。完成 HTTP 事务所需的事件序列为:建立到 HTTP 服务器的连接,将命令发送到 HTTP 服务器,从 HTTP 服务器接收数据。

<ct> 参数表示在将命令发送到 HTTP 服务器以后等待的时间(毫秒)。这可以有效地将分配用来服务于响应请求的 HTTP 服务器线程/进程保留在空闲状态下。<ct> 应该小于 HTTP 服务器的连接时间超时参数(通常为 2 分钟)。<st> 参数用于指定在将命令发送到 HTTP 服务器后所等待的时间。这可以有效地将提供服务的 HTTP 服务器线程/进程保留在空闲状态下,即使它可能已经准备好发送数据。<rt> 参数用于指定从 HTTP 服务器收到请求的数据后所等待的时间。

-mi 开关特别适用于 WebMail负载打开用户的 Web Mail 收件箱。

-mis <msgsize> <numrecipients> [<nthIteration>] 

-mis 开关特别适用于 Web Mail 负载发送邮件(msgsize = 邮件正文的大小),或者单词“profile”被用来随机选择邮件,并根据下列概要文件确定的大小选择附件:

1. 开关:-mis

正文大小

附件

常用(%)

500.00

10.00

10000.00

30.00

50000.00

40.00

50000.00

50000.00

10.00

150000.00

9.50

1000.00

10000000.00

0.50

<numrecipients> 参数等于邮件收件人的数量,可选参数 <nthiteration> 控制此命令实际执行的频率。例如,

  • 如果 nthiteration = 1,则总是执行此命令。
  • 如果 nthiteration = 2,则每隔一个循环执行一次此命令。
  • 如果 nthiteration = 6,则每 6 个循环执行一次此命令。

-mir <numtoread> [<numtodel>] 开关特别适用于 Web Mail 负载读取 Web 邮件。参数 numtoread 表示要读取的邮件数,可选参数 numtodel 表示要删除的邮件数。

-mp 开关特别适用于 WebMail 负载设置 Web 邮件数据库的所有者。

-qp 开关特别适用于 iNotes® 工作负载设置 iNotes® 数据库的所有者。

-qi 开关特别适用于 iNotes® 工作负载打开用户的 iNotes® 数据库(收件箱),无须读取任何文档。

-qt 开关特别适用于 iNotes® 工作负载确定该数据库使用的邮件模板。

-qis <msgsize> <numrecipients> [<nthIteration>] 开关特别适用于 iNotes® 工作负载发送邮件。参数 msgsize 等于邮件正文的大小,单词“profile”用来随机选择邮件和附件,附件的大小取决于下列概要文件:

2. 开关:-qis

正文大小

附件

常用(%)

500.00

10.00

10000.00

30.00

50000.00

40.00

50000.00

50000.00

10.00

150000.00

9.50

1000.00

10000000.00

0.50

numrecipients 参数等于邮件收件人的数量,可选参数 nthiteration 控制此命令实际执行的频率。例如,

  • 如果 nthiteration = 1,则总是执行此命令。
  • 如果 nthiteration = 2,则每隔一个循环执行一次此命令。
  • 如果 nthiteration = 6,则每 6 个循环执行一次此命令。

-qir <numtoread> [<numtodel>] [<numtoadd>] 开关专门用于 iNotes® 工作负载读取邮件。参数 <numtoread> 表示读取的邮件数量,可选参数 <numtodel> 表示删除的邮件数量。可选参数 <numtoadd> 表示添加到 $Inbox 的消息数量。

-qca <msgsize> <duration> <mindaysaway> <maxdaysaway> [<nthIteration>] 开关专门用于 iNotes® 工作负载创建日程表指定。参数 msgsize 等于约会正文的大小,参数 duration 等于以分钟为单位的约会长度,参数 mindaysaway 等于从今天起到预定约会为止的最小天数,参数 maxdaysaway 等于从今天起到预定约会的最大天数。可选参数 nthiteration 控制此命令的实际执行频率。

-qci <msgsize> <duration> <mindaysaway> <maxdaysaway> <numrecipients> [<nthIteration>] 开关专门用于 iNotes® 工作负载创建并发送邀请。参数 msgsize 等于邀请正文的大小,参数 duration 等于以分钟为单位的邀请长度,参数 mindaysaway 等于从今天起到预定邀请为止的最小天数,参数 maxdaysaway 等于从今天起到预定邀请的最大天数。可选参数 nthiteration 控制此命令的实际执行频率。

-qmr <num> [<nthIteration>] 开关专门用于 iNotes® 工作负载创建并发送收到的邀请的响应。参数 num 等于要创建的 RSVP 数量,即收到邀请等待处理的数量。可选参数 nthiteration 控制此命令的实际执行频率。

示例 1

从 Web 浏览器的角度,命令 [-url www.renovations.com -walk 2 1] 解释为:从 Web 页面 www.renovations.com 开始,在该页面上选择两个要单击的链接(如果该页面至少含有两个链接)。单击第一个选定的链接,返回到初始页面,然后单击第二个链接,并返回到初始页面。

示例 2

从 Web 浏览器的角度,命令 [-url www.renovations.com -walk 1 2] 解释为:从 Web 页面 www.renovations.com 开始,在该页面上选择一个要单击的链接。单击该链接,然后将同一规则递归地应用于每个新页面。假定所单击的第一个链接为 www.renovations.com/sales.htm,那么该规则将要求 WebGet 在该页面上找到一个链接并遍历它。span 参数表示该递归过程的停止位置。

另外,-walk 0 0 表示 WebGet 应当仅请求由 <urlname> 指示的页面,而不再请求其他页面。等效于省略 -walk 开关。或者,使用 -walk 10000 10000(或其他较大数字),表示您希望 WebGet 遍历该页面上每个可能的链接,这非常像一个网络机器人。