El HTTunnel:: Cliente es una clase de cliente para el Apache:: HTTunnel.

SINOPSIS

mi $hc = nuevo HTTunnel:: Cliente ("http://localhost/httunnel");
El $hc-> conecta (tcp, $some_host, $some_port);

$hc-> letra (un poco de petición);
mi $some_response = $hc-> leído (1024);

$ch-> cerca ();

El HTTunnel:: Cliente es la clase de cliente al Apache:: HTTunnel. Esto permite la creación de una conexión de red cavada por el HTTP. Todos los datos enviados y recibidos durante esta conexión serán transportados dentro de peticiones de HTTP normales.

El HTTunnel:: Cliente amplía LWP:: UserAgent, entonces todos LWP:: UserAgent métodos están disponibles por HTTunnel:: el Cliente.

CONSTRUCTORES

nuevo (URL, [ARGS])

Crea un HTTunnel:: objeto de Cliente que usará el URL para ponerse en contacto con el Apache:: HTTunnel servidor. ARGS son es pasado directamente al LWP:: UserAgent constructor.

MÉTODOS

conecte (PROTO, SERVIDOR, PUERTA, [INTERVALO DE ESPERA])

Pide el Apache:: HTTunnel servidor establecer una conexión de protocolo PROTO a HOST:PORT. Una excepción es lanzada si un error ocurre.

Los valores aceptados para PROTO son tcp y udp.

letra (DATOS)

Pide el Apache:: HTTunnel servidor escribir DATOS a la conexión remota establecida. Una excepción es lanzada si un error ocurre.
LOS DATOS pueden ser un escalar o una lista, en cuyo caso los artículos de lista son concadenados juntos.

lea (LEN, [INTERVALO DE ESPERA], [CUERDA DE SALVAMENTO], [LIFELINE_CUT_ACTION])

Pide el Apache:: HTTunnel servidor leer hasta bytes de LEN de la conexión remota establecida. Una excepción es lanzada si un error ocurre.

Cuando la tentativa de leer, HTTunnel:: al Cliente establecerá una conexión de HTTP con el Apache:: HTTunnel servidor que pide que bytes de LEN ser leída. Si ningunos datos están disponibles después de segundos de INTERVALO DE ESPERA (el valor por defecto es 15 segundos), la conexión de HTTP está cerrada por el servidor y el método leído establecerá nuevo uno. Esto continuará hasta algunos datos o EOF es devuelto.

Por lo tanto lea sólo volverá cuando unos (o no más) datos están disponibles para ser leídos (como el regular leído).

LA CUERDA DE SALVAMENTO puede ser cualquier filehandle válido del cual puede leer. De ser usado, lea interrumpirá su repetición de conexión y ejecutará LIFELINE_CUT_ACTION cuando los datos (o EOF) están disponibles para ser leídos de la CUERDA DE SALVAMENTO. Esto devolverá entonces undef.
LIFELINE_CUT_ACTION wust ser un CÓDIGO en cuanto a. El valor por defecto es

la suscripción {muere ("cuerda de salvamento cutn")}

Estos aspectos pueden estar usados si usted quiere el tenedor y comenzar un proceso que hace solamente lee y devuelve los datos vía un tubo. Usted puede usar entonces un segundo tubo para asegurarse que el proceso de lector se termina cuando el proceso de maestro se termina.

Aquí está un ejemplo:

mi $lifeline = nuevo IO:: Tubo ();
mi $reader = nuevo IO:: Tubo ();
mi $pid = tenedor ();
si ($pid) {
$reader-> lector ();
$lifeline-> escritor ();

# Lea datos de $reader...
}
más {
$reader-> escritor ();
$reader-> autorubor (1);
$lifeline-> lector ();

mientras (1) {
mi $data = $hc-> leído (1024, 15, $lifeline, suscripción {salida ()});
salida () a menos que definido ($data);
$data de $reader de letra;
}
}
cerca ()

Pide el Apache:: HTTunnel servidor cerrar una conexión antes establecida.
get_peer_info ()

El método get_peer_info devuelve la información sobre la conexión remota. Una cuerda que contiene la dirección IP y número de puerta, separado por un colon ( :)es devuelto. Este método puede ser útil con conexiones UDP para validar al remitente de cada paquete.

request_callback (PETICIÓN)

El método request_callback es un método de rellamada que puede ser usado para tener acceso el HTTP::Request objeto justo antes de que es enviado. La realización por defecto no hace nada.

response_callback (RESPUESTA)

El método response_callback es un método de rellamada que puede ser usado para tener acceso el HTTP::Response objeto sólo después de que es recibido. La realización por defecto no hace nada.