uva.infor.soft
Class TextFile

java.lang.Object
  uva.infor.soft.TextFile

public class TextFile
extends java.lang.Object

La clase TextFile representa a un fichero de texto abierto para lectura o para escritura, e implementa métodos para leer y escribir datos de tipo primitivo y detectar condiciones de fin de linea y fin de fichero asi como detectar errores en la última operación realizada.

La lectura de datos se ha implementado usando las facilidades de StreamTokenizer.

La consola (habitualmente el teclado y la pantalla) se representa por un objeto estático SimpleIO.Consola de este tipo, abierto simultaneamente para lectura y escritura.

Un fichero físico, sin embargo, sólo puede crearse en modo lectura o modo escritura. Las operaciones disponibles dependen del modo de apertura.

• MODO_LECTURA: No existe una operación de lectura general, sino una operación por cada tipo de dato primitivo y String.
  • readBoolean()
  • readChar()
  • readInt()
  • readDouble()
  • readKeyword()
  • readLine()
  Existen dos funciones para descartar datos del fichero:
  • skipChar()
  • skipLine()
  Y funciones para comprobar el fin de linea y de fichero:
  • isEndOfLine()
  • isEndOfFile()
• MODO_ESCRITURA: Para escribir existen tres métodos:
  • write(tipo valor) sobrecargado para los tipos primitivos.
  • writeln(tipo valor) identico al anterior salvo que pasa a la siguiente linea.
  • writeFmt(String, Object...) para la escritura con formato.
  Para la detección de errores se han creado dos funciones:
  • status()
  • msgError()
  las cuales permiten comprobar si la última operación se realizó correctamente y en caso contrario obtener un mensaje que explica el error.

  Since:

  28/04/2010

  Author:

  César Vaca Rodríguez

  Constructor Summary

  protected	TextFile() Constructor del fichero de texto asociado a la consola.
  	TextFile(java.lang.String nomFich, int modo) Constructor de un fichero de texto y apertura del mismo.

  Method Summary

  void	close() Cierra el fichero, permitiendo que otros programas puedan acceder a él.
  boolean	isEndOfFile() Comprueba si quedan o no datos por leer en el fichero.
  boolean	isEndOfLine() Comprueba si quedan o no datos por leer en la linea actual.
  java.lang.String	msgError() Permite obtener un String que describe el último error producido.
  boolean	readBoolean() Lee una valor booleano del fichero (creado para lectura).
  char	readChar() Lee un carácter del fichero (creado para lectura).
  double	readDouble() Lee un número real del fichero (creado para lectura).
  int	readInt() Lee un entero del fichero (creado para lectura).
  java.lang.String	readKeyword() Lee una palabra del fichero (creado para lectura).
  java.lang.String	readLine() Lee el resto de la linea.
  void	skipChar() Pasa al siguiente carácter del fichero (creado para lectura).
  void	skipLine() Avanza hasta el principio de la linea siguiente.
  int	status() Permite comprobar si la última operación sobre el fichero se ha realizado correctamente.
  void	write(boolean val) Escribe la traducción a texto de val al fichero.
  void	write(char val) Escribe la traducción a texto de val al fichero.
  void	write(double val) Escribe la traducción a texto de val al fichero.
  void	write(int val) Escribe la traducción a texto de val al fichero.
  void	write(java.lang.String val) Escribe el string val al fichero.
  void	writeFmt(java.lang.String fmt, java.lang.Object... args) Escribe la cadena fmt formateada con los argumentos arg de la manera descrita en PrintWriter.format(String, Object...).
  void	writeln(boolean val) Escribe la traducción a texto de val al fichero, pasando a la siguiente linea.
  void	writeln(char val) Escribe la traducción a texto de val al fichero, pasando a la siguiente linea.
  void	writeln(double val) Escribe la traducción a texto de val al fichero, pasando a la siguiente linea.
  void	writeln(int val) Escribe la traducción a texto de val al fichero, pasando a la siguiente linea.
  void	writeln(java.lang.String val) Escribe el string val al fichero, pasando a la siguiente linea.

  Methods inherited from class java.lang.Object

  clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  Constructor Detail

  TextFile

  protected TextFile()

  Constructor del fichero de texto asociado a la consola.

  TextFile

  public TextFile(java.lang.String nomFich,
                  int modo)

  Constructor de un fichero de texto y apertura del mismo.

  Parameters:

  nomFich - Ruta y nombre del fichero

  modo - Modo de apertura:

  • MODO_LECTURA: Abre un fichero existente para lectura de datos.
  • MODO_ESCRITURA: Crea un nuevo fichero vacío (si ya existe se borra el anterior) y permite escribir datos en el.

  Method Detail

  close

  public void close()

  Cierra el fichero, permitiendo que otros programas puedan acceder a él.

  isEndOfLine

  public boolean isEndOfLine()

  Comprueba si quedan o no datos por leer en la linea actual.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Returns:

  true si no quedan datos en la linea, false si quedan datos por leer.

  isEndOfFile

  public boolean isEndOfFile()

  Comprueba si quedan o no datos por leer en el fichero.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado, o se intenta realizar esta comprobación sobre la consola.

  Returns:

  true si se ha alcanzado el final del fichero, false si quedan datos por leer.

  status

  public int status()

  Permite comprobar si la última operación sobre el fichero se ha realizado correctamente.

  Returns:

  Codigo de la ultima operacion (apertura, lectura, escritura, etc.)

  • NO_ERROR: Operación correcta.
  • ERROR_INDEFINIDO: Fallo I/O.
  • ERROR_APERTURA: Fichero inexistente o no editable.
  • ERROR_CONVERSION: Imposible obtener dato requerido.
  • ERROR_FIN_FICHERO: Se alcanzó el final de fichero.

  msgError

  public java.lang.String msgError()

  Permite obtener un String que describe el último error producido.

  Returns:

  Mensaje de error

  readChar

  public char readChar()

  Lee un carácter del fichero (creado para lectura). El fin de linea se trata como un carácter normal.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Posibles códigos de error (obtenidos llamando a status()):

  • ERROR_INDEFINIDO: Error de I/O
  • ERROR_FIN_FICHERO: Intento de lectura tras fin de fichero

  Returns:

  El carácter leido o 0 si se ha producido un error

  skipChar

  public void skipChar()

  Pasa al siguiente carácter del fichero (creado para lectura). El fin de linea se trata como un carácter normal.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Posibles códigos de error (obtenidos llamando a status()):

  • ERROR_INDEFINIDO: Error de I/O
  • ERROR_FIN_FICHERO: Intento de lectura tras fin de fichero

  readInt

  public int readInt()

  Lee un entero del fichero (creado para lectura). No se bloquea en el fin de linea. El número entero debe estar rodeado por separadores y no terminar en un punto.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Posibles códigos de error (obtenidos llamando a status()):

  • ERROR_INDEFINIDO: Error de I/O
  • ERROR_FIN_FICHERO: Intento de lectura tras fin de fichero
  • ERROR_CONVERSION: No se puede traducir a entero. Si se llama a msgError() se puede obtener un mensaje personalizado indicando la naturaleza concreta del error.

  Returns:

  El entero leido o 0 si se ha producido un error.

  readDouble

  public double readDouble()

  Lee un número real del fichero (creado para lectura). No se bloquea en el fin de linea. El número real debe estar rodeado por separadores. El separador decimal es el punto.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Posibles códigos de error (obtenidos llamando a status()):

  • ERROR_INDEFINIDO: Error de I/O
  • ERROR_FIN_FICHERO: Intento de lectura tras fin de fichero
  • ERROR_CONVERSION: No se puede traducir a entero. Si se llama a msgError() se puede obtener un mensaje personalizado indicando la naturaleza concreta del error.

  Returns:

  El número real leido o 0 si se ha producido un error.

  readKeyword

  public java.lang.String readKeyword()

  Lee una palabra del fichero (creado para lectura). No se bloquea en el fin de linea. Una palabra se define como la serie contigua de mayor longitud consistente en letras o dígitos.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Posibles códigos de error (obtenidos llamando a status()):

  • ERROR_INDEFINIDO: Error de I/O
  • ERROR_FIN_FICHERO: Intento de lectura tras fin de fichero

  Returns:

  La palabra leída o "" si se ha producido un error.

  readBoolean

  public boolean readBoolean()

  Lee una valor booleano del fichero (creado para lectura). No se bloquea en el fin de linea. Las palabras true, yes, si, ok, vale (o sus abreviaturas) generan el resultado true, y el resto de entradas genera el resultado false.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Posibles códigos de error (obtenidos llamando a status()):

  • ERROR_INDEFINIDO: Error de I/O
  • ERROR_FIN_FICHERO: Intento de lectura tras fin de fichero
  • ERROR_CONVERSION: Se ha leído un carácter especial

  Returns:

  El valor booleano leído o false si se ha producido un error.

  readLine

  public java.lang.String readLine()

  Lee el resto de la linea. Procesa el fin de linea de forma que la siguiente lectura sea en la linea siguiente.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Posibles códigos de error (obtenidos llamando a status()):

  • ERROR_INDEFINIDO: Error de I/O

  Returns:

  Un String conteniendo el resto de la linea.

  skipLine

  public void skipLine()

  Avanza hasta el principio de la linea siguiente.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Posibles códigos de error (obtenidos llamando a status()):

  • ERROR_INDEFINIDO: Error de I/O

  write

  public void write(boolean val)

  Escribe la traducción a texto de val al fichero.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Parameters:

  val -

  write

  public void write(char val)

  Escribe la traducción a texto de val al fichero.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Parameters:

  val -

  write

  public void write(int val)

  Escribe la traducción a texto de val al fichero.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Parameters:

  val -

  write

  public void write(double val)

  Escribe la traducción a texto de val al fichero.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Parameters:

  val -

  write

  public void write(java.lang.String val)

  Escribe el string val al fichero.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Parameters:

  val -

  writeln

  public void writeln(boolean val)

  Escribe la traducción a texto de val al fichero, pasando a la siguiente linea.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Parameters:

  val -

  writeln

  public void writeln(char val)

  Escribe la traducción a texto de val al fichero, pasando a la siguiente linea.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Parameters:

  val -

  writeln

  public void writeln(int val)

  Escribe la traducción a texto de val al fichero, pasando a la siguiente linea.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Parameters:

  val -

  writeln

  public void writeln(double val)

  Escribe la traducción a texto de val al fichero, pasando a la siguiente linea.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Parameters:

  val -

  writeln

  public void writeln(java.lang.String val)

  Escribe el string val al fichero, pasando a la siguiente linea.

  Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.

  Parameters:

  val -

  writeFmt

  public void writeFmt(java.lang.String fmt,
                       java.lang.Object... args)

  Escribe la cadena fmt formateada con los argumentos arg de la manera descrita en PrintWriter.format(String, Object...).

  Parameters:

  fmt -

  args -