El documento habla sobre el API de Java. Explica que el API de Java contiene librerías extensivas y bien probadas. También describe cómo la documentación del API se genera con Javadoc y cómo los comentarios Javadoc documentan las clases, métodos y variables. Además, explica conceptos como paquetes, la declaración import, la clase String y StringTokenizer, y las clases de envoltura.

1. 1_1_3 API de Java Apoyo SSD3

2. Introducción El API (Interfaz de Programación de Aplicaciones o Application Programming Interface ) de Java representa una librería de Java extensiva. Estas librerías son escritas cuidadosamente, son robustas y están probadas exitosamente.

3. Introducción La documentación del API de Java es generada por la herramienta Javadoc. Javadoc produce un conjunto de páginas HTML a partir de los comentarios Javadoc de un archivo fuente de Java.

4. Introducción Los comentarios Javadoc documentan las clases, variables y métodos de una aplicación. Utilizaremos comentarios Javadoc en nuestro código fuente para que la documentación de nuestras aplicaciones cuente con la misma organización y formato que el API de Java.

5. Paquetes y el Estatuto import Las clases del API de Java están agrupadas en paquetes . Un paquete es simplemente una colección de clases relacionadas. El siguiente es un ejemplo del nombre de un paquete: java.util

6. Paquetes y el Estatuto import El nombre completo calificado de una clase que es parte de un paquete es el nombre del paquete y el nombre de la clase, separados por un punto. java.util.GregorianCalendar

7. Paquetes y el Estatuto import Para declarar dos variables de tipo GregorianCalendar, podemos escribir: java.util.GregorianCalendar firstDate = new java.util.GregorianCalendar(2004, 1, 1); java.util.GregorianCalendar lastDate = new java.util.GregorianCalendar(2004, 12, 31);

8. Paquetes y el Estatuto import Escribir el nombre completo calificado de una clase es tedioso y el código resultante es difícil de leer. Por esta razón, Java ofrece el estatuto import . Se utiliza para "importar" una clase —o un paquete entero de clases —en un archivo.

9. Paquetes y el Estatuto import Una clase importada puede ser referenciada utilizando su nombre simple, el nombre completo calificado menos el nombre del paquete

10. Paquetes y el Estatuto import Un estatuto import está compuesto por la palabra clave import, un nombre completo calificado y un punto y coma: import java.util.GregorianCalendar;

11. Paquetes y el Estatuto import Esta instrucción, colocada al inicio de un archivo, hace posible escribir: GregorianCalendar firstDate = new GregorianCalendar(2004, 1, 1); GregorianCalendar lastDate = new GregorianCalendar(2004, 12, 31);

12. java.lang.String Debido a que Java no provee un tipo string primitivo, la clase java.lang.String se utiliza mucho. Java incluye la literal de la clase String, una secuencia de caracteres entre comillas dobles, tales como "abc". Una literal de la clase String es una instancia de la clase String.

13. métodos definidos en la clase String String () . Construye un nuevo objeto String que representa una secuencia vacía de caracteres. String(char [] value ) . Construye un nuevo objeto String que representa la secuencia de caracteres contenidos en el arreglo de caracteres. String(String original) . Construye un nuevo objeto String que representa la misma secuencia de caracteres que el argumento. int length () . Obtiene el número de caracteres en el String. char charAt(int index ) . Regresa el carácter que se encuentra en el índice especificado.

14. métodos definidos en la clase String boolean equals(Object anObject ) . Regresa verdadero si anObject representa un String con la misma secuencia de caracteres. int indexOf(int ch ) . Regresa el índice de la primera ocurrencia del carácter . int indexOf(String str ) . Regresa el índice de la primera ocurrencia del String. boolean startsWith(String prefix ) . Verifica si el String tiene el prefijo especificado. String substring(int beginIndex , int endIndex ) . Regresa una subcadena.

15. Operador clase String Java también provee el operador de concatenación de String ( + ). Es un operador binario que requiere dos operandos de tipo String.

16. Operador clase Strig Concatena estos operandos, regresando el resultado en un nuevo String. Las siguientes dos líneas representan objetos String equivalentes: "uno" + "dos" unodos

17. java.util.StringTokenizer Tokenización (tokenizing) es el proceso de descomponer una cadena en piezas más pequeñas llamadas tokens . Los tokens están separados, o delimitados, por un carácter o un grupo de caracteres

18. java.util.StringTokenizer Por ejemplo, si consideramos que la siguiente cadena es tokenizada utilizando espacios en blanco como delimitador, el resultado sería cinco tokens: "Esta cadena tiene cinco tokens"

19. java.util.StringTokenizer El espacio en blanco es el delimitador más común (espacio en blanco incluye el carácter de espacio, el carácter tabulador, el carácter de nueva línea, y el carácter retorno de carro). Otros delimitadores de uso frecuente son el guión bajo ( _ ) y la coma ( , ).

20. Métodos de StringTokenizer La clase StringTokenizer es parte del paquete java.util. La siguiente, es una lista de algunos de los métodos de la clase StringTokenizer: StringTokenizer(String str ) . Construye un tokenizador de cadenas. Utiliza el delimitador predeterminado, el espacio en blanco. StringTokenizer(String str , String delim ) . Construye un tokenizador de cadenas. El argumento delim contiene los caracteres delimitadores para separar los tokens.

21. Métodos de StringTokenizer boolean hasMoreTokens () . Verifica si hay más tokens que extraer. String nextToken(String delim ) . Regresa el siguiente token de la cadena. int countTokens () . Obtiene el número de tokens que aún pueden ser extraídos, no el número de tokens de la cadena.

22. Las Clases de Envoltura (Wrapper Classes) Existen muchas clases en el API de Java y los programadores pueden definir aún muchas más. Sin embargo, sólo se tienen disponibles unos cuantos primitivos. En ciertos aspectos, sería deseable que en los programas de Java pudiéramos tratar todos los datos de la misma manera consistente

23. Wrapper Classes Para hacer esto realidad, Java cuenta con clases que simulan a los tipos primitivos. Para cada tipo primitivo existe una de estas clases. java.lang.Byte java.lang.Short java.lang.Integer java.lang.Long java.lang.Character java.lang.Float java.lang.Double java.lang.Boolean