Weblog de Victor Ramirez

Sábado, febrero 15, 2014

Crear aplicaciones para Twitter desde NetBeans

Filed under: java, jdk, jdk7, netbeans, tutorial, Twitter — Etiquetas: , , , , , , , — vramirez @ 3:05 PM

En el siguiente post crearemos una aplicación ejemplo muy básica y sencilla (sin GUI, de hecho) en NetBeans para conectarnos a Twitter y leer nuestro timeline. Los siguientes son los prerequisitos para este tutorial:

  • Cuenta en Twitter
  • NetBeans IDE 7.x
  • JDK 1.7
  • Twitter4J

Lo primero es loguearnos en el sitio web de desarrolladores para Twitter https://dev.twitter.com/apps. Una vez allí le damos click en crear nueva aplicación. A continuación, diligenciamos un formulario con el nombre que tendrá la aplicación, una breve descripción (10 o más caracteres), y una URL de la App, la cual se supone apunta a una direccion en Internet con información sobre la App. Por ahora, pueden poner cualquiera como en mi ejemplo y cambiarla después (La URL debe ser completa, por ejemplo, debe empezar por http o https…).

Twitter new app

Formulario de creación nueva aplicación en Twitter

Una vez la hemos creado, Twitter nos muestra una serie de opciones de configuración de la aplicación, acá las vamos a repasar brevemente mostrando lo que nos interesa para el tutorial.

En la pestaña “Details” verificar que la opción “Access level” tenga “read-only”. En esta misma pestaña, al final, se encuentra la opción para borrar la aplicación.

En API Keys esta toda la info que necesitaremos darle a nuestra aplicación en NetBeans. En la sección “Your access token” dar click en “Create my access token”. Darle “Refresh” a la página. Ahora tenemos 4 parámetros MUY importantes para nuestra App:

  • API key
  • API Secret
  • Access token
  • Access token secret

Ya veremos porqué debemos tener estos 4 hashes muy presentes. Cabe destacar que dichos hashes son SECRETOS, pues si alguien los obtiene, puede suplantar tu aplicación, incluso tu cuenta de Twitter.

Lo siguiente es descargar la librería de Twitter4j entrando a http://twitter4j.org/ y en el link Download descargar el .zip. Una vez descargado, entrar a NetBeans y en Tools –> Libraries  –> New Library. En el nombre, ponerle nombre a la librería, por ejemplo, “Twitter4j” o algo que la identifique con Twitter. En classpath, darle Add Jar/Folder y buscar la carpeta previamente descomprimida de Twitter4J y en la subcarpeta “lib”, se pueden seleccionar todos los archivos jar, sin embargo, agregando solo el que tenga nombre “core”, bastará.

Libreria de Twitter Twitter4J creada en NetBeans

Libreria de Twitter4J creada en NetBeans

Ahora, con la librería ya creada, debemos crear un nuevo proyecto tipo “Java Aplication” de NetBeans. Al proyecto ya creado, agregarle la librería que se creó en el paso anterior. Sobre el proyecto hacer click derecho –> Properties. Luego hacer click en la categoría “Libraries”, en la pestaña “Compile” agregar la librería de Twitter4J. En la clase

public static void main(String[] args) throws TwitterException {
        ConfigurationBuilder cb = new ConfigurationBuilder();
        TwitterFactory tf = new TwitterFactory(cb.build());
        Twitter twitter = tf.getInstance();
        List<Status> statuses = twitter.getHomeTimeline();
        System.out.println("Mostrando el timeline...");
        for (Status status : statuses) {
            System.out.println("@" + status.getUser().getScreenName()+": "+ status.getText());
        }
    }

Ahora, debemos pasar los parámetros de la API de Twitter a nuestra aplicación. Para ello existen varias alternativas. Una de ellas, es mediante un archivo .properties:

Lo primero es dar click derecho sobre el proyecto New –> Other… –> Other –> Properties File. Al archivo llamarlo twitter4j. El archivo debe quedar en la raíz del proyecto, al mismo nivel de carpetas como “src” y “dist”.

El archivo debe ser completado con estas cuatro líneas, con la información (los hashs) provista por Twitter:

oauth.consumerKey=<La Api Key>
oauth.consumerSecret=<La Api Secret>
oauth.accessToken=<El token access>
oauth.accessTokenSecret=<El token access secret>

Desde luego, todo esto sin los signos de <>.

Ahora podemos ejecutar la aplicación y mostrará por consola nuestro timeline más reciente. O

Otra opción es pasarle los parámetros a través del código Java directamente, (eliminando primero el archivo .properties) así:

public static void main(String[] args) throws TwitterException {
        // TODO code application logic here
        ConfigurationBuilder cb = new ConfigurationBuilder();
         cb.setDebugEnabled(true)
         .setOAuthConsumerKey("<API key>")
         .setOAuthConsumerSecret("<API key secret>")
         .setOAuthAccessToken("<Access token>")
         .setOAuthAccessTokenSecret("<Access token secret>");
        TwitterFactory tf = new TwitterFactory(cb.build());
        Twitter twitter = tf.getInstance();
        List<Status> statuses = twitter.getHomeTimeline();
        System.out.println("Showing home timeline.");
        for (Status status : statuses) {
            System.out.println("@" + status.getUser().getScreenName()+ status.getText());
        }
    }

