Building the Application

Prerequisites

Before building the application, ensure you have the following installed:

Java Development Kit (JDK) 21

The project requires Java 21 or later. Verify your installation:

java -version

The output should show version 21 or higher.

Apache Maven 3.6+

Maven is used for dependency management and building. Verify installation:

mvn -version

Git

Required for cloning the repository:

git --version

The project uses Maven’s compiler plugin version 3.13.0 configured for Java 21 source and target compatibility.

Cloning the Repository

Clone the project repository to your local machine:

git clone <repository-url>
cd Refactorizacion-ALFA

Project Structure

The project follows Maven’s standard directory layout:

Refactorizacion-ALFA/
├── pom.xml                 # Maven configuration
├── src/
│   └── main/
│       └── java/
│           ├── InventarioApp.java
│           ├── controller/
│           ├── model/
│           └── view/
├── input/                  # Input data files
└── target/                 # Build output (generated)

Dependencies

The project uses the following main dependencies:

SQLite JDBC (3.41.2.1): Database connectivity
JUnit Jupiter (5.10.0): Testing framework (test scope)
JCalendar (1.4): Date picker components

Clean Build

To perform a clean build, removing any previous build artifacts:

mvn clean

Compile Source Code

To compile the source code without running tests:

mvn compile

Package the Application

To create both a standard JAR and a fat JAR with all dependencies:

mvn package

This command will:

Compile the source code
Run tests (if present)
Create a standard JAR in target/
Create a fat JAR with all dependencies using the Maven Shade Plugin

The Maven Shade Plugin is configured to create an executable JAR that includes all dependencies (SQLite JDBC, JCalendar) bundled together.

Skip Tests During Build

If you need to build without running tests:

mvn package -DskipTests

Build Output

After a successful build, you’ll find the following in the target/ directory:

target/Refactorizacion-ALFA-1.0-SNAPSHOT.jar

Use the shaded JAR (fat JAR) for distribution and execution, as it contains all required dependencies.

Running the Application

From Fat JAR

The recommended way to run the application is using the fat JAR:

java -jar target/Refactorizacion-ALFA-1.0-SNAPSHOT.jar

From Maven

Alternatively, you can run directly using Maven:

mvn exec:java -Dexec.mainClass="InventarioApp"

Maven Plugins Configuration

Compiler Plugin

Configured for Java 21 compilation:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.13.0</version>
    <configuration>
        <source>21</source>
        <target>21</target>
    </configuration>
</plugin>

JAR Plugin

Creates a standard JAR with manifest entry for the main class:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <version>3.2.2</version>
    <configuration>
        <archive>
            <manifest>
                <mainClass>InventarioApp</mainClass>
            </manifest>
        </archive>
    </configuration>
</plugin>

Shade Plugin

Creates an executable fat JAR with all dependencies:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.3.0</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <createDependencyReducedPom>true</createDependencyReducedPom>
                <transformers>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <mainClass>InventarioApp</mainClass>
                    </transformer>
                </transformers>
            </configuration>
        </execution>
    </executions>
</plugin>

Troubleshooting

Build Failures

Java Version Mismatch

If you see compilation errors about language level:

[ERROR] Source option 21 is no longer supported. Use 21 or later.

Ensure you’re using JDK 21 or later:

java -version
echo $JAVA_HOME

Dependency Download Issues

If Maven fails to download dependencies:

# Clear local repository cache
rm -rf ~/.m2/repository/org/xerial/sqlite-jdbc
rm -rf ~/.m2/repository/com/toedter/jcalendar

# Retry with force update
mvn clean package -U

Out of Memory Errors

For large builds, increase Maven memory:

export MAVEN_OPTS="-Xmx1024m -XX:MaxPermSize=256m"
mvn clean package

Missing Main Class

If you encounter errors about missing main class when running the JAR:

no main manifest attribute, in target/Refactorizacion-ALFA-1.0-SNAPSHOT.jar

Make sure you’re using the shaded JAR or run the build again to ensure the manifest is properly configured.

Database File Not Found

The application expects the SQLite database file. Ensure your database is properly configured in the input/ directory or as specified in the application configuration.

Build Lifecycle

Maven executes the following phases during mvn package:

validate: Validates the project structure
compile: Compiles source code
test: Runs unit tests with JUnit
package: Packages compiled code into JAR
shade: Creates fat JAR with dependencies

The shade plugin is bound to the package phase and automatically executes when you run mvn package.

Additional Commands

View Dependency Tree

mvn dependency:tree

Clean Build Artifacts

mvn clean

Install to Local Repository

mvn install

Generate Project Information

mvn site

Get Started

User Guide

Technical Reference

Development

Building the Application

Prerequisites

Cloning the Repository

Project Structure

Dependencies