java/sql-dk/src/info/globalcode/sql/dk/formatting/Formatter.java
author František Kučera <franta-hg@frantovo.cz>
Tue, 07 Jan 2014 21:54:59 +0100
branchv_0
changeset 142 da1e38386d84
parent 101 97b0d9069133
child 155 eb3676c6929b
permissions -rw-r--r--
Formatters: structural change – new level „statement“ → query and parameters are no more duplicated into each result set or updates result
     1 /**
     2  * SQL-DK
     3  * Copyright © 2013 František Kučera (frantovo.cz)
     4  *
     5  * This program is free software: you can redistribute it and/or modify
     6  * it under the terms of the GNU General Public License as published by
     7  * the Free Software Foundation, either version 3 of the License, or
     8  * (at your option) any later version.
     9  *
    10  * This program is distributed in the hope that it will be useful,
    11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
    12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    13  * GNU General Public License for more details.
    14  *
    15  * You should have received a copy of the GNU General Public License
    16  * along with this program. If not, see <http://www.gnu.org/licenses/>.
    17  */
    18 package info.globalcode.sql.dk.formatting;
    19 
    20 import info.globalcode.sql.dk.Parameter;
    21 import info.globalcode.sql.dk.configuration.DatabaseDefinition;
    22 import java.util.List;
    23 
    24 /**
    25  *
    26  * @author Ing. František Kučera (frantovo.cz)
    27  */
    28 public interface Formatter extends AutoCloseable {
    29 
    30 	void writeStartBatch();
    31 
    32 	void writeStartDatabase(DatabaseDefinition databaseDefinition);
    33 
    34 	void writeEndDatabase();
    35 
    36 	void writeStartStatement();
    37 
    38 	void writeEndStatement();
    39 
    40 	void writeQuery(String sql);
    41 
    42 	void writeParameters(List<? extends Parameter> parameters);
    43 
    44 	void writeStartResultSet(ColumnsHeader header);
    45 
    46 	void writeEndResultSet();
    47 
    48 	void writeStartRow();
    49 
    50 	void writeColumnValue(Object value);
    51 
    52 	void writeEndRow();
    53 
    54 	void writeUpdatesResult(int updatedRowsCount);
    55 
    56 	void writeEndBatch();
    57 
    58 	/**
    59 	 * If an error occurs (e.g. lost connection during result set reading) this method will be
    60 	 * called even if there was no {@linkplain #writeEndBach()}.
    61 	 */
    62 	@Override
    63 	void close() throws FormatterException;
    64 }