Merge pull request #516 from JoyOfCodingPDX/Winter2026-SNAPSHOT

Changes for Winter 2026:

- Resolve #478 by adding a tool to identify project submissions (.zip files) that need to be tested or need to be graded.
- Resolve #515 by adding a salutation to the grade report when letter grades are assigned.
- Resolve #498 by writing the grade totals for each student to a file in addition to standard output.
- Resolve #511 by having the Survey program exit if the `me.xml` file already exists.
- Improvements to the example `Student` project including fixes to typos and prevention of submission for grading.
- Use version 3.9.11 of Maven in the wrapper.
- Add an example of how to parse Phone Bill XML.
- Update the versions of third-party dependencies and Maven Plugins
- Resolve #526 by adding JDBC examples
- Improve error messages when no arguments are supplied to out-of-the-box project main methods.

Author: DavidWhitlock

.gitignore

@@ -18,3 +18,5 @@ target
 */target
 dependency-reduced-pom.xml
 
+# H2 database files
+*.db

.mvn/wrapper/maven-wrapper.properties

@@ -1,19 +1,3 @@
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-wrapperVersion=3.3.2
+wrapperVersion=3.3.4
 distributionType=only-script
-distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.9/apache-maven-3.9.9-bin.zip
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.11/apache-maven-3.9.11-bin.zip

examples/pom.xml

@@ -3,28 +3,23 @@
   <parent>
     <artifactId>joy</artifactId>
     <groupId>io.github.davidwhitlock.joy</groupId>
-    <version>1.2.3</version>
+    <version>1.2.4-SNAPSHOT</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
   <artifactId>examples</artifactId>
   <name>examples</name>
-  <version>1.3.4</version>
+  <version>1.4.0-SNAPSHOT</version>
   <url>https://www.cs.pdx.edu/~whitlock</url>
   <dependencies>
-    <dependency>
-      <groupId>io.github.davidwhitlock.joy</groupId>
-      <artifactId>family</artifactId>
-      <version>1.1.5</version>
-    </dependency>
     <dependency>
       <groupId>io.github.davidwhitlock.joy</groupId>
       <artifactId>projects</artifactId>
-      <version>3.0.3</version>
+      <version>3.0.4-SNAPSHOT</version>
     </dependency>
     <dependency>
       <groupId>com.sun.mail</groupId>
       <artifactId>jakarta.mail</artifactId>
-      <version>2.0.1</version>
+      <version>2.0.2</version>
     </dependency>
     <dependency>
       <groupId>com.google.inject</groupId>
@@ -34,20 +29,39 @@
     <dependency>
       <groupId>jakarta.xml.bind</groupId>
       <artifactId>jakarta.xml.bind-api</artifactId>
-      <version>4.0.2</version>
+      <version>4.0.4</version>
     </dependency>
     <dependency>
       <groupId>com.sun.xml.bind</groupId>
       <artifactId>jaxb-impl</artifactId>
-      <version>4.0.5</version>
+      <version>4.0.6</version>
       <scope>runtime</scope>
     </dependency>
+    <dependency>
+      <groupId>com.h2database</groupId>
+      <artifactId>h2</artifactId>
+      <version>${h2.version}</version>
+    </dependency>
     <dependency>
       <groupId>io.github.davidwhitlock.joy</groupId>
       <artifactId>projects</artifactId>
-      <version>3.0.3</version>
+      <version>3.0.4-SNAPSHOT</version>
       <classifier>tests</classifier>
       <scope>test</scope>
     </dependency>
   </dependencies>
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.codehaus.mojo</groupId>
+        <artifactId>build-helper-maven-plugin</artifactId>
+        <version>${build-helper-maven-plugin.version}</version>
+      </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-failsafe-plugin</artifactId>
+        <version>${surefire.version}</version>
+      </plugin>
+    </plugins>
+  </build>
 </project>

examples/src/it/java/edu/pdx/cs/joy/jdbc/DepartmentDAOIT.java

@@ -0,0 +1,101 @@
+package edu.pdx.cs.joy.jdbc;
+
+import org.junit.jupiter.api.*;
+
+import java.io.File;
+import java.sql.Connection;
+import java.sql.SQLException;
+
+import static org.hamcrest.MatcherAssert.assertThat;
+import static org.hamcrest.Matchers.*;
+
+@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
+public class DepartmentDAOIT {
+
+  private static final String TEST_DEPARTMENT_NAME = "Computer Science";
+  private static int generatedDepartmentId;
+
+  private static String dbFilePath;
+  private Connection connection;
+  private DepartmentDAO departmentDAO;
+
+  @BeforeAll
+  public static void createTable() throws SQLException {
+    // Create database file in temporary directory
+    String tempDir = System.getProperty("java.io.tmpdir");
+    dbFilePath = tempDir + File.separator + "DepartmentDAOIT.db";
+
+    // Connect to the file-based H2 database
+    Connection connection = H2DatabaseHelper.createFileBasedConnection(new File(dbFilePath));
+
+    // Create the departments table
+    DepartmentDAOImpl.createTable(connection);
+
+    connection.close();
+  }
+
+  @BeforeEach
+  public void setUp() throws SQLException {
+    // Connect to the existing database file
+    connection = H2DatabaseHelper.createFileBasedConnection(new File(dbFilePath));
+    departmentDAO = new DepartmentDAOImpl(connection);
+  }
+
+  @AfterEach
+  public void tearDown() throws SQLException {
+    if (connection != null && !connection.isClosed()) {
+      connection.close();
+    }
+  }
+
+  @AfterAll
+  public static void cleanUp() throws SQLException {
+    // Connect one final time to drop the table and clean up
+    Connection connection = H2DatabaseHelper.createFileBasedConnection(new File(dbFilePath));
+    DepartmentDAOImpl.dropTable(connection);
+    connection.close();
+
+    // Delete the database files
+    deleteIfExists(new File(dbFilePath + ".mv.db"));
+    deleteIfExists(new File(dbFilePath + ".trace.db"));
+  }
+
+  private static void deleteIfExists(File file) {
+    if (file.exists()) {
+      assertThat(file.delete(), is(true));
+    }
+  }
+
+  @Test
+  @Order(1)
+  public void testPersistDepartment() throws SQLException {
+    // Create and persist a department (ID will be auto-generated)
+    Department department = new Department(TEST_DEPARTMENT_NAME);
+    departmentDAO.save(department);
+
+    // Store the auto-generated ID for use in subsequent tests
+    generatedDepartmentId = department.getId();
+
+    // Verify that an ID was auto-generated
+    assertThat(generatedDepartmentId, is(greaterThan(0)));
+
+    // Verify the department was saved by fetching it in the same test
+    Department fetchedDepartment = departmentDAO.findById(generatedDepartmentId);
+    assertThat(fetchedDepartment, is(notNullValue()));
+    assertThat(fetchedDepartment.getId(), is(equalTo(generatedDepartmentId)));
+    assertThat(fetchedDepartment.getName(), is(equalTo(TEST_DEPARTMENT_NAME)));
+  }
+
+  @Test
+  @Order(2)
+  public void testFindPersistedDepartment() throws SQLException {
+    // Search for the department that was persisted in the previous test
+    // using the auto-generated ID
+    Department fetchedDepartment = departmentDAO.findById(generatedDepartmentId);
+
+    // Validate that the department persisted between test methods
+    assertThat(fetchedDepartment, is(notNullValue()));
+    assertThat(fetchedDepartment.getId(), is(equalTo(generatedDepartmentId)));
+    assertThat(fetchedDepartment.getName(), is(equalTo(TEST_DEPARTMENT_NAME)));
+  }
+}