## Leer y Escribir a través de un objeto URLConnection

Si has utilizado satisfactoriamente openConnection() para inicializar comunicaciones con una URL, tendrás una referencia a un objeto URLConnection. La clase URLConnection contiene muchos métodos que permiten comunicarse con la URL a través de la red. URLConnection es una clase centrada sobre HTTP -- muchos de sus métodos son útiles sólo cuando trabajan con URLs HTTP. Sin embargo, la mayoría de los protocolos URL permite leer y escribir desde una conexión por eso esta página enseña como leer y escribir desde una URL a través de un objeto URLConnection.

### Leer desde un objeto URLConnection

> El siguiente programa realiza la misma función que el mostrado en Leer Directamente desde una URL. Sin embargo, mejor que abrir directamente un stream desde la URL, este programa abre explícitamente una conexión con la URL, obtiene un stream de entrada sobre la conexión, y lee desde el stream de entrada:

>     import java.net.*;
>     import java.io.*;

>     class ConnectionTest {
>         public static void main(String[] args) {
>             try {
>                 URL yahoo = new URL("http://www.yahoo.com/");
>                 URLConnection yahooConnection = yahoo.openConnection();
>                 DataInputStream dis = new DataInputStream(yahooConnection.getInputStream());
>                 String inputLine;

>                 while ((inputLine = dis.readLine()) != null) {
>                     System.out.println(inputLine);
>                 }
>                 dis.close();
>             } catch (MalformedURLException me) {
>                 System.out.println("MalformedURLException: " + me);
>             } catch (IOException ioe) {
>                 System.out.println("IOException: " + ioe);
>             }
>         }
>     }

> La salida de este programa debería ser idéntica a la salida del programa que abría directamente el stream desde la URL. Puedes utilizar cualquiera de estas dos formas para leer desde una URL. Sin embargo, algunas veces leer desde una URLConnection en vez de leer directamente desde una URL podría ser más útil ya que se puede utilizar el objeto URLConnection para otras tareas (como escribir sobre la conexión URL) al mismo tiempo.

> De nuevo, si en vez de ver la salida del programa, se viera el siguiente mensaje error:

>     IOException: java.net.UnknownHostException: www.yahoo.com

Podrías tener activado un proxy y el programa no podría encontrar el servidor de www.yahoo.com.

### Escribir a una URLConnection

> Muchas páginas HTML contienen forms -- campos de texto y otros objeto GUI que le permiten introducir datos en el servidor. Después de teclear la información requerida e iniciar la petición pulsando un botón, el navegador que se utiliza escribe los datos en la URL a través de la red. Después de que la otra parte de la conexión (normalemente un script cgi-bin) en el servidor de datos, los procesa, y le envía de vuelta una respuesta, normalmente en la forma de una nueva página HTML. Este esenario es el utilizado normalmente por los motores de búsqueda.

> Muchos scripts cgi-bin utilizan el POST METHOD para leer los datos desde el cliente. Así, escribir sobre una URL frecuentemente es conocido como posting a URL. Los scripts del lado del servidor utilizan el método POST METHOD para leer desde su entrada estandard.

> Nota: Algunos scripts cgi-bin del lado del servidor utilizan el método GET METHOD para leer sus datos. El método POST METHOD es más rápido haciendo que GET METHOD esté obsoleto porque es más versátil y no tiene limitaciones sobre los datos que pueden ser enviados a través de la conexión.

> Tus programas Java también pueden interactuar con los scripts cgi-bin del lado del servidor. Sólo deben poder escribir a una URL, así proporcionan los datos al servirdor. Tu programa puede hacer esto siguiendo los siguientes pasos:

> 1. Crear una URL.
> 2. Abrir una conexión con la URL.
> 3. Obtener un stream de salida sobre la conexión. Este canal de entrada está conectado al stream de entrada estandard del script cgi-bin del servidor.
> 4. Escribir en el stream de salida.
> 5. Cerrar el stram de salida.

> Hassan Schroeder, un miembro del equipo de Java, escribió un script cgi-bin, llamado backwards, y está disponible en la Web site de, java.sun.com. Puedes utilizar este script para probar el siguiente programa de ejemplo.Si por alguna razón no puedes obtenerlo de nuestra Web; puedes poner el script en cualquier lugar de la red, llamándolo backwards, y prueba el programa localmente.

