JSBS_DBA_Set – Basisklasse für den Low-Level Zugriff auf Datenbank-Tabellen

Inhaltsverzeichnis

Code 
Erklärungen und Anwendungsbeispiele 
Verwandte Dokumentation 

Code

package js_base.dba;

import java.util.*;

/**
 *
 * @author kurt@javascout.biz
 * @date 2006-11-16
 *
 * @description
 *  de:
 *  Basisklasse für Data-Base-Access (DBA) Objekte die ein Set von Datensätzen halten.
 *  Diese Klasse kann von DBA_Set-Objekte, die für eine bestimmte Datenbank-Tabelle entworfen
 *  ist, geerbt werden.
 *  en:
 *  Base-Class for Data-Base-Access (DBA) Objects holding sets of data-records.
 *  This class can be inherited by DBA_Set Objects designed for a dedicated database-table.
 *
 * @change-log
 * when         who               why
 * --------------------------------------------------------
 *
 */
public class JSBS_DBA_Set {
/*
 * de:
 * Vector der das Set mit den Datensätzen enthält.
 * Diese Variable definiert nicht die Struktur des Vector-Inhalts;
 * die Umwandlung hat in der Klasse, die diese Basisklasse erbt, zu erfolgen.
 * en:
 * Vector holding the set of read data-records.
 * This variable does not define the structure of the vector content;
 * the conversion has to be done within the class inheriting this base-class. */
    public Vector vecRecordSet = new Vector();
/*
 * de: Zeichenkette mit einer möglicher Fehlermeldung vom Datenbanksystem.
 * en: String with a possible Error-Message from the database system. */
    public String ErrorMsg = "";
/*
 * de:
 * Werte im java.sql.Date Format zum Vergleichen des Gültigkeitsbereiches des
 * gelesenen Datensatzes mit dem 'aktuellen' Datum das als Wert innerhalb der
 * Struktur JSBS_MinimalParameters übergeben wurde.
 * en:
 * Values in java.sql.Date format to compare the validity range of the read record
 * with the 'actual' date passed as value in the structure JSBS_MinimalParameters. */
    protected java.sql.Date locdteReadValidFrom;
    protected java.sql.Date locdteReadValidTill;
    protected java.sql.Date locdteActualDate;
/*
 * --------------------
 * de:
 * Methode zum Vergleichen ob ein gegebenes Datum innerhalb eines Datumsbereiches ist.
 * Notwendig in allen Methoden (von erbenden Klassen) die nur 'aktive' Datensätze
 * auswählen sollen.
 * en:
 * Method to compare if a given date is within a date-range.
 * Necessary in all methods (of derived classes) that should just select
 * 'active' data-records. */
    public boolean isWithinDateRange(java.sql.Date parmActualDate,
                                     java.sql.Date parmValidFrom,
                                     java.sql.Date parmValidTill) {
/* de:
 * Zum Vergleichen wird vom java.sql.Date Format ein Format umgewandelt, mit dem
 * zwei Datums-Werte leichter verglichen werden können.
 * Die erste Zeile enthält den Vergleich, ob der Datensatz zum aktuellen Datum oder später
 * noch gültig ist;
 * die zweite Zeile enthält den Vergleich, ob die Gültigkeit vor dem aktuellen Datum begonnen hat.
 * en:
 * For an easier comparison of 2 date-values the java.sql.Date format is converted to another
 * format.
 * The first line contains the comparison, if the data-set is valid at the actual date or later;
 * the second line contains the comparison, if the validity started before the actual date. */
      return ((parmActualDate.getTime() <= parmValidTill.getTime())
              && (parmValidFrom.getTime() <= parmActualDate.getTime()));
    }
/*
 * --------------------
 * de:
 * Methode zum Prüfen ob die Gültigkeit eines Datensatzes erst nach dem aktuellen Datum endet.
 * en:
 * Method to verify if the validity of a data-set ends after the actual date. */
    public boolean endsAfterWorkDate(java.sql.Date parmActualDate,
                                     java.sql.Date parmValidTill) {
/* de:
 * Zum Vergleichen wird vom java.sql.Date Format ein Format umgewandelt, mit dem
 * zwei Datums-Werte leichter verglichen werden können.
 * Dann wird der Vergleich ausgeführt.
 * en:
 * For an easier comparison of 2 date-values the java.sql.Date format is converted to another
 * format.
 * Then the comparison is carried out. */
      return (parmActualDate.getTime() <= parmValidTill.getTime());
    }
}

▲ zum Inhaltsverzeichnis

Erklärungen und Anwendungsbeispiele

xxx

▲ zum Inhaltsverzeichnis

Verwandte Dokumentation

▲ zum Inhaltsverzeichnis