Print

---

Author: [log in to unmask]
Date: Wed Oct 26 09:16:14 2016
New Revision: 4535

Log:
Added comments to the DAQ database driver.

Modified:
    java/trunk/users/src/main/java/org/hps/users/kmccarty/DatabaseDAQConfigDriver.java

Modified: java/trunk/users/src/main/java/org/hps/users/kmccarty/DatabaseDAQConfigDriver.java
 =============================================================================
--- java/trunk/users/src/main/java/org/hps/users/kmccarty/DatabaseDAQConfigDriver.java	(original)
+++ java/trunk/users/src/main/java/org/hps/users/kmccarty/DatabaseDAQConfigDriver.java	Wed Oct 26 09:16:14 2016
@@ -14,11 +14,23 @@
 import java.io.IOException;
 import java.io.StringReader;
 
+/**
+ * Driver <code>DatabaseDAQConfigDriver</code> is a variant of the
+ * standard DAQ configuration driver that reads configuration data from
+ * the run database instead of either local files or an EvIO file.
+ * 
+ * @author Kyle McCarty <[log in to unmask]>
+ */
 public class DatabaseDAQConfigDriver extends DAQConfigDriver {
     // Define the crate enumerables by crate number. Crates are
     // in the order 46, 37, 39.
     private static final Crate[] CRATES = { Crate.CONFIG3, Crate.CONFIG1, Crate.CONFIG2 };
     
+    /**
+     * Updates the DAQ configuration manager with DAQ settings from the
+     * run database.
+     * @param detector - The detector object. This is not actually used.
+     */
     @Override
     public void detectorChanged(Detector detector) {
         // Make sure that the run number is defined.
@@ -51,9 +63,25 @@
         manager.closeConnection();
     }
     
+    /**
+     * When loading from the database, information is pulled on detector
+     * change rather than by looking for a specific object in event data.
+     * As such, <code>process</code> is overwritten to do nothing.
+     * @param event - Object containing event data.
+     */
     @Override
     public void process(EventHeader event) { }
     
+    /**
+     * Parses the text dump containing the DAQ configuration and parses
+     * it into lines. Data is returned as an array of strings. The first
+     * array index corresponds to the crate dump and the second array
+     * to the line.
+     * @param triggerConfig - The DAQ configuration dump object.
+     * @return Returns the DAQ configuration parsed as a String array.
+     * @throws IOException Occurs if there is an error reading the dump
+     * stream.
+     */
     private static final String[][] getDataFileArrays(TriggerConfigData triggerConfig) throws IOException {
         // Create file readers to process the data files.
         StringReader[] fr = new StringReader[3];