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.