Esta clase da soporte al manejo de tablas, bases de datos y web semántica. Una tabla es una lista no ordenada de registros. Cada uno de estos registros tiene un conjunto de atributos, (tambien llamados campos por analogía con los sistemas de bases de datos) que toman valores. Una tabla puede describirse mediante un fichero cuya primera línea (opcionalmente) contiene los nombres de los campos, y las siguientes líneas, una por registro los valores de cada uno de los atributos. El tamaño de las tablas es teóricamente ilimitado, aunque evidentemente nada hay ilimitado en informática, simplemente no se especifica su tamaño.

Esta clase soporta tanto fichero de texto en formato CSV con la extensión .txt o .csv; o ficheros en formato de hoja de cálculo con extendión .xlx o .xlsx.

public Table(String sURL, boolean hasTitleRow, String separator, String charSet, boolean filterHTML)
public Table(String sURL, boolean hasTitleRow, String separator)
public Table(String sURL, String separator, String charSet)
public Table(String sURL, String separator)
public Table(String sURL, boolean hasTitleRow)
public Table(String sURL)
public Table(Table table)
public Table()

Por comodidad de programación se han definido varios constructores. Unos llaman a otros pasándoles parámetros por defecto. Si se construye el objeto sin inicializarlo la primera operación debe ser la llamada al método getTable. Los constructores resuelven de forma inteligente la carga del fichero, dependiendo de su extensión. Por ejemplo los ficheros con extensión .xls se consideran ficheros de Excel en formato antiguo.

El constructor Table(Table table) es un constructor de copia, duplica la. tabla que se le pasa como parámetro construyendo una nueva instancia.

public void setTable(String sURL, boolean hasTitleRow)
public void setTable(String sURL, boolean hasTitleRow, String separator)
public void setTableXLS(String sURL, boolean hasTitleRow)
public void setTableXLSX(String sURL, boolean hasTitleRow)

Estos métodos sirven para cargar un fichero que contenga una tabla. Los tres primeros usan ficheros de texto, y los dos últimos ficheros de hojas de cálculo. (Ver la sección constructores para el significado de los parámetro)

public void setExclusive()
public void setNotExclusive()

La selección en una tabla tiene dos modos de funcionamiento exclusivo y no exclusivo. El modo exclusivo que es el que se usa por defecto elimina de la tabla cada registro que se haya seleccionando previamente, de manera que no se pueda seleccionar dos veces el mismo registro. El modo no exclusivo si lo permite. Si no se especifica lo contrario, el modo por defecto es exclusivo.

public void setFilterHTML()
public void setNotFilterHTML()

Los ficheros de tablas pueden contener caracteres especiales que cuando se presentan en una página web pueden no mostrarse correctamente. Para inidcar que Siette debe transformarr estos caracteres en secuencias correspondientes a entidades HTML. Por defecto esta opción esta activada, salvo que expresamente se llame al método setNotFilterHTML

public void setCharSet(String cs)

Indica el tipo de codificación del fichero de entrada. Por defecto UTF-8. Hay que llamar a este método antes de la lectura del fichero.

public void setMatchMode(int mode)
public void setExactMatch()
public void setPartialMatch()

Cuando se realizan búsquedas en la tabla, hay dos modos de hacerlo considerando que debe haber conincidencia total, o parcial entre el contenido de la tabla y la cadena de búsqueda. Por ejemplo, si la tabla contiene el valoralineamiento y la cadena de búsqueda es linea, la busqueda tendrá exito en el caso de que sea en modo parcial ya que parte de la cadena de la tabla contiene la cadena de búsqueda. Sin embargo si el modo es total este término no se considerará correspondiente a la búsqueda. Por fecto el modo es parcial.

Nótese que la secuencia de búsqueda es línea (con acento), a pesar de que el modo sea parcial puede que no se encuentre este valor, depende si se consideran iguales las letras acentuadas y no acentuadas. Ver setIgnoreCase y setIgnoreAccents.

