TUTORIAL DE JAVA (1): Consejos y comentarios.

Antes de seguir leyendo, debes de leerte uno de los post anteriores donde explico como instalar JDK.


Consejos previos:

Antes de empezar a programar, debemos de conocer una serie de conceptos y consejos para conseguir un buen programa y código.


Lo primero que debemos plantearnos es si nuestro programa va a ser privativo o lo vamos a compartir con otros programadores.


Si decidimos que el programa va a ser privativo y no queremos que nadie lo entienda, debemos de ofuscar el código, es decir, el nombre de las variables, métodos, campos, estados, excepciones, etc, no deben de ser claros. Ejemplo:


int x; (variable que va a ser la edad)

public void metodo1(int x); (método que aumentará la edad en +1)


Tampoco se debería comentar el código ni tabular el código.


Si por el contrario decimos que el código lo vamos a compartir con otros programadores o el caso de que no nos importe que sea legible, el código ha de ser claro y conciso.


El nombre de las variables, métodos, campos, estados, etc han de estar bien escritos:


int edad;

public void cumpleanios(int edad);


En este caso el código ha de estar bien comentado y correctamente tabulado.


Conociendo el entorno de java:


– Comentarios:

Para comentar el código, debemos ver el tipo de comentario que queremos hacer.


El primero que vamos a definir es el comentario en linea (//), el comentario no puede superar una línea. Se suele usar para comentar cosas que te quedan por hacer en el código o por hacer una breve aclaración de alguna línea de código.




public void cumpleanios(int edad){
    ++edad; // incrementar en uno la edad

}


Ahora pasemos a definir el comentario en bloque(/* comentario */), el comentario suele ser grande y para no hacer varios comentarios en linea, pasamos a hacer un solo comentario pero en bloque. Suele usarse para grandes comentarios dentro del código.


public void cumpleanios(int edad){

    /* En este comentario vamos a definir este método

    comentario comentario comentario comentario

    comentario comentario comentario comentario

    comentario comentario comentario comentario */

    ++edad;

}


El siguiente comentario que vamos a definir se suele usar para hacer un comentario formal e ilustrativo de nuestro código, haciendo de resumen de éste. Este comentario va a ser javadoc (/** comentario*/)


/**

* Programa de ejemplo para comentario javadoc

*

* @autor Emanuel Galván Fontalba

* @version 1.0

*/

public class Ejemplo(){
    public static void main(String [] args){

      //codigo

      //codigo

      //codigo

    }

}


Éste comentario requerirá generarlo más adelante y se genera un documento en HTML, el cual se puede visualizar más adelante.


-Conceptos generales:


Bloque de código:

Todo lo que va en un bloque de código, irá entre llaves ({ código }).


Cerrar lineas de código:

Líneas de código que no definen un bloque de código, se cerrará con punto y coma ( ; ).


Reglas generales de sintaxis:


-En el nombre de las variables, la primera letra es en minúscula.

-En el nombre de las clases, la primera letra es en mayúscula.

-En el nombre de métodos, la primera letra es minúscula.




Tras esta pequeña introducción pasamos a programar y establecer los comentarios correctamente:


/**

* Programa que muestra por pantalla “Hola mundo”

*

* @autor Emanuel Galván Fontalba

* @version 1.0

*/

public class HolaMundo(){ //Bloque de código
    public static void main(String [] args){
      System.out.println(“Hola mundo!!”); // Muestra por pantalla en consola

    }

}



Todo esto lo ejecutamos correctamente como se indica en la entrada donde comentamos como instalar JDK.

Documentación Javadoc de Oracle: Enlace

Comparación de editores de texto.(Para principiantes)

 

Sin título-1 (1)

 

Hola, muy buenas a todos.
 
En este articulo del blog, vamos a comparar algunos de los editores de texto más usados para programar en distintos lenguajes.
 
Como ya sabemos, los editores de texto trabajan con texto plano, es decir, para nuestra máquina carácteres simples, sin formato para que quede «bonito» a diferencia de los procesadores de texto. Para programar en cualquier lenguaje de programación vamos a usar estos editores.
 
Antes de empezar con la comparativa, he de decir que cada uno de ellos son útiles dependiendo de varios factores, como por ejemplo donde lo vayas a ejecutar o el lenguaje de programación o marcado.
 
Una vez comentado esto, vamos a comentar por orden de preferencia:
 
1.-Sublime Text
 
Sublime Text es uno de  los mejores editores que existen actualmente. Me llama muchísimo la atención la simpleza y su utilidad, el aspecto visual también es sencillo pero elegante. Tiene una gran capacidad de personalización y puedes instalar varios plugins para hacer este editor más complejo.
 
Lo tenemos disponible para todas las plataformas, aunque el único pero que le pongo es que no es libre, y nos cuesta ni más ni menos que 50€, aunque podemos probarlo de forma gratuita desde su página web.
 
 
 
2.-Geany
 
Geany no solo es un editor de texto, es un IDE. Nos encontramos ante un IDE muy básico y el cual se puede aprender a usar bastante rápido. Algo muy importante de este IDE es que no nos sobrecarga el sistema.
 
URL| Geany
 
 
3.-Notepad++
 
Notepad++ es un editor de texto para Windows. Este editor está escrito en C++. Este editor es software libre y también cuenta con un gestor de plugins, donde puedes añadir nuevas funcionalidades al editor.
 
Como comentábamos antes, solo está disponible para Windows, aunque existe una versión similar para Linux y se llama Notepadqq.
 
 
4.-Komodo Edit
 
Komodo Edit es otro editor de textos, bastante sencillo y te permite editar código de forma sencilla y sin complicaciones. Uno de sus puntos fuertes es su clara sintaxis y la personalización de sus temas.
 
También estamos tratando de un software libre y si se te queda corto también puedes contar con Komodo IDE, que al ser un entorno de desarrollo es mucho mas completo.
 
 
 
5.-SlimText
 
SlimText es una extensión para el navegador Google Chrome y su función es ser un editor de textos, muy sencillo y bastante cómodo. Es muy similar a Komodo Edit, solo que este lo tienes en tu navegador.
 
URL | SlimText
 
 
6.-NetBeans
 
NetBeans es otro IDE, es muy similar a otros IDE´s más complejos, aunque este es más sencillo de utilizar que otros. Este IDE nos ofrece soporte para bases de datos.
 
NetBeans es gratuito, libre y multiplataforma. Tiene una gran comunidad que aporta plugins y tutoriales.
 
 

 

Estos programas son para facilitarnos la vida, desarrolla con el editor que más se acople a tus necesidades.