En la sección Code Examples de  http://twitter4j.org se pueden encontrar distintos ejemplos más avanzados de código Java para Twitter. Espero que este corto tutorial les sea de utilidad.

Notas:

  • Un error de “401:Authentication credentials” es que alguno de los 4 hash fueron mal ingresados.
  • Un error de “Authentication credentials are missing” indica que a la aplicación le faltan los 4 hashs. Si se le están pasando los hashs a la aplicación mediante archivo .properties, es probable que el archivo no esté en la raíz del proyecto (debe estar en el mismo nivel del archivo manifest.mf).

Jueves, abril 3, 2008

Aplicación para enviar mails utilizando Netbeans 6.x

Filed under: java, netbeans, tips, web — Etiquetas: , , , , , , — vramirez @ 1:07 PM

Netbeans 6, pretende facilitar enormemente las tareas del desarrollador. En el siguiente ejemplo demostraré como crear una sencila aplicación para enviar mails desde un servidor de correo, en este caso en particular a través de una cuenta de gmail. La aplicación será generada prácticamente en su totalidad por netbeans, y solo tendremos que añadir y modificar unas partes. Crea una aplicación web, denomínala EjemploMail y le agregas el framework visual server faces. Agregale los componentes necesarios para que se vea como una página que utilizarás para componer y enviar emails. Una interfaz que tenga un input para escribir el destinatario del mail, otro para el título del mensaje (subject), y uno más para el contenido. Por su longitud, lo más lógico es agregar este último como textarea. Les debe quedar algo como esto:

Luego hacemos doble click en el boton “Enviar”. Esto nos llevará a la vista de código java de la página. Más exactamente, dentro del código a ejecutarse para el botón. En la barra lateral llama “Paleta” encontraremos varias plantillas de código. Por ejemplo código que contiene bloques try/catch, bucle for, y algunos códigos prediseñados para recorres consultas (dataproviders). Dentro de estos códigos existe uno que se llama “Send mail” ubicado en la sección Web App Functions. Haga click en el y arrástrelo hacia el método que contiene el evento del botón. La figura muestra donde esta ubicado el código plantilla, y hasta dónde debe ser arrastrado.

Luego de soltar el código plantilla de la paleta, aparecerá un cuadro de diálogo pidiendonos algunos parametros para enviar el mail. Mejor los dejamos vacios y los llenamos desde el código, donde netbeans nos ayudará a completarlo. Asi que simplemenete damos click en “OK”.

Ahora cuando vamos a echarle un vistazo al código, vemos el código plantilla que netbenas ha generado. Se trata de algo más de 60 líneas de código. Al comienzo están las variables que nos pedía el cuadro de diálogo. Cada una de ellas aparece declarada como “String” a las cuales se ha incializado con un valor vacío, excepto la variable “message”, q no aparecía en el cuadro de diálogo. Bueno, vamos a llenar los campos:

  • La variable “To” indica el destinatario, asi q a esta variable le asignamos el textfield que recibirá el destino.
  • La variable “From” indica el usuario que envia, alli escribiré mi driección de correo de gmail completa, incluyendo @gmail.com
  • La variable “subject” indica el titulo del mensaje.
  • En la variable “message” colocams el texto que venga del textarea.
  • La variable “server” la llenamos con la dirección del servidor de correo saliente que tengamos asociado. Para gmail es smpt.gmail.com En “user” coloca tu user de gmail. Es decir, el correo, pero SIN el @gmail.com y en “password”…. ya sabes.

Verifica que la variable boolean llamada “ssl” esté en true. Esta última configuración solo es propia de gmail. Si vas a enviar correo desde otro servidor debes verificar sus respectivos protocolos y puertos.

Para especificarla un puerto a la conexion con el servidor smtp puedes agregar la sgte linea de código: props.put(“mail.smtp.port”, puerto); Donde, “puerto” es una variable tipo String que contiene el número del puerto para conectarse con el servidor. Para comprobar que el mail sea enviado, agregamos un “groupMessage” a la página. Un GroupMessage es un componente sencillo que nos permite mostrar mensajes de error o información adicional. Desde la vista de diseño, arrastralo de la paleta. Se encuentra dentro de los componentes woodstock basic. Para enviarle información escribimos desde cualquier parte de la página:

info("Mensaje de confirmación");

error("Mensaje de error");

Adicional a estos 2 métodos, existe un tercero denominado log(String msj), con el cual anotamos en el log del servidor de aplicaciones en que este montada la aplicación. Coloca un mensaje de exito después de la línea de código: log(“Mail was sent successfully.”); ubicada justo antes de cerrar el try e iniciar el catch, y una linea con un mensaje de error, apenas un par de lineas abajo, justo después de la línea log(“Smtp_Send_Failed:”);

Tip: si quieres enviar texto en código html, debes modificar un atributo del objeto msg el cual es de tipo javax.mail.Message. Este objeto es el que va a contener el mensaje. Asi que justo después que se le asigne el mensaje pones la siguiente línea:

msg.setContent(message, "text/html");

El bloque de código queda más o menos asi:

msg.setSubject(subject);
msg.setSentDate(new Date());
msg.setText(message);
msg.setContent(message, "text/html");

Si agregas esa línea antes de que asignes el mensaje, no funcionará correctamente. El ejemplo completo lo pueden descargar aqui

Crea un blog o un sitio web gratuitos con WordPress.com.