public void setIgnoreCase()
public void setCaseSensitive()

Indica a Siette que al realizar las búsquedas en la tabla debe considerar como la misma letra las máyusculas y las minúsculas, o por el contrario, considerar que son letras diferentes.

public void setIgnoreAccent()
public void setNotIgnoreAccent()

Indica a Siette que al realizar las búsquedas en la tabla debe considerar como la misma letra los carecteres acentuados y los no acentuados, o por el contrario, considerar que son letras diferentes.

public int size()
public int nRows()
public int nCols()

Los métodos size y nRows devuelven el número de filas de la tabla. El método nCols devuelve el número de columnas (atributos).

public Table sort(int n)
public Table sort(String nombreColumna)
public Table sort(int n, boolean descendente)
public Table sort(String nombreColumna, boolean descendente)

Devuelve una tabla con las filas ordenadas según la n-sima columna, o bien el de la columna etiquetada con el valor nombreColumna . El segundo parámetro, en caso de usarse con el valor true indicaría que la ordenación se realizaría en orden inverso.

public Table selectTable(int columnPos, String[] attPos, int modePos, int columnNeg, String[] attNeg, int modeNeg )
public Table selectTable(int columnPos, String[] attPos, int columnNeg, String[] attNeg)
public Table selectTable(int columnPos, String[] attPos, int modePos)
public Table selectTable(int columnPos, String[] attPos)
public Table selectTable(int columnPos, String attPos)
 
public Table selectTable(String namePos, String[] attPos, int modePos, String nameNeg, String[] attNeg, int modeNeg )
public Table selectTable(String namePos, String[] attPos,  String nameNeg, String[] attNeg)
public Table selectTable(String namePos, String[] attPos, int modePos)
public Table selectTable(String namePos, String[] attPos)
public Table selectTable(String namePos, String attPos)

Todos estos métodos devuelven una subtabla a partir de la tabla original. Se han implementado diversos métodos para mayor facilidad en la programación, pero en realidad son el mismo método usando valores por defecto. La siguiente tabla indica el significado de cada uno de los parámetros:

Supongamos que la ttabla contiene una descripcion de prendas de vestir, y que existen los campos NOMBRE, TALLA y COLOR. Y sea el siguiente programa:

   Table t = new Table(...);
   String[] tallas = {"38","39","40"}
   String[] colores = {"rojo","azul"};
   Table t2 = t.selectTable("TALLA", tallas, Table.ANY, "COLOR", colores, Table.ANY);

La instrucción selectTable forma una subtabla que contiene solamente los registros que en el campo TALLA tienen el valor 28, 39 o 40, y que en el campo COLOR no tienen ni el valor rojo, ni el valor azul. La instrucción

   Table t3 = t.selectTable("COLOR", "rojo");

