English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Métodos CGI do Ruby

Métodos CGI do Ruby

A seguir está a lista de métodos da classe CGI:

Métodos de exemplo CGINeste exemplo, atribuímos o objeto CGI::new ao variável c, a lista de métodos é a seguinte:
1CGI::new([ level="query"])
Cria objeto CGI. query pode ser um dos seguintes valores:
  • query: Sem geração de saída HTML

  • html3: HTML3.2

  • html4:  HTML4.0 Strict

  • html4Tr: HTML4.0 Transitional

  • html4Fr:  HTML4.0 Frameset

2CGI::escape( str)
Usa codificação URL para escapar strings.
3CGI::unescape( str)
Decodifica strings codificadas pelo escape().
4CGI::escapeHTML( str)
Codifica caracteres especiais HTML, incluindo: & < >.
5CGI::unescapeHTML( str)
Decodifica caracteres especiais HTML, incluindo: & < >.
6CGI::escapeElement( str[, element...])
Codifica caracteres especiais HTML no elemento HTML especificado.
7CGI::unescapeElement( str, element[, element...])
在指定的 HTML 元素中解码 HTML 特殊字符。
8CGI::unescapeElement( str, elemento[, elemento...])
Decodifica caracteres especiais HTML no elemento HTML especificado.
9CGI::parse( consulta)
Análise da string de consulta, e retorna um hash contendo os pares de chave=》valor. Retorna formato HTML arrumado. Se for especificado CGI::pretty( string[, líder=" "]) Retorna formato HTML arrumado. Se for especificado que será escrito no início de cada linha.
10líder1123O valor padrão são dois espaços.
CGI::rfc-1123 _date( tempo) 2 De acordo com RFC 2para formatar o tempo (por exemplo, Ter,8 Jun

00

00:00:00 GMT).

Métodos de exemplo CGINeste exemplo, atribuímos o objeto CGI::new ao variável c, a lista de métodos é a seguinte:
1Número de série
Descrição do método c[ nome] Retorna um array que contém os valores correspondentes ao nome do campo
2nome
do valor.

Retorna uma string HTML para definir o campo de checkbox. As propriedades da tag podem ser passadas como uma função hash como parâmetro.
3c.checkbox_group( nome, valor...)
c.checkbox_group( opções)

>Retorna uma string HTML para definir um grupo de checkboxes. As propriedades da tag podem ser passadas como uma função hash como parâmetro.
4c.file_field( nome[, tamanho=20[, max]])
c.file_field( opções)

Retorna uma string HTML definindo o campo de arquivo.
5c.form([ método="post"[, url]]) { ...}
c.form( opções)

Retorna uma string HTML definindo o formulário. Se for especificado um bloco de código, ele será output como conteúdo do formulário. As propriedades da tag podem ser passadas como uma função hash como parâmetro.
6c.cookies
Retorna o objeto CGI::Cookie, que contém os pares de chave-valor do cookie.
7c.header([ cabeçalho])
Retorna informações do cabeçalho CGI. Se o parâmetro header for um valor hash, suas chaves - Par de valor, usado para criar informações de cabeçalho.
8c.hidden( nome[, valor])
c.hidden( opções)

Retorna uma string HTML para definir um campo oculto. As propriedades do rótulo podem ser passadas como um função hash como parâmetro.
9c.image_button( url[, name[, alt]])
c.image_button( options)

Retorna uma string HTML para definir um botão de imagem. As propriedades do rótulo podem ser passadas como um função hash como parâmetro.
10c.keys
Retorna um array contendo os nomes dos campos do formulário.
11c.key?( name)
c.has_key?( name)
c.include?( name)

Se o formulário contiver o nome do campo especificado, retorna true.
12c.multipart_form([ url[, encode]]) { ...}
c.multipart_form( options) { ...}

Retorna uma string HTML para definir um formulário de múltiplos partes (multipart). As propriedades do rótulo podem ser passadas como um função hash como parâmetro.
13c.out([ header]) { ...}
Gera HTML e exibe. Usa a string gerada pela saída do bloco para criar o corpo da página.
14c.params
Retorna um valor hash contendo o nome e o valor dos campos do formulário.
15c.params= hash
Define o uso do nome do campo e do valor.
16c.password_field( name[, value[, size=)40[, max]]]
c.password_field( options)

Retorna uma string HTML para definir um campo de senha. As propriedades do rótulo podem ser passadas como um função hash como parâmetro.
17c.popup_menu( name, value...)
c.popup_menu( options)
c.scrolling_list( name, value...)
c.scrolling_list( options)

Retorna uma string HTML para definir um menu suspenso. As propriedades do rótulo podem ser passadas como um função hash como parâmetro.
18c.radio_button( name[, value[, checked=false]])
c.radio_button( options)

Retorna uma string HTML para definir um campo de rádio. As propriedades do rótulo podem ser passadas como um função hash como parâmetro.
19c.radio_group( name, value...)
c.radio_group( options)

Retorna uma string HTML para definir um grupo de botões de rádio. As propriedades do rótulo podem ser passadas como um função hash como parâmetro.
20c.reset( name[, value])}
c.reset( options)

Retorna uma string HTML definindo um botão reset. Os atributos da tag podem ser passados como um hash.
21c.text_field( name[, value[, size=40[, max]]]
c.text_field( options)

Retorna uma string HTML definindo um campo texto. Os atributos da tag podem ser passados como um hash.
22c.textarea( name[, cols=70[, lines=10}] { ...}
c.textarea( options) { ...}

Retorna uma string HTML definindo um campo textarea. Se especificado, a string de saída do bloco de código será o conteúdo do textarea. Os atributos da tag podem ser passados como um hash.

Métodos de geração HTML

Você pode usar os nomes de tags HTML correspondentes no exemplo CGI para criar tags HTML, exemplo a seguir:

Exemplo online

#!/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
         }
      }
   }
}

Atributos do objeto CGI

Você pode usar os seguintes atributos no exemplo CGI:

AtributoValor de retorno
acceptTipos MIME aceitos
accept_charsetConjuntos de caracteres aceitos
accept_encodingCodificações aceitas
accept_languageLinguagens aceitas
auth_typeTipos aceitos
raw_cookieDados do Cookie (string original)
content_lengthTamanho do conteúdo (Content length)
content_typeTipo de conteúdo (Content type)
DeClient e-endereço de e-mail
interface do gatewayVersão CGI
path_infoCaminho
path_translatedCaminho Traduzido
Query_stringString de Consulta
refererURL da Última Acesso
remote_addrEndereço IP do Host do Cliente
remote_hostNome do Host do Cliente
remote_identNome do Cliente
remote_userUsuário Autenticado
request_methodMétodo de Requisição (GET, POST, etc.)
script_nameNome do Parâmetro
server_nameNome do Servidor
server_portPorta do Servidor
server_protocolProtocolo do Servidor
server_softwareSoftware do Servidor
user_agentAgente de Usuário (User agent)