La API de Java y la importación de módulos, paquetes y clases

Pasamos ya a un tema muy importante de Java, el funcionamiento de la API de Java y como trabajar con módulos, paquetes y clases en Java.

¿Qué es la API de Java?

La API de Java es el conjunto de módulos y clases que proporciona Java para que podamos programar aplicaciones. Es como una biblioteca que contiene todo lo que necesitamos para crear programas.

Para acceder a la API de Java, puedes visitar su sitio web oficial y buscar los módulos y clases que necesitas para tu proyecto.

Aquí tienes la documentación de las versiones JDK.

Vamos a utilizar la última versión, la que está en "Latest Release".

Lo que encontrarás en cada versión, puede variar, así que deberás buscar algo como "API Documentation".

¿Qué es un módulo de Java?

Un módulo es una unidad de organización y distribución que contiene un conjunto de paquetes y otros módulos.

¿Cómo se importa un paquete en Java?

Para importar un paquete en Java, primero debes conocer su nombre. Luego, por norma general, en la parte superior del código, escribes la siguiente línea:

import nombre_del_paquete;

Por ejemplo, si queremos importar la clase Math que nos permite realizar operaciones matemáticas, escribiríamos:

import java.lang.Math;

¿Cómo se puede ver la referencia de esto en la API?

Utiliza el buscador que tiene integrado, o busca en los diferentes módulos. Por ejemplo, "Math" está en java.base > java.lang > Math.

"Math" es una clase que se encuentra dentro del paquete "java.lang". Este paquete, a su vez, se encuentra dentro del módulo "java.base". Por lo tanto, la ruta completa sería "java.base > java.lang > Math".

Para que no haya confusión:

• "java.lang.Math" es una clase del paquete "java.lang".
• "java.lang" es un paquete.
• "java.base" es un módulo que entre otras cosas, tiene el paquete "java.lang".

Al escribir "import java.lang.Math;", estamos importando la clase "Math" del paquete "java.lang" dentro del módulo "java". De esta manera, podemos utilizar la clase "Math" en nuestro código sin tener que escribir el nombre completo del paquete y el módulo cada vez que queramos acceder a ella.

Utilizar un método de la clase importada:

Para usar algo de esta clase solo debemos llamarla y a continuación, utilizar uno de sus métodos. Por ejemplo, el método "max()", el cual, espera dos valores numéricos y devuelve como resultado el número más grande de los dos.

import java.lang.Math;

public class Main {
    public static void main(String[] args) {
        int numero1 = 10;
        int numero2 = 20;
        int numeroMayor = Math.max(numero1, numero2);
        System.out.println("El número mayor es: " + numeroMayor);
    }
}

Resultado en la consola

El número mayor es: 20

Si nos fijamos, en la referencia de Java, veremos que se proporcionan cuatro métodos max(). Hay para cuatro tipos de valores numéricos:

max(double a, double b)
max(float a, float b)
max(int a, int b)
max(long a, long b)

Esto se consigue con la sobrecarga de métodos del capítulo anterior. Acción que hace la clase Math y tantas otras clases de Java, para conseguir que podamos pasar diferentes tipos de datos a los mismos métodos.

Fijándote en esta referencia, podrás llegar a la conclusión, de que en principio, directamente, sin realizar conversiones de tipos, solo puedes pasar dos tipos de datos del mismo tipo en la misma llamada.

Importar todo de un paquete de java

Para importar un paquete entero de Java, lo podemos hacer con el asterisco.

Por ejemplo, esto nos dará acceso a todas las clases de "java.lang", no solo "Math".

import java.lang.*;

Al importar todas las clases de un paquete, existe la posibilidad de que haya clases con nombres similares entre ellas que causen conflictos en el nombre de las variables o métodos. Por lo tanto, es más recomendable importar solo las clases específicas que necesites.

No te pierdas nada del curso Máster en Java.