KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > calipso > reportgenerator > reportcalculator > IDataSource


1 /*
2
3  */
4
5 package com.calipso.reportgenerator.reportcalculator;
6
7 import java.util.Collection JavaDoc;
8 import com.calipso.reportgenerator.common.InfoException;
9
10 /**
11  * Almacena y permite modificar datos en una matriz de objetos de dos dimensiones.
12  * Sólo permite introducir valores fila a fila.
13  */
14 public interface IDataSource {
15     /**
16      * Devuelve el número de filas de esta matriz de objetos
17      * @return número de filas
18      */
19     public int getRowCount();
20
21     /**
22      * Devuelve el número de columnas de esta matriz de objetos
23      * @return número de columnas
24      */
25     public int getColumCount();
26
27     /**
28      * Devuelve el nombre de la columna
29      * @param colum - número de columna
30      * @return Nombre de la columna
31      * @throws IndexOutOfBoundsException - Si la posición solicitada no se encuadra en las dimensiones de la matriz
32      */
33     public String JavaDoc getColumName(int colum) throws IndexOutOfBoundsException JavaDoc;
34
35     /**
36      * Asigna un nombre a una columna
37      * @param colum - número de columna
38      * @param name - nombre que se asigna a la columna
39      * @throws IndexOutOfBoundsException - Si la posición solicitada no se encuadra en las dimensiones de la matriz
40      * @throws InfoException - Si el nombre que se desea asignar a la columna es null
41      */
42     public void setColumName(int colum, String JavaDoc name) throws IndexOutOfBoundsException JavaDoc, InfoException;
43
44     /**
45      * Devuelve el objeto posicionado en la fila y columna especificada
46      * @param row - Número de fila
47      * @param colum - Número de columna
48      * @return Object posicionado en la fila row y columna colum
49      * @throws IndexOutOfBoundsException - Si la posición solicitada no se encuadra en las dimensiones de la matriz
50      */
51     public Object JavaDoc getValueAt(int row, int colum) throws IndexOutOfBoundsException JavaDoc;
52
53     /**
54      * Devuelve los objetos posicionados en la columna especificada
55      * @param colum - número de columna
56      * @return Collection con los objetos seleccionados
57      * @throws IndexOutOfBoundsException - Si la posición solicitada no se encuadra en las dimensiones de la matriz
58      */
59     public Collection JavaDoc getColumValues(int colum) throws IndexOutOfBoundsException JavaDoc;
60
61     /**
62      * Devuelve los objetos posicionados en la columna especificada
63      * @param row - número de fila
64      * @return Collection con los objetos seleccionados
65      * @throws IndexOutOfBoundsException - Si la posición solicitada no se encuadra en las dimensiones de la matriz
66      */
67     public Collection JavaDoc getRowValues(int row) throws IndexOutOfBoundsException JavaDoc;
68
69     /**
70      * Modifica el objeto posicionado en la coordenada solicitada
71      * @param row - número de fila
72      * @param colum - número de columna
73      * @param newValue - nuevo valor a posicionar en la coordenada solicitada
74      * @throws IndexOutOfBoundsException - Si la posición solicitada no se encuadra en las dimensiones de la matriz
75      */
76     public void updateValueAt(int row, int colum, Object JavaDoc newValue) throws IndexOutOfBoundsException JavaDoc;
77
78     /**
79      * Añade una nueva fila a la matriz
80      * @param row - Fila a insertar
81      * @throws InfoException - Si la fila que se desea introducir no tiene el mismo número de columnas que la matriz
82      */
83     public void addRow(Collection JavaDoc row) throws InfoException;
84 }
85
Popular Tags