selecciona todos los registros que en el campo COLOR tengan el valor rojo. La tabla creada tendrá los mismos campos que la tabla original y conservará las opciones asignadas a la tabla original, como setFilterHTML], [[#setIgnoreCase, etc.

Para hacer búsquedas múltiples simplemente se pueden encadenar llamadas a este método. Por ejemplo:

  Table t4 = t.selectTable("COLOR", "rojo").select("TALLA","40");

crea una tabla con los registros de COLOR rojo de la TALLA 40. (Para ello crea una tabla intermedia a la que no se da nombre).

Finalemnte hay algunas funciones especiales

public Table selectTable(String[] attPos)
public Table selectTable(String attPos)

Buscan el valor o valores de attPos en cualquiera de los campos de la tabla.

public Table selectTable(int n)

Selecciona una subtabla con n filas elegidos al azar

public Table selectTable()

Devuelve una copia de la tabla integra.

public Set selectSet(int columnPos, String[] attPos, int modePos, int columnNeg, String[] attNeg, int modeNeg )
public Set selectSet(int columnPos, String[] attPos, int columnNeg, String[] attNeg)
public Set selectSet(int columnPos, String[] att, int mode)
public Set selectSet(int columnPos, String[] att)
public Set selectSet(int columnPos, String att)
 
public Set selectSet(String namePos, String[] attPos, int modePos, String nameNeg, String[] attNeg, int modeNeg )
public Set selectSet(String namePos, String[] attPos,  String nameNeg, String[] attNeg)
public Set selectSet(String namePos, String[] att, int mode)
public Set selectSet(String namePos, String[] att)
public Set selectSet(String namePos, String att)
 
public Set selectSet(String[] att)
public Set selectSet(String att)
public Set selectSet()

Son métodos similares a selectTable pero que devuelven conjuntos de elemntos de la clase siette.util.corpus.Row, una clase auxiliar para el manejo de tablas.

public String[][] selectAll(int columnPos, String[] attPos, int modePos, int columnNeg, String[] attNeg, int modeNeg)
public String[][] selectAll(int columnPos, String[] attPos, int columnNeg, String[] attNeg)
public String[][] selectAll(int columnPos, String[] att, int mode)
public String[][] selectAll(int columnPos, String[] att)
public String[][] selectAll(int columnPos, String att)
 
public String[][] selectAll(String namePos, String[] attPos, int modePos, String nameNeg, String[] attNeg, int modeNeg )
public String[][] selectAll(String namePos, String[] attPos,  String nameNeg, String[] attNeg)
public String[][] selectAll(String namePos, String[] att, int mode)
public String[][] selectAll(String namePos, String[] att)
public String[][] selectAll(String namePos, String att)
 
public String[][] selectAll(String[] att)
public String[][] selectAll(String att)
public String[][] selectAll()

Son métodos similares a selectTable pero que devuelven la tabla como una matriz de cadenas de caracteres String[][] por filas y columnas.

public String[] select(int columnPos, String[] attPos, int columnNeg, String[] attNeg)
public String[] select(int columnPos, String[] att)
public String[] select(int columnPos, String att)
public String[] select(int columnPos)
 
public String[] select(String namePos, String[] attPos, String nameNeg, String[] attNeg)
public String[] select(String namePos, String[] att)
public String[] select(String namePos, String att)
public String[] select(String[] att)
 
public String[] select(String att)
public String[] select()

public void addTable(Table t)

Añade ala tabla todas las filas de la otra tabla t.

public void delRow(int columnPos, String[] attPos, int modePos, int columnNeg, String[] attNeg, int modeNeg )
public void delRow(int columnPos, String[] attPos, int columnNeg, String[] attNeg)
public void delRow(int columnPos, String[] attPos, int modePos)
public void delRow(int columnPos, String[] attPos)
public void delRow(int columnPos, String attPos)
 
public void delRow(String namePos, String[] attPos, int modePos, String nameNeg, String[] attNeg, int modeNeg )
public void delRow(String namePos, String[] attPos,  String nameNeg, String[] attNeg)
public void delRow(String namePos, String[] attPos, int modePos)
public void delRow(String namePos, String[] attPos)
public void delRow(String namePos, String attPos)
 
public void delRow(String[] atts)
public void delRow(String att)

Son métodos similares a selectTable, pero lo único que hacen es borrar de la tabla los elementos que coinciden con los atributos que se le pasa.

public Row getRow(int i)

Devuelve un objeto de la clase siette.util.corpus.Row (una subclase de java.util.ArrayList<String> que representa una fila completa de la tabla.

public String[] get(int i)
public String get(int i, int j)
public String get(String[] rowString, String name)
public String get(int i, String name)

Devuelve el valor de un campo concreto de la tabla, por fila y columna. Téngase en cuenta que la numeración tanto de filas como columnas comienza en 0, por lo que la función:

 get(1,3)

devuelve el valor del cuarto campo del segundo registro. Puede indicarse la posición del registro por su nombre:

 get(1,"COLOR");

Devuele el valor del campo COLOR del segundo registro. (Si la tabla tiene una fila de títulos el segundo registro corresponderá a la tercera fila).

Esta funcion esta pensada para utilizarla junto con la clase siette.util.Random, obteniendo valores de registros al azar, por ejemplo:

 get(Random.nextInt(t.size()),"COLOR");

devuelve un color al azar, evidentemente con una frecuencia proporcional al número de ocurrencias que haya en la tabla.

public String[] get(int i)

La función get con un solo argumento devuelve un vector de String con todos los valores de la fila, es decir, es similar a la función getRow

public Set<String> getAlternativesSet(int j)
public Set<String> getAlternativesSet(String name)
 
public String[] getAlternatives(int j)
public String[] getAlternatives(String name)

Estos métodos devuelven o bien un conjunto o un array de cadenas de caracteres, (en cualquier caso, sin elementos repetidos), con todos los posibles valores del campo de la tabla que se indique. Por ejemplo para la tabla:

  PRENDA.   COLOR   TALLA
   X8978    azul     40
   X7866    rojo     39
   X7846    azul     39
   X7867    blanco   39
   X7836    rojo     40
   X7826    azul     39
   X7861    rojo     38

la llamada al método getAlternatives(“COLOR”) devuelve el array {“azul”,“rojo”,“blanco”}. Este método es útil junto con el método [#toPattern]] para crear patrones u opciones de respuesta a una pregunta.

public String[] getFirstRow()

Devuelve la primera fila de la tabla, es decir, un array con los nombres de todos los campos.

public String toString()

Devuelve sobre una cadena de caracteres toda la tabla, incluyendo la cabecera, con los valores separados por el separador por defecto.

public String find(int n)
public int find(String title)

Estas dos funciones son una la inversa de la otra. La primera devuelve el nombre del campo n-esimo (Iniciando la cuenta en 0), y la segunda devuelve la posición del campo title en la secuencia de campos.

public String[] allValues(ArrayList list, String title)
public String[] allValues(String title)

Devuelve todos los posibles valores de un campo. Ver getAlternatives. El prmer método esta pensado para recibir un objeto de la clase siette.util.corpus.Row como parámetro list.

public static String[][] getTable(ArrayList<String> list)
public static String[][] getTable(Set<Row> set)

Son funciones auxiliares para transformar las salidas de otros métodos en una matriz de cadenas de caracteres.

public static String toHint(String in, String remove, String replace)
public static String toHint(String in, Set<String> set, String replace)

Se trata de una funcion auxiliar que permite construir de forma automática ayudas en las preguntas generadas a partir de textos. Es de mucha utilidad cuando se trabaja con bases de datos y web semántica.

La función da como resultado la misma cadena in pero en la que se han reemplazado todas las ocurrencias de la ubcadenaremove por la cadena replace. La segunda función puede llamarse con un conjunto de cadenas de caracteres, y todas ellas serán reemplazadas. Por ejemplo

 String texto = "Johannes Chrysostomus Wolfgangus Theophilus Mozart "
              + "más conocido como Wolfgang Amadeus Mozart o simplemente Mozart"
              + "fue un compositor y pianista del antiguo Arzobispado de Salzburgo,"
              + "maestro del Clasicismo, considerado como uno de los músicos más"
              + " influyentes y destacados de la historia."
 String[] remove = {"Johannes", "Chrysostomus", "Wolfgangus",  
                     "Theophilus", "Mozart", "Amadeus" };            
 String replace = "___";             
 Table.toHint(texto, remove, replace); 

da como resultado:

 ___ ___ ___ ___ ___​ , más conocido como ___ ___ ___ o simplemente ___,
 fue un compositor y pianista del antiguo Arzobispado de Salzburgo, 
 maestro del Clasicismo, considerado como uno de los músicos más influyentes 
 y destacados de la historia.

public static String cap(String st)

Pone en mayúsculas la primera letra de una cadedena de caracteres st.

public static String toPattern(String in, boolean escape, int patternAlign)
public static String toPattern(String in, boolean escape)
public static String toPattern(String in)

Son métodos iguales a los de la clase siette.util.corpus.Dictionary.

El proposito de estas funciones es construir un patrón Siette a partir de una cadena de entrada in. Al construir un patrón Siette algunos caracteres son caracteres especiales que no pueden usarse directamente en las expresiones, si no se especifica otra cosa, estos caracteres simplemente se eliminan.

 out.println(Table.toPattern("Miguel (de) Cervantes"));

produce la salida

 Miguel de Ceravntes

Otra opciones, es construir el patrón de manera que conserve los caracteres especiales, para lo cual hay que precederlo del caracter deescape

 out.println(Table.toPattern("Miguel (de) Cervantes"),true);

produce la salida

 Miguel \(de\) Ceravntes

que es un patrón Siette valido. Finalmente tambien se puede construir un patrón Siette de manera que parte del texto sea opcional a derecha o izquierda, por ejemplo:

 out.println(Table.toPattern("Miguel de Cervantes"),false, Table.LEFT);

produce en la salida el patrón Siette:

 {{Miguel} de} Cervantes

o bien

 out.println(Table.toPattern("Aguila culebrera blanca"),false, Table.RIGHT);

produce en la salida el patrón Siette:

 Aguila{ culebrera{ blanca}}

El primer patrón daria como buena una respuesta que dijera simplemente Cervantes y el segundo una respuesta que dijera simplemente Aguila. Dependiendo de la aplicación unas veces es mas conveniente un patrón que otro.

public static String toPattern(Set set, int mode)
public static String toPattern(List aList, int mode)
public static String toPattern(String[] aString, int mode)
public static String toPatternAll(Set set)
public static String toPatternAll(List aList)
public static String toPatternAll(String[] aString)
public static String toPatternAny(Set set)
public static String toPatternAny(List aList)
public static String toPatternAny(String[] aString)

Este conjunto de métodos devuelve un patrón Siette combinando las cadenas de caracteres que se les pasan como argumentos, ya sea como un array de cadenas de caracteres, una lista o un conjunto. El atributo mode puede tomar dos valores, correspondientes a dos constantes de la clase Table.ALL y Table.ANY indciando como deben combianrse. Por ejemplo

   toPattern(new String[] {"rojo","azul","blanco"}, Table.ALL)

genera el siguiente patrón Siette:

   rojo+azul+blanco

que reconoce respuestas como:

   rojo,azul,blanco
   rojo,blanco,azul
   azul rojo blanco
   ...

Las versiones abreviadas de esta funcion imponen el modo en el propio nombre de la función, como por ejemplo

  toPatternAny(new String[] {"rojo","azul","blanco"})

que genera el patrón

  rojo|azul|blanco

que acepta cualquiera de estas cadenas como respuesta.

public static String toText(String[] aString, int mode, String lang)
public static String toText(Set set, int mode, String lang)
public static String toTextAll(String[] aString, String lang)
public static String toTextAll(Set set, String lang) 
public static String toTextAll(String s, String lang)
public static String toTextAny(String[] aString, String lang)
public static String toTextAny(Set set, String lang)
public static String toTextAny(String s, String lang)

Son métodos iguales a los de la clase siette.util.corpus.Dictionary.

Los métodos toText son similares a los métodos toPattern solo que en vez de crear un patrón Siette, forman una frase en lenguaje natural. Estan pensados para trabajar con una lista de atributos y generar textos que pueden usarse en las rpeguntas de respuesta corta como ejemplos de respuestas correctas, o en la seccion de ayuda. Por ejemplo,

   toText(new String[] {"rojo","azul","blanco"}, Table.ALL, "es")

devuelve la cadena de caracteres:

   rojo, azul y blanco 

Los métodos 'toTextAll' y toTextAny, utilizan un modo por defecto, por ejemplo

   toTextAll(new String[] {"red","blue","white"}, "en")

devuelve la cadena:

   red, blue and white