Mehr JavaDoc und Refactoring

src/main/java/de/uniluebeck/mi/projmi6/db/DBHandler.java

@@ -234,6 +234,13 @@ public class DBHandler {
         return stationen;
     }
 
+    /**
+     * Extrahiert ein Objekt {@link Station} aus einem gegebenen {@link ResultSet}.
+     *
+     * @param rs ResultSet from Database Query.
+     * @return {@link Station}
+     * @throws SQLException wenn Fehler bei der SQL Verarbeitung auftreten.
+     */
     private static Station getStation(ResultSet rs) throws SQLException {
         Station station = new Station();
         station.setStation(rs.getString("station"));
@@ -257,6 +264,13 @@ public class DBHandler {
         return faelle;
     }
 
+    /**
+     * Extrahiert ein Objekt {@link Fall} aus einem gegebenen {@link ResultSet}.
+     *
+     * @param rs ResultSet from Database Query.
+     * @return {@link Fall}
+     * @throws SQLException wenn Fehler bei der SQL Verarbeitung auftreten.
+     */
     private static Fall getFall(ResultSet rs) throws SQLException {
         Fall fall = new Fall();
 
@@ -274,6 +288,14 @@ public class DBHandler {
         return fall;
     }
 
+    /**
+     * Fuehrt {@code INSERT} bei einem neuen Datensatz und {@code UPDATE} bei einem existierenden Datensatz aus.
+     *
+     * @param fall zu verarbeitender Datensatz.
+     * @param mitarbid {@link Mitarbeiter#mitarbID} des aktuellen Benutzers/Mitarbeiters.
+     * @param isUpdate {@code true} wenn der Datensatz bereits existiert, sonst {@code false}.
+     * @throws SQLException wenn Fehler bei der SQL Verarbeitung auftreten.
+     */
     public static void setFall(Fall fall, int mitarbid, boolean isUpdate) throws SQLException {
         PreparedStatement statement;
         if (isUpdate) {
@@ -309,7 +331,7 @@ public class DBHandler {
         } else {
             statement.setTimestamp(7, null);
         }
-        statement.setString(8, fall.getVersichertenNummer());                           // Versichertennummer
+        statement.setString(8, fall.getVersichertenNummer());                          // Versichertennummer
         if (fall.getKasse() != null) {
             statement.setInt(9, fall.getKasse().getKassenID());                        // KassenID
         } else {
@@ -318,13 +340,23 @@ public class DBHandler {
         statement.setBoolean(10, fall.getStorniert());                                  // storniert
         statement.setInt(11, mitarbid);                                                 // Letzter Bearbeiter
         if (!isUpdate) {
-            statement.setInt(12, fall.getPatient().getPatID());                              // PatientID
+            statement.setInt(12, fall.getPatient().getPatID());                         // PatientID
             statement.setInt(13, mitarbid);                                             // Ersteller
         }
 
         statement.execute();
     }
 
+    /**
+     * Fuehrt {@code INSERT} eines neuen Datensatz durch.
+     * @param fall zu verarbeitender Datensatz.
+     * @param mitarbid {@link Mitarbeiter#mitarbID} des aktuellen Benutzers/Mitarbeiters.
+     * @throws SQLException wenn Fehler bei der SQL Verarbeitung auftreten.
+     */
+    public static void setFall(Fall fall, int mitarbid) throws SQLException {
+        setFall(fall, mitarbid, false);
+    }
+
     private static Diagnose getDiagnose(int diagid, Fall fall) throws SQLException {
         Diagnose diagnose = getDiagnose(diagid);
         diagnose.setFall(fall);
@@ -341,6 +373,13 @@ public class DBHandler {
         return getDiagnose(rs);
     }
 
+    /**
+     * Extrahiert ein Objekt {@link Diagnose} aus einem gegebenen {@link ResultSet}.
+     *
+     * @param rs ResultSet from Database Query.
+     * @return {@link Diagnose}
+     * @throws SQLException wenn Fehler bei der SQL Verarbeitung auftreten.
+     */
     private static Diagnose getDiagnose(ResultSet rs) throws SQLException {
         Diagnose diagnose = new Diagnose();
 
@@ -386,6 +425,13 @@ public class DBHandler {
         return getIcd10Code(rs);
     }
 
+    /**
+     * Extrahiert ein Objekt {@link Icd10Code} aus einem gegebenen {@link ResultSet}.
+     *
+     * @param rs ResultSet from Database Query.
+     * @return {@link Icd10Code}
+     * @throws SQLException wenn Fehler bei der SQL Verarbeitung auftreten.
+     */
     private static Icd10Code getIcd10Code(ResultSet rs) throws SQLException {
         String code = rs.getString("icd10code");
         String text = rs.getString("text");
@@ -417,6 +463,13 @@ public class DBHandler {
         return getOpsCode(rs);
     }
 
+    /**
+     * Extrahiert ein Objekt {@link OpsCode} aus einem gegebenen {@link ResultSet}.
+     *
+     * @param rs ResultSet from Database Query.
+     * @return {@link OpsCode}
+     * @throws SQLException wenn Fehler bei der SQL Verarbeitung auftreten.
+     */
     private static OpsCode getOpsCode(ResultSet rs) throws SQLException {
         String code = rs.getString("opscode");
         String text = rs.getString("text");
@@ -447,6 +500,13 @@ public class DBHandler {
         return getMitarbeiter(rs);
     }
 
+    /**
+     * Extrahiert ein Objekt {@link Mitarbeiter} aus einem gegebenen {@link ResultSet}.
+     *
+     * @param rs ResultSet from Database Query.
+     * @return {@link Mitarbeiter}
+     * @throws SQLException wenn Fehler bei der SQL Verarbeitung auftreten.
+     */
     private static Mitarbeiter getMitarbeiter(ResultSet rs) throws SQLException {
         Mitarbeiter mitarbeiter = new Mitarbeiter(rs.getInt("mitarbid"));
         mitarbeiter.setTitel(rs.getString("titel"));
@@ -543,6 +603,13 @@ public class DBHandler {
         return kassen;
     }
 
+    /**
+     * Extrahiert ein Objekt {@link Kasse} aus einem gegebenen {@link ResultSet}.
+     *
+     * @param rs ResultSet from Database Query.
+     * @return {@link Kasse}
+     * @throws SQLException wenn Fehler bei der SQL Verarbeitung auftreten.
+     */
     private static Kasse getKasse(ResultSet rs) throws SQLException {
         Kasse kasse = new Kasse();
         kasse.setKassenID(rs.getInt("kassenid"));
@@ -552,8 +619,4 @@ public class DBHandler {
         setVersionInformation(kasse, rs);
         return kasse;
     }
-
-    public static void setFall(Fall fall, int mitarbid) throws SQLException {
-        setFall(fall, mitarbid, false);
-    }
 }