> El script de nuestra Web lee una cadena de la entrada estandard, invierte la cadena, y escribe el resultado en la salida estandard. El script requiere una entrada de la siguiente forma: string=string_to_reverse, donde string_to_reverse es la cadena cuyos caracteres van a mostrarse en orden inverso.

> Aquí tienew un programa de ejemplo que ejecuta el script backwards a través de la red utilizando un URLConnection:

>     import java.io.*;
>     import java.net.*;

>     public class ReverseTest {
>         public static void main(String[] args) {
>             try {
>                 if (args.length != 1) {
>                     System.err.println("Usage:  java ReverseTest string_to_reverse");
>                     System.exit(1);
>                 }
>                 String stringToReverse = URLEncoder.encode(args[0]);

>                 URL url = new URL("http://java.sun.com/cgi-bin/backwards");
>                 URLConnection connection = url.openConnection();

>                 PrintStream outStream = new PrintStream(connection.getOutputStream());
>                 outStream.println("string=" + stringToReverse);
>                 outStream.close();

>                 DataInputStream inStream = new DataInputStream(connection.getInputStream());
>                 String inputLine;

>                 while ((inputLine = inStream.readLine()) != null) {
>                     System.out.println(inputLine);
>                 }
>                 inStream.close();
>             } catch (MalformedURLException me) {
>                 System.err.println("MalformedURLException: " + me);
>             } catch (IOException ioe) {
>                 System.err.println("IOException: " + ioe);
>             }
>         }
>     }

> Examinemos el programa y veamos como trabaja. Primero, el programa procesa los argumentos de la línea de comandos:

>     if (args.length != 1) {
>         System.err.println("Usage:  java ReverseTest string_to_reverse");
>         System.exit(1);
>     }
>     String stringToReverse = URLEncoder.encode(args[0]);

> Estas líneas aseguran que el usuario proporciona uno y sólo un argumento de la línea de comandos del programa y lo codifica. El argumento de la línea de comandos es la cadena a invertir por el script cgi-bin backwards. El argumento de la línea de comandos podría tener espacios u otros caractetes no alfanuméricos. Estos caracteres deben ser codificados porque podrían suceder varios procesos en la cadena en el lado del servidor. Esto se consigue mediante la clase URLEncoder.

> Luego el programa crea el objeto URL -- la URL para el script backwards en java.sun.com.

>     URL url = new URL("http://java.sun.com/cgi-bin/backwards");

> El programa crea una URLConnection y abre un stream de salida sobre esa conexión. El stream de salida está filtrado a través de un PrintStream.

>     URLConnection connection = url.openConnection();
>     PrintStream outStream = new PrintStream(connection.getOutputStream());

> La segunda línea anterior llama al método getOutputStream() sobre la conexión. Si no URL no soporta salida, este método lanza una UnknownServiceException. Si la URL soporta salida, este método devuelve un stream de salida que está conectado al stream de entrada estandard de la URL en el lado del servidor -- la salida del cliente es la entrada del servidor.

> Luego, el programa escribe la información requerida al stream de salida y cierra el stream:

>     outStream.println("string=" + stringToReverse);
>     outStream.close();

> Esta línea escribe en el canal de salida utilizando el método println(). Como puedes ver, escribir datos a una URL es tan sencillo como escribir datos en un stream. Los datos escritos en el stream de salida en el lado del cliente son la entrada para el script backwards en el lado del servidor. El programa ReverseTest construye la entrada en la forma requirida por el script mediante la concatenación string= para codificar la cadena.

> Frecuentemente, como en este ejemplo, cuando escribe en una URL está pasando información al script cgi-bin que lee la información que usted escribe, realiza alguna acción y luego envía la información de vuelta mediante la misma URL. Por lo que querrás leer desde la URL después de haber escrito en ella. El programa ReverseTest los hace de esta forma:

>     DataInputStream inStream = new DataInputStream(connection.getInputStream());
>     String inputLine;

>     while (null != (inputLine = inStream.readLine())) {
>         System.out.println(inputLine);
>     }
>     inStream.close();

> Cuando ejecutes el programa ReverseTest utilizando Invierteme como argumento, deberías ver esta salida:

>     Invierteme
>      reversed is:
>     emetreivnI

Ozito