雷林鵬分享：Ruby CGI方法

　　Ruby CGI方法

　　如下爲CGI類的方法列表：

　　序號方法描述

　　1CGI::new([ level="query"])

　　建立 CGI 對象。query能夠是如下值:

　　query: 沒有 HTML 生成輸出

　　html3: HTML3.2

　　html4: HTML4.0 Strict

　　html4Tr: HTML4.0 Transitional

　　html4Fr: HTML4.0 Frameset

　　2CGI::escape( str)

　　使用 URL 編碼來轉義字符串

　　3CGI::unescape( str)

　　對經過 escape() 編碼的字符串進行解碼。

　　4CGI::escapeHTML( str)

　　編碼 HTML 特殊字符, 包括: & < >。

　　5CGI::unescapeHTML( str)

　　解碼 HTML 特殊字符, 包括: & < >。

　　6CGI::escapeElement( str[, element...])

　　在指定的 HTML 元素中編碼 HTML 特殊字符。

　　7CGI::unescapeElement( str, element[, element...])

　　在指定的 HTML 元素中解碼 HTML 特殊字符。

　　8CGI::parse( query)

　　解析查詢字符串，並返回包含哈希的 鍵=》值 對。

　　9CGI::pretty( string[, leader=" "])

　　返回整齊的HTML格式。 若是指定了 leader ，它將寫入到每一行的開頭。 leader 默認值爲兩個空格。

　　10CGI::rfc1123_date( time)

　　根據 RFC-1123 來格式化時間 (例如, Tue, 2 Jun 2008 00:00:00 GMT)。

　　CGI 實例化方法

　　如下實例中咱們將 CGI::new 的對象賦值給 c 變量，方法列表以下：

　　序號方法描述

　　1c[ name]

　　返回一個數組，包含了對應字段名爲 name 的值。

　　2c.checkbox( name[, value[, check=false]])

　　c.checkbox( options)

　　返回 HTML 字符串用於定義 checkbox 字段。標籤的屬性能夠以一個哈希函數做爲參數傳遞。

　　3c.checkbox_group( name, value...)

　　c.checkbox_group( options)

　　>返回 HTML 字符串用於定義 checkbox 組。標籤的屬性能夠以一個哈希函數做爲參數傳遞。

　　4c.file_field( name[, size=20[, max]])

　　c.file_field( options)

　　返回定義 file 字段的HTML字符串。

　　5c.form([ method="post"[, url]]) { ...}

　　c.form( options)

　　返回定義 form 表單的HTML字符串。 若是指定了代碼塊，將做爲表單內容輸出。標籤的屬性能夠以一個哈希函數做爲參數傳遞。

　　6c.cookies

　　返回 CGI::Cookie 對象，包含了cookie 中的鍵值對。

　　7c.header([ header])

　　返回 CGI 頭部的信息。若是 header 參數是哈希值，其鍵 - 值對，用於建立頭部信息。

　　8c.hidden( name[, value])

　　c.hidden( options)

　　返回定義一個隱藏字段的HTML字符串。標籤的屬性能夠以一個哈希函數做爲參數傳遞。

　　9c.image_button( url[, name[, alt]])

　　c.image_button( options)

　　返回定義一個圖像按鈕的HTML字符串。標籤的屬性能夠以一個哈希函數做爲參數傳遞。

　　10c.keys

　　返回一個數組，包含了表單的字段名。

　　11c.key?( name)

　　c.has_key?( name)

　　c.include?( name)

　　若是表單包含了指定的字段名返回 true。

　　12c.multipart_form([ url[, encode]]) { ...}

　　c.multipart_form( options) { ...}

　　返回定義一個多媒體表單(multipart)的HTML字符串。標籤的屬性能夠以一個哈希函數做爲參數傳遞。

　　13c.out([ header]) { ...}

　　生成 HTML 並輸出。使用由塊的輸出來建立頁面的主體生成的字符串。

　　14c.params

　　返回包含表單字段名稱和值的哈希值。

　　15c.params= hash

　　設置使用字段名和值。

　　16c.password_field( name[, value[, size=40[, max]]])

　　c.password_field( options)

　　返回定義一個password字段的HTML字符串。標籤的屬性能夠以一個哈希函數做爲參數傳遞。

　　17c.popup_menu( name, value...)

　　c.popup_menu( options)

　　c.scrolling_list( name, value...)

　　c.scrolling_list( options)

　　返回定義一個彈出式菜單的HTML字符串。標籤的屬性能夠以一個哈希函數做爲參數傳遞。

　　18c.radio_button( name[, value[, checked=false]])

　　c.radio_button( options)

　　返回定義一個radio字段的HTML字符串。標籤的屬性能夠以一個哈希函數做爲參數傳遞。

　　19c.radio_group( name, value...)

　　c.radio_group( options)

　　返回定義一個radio按鈕組的HTML字符串。標籤的屬性能夠以一個哈希函數做爲參數傳遞。

　　20c.reset( name[, value])

　　c.reset( options)

　　返回定義一個reset按鈕的HTML字符串。 標籤的屬性能夠以一個哈希函數做爲參數傳遞

　　21c.text_field( name[, value[, size=40[, max]]])

　　c.text_field( options)

　　返回定義一個text字段的HTML字符串。標籤的屬性能夠以一個哈希函數做爲參數傳遞。

　　22c.textarea( name[, cols=70[, rows=10]]) { ...}

　　c.textarea( options) { ...}

　　返回定義一個textarea字段的HTML字符串。 若是指定了塊，代碼塊輸出的字符串將做爲 textarea 的內容。 標籤的屬性能夠以一個哈希函數做爲參數傳遞。

　　HTML 生成方法

　　你能夠再 CGI 實例中使用相應的 HTML 標籤名來建立 HTML 標籤，實例以下：

　　#!/usr/bin/ruby

　　require "cgi"

　　cgi = CGI.new("html4")

　　cgi.out{

　　cgi.html{

　　cgi.head{ "\n"+cgi.title{"This Is a Test"} } +

　　cgi.body{ "\n"+

　　cgi.form{"\n"+

　　cgi.hr +

　　cgi.h1 { "A Form: " } + "\n"+

　　cgi.textarea("get_text") +"\n"+

　　cgi.br +

　　cgi.submit

　　}

　　}

　　}

　　}

　　CGI 對象屬性

　　你能夠再 CGI 實例中使用如下屬性：

　　屬性返回值

　　accept可接受的 MIME 類型

　　accept_charset可接受的字符集

　　accept_encoding可接受的編碼

　　accept_language可接受的語言

　　auth_type可接受的類型

　　raw_cookieCookie 數據 (原字符串)

　　content_length內容長度(Content length)

　　content_type內容類型(Content type)

　　FromClient e-mail 地址

　　gateway_interfaceCGI 版本

　　path_info路徑

　　path_translated轉換後的路徑

　　Query_string查詢字符串

　　referer以前訪問網址

　　remote_addr客戶端主機地址(IP)

　　remote_host客戶端主機名

　　remote_ident客戶端名

　　remote_user通過身份驗證的用戶

　　request_method請求方法(GET, POST, 等。)

　　script_name參數名

　　server_name服務器名

　　server_port服務器端口

　　server_protocol服務器協議

　　server_software服務器軟件

　　user_agent用戶代理(User agent)

　　(編輯：雷林鵬 來源：網絡)