/**
Az <Q>Adatbázis-programozás</Q> fejezet példaprogramjai.
<style>
blockquote, ul { font-style: italic }
</style>
<blockquote>
A Java nyelv hálózati szolgáltatásai miatt ideálisan megfelel kliens-szerver architektúrájú adatbázis-kezelő programok létrehozására.
Ezért felmerült az igény a legkülönfélébb adatbázisok elérési lehetőségére, amit a <em>JDBC</em> biztosít.
</blockquote>
Tartalomjegyzék a hivatkozott referenciákkal és felhasznált képekkel:
<ul>
<li>Referenciák:
    <ul>
    <li>A {@link java.sql} csomag
    <li>A {@link javax.sql} csomag
    </ul>
</ul>
<dl>
<dt>JDBC meghajtóprogramok
<dd><ul>
    <li>Referenciák:
        <ul>
        <li><a href="http://java.sun.com/products/jdbc/driverdesc.html" target=_blank>Meghajtóprogram típusok</a>
        </ul>
    </ul>
    <dl>
    <dt>Két- és háromrétegű adatbázis-elérési modell
    <dd>
    <dt>JDBC-nek megfelelő meghajtóprogramok
    <dd><ul>
        <li>Referenciák:
            <ul>
            <li>A {@link java.sql.Driver} interfész
            </ul>
        </ul>
    </dl>
<dt>ODBC--JDBC
<dd><ul>
    <li>Referenciák:
        <ul>
        <li><a href="http://java.sun.com/j2se/1.5.0/docs/guide/jdbc/bridge.html" target=_blank>Dokumentáció</a>
        </ul>
    </ul>
<dt>Továbbfejlesztési tervek
<dd>
<dt>A JDBC használata
<dd><ul>
    <li>Referenciák:
        <ul>
        <li><a href="http://java.sun.com/j2se/1.5.0/docs/guide/jdbc/" target=_blank>Útmutató</a>
        <li><a href="http://java.sun.com/j2se/1.5.0/docs/guide/jdbc/getstart/GettingStartedTOC.fm.html" target=_blank>Kézikönyv</a>
        </ul>
    </ul>
    <dl>
    <dt>Fordítás
    <dd>
    <dt>Futtatás
    <dd>
    </dl>
<dt>Meghajtóprogramok kezelése
<dd><dl>
    <dt>A meghajtóprogram kiválasztása
    <dd><ul>
        <li>Referenciák:
            <ul>
            <li>A {@link java.sql.DriverManager} osztály
            </ul>
        </ul>
    <dt>Meghajtóprogramok regisztrálása
    <dd>
    </dl>
<dt>Kapcsolattartás az adatbázissal
<dd><ul>
    <li>Referenciák:
        <ul>
        <li>A {@link java.sql.Connection} interfész
        </ul>
    </ul>
    <dl>
    <dt>Adatbázis-URL-ek
    <dd>
    <dt>Kapcsolat felvételének hagyományos módja
    <dd><ul>
        <li>Referenciák:
            <ul>
            <li>A {@link java.sql.DriverPropertyInfo} osztály
            </ul>
        </ul>
    <dt>Kapcsolat felvételének ajánlott módja
    <dd><ul>
        <li>Referenciák:
            <ul>
            <li>A {@link javax.sql.DataSource} interfész
            </ul>
        </ul>
        <dl>
        <dt>Kapcsolatok újrahasznosítása
        <dd><ul>
            <li>Referenciák:
                <ul>
                <li>A {@link javax.sql.ConnectionPoolDataSource} interfész
                <li>A {@link javax.sql.PooledConnection} interfész
                <li>A {@link javax.sql.ConnectionEventListener} interfész
                <li>A {@link javax.sql.ConnectionEvent} osztály
                </ul>
            </ul>
        </dl>
    <dt>Tranzakciókezelés
    <dd><ul>
        <li>Referenciák:
            <ul>
            <li>A {@link java.sql.Savepoint} interfész
            </ul>
        </ul>
        <dl>
        <dt>Tranzakció-izolációs szintek
        <dd>
        <dt>Globális tranzakciók
        <dd><ul>
            <li>Referenciák:
                <ul>
                <li>Az {@link javax.sql.XADataSource} interfész
                <li>Az {@link javax.sql.XAConnection} interfész
                </ul>
            </ul>
        </dl>
    <dt>Információ a kapcsolatról
    <dd><ul>
        <li>Referenciák:
            <ul>
            <li>A {@link java.sql.DatabaseMetaData} interfész
            </ul>
        </ul>
    <dt>Hibakezelés
    <dd><ul>
        <li>Referenciák:
            <ul>
            <li>Az {@link java.sql.SQLExcepiton} kivétel
            <li>Az {@link java.sql.SQLWarning} kivétel
            </ul>
        </ul>
    <dt>Kapcsolat lezárása
    <dd>
    </dl>
<dt>JDBC típusok
<dd><ul>
    <li>Referenciák:
        <ul>
        <li>A {@link java.sql.Types} osztály
        </ul>
    </ul>
    <dl>
    <dt>A JDBC típus használata
    <dd>
    <dt>SQL -- Java típusmegfeleltetés
    <dd><dl>
        <dt><code>CHAR</code>, <code>VARCHAR</code> és <code>LONGVARCHAR</code>
        <dd>
        <dt><code>DECIMAL</code> és <code>NUMERIC</code>
        <dd>
        <dt><code>BINARY</code>, <code>VARBINARY</code> és <code>LONGVARBINARY</code>
        <dd>
        <dt><code>BIT</code>, <code>BOOLEAN</code>
        <dd>
        <dt>Egész számok
        <dd>
        <dt>Lebegőpontos számok
        <dd>
        <dt>Dátum/idő
        <dd><ul>
            <li>Referenciák:
                <ul>
                <li>A {@link java.sql.Date} osztály
                <li>A {@link java.sql.Time} osztály
                <li>A {@link java.sql.TimeStamp} osztály
                </ul>
            </ul>
        <dt>Hivatkozás
        <dd>
        </dl>
    <dt>SQL3 adattípusok
    <dd><dl>
        <dt><code>BLOB</code>/<code>CLOB</code>
        <dd><ul>
            <li>Referenciák:
                <ul>
                <li>A {@link java.sql.Blob} interfész
                <li>A {@link java.sql.Clob} interfész
                </ul>
            </ul>
        <dt><code>ARRAY</code>
        <dd><ul>
            <li>Referenciák:
                <ul>
                <li>Az {@link java.sql.Array} interfész
                </ul>
            </ul>
        <dt><code>REF</code>
        <dd><ul>
            <li>Referenciák:
                <ul>
                <li>A {@link java.sql.Ref} interfész
                </ul>
            </ul>
        <dt>Az SQL <code>NULL</code> kezelése
        <dd>
        </dl>
    <dt>Felhasználói SQL adattípusok
    <dd><dl>
        <dt>Paraméteres (<code>DISTINCT</code>) felhasználói SQL típus
        <dd>
        <dt>Strukturált (<code>STRUCT</code>) felhasználói SQL típus
        <dd><ul>
            <li>Referenciák:
                <ul>
                <li>A {@link java.sql.Struct} interfész
                </ul>
            </ul>
        <dt>Felhasználói SQL adattípusok Java megfeleltetése
        <dd><ul>
            <li>Referenciák:
                <ul>
                <li>Az {@link java.sql.SQLData} interfész
                <li>Az {@link java.sql.SQLInput} interfész
                <li>Az {@link java.sql.SQLOutput} interfész
                <li>A {@link elte.java2_utikalauz5.jdbc.Rovidnev}, {@link elte.java2_utikalauz5.jdbc.Penz}, {@link elte.java2_utikalauz5.jdbc.Lakhely}, {@link elte.java2_utikalauz5.jdbc.Teljesnev}, {@link elte.java2_utikalauz5.jdbc.Szemely} és {@link elte.java2_utikalauz5.jdbc.Dolgozo} példatípusok
                </ul>
            </ul>
        </dl>
    <dt>Adatbázisbeli Java objektumok
    <dd>
    </dl>
<dt>SQL utasítások végrehajtása
<dd><dl>
    <dt>A <code>Statement</code> interfész
    <dd><ul>
        <li>Referenciák:
            <ul>
            <li>A {@link java.sql.Statement} interfész
            </ul>
        </ul>
        <dl>
        <dt><code>Statement</code> létrehozása
        <dd>
        <dt><code>Statement</code> végrehajtása
        <dd>
        <dt><code>Statement</code> megszakítása
        <dd>
        <dt><code>Statement</code> befejeződése
        <dd>
        <dt><em>Escape-szintaxis</em> használata
        </dl>
    <dt>A <code>PreparedStatement</code> interfész
    <dd><ul>
        <li>Referenciák:
            <ul>
            <li>A {@link java.sql.PreparedStatement} interfész
            </ul>
        </ul>
        <dl>
        <dt><code>PreparedStatement</code> létrehozása
        <dd>
        <dt><code>PreparedStatement</code> végrehajtása
        <dd>
        <dt>Bemenő paraméterek típusának lekérdezése
        <dd><ul>
            <li>Referenciák:
                <ul>
                <li>A {@link java.sql.ParameterMetaData} interfész
                </ul>
            </ul>
        <dt>Bemenő paraméterek értékének megadása
        <dd>
        <dt>Nagyméretű bemenő paraméterek megadása
        </dl>
    <dt>A <code>CallableStatement</code> interfész
    <dd><ul>
        <li>Referenciák:
            <ul>
            <li>A {@link java.sql.CallableStatement} interfész
            </ul>
        </ul>
        <dl>
        <dt><code>CallableStatement</code> létrehozása
        <dd>
        <dt><code>CallableStatement</code> végrehajtása
        <dd>
        <dt>Kimenő paraméterek értékeinek lekérdezése
        <dd>
        </dl>
    </dl>
<dt>SQL utasítások kötegelt végrehajtása
<dd><dl>
    <dt>Kötegelt végrehajtás előkészítése
    <dd>
    <dt>Kötegelt végrehajtás indítása
    <dd>
    <dt>Hibakezelés kötegelt végrehajtás esetén
    <dd><ul>
        <li>Referenciák:
            <ul>
            <li>A {@link java.sql.BatchUpdateException} kivétel
            </ul>
        </ul>
    <dt>Példa kötegelt végrehajtásra
    <dd><table class="pelda" border=1 cols=1><tr><td><pre>
int[] updateCounts;
Connection con=...                        // a felhasználandó adatbáziskapcsolat
Statement stmt=null;                             // a végrehajtandó SQL utasítás
try {
    con.setAutoCommit(false);            // automatikus véglegesítés kikapcsolva
    stmt = con.createStatement();                       // Statement létrehozása
    stmt.addBatch("CREATE TABLE NEVEK OF TELJESNÉV");       // tábla létrehozása
    stmt.addBatch("INSERT INTO NEVEK VALUES ('Gábor', 'Dénes')");  // feltöltése
    stmt.addBatch("INSERT INTO NEVEK VALUES ('Máté', 'Barbara')");
    stmt.addBatch("INSERT INTO NEVEK VALUES ('Csilla', 'Péter')");
    stmt.addBatch("DELETE FROM NEVEK");                            // és ürítése
    updateCounts = stmt.executeBatch();             // eredmény: {0, 1, 1, 1, 3}
    stmt = con.prepareStatement(       // ismétlődő feltöltés
                  "INSERT INTO NEVEK VALUES (?, ?)"); //előfordított utasítással
    ((PreparedStatement)stmt).setString(1, "Névtelen");
    for (int i=1; i<=10; i++) {
        ((PreparedStatement)stmt).setString(2, "Felhasználó"+i );
        stmt.addBatch();
    }
    updateCounts = stmt.executeBatch();       // eredmény: {1,1,1,1,1,1,1,1,1,1}
    stmt.addBatch("SELECT * FROM NEVEK");                     // itt még nem, de
    updateCounts = stmt.executeBatch(); //itt Exception (mivel select nem lehet)
} catch (BatchUpdateException bue) {                 // hibaüzenet megjelenítése
        System.err.println("BatchUpdateException: " + bue.getMessage());
        System.err.println("SQLState:  " + bue.getSQLState());
        System.err.println("ErrorCode:  " + bue.getErrorCode());
        System.err.println("Sikeres végrehajtások sormódosítási számai:");
        updateCounts = bue.getUpdateCounts();
        for (int i=1; i<=updateCounts.length; i++)
             System.err.println("\t" + i + ".: " + updateCounts[i]);
} catch (SQLException se) {
        System.err.println("SQLException: " + se.getMessage());
        System.err.println("SQLState:  " + se.getSQLState());
        System.err.println("ErrorCode:  " + se.getErrorCode());
} finally {                                        // erőforrások felszabadítása
        if (stmt != null) try {                            // Statement lezárása
           stmt.close();
        } catch (SQLException se) {}
        if (con != null)  try {                   // adatbáziskapcsolat lezárása
           con.close();
        } catch (SQLException se) {}
}
    </pre></table>
    </dl>
<dt>Eredménytáblák kezelése
<dd><ul>
    <li>Referenciák:
        <ul>
        <li>A {@link java.sql.ResultSet} interfész
        </ul>
    </ul>
    <dl>
    <dt>Eredménytábla típusok
    <dd>
    <dt>Eredménytábla létrehozása
    <dd>
    <dt>Eredménytábla elérésének optimalizálása
    <dd>
    <dt>Navigálás az eredménytáblában
    <dd>
    <dt>Értékek beolvasása
    <dd><ul>
        <li>Referenciák:
            <ul>
            <li>A {@link java.sql.ResultSetMetaData} interfész
            </ul>
        </ul>
    <dt>Értékek módosítása
    <dd>
    <dt>Új sor beszúrása
    <dd>
    <dt>Sor törlése
    <dd>
    <dt>Változások észlelése
    <dd>
    <dt>Eredménytábla lezárása
    <dd>
    </dl>
<dt>Önálló eredménytáblák
<dd><ul>
    <li>Referenciák:
        <ul>
        <li>A {@link javax.sql.RowSet} interfész
        </ul>
    </ul>
    <dl>
    <dt>Adatforrás megadása
    <dd>
    <dt>Eredménytábla feltöltése
    <dd><ul>
        <li>Referenciák:
            <ul>
            <li>A {@link javax.sql.RowSetInternal} interfész
            <li>A {@link javax.sql.RowSetReader} interfész
            <li>A {@link javax.sql.RowSetWriter} interfész
            </ul>
        </ul>
    <dt>Eredménytábla használata
    <dd><ul>
        <li>Referenciák:
            <ul>
            <li>A {@link javax.sql.RowSetMetaData} interfész
            </ul>
        </ul>
    <dt>Eredménytábla események
    <dd><ul>
        <li>Referenciák:
            <ul>
            <li>A {@link javax.sql.RowSetListener} interfész
            <li>A {@link javax.sql.RowSetEvent} osztály
            </ul>
        </ul>
    <dt>Önálló eredménytábla megvalósítások
    <dd><ul>
        <li>Referenciák:
            <ul>
            <li>A {@link javax.sql.rowset} csomag
            <li>A {@link javax.sql.rowset.BaseRowSet} osztály
            </ul>
        </ul>
        <dl>
        <dt>Önálló JDBC táblák
        <dd><ul>
            <li>Referenciák:
                <ul>
                <li>A {@link javax.sql.rowset.JdbcRowSet} interfész
                <li>A {@link javax.sql.rowset.RowSetWarning} kivétel
                </ul>
            </ul>
        <dt>Memória táblák
        <dd><ul>
            <li>Referenciák:
                <ul>
                <li>A {@link javax.sql.rowset.CachedRowSet} interfész
                <li>A {@link javax.sql.rowset.spi} csomag
                <li>A {@link javax.sql.rowset.spi.SyncProvider} osztály
                <li>A {@link javax.sql.rowset.spi.SyncProviderException} kivétel
                <li>A {@link javax.sql.rowset.spi.SyncResolver} interfész
                <li>A {@link javax.sql.rowset.spi.SyncFactory} osztály
                </ul>
            </ul>A következő példa lapozást használva végigmegy a teljes memóriatábla összes során:<br>
            <table class="pelda" border=1 cols=1><tr><td><pre>
Connection con = ...
CachedRowSet crs = ...

crs.setPageSize(100);                                   //100 soronként lapozunk
crs.execute(con);                                          //első lap feltöltése
do {
    while(crs.next()) {
        ...                                                     //sorfeldolgozás
    }
} while(crs.nextPage());                                               //lapozás
\end{verbatim}
            </pre></table><p>Az alábbi kóddal a véglegesítéskor fellépő szinkronizálási konfliktusokat saját magunk is feloldhatjuk:<br>
            <table class="pelda" border=1 cols=1><tr><td><pre>
Connection con = ...
CachedRowSet crs = ...

try {
    crs.acceptChanges(con);             //változások visszaírása az adatforrásba
} catch (SyncProviderException spe) {       //szinkronizálási hibák feldolgozása
    SyncResolver resolver = spe.getSyncResolver();
    Object régiérték;                     //az adatforrásból jövő aktuális érték
    Object ütközőérték:               //a szinkronizálási ütközést kiváltó érték
    Object újérték:                                   //a hibát feloldó új érték
    while(resolver.nextConflict())  {                  //ütközések végigolvasása
        if (resolver.getStatus() == SyncResolver.UPDATE_ROW_CONFLICT) {//módosít
            crs.absolute(resolver.getRow());  //eredeti adatforrásban pozícionál
            int oszlopok = crs.getMetaData().getColumnCount();  //oszlopok száma
            for (int oszlop = 1; oszlop <= oszlopok; oszlop++) {
                ütközőérték = resolver.getConflictValue(oszlop);
                if (ütközőérték != null)  {           //van ütközés az oszlopban
                    régiérték = crs.getObject(oszlop);
                    újérték = ...                            //ütközés feloldása
                    resolver.setResolvedValue(oszlop, újérték);
                }
            }
        }
    }
}
            </pre></table>
        <dt>Hálózati táblák
        <dd><ul>
            <li>Referenciák:
                <ul>
                <li>A {@link javax.sql.rowset.WebRowSet} interfész
                </ul>
            </ul>
        <dt>Szűrt táblák
        <dd><ul>
            <li>Referenciák:
                <ul>
                <li>A {@link javax.sql.rowset.FilteredRowSet} interfész
                <li>A {@link javax.sql.rowset.Predicate} interfész
                </ul>
            </ul>
        <dt>Önálló táblák összekapcsolása
        <dd><ul>
            <li>Referenciák:
                <ul>
                <li>A {@link javax.sql.rowset.JoinRowSet} interfész
                <li>A {@link javax.sql.rowset.Joinable} interfész
                </ul>
            </ul>
        </dl>
    </dl>
<dt>Példa
<dd><ul>
    <li>Képek:
        <ul>
        <li>A {@code JDBCTeszt} példaapplet grafikus felhasználói felülete<BR>
            <img src="{@docRoot}/../data/jdbc/img/JDBCTeszt.png">
        </ul>
    </ul>
</dl>

@link.forrásfájl {@docRoot}/../data/jdbc/src package-info.java
@author <A href="http://kispitye.hu" target=_blank>Kispitye Software</A>
*/
package elte.java2_utikalauz5.jdbc;