Pular para o conteúdo principal

Regras de reescrita

As regras de reescrita consistem em duas partes: Matching Rules (quais requisições reescrever) e Rewriting Rules (como reescrever).

O Rewrite Debug suporta reescrita para HTTP(S), WebSocket, TCP e UDP. Você pode redirecionar requisições, reescrever path/query/headers/body ou mockar respostas por protocolo — veja Modificação de TCP ou WebSocket para detalhes de fluxos binários.

1. Redirecionamento de requisições para 'HTTP&WebSocket&TCP'​

O redirecionamento é usado para alterar o endereço e a porta de destino de uma requisição e também pode determinar se será usada criptografia SSL/TLS. Essa regra é particularmente útil para trocas frequentes entre endereços de servidor de teste e de produção durante os testes.

2. Reescrita de paths para 'HTTP&WebSocket'​

O HTTP Path refere-se à parte da URL após o hostname, usada para identificar o caminho dos recursos no servidor web.

https://example.com/api/user?name=john&age=25

Neste exemplo, /api/user é o Path, normalmente começando com /. Ao reescrever o Path, o caminho inteiro precisa ser substituído. Se você quiser substituir o Path por nada, basta preencher /.

3. Reescrita de queries para 'HTTP&WebSocket'​

HTTP Query é uma técnica para passar dados por meio da URL, permitindo que parâmetros e valores sejam passados na URL usando o símbolo '?'. Queries consistem em um ou mais pares chave-valor separados por '&'.

Por exemplo, a URL a seguir contém uma query string com dois parâmetros (name e age):

https://example.com/api/user?name=john&age=25

Neste exemplo, name=john&age=25 é a query string, composta por múltiplos pares chave-valor concatenados com '&'. Ao reescrever, o Hodor analisa a Query em pares chave-valor (tratando ordem e situações de array) e modifica o Key e o Value correspondentes. Além disso, esses nomes e valores de parâmetros precisam estar URL-encodados; por exemplo, "value 1" será codificado como "value%201". O Hodor trata essas conversões automaticamente para você.

4. Reescrita de headers para 'HTTP&WebSocket'​

HTTP Headers são um conjunto de pares chave-valor. Você pode adicionar ou remover valores do HTTP Header. No entanto, há algumas considerações especiais para campos como Range, Content-Range, Content-Length, Content-Encoding, Content-Transfer-Encoding, Transfer-Encoding, que são controlados pelo sistema e não terão efeito se preenchidos manualmente. Se o Content-Type for especificado, ele sobrescreverá a configuração de mime-type do sistema.

5. Modificação do Body para 'HTTP'​

O HTTP Body pode transmitir dados em vários formatos de codificação. O Hodor suporta decodificar dados em quatro formatos de codificação (text, JSON, x-www-form-urlencoded, multipart/form-data) e modificá-los como pares chave-valor. Alternativamente, você pode substituir dinamicamente a seção inteira do Body com dados preparados previamente.

5.1. Decodificar como text e modificar com expressões regulares​

Para a documentação detalhada, consulte o documento de exemplo.

5.2. Decodificar como JSON para modificação​

Para a documentação detalhada, consulte o documento de exemplo.

5.3. Decodificar como x-www-form-urlencoded para modificação​

Para a documentação detalhada, consulte o documento de exemplo.

5.4. Decodificar como multipart/form-data para modificação​

Para a documentação detalhada, consulte o documento de exemplo.

6. Substituição do Body para 'HTTP'​

Substitui diretamente a seção do Body antes de o app enviar a requisição ao servidor e antes de os dados do servidor retornarem ao app.

7. Reescrita do código para 'HTTP'​

O Hodor pode alterar os códigos de status HTTP e também redirecionar por meio de códigos de resposta HTTP, selecionando entre 301, 302, 307, 308 com endereços de redirecionamento configuráveis.

8. Mock para 'HTTP'​

Usado principalmente para retornar conteúdo específico para uma requisição particular; você pode pensar nisso como um servidor HTTP local que retorna conteúdo pré-definido para requisições que casam.

9. Modificação de dados para 'TCP&WebSocket'​

Converte o fluxo de dados upstream e downstream de TCP ou WebSocket em strings ou hex16 e usa expressões regulares para modificar esses dados. Para a documentação detalhada, consulte o documento de exemplo.