From b244a30f8e6ed547c1bddc535585b6123d390073 Mon Sep 17 00:00:00 2001 From: AnonimProgrammer Date: Fri, 3 Apr 2026 15:28:54 +0400 Subject: [PATCH 1/5] Lab is finished. --- .gitattributes | 2 + .gitignore | 33 ++ .mvn/wrapper/maven-wrapper.properties | 3 + mvnw | 295 ++++++++++++++++++ mvnw.cmd | 189 +++++++++++ pom.xml | 59 ++++ src/main/java/com/ironhack/Application.java | 13 + .../com/ironhack/entity/BillableTask.java | 28 ++ .../java/com/ironhack/entity/Contact.java | 59 ++++ .../com/ironhack/entity/InternalTask.java | 16 + src/main/java/com/ironhack/entity/Name.java | 54 ++++ src/main/java/com/ironhack/entity/Task.java | 49 +++ src/main/resources/application.properties | 8 + 13 files changed, 808 insertions(+) create mode 100644 .gitattributes create mode 100644 .gitignore create mode 100644 .mvn/wrapper/maven-wrapper.properties create mode 100755 mvnw create mode 100644 mvnw.cmd create mode 100644 pom.xml create mode 100644 src/main/java/com/ironhack/Application.java create mode 100644 src/main/java/com/ironhack/entity/BillableTask.java create mode 100644 src/main/java/com/ironhack/entity/Contact.java create mode 100644 src/main/java/com/ironhack/entity/InternalTask.java create mode 100644 src/main/java/com/ironhack/entity/Name.java create mode 100644 src/main/java/com/ironhack/entity/Task.java create mode 100644 src/main/resources/application.properties diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..3b41682 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,2 @@ +/mvnw text eol=lf +*.cmd text eol=crlf diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..667aaef --- /dev/null +++ b/.gitignore @@ -0,0 +1,33 @@ +HELP.md +target/ +.mvn/wrapper/maven-wrapper.jar +!**/src/main/**/target/ +!**/src/test/**/target/ + +### STS ### +.apt_generated +.classpath +.factorypath +.project +.settings +.springBeans +.sts4-cache + +### IntelliJ IDEA ### +.idea +*.iws +*.iml +*.ipr + +### NetBeans ### +/nbproject/private/ +/nbbuild/ +/dist/ +/nbdist/ +/.nb-gradle/ +build/ +!**/src/main/**/build/ +!**/src/test/**/build/ + +### VS Code ### +.vscode/ diff --git a/.mvn/wrapper/maven-wrapper.properties b/.mvn/wrapper/maven-wrapper.properties new file mode 100644 index 0000000..c595b00 --- /dev/null +++ b/.mvn/wrapper/maven-wrapper.properties @@ -0,0 +1,3 @@ +wrapperVersion=3.3.4 +distributionType=only-script +distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.14/apache-maven-3.9.14-bin.zip diff --git a/mvnw b/mvnw new file mode 100755 index 0000000..bd8896b --- /dev/null +++ b/mvnw @@ -0,0 +1,295 @@ +#!/bin/sh +# ---------------------------------------------------------------------------- +# 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. +# ---------------------------------------------------------------------------- + +# ---------------------------------------------------------------------------- +# Apache Maven Wrapper startup batch script, version 3.3.4 +# +# Optional ENV vars +# ----------------- +# JAVA_HOME - location of a JDK home dir, required when download maven via java source +# MVNW_REPOURL - repo url base for downloading maven distribution +# MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven +# MVNW_VERBOSE - true: enable verbose log; debug: trace the mvnw script; others: silence the output +# ---------------------------------------------------------------------------- + +set -euf +[ "${MVNW_VERBOSE-}" != debug ] || set -x + +# OS specific support. +native_path() { printf %s\\n "$1"; } +case "$(uname)" in +CYGWIN* | MINGW*) + [ -z "${JAVA_HOME-}" ] || JAVA_HOME="$(cygpath --unix "$JAVA_HOME")" + native_path() { cygpath --path --windows "$1"; } + ;; +esac + +# set JAVACMD and JAVACCMD +set_java_home() { + # For Cygwin and MinGW, ensure paths are in Unix format before anything is touched + if [ -n "${JAVA_HOME-}" ]; then + if [ -x "$JAVA_HOME/jre/sh/java" ]; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD="$JAVA_HOME/jre/sh/java" + JAVACCMD="$JAVA_HOME/jre/sh/javac" + else + JAVACMD="$JAVA_HOME/bin/java" + JAVACCMD="$JAVA_HOME/bin/javac" + + if [ ! -x "$JAVACMD" ] || [ ! -x "$JAVACCMD" ]; then + echo "The JAVA_HOME environment variable is not defined correctly, so mvnw cannot run." >&2 + echo "JAVA_HOME is set to \"$JAVA_HOME\", but \"\$JAVA_HOME/bin/java\" or \"\$JAVA_HOME/bin/javac\" does not exist." >&2 + return 1 + fi + fi + else + JAVACMD="$( + 'set' +e + 'unset' -f command 2>/dev/null + 'command' -v java + )" || : + JAVACCMD="$( + 'set' +e + 'unset' -f command 2>/dev/null + 'command' -v javac + )" || : + + if [ ! -x "${JAVACMD-}" ] || [ ! -x "${JAVACCMD-}" ]; then + echo "The java/javac command does not exist in PATH nor is JAVA_HOME set, so mvnw cannot run." >&2 + return 1 + fi + fi +} + +# hash string like Java String::hashCode +hash_string() { + str="${1:-}" h=0 + while [ -n "$str" ]; do + char="${str%"${str#?}"}" + h=$(((h * 31 + $(LC_CTYPE=C printf %d "'$char")) % 4294967296)) + str="${str#?}" + done + printf %x\\n $h +} + +verbose() { :; } +[ "${MVNW_VERBOSE-}" != true ] || verbose() { printf %s\\n "${1-}"; } + +die() { + printf %s\\n "$1" >&2 + exit 1 +} + +trim() { + # MWRAPPER-139: + # Trims trailing and leading whitespace, carriage returns, tabs, and linefeeds. + # Needed for removing poorly interpreted newline sequences when running in more + # exotic environments such as mingw bash on Windows. + printf "%s" "${1}" | tr -d '[:space:]' +} + +scriptDir="$(dirname "$0")" +scriptName="$(basename "$0")" + +# parse distributionUrl and optional distributionSha256Sum, requires .mvn/wrapper/maven-wrapper.properties +while IFS="=" read -r key value; do + case "${key-}" in + distributionUrl) distributionUrl=$(trim "${value-}") ;; + distributionSha256Sum) distributionSha256Sum=$(trim "${value-}") ;; + esac +done <"$scriptDir/.mvn/wrapper/maven-wrapper.properties" +[ -n "${distributionUrl-}" ] || die "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties" + +case "${distributionUrl##*/}" in +maven-mvnd-*bin.*) + MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ + case "${PROCESSOR_ARCHITECTURE-}${PROCESSOR_ARCHITEW6432-}:$(uname -a)" in + *AMD64:CYGWIN* | *AMD64:MINGW*) distributionPlatform=windows-amd64 ;; + :Darwin*x86_64) distributionPlatform=darwin-amd64 ;; + :Darwin*arm64) distributionPlatform=darwin-aarch64 ;; + :Linux*x86_64*) distributionPlatform=linux-amd64 ;; + *) + echo "Cannot detect native platform for mvnd on $(uname)-$(uname -m), use pure java version" >&2 + distributionPlatform=linux-amd64 + ;; + esac + distributionUrl="${distributionUrl%-bin.*}-$distributionPlatform.zip" + ;; +maven-mvnd-*) MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ ;; +*) MVN_CMD="mvn${scriptName#mvnw}" _MVNW_REPO_PATTERN=/org/apache/maven/ ;; +esac + +# apply MVNW_REPOURL and calculate MAVEN_HOME +# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-,maven-mvnd--}/ +[ -z "${MVNW_REPOURL-}" ] || distributionUrl="$MVNW_REPOURL$_MVNW_REPO_PATTERN${distributionUrl#*"$_MVNW_REPO_PATTERN"}" +distributionUrlName="${distributionUrl##*/}" +distributionUrlNameMain="${distributionUrlName%.*}" +distributionUrlNameMain="${distributionUrlNameMain%-bin}" +MAVEN_USER_HOME="${MAVEN_USER_HOME:-${HOME}/.m2}" +MAVEN_HOME="${MAVEN_USER_HOME}/wrapper/dists/${distributionUrlNameMain-}/$(hash_string "$distributionUrl")" + +exec_maven() { + unset MVNW_VERBOSE MVNW_USERNAME MVNW_PASSWORD MVNW_REPOURL || : + exec "$MAVEN_HOME/bin/$MVN_CMD" "$@" || die "cannot exec $MAVEN_HOME/bin/$MVN_CMD" +} + +if [ -d "$MAVEN_HOME" ]; then + verbose "found existing MAVEN_HOME at $MAVEN_HOME" + exec_maven "$@" +fi + +case "${distributionUrl-}" in +*?-bin.zip | *?maven-mvnd-?*-?*.zip) ;; +*) die "distributionUrl is not valid, must match *-bin.zip or maven-mvnd-*.zip, but found '${distributionUrl-}'" ;; +esac + +# prepare tmp dir +if TMP_DOWNLOAD_DIR="$(mktemp -d)" && [ -d "$TMP_DOWNLOAD_DIR" ]; then + clean() { rm -rf -- "$TMP_DOWNLOAD_DIR"; } + trap clean HUP INT TERM EXIT +else + die "cannot create temp dir" +fi + +mkdir -p -- "${MAVEN_HOME%/*}" + +# Download and Install Apache Maven +verbose "Couldn't find MAVEN_HOME, downloading and installing it ..." +verbose "Downloading from: $distributionUrl" +verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName" + +# select .zip or .tar.gz +if ! command -v unzip >/dev/null; then + distributionUrl="${distributionUrl%.zip}.tar.gz" + distributionUrlName="${distributionUrl##*/}" +fi + +# verbose opt +__MVNW_QUIET_WGET=--quiet __MVNW_QUIET_CURL=--silent __MVNW_QUIET_UNZIP=-q __MVNW_QUIET_TAR='' +[ "${MVNW_VERBOSE-}" != true ] || __MVNW_QUIET_WGET='' __MVNW_QUIET_CURL='' __MVNW_QUIET_UNZIP='' __MVNW_QUIET_TAR=v + +# normalize http auth +case "${MVNW_PASSWORD:+has-password}" in +'') MVNW_USERNAME='' MVNW_PASSWORD='' ;; +has-password) [ -n "${MVNW_USERNAME-}" ] || MVNW_USERNAME='' MVNW_PASSWORD='' ;; +esac + +if [ -z "${MVNW_USERNAME-}" ] && command -v wget >/dev/null; then + verbose "Found wget ... using wget" + wget ${__MVNW_QUIET_WGET:+"$__MVNW_QUIET_WGET"} "$distributionUrl" -O "$TMP_DOWNLOAD_DIR/$distributionUrlName" || die "wget: Failed to fetch $distributionUrl" +elif [ -z "${MVNW_USERNAME-}" ] && command -v curl >/dev/null; then + verbose "Found curl ... using curl" + curl ${__MVNW_QUIET_CURL:+"$__MVNW_QUIET_CURL"} -f -L -o "$TMP_DOWNLOAD_DIR/$distributionUrlName" "$distributionUrl" || die "curl: Failed to fetch $distributionUrl" +elif set_java_home; then + verbose "Falling back to use Java to download" + javaSource="$TMP_DOWNLOAD_DIR/Downloader.java" + targetZip="$TMP_DOWNLOAD_DIR/$distributionUrlName" + cat >"$javaSource" <<-END + public class Downloader extends java.net.Authenticator + { + protected java.net.PasswordAuthentication getPasswordAuthentication() + { + return new java.net.PasswordAuthentication( System.getenv( "MVNW_USERNAME" ), System.getenv( "MVNW_PASSWORD" ).toCharArray() ); + } + public static void main( String[] args ) throws Exception + { + setDefault( new Downloader() ); + java.nio.file.Files.copy( java.net.URI.create( args[0] ).toURL().openStream(), java.nio.file.Paths.get( args[1] ).toAbsolutePath().normalize() ); + } + } + END + # For Cygwin/MinGW, switch paths to Windows format before running javac and java + verbose " - Compiling Downloader.java ..." + "$(native_path "$JAVACCMD")" "$(native_path "$javaSource")" || die "Failed to compile Downloader.java" + verbose " - Running Downloader.java ..." + "$(native_path "$JAVACMD")" -cp "$(native_path "$TMP_DOWNLOAD_DIR")" Downloader "$distributionUrl" "$(native_path "$targetZip")" +fi + +# If specified, validate the SHA-256 sum of the Maven distribution zip file +if [ -n "${distributionSha256Sum-}" ]; then + distributionSha256Result=false + if [ "$MVN_CMD" = mvnd.sh ]; then + echo "Checksum validation is not supported for maven-mvnd." >&2 + echo "Please disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2 + exit 1 + elif command -v sha256sum >/dev/null; then + if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | sha256sum -c - >/dev/null 2>&1; then + distributionSha256Result=true + fi + elif command -v shasum >/dev/null; then + if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | shasum -a 256 -c >/dev/null 2>&1; then + distributionSha256Result=true + fi + else + echo "Checksum validation was requested but neither 'sha256sum' or 'shasum' are available." >&2 + echo "Please install either command, or disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2 + exit 1 + fi + if [ $distributionSha256Result = false ]; then + echo "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised." >&2 + echo "If you updated your Maven version, you need to update the specified distributionSha256Sum property." >&2 + exit 1 + fi +fi + +# unzip and move +if command -v unzip >/dev/null; then + unzip ${__MVNW_QUIET_UNZIP:+"$__MVNW_QUIET_UNZIP"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -d "$TMP_DOWNLOAD_DIR" || die "failed to unzip" +else + tar xzf${__MVNW_QUIET_TAR:+"$__MVNW_QUIET_TAR"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -C "$TMP_DOWNLOAD_DIR" || die "failed to untar" +fi + +# Find the actual extracted directory name (handles snapshots where filename != directory name) +actualDistributionDir="" + +# First try the expected directory name (for regular distributions) +if [ -d "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" ]; then + if [ -f "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain/bin/$MVN_CMD" ]; then + actualDistributionDir="$distributionUrlNameMain" + fi +fi + +# If not found, search for any directory with the Maven executable (for snapshots) +if [ -z "$actualDistributionDir" ]; then + # enable globbing to iterate over items + set +f + for dir in "$TMP_DOWNLOAD_DIR"/*; do + if [ -d "$dir" ]; then + if [ -f "$dir/bin/$MVN_CMD" ]; then + actualDistributionDir="$(basename "$dir")" + break + fi + fi + done + set -f +fi + +if [ -z "$actualDistributionDir" ]; then + verbose "Contents of $TMP_DOWNLOAD_DIR:" + verbose "$(ls -la "$TMP_DOWNLOAD_DIR")" + die "Could not find Maven distribution directory in extracted archive" +fi + +verbose "Found extracted Maven distribution directory: $actualDistributionDir" +printf %s\\n "$distributionUrl" >"$TMP_DOWNLOAD_DIR/$actualDistributionDir/mvnw.url" +mv -- "$TMP_DOWNLOAD_DIR/$actualDistributionDir" "$MAVEN_HOME" || [ -d "$MAVEN_HOME" ] || die "fail to move MAVEN_HOME" + +clean || : +exec_maven "$@" diff --git a/mvnw.cmd b/mvnw.cmd new file mode 100644 index 0000000..92450f9 --- /dev/null +++ b/mvnw.cmd @@ -0,0 +1,189 @@ +<# : batch portion +@REM ---------------------------------------------------------------------------- +@REM Licensed to the Apache Software Foundation (ASF) under one +@REM or more contributor license agreements. See the NOTICE file +@REM distributed with this work for additional information +@REM regarding copyright ownership. The ASF licenses this file +@REM to you under the Apache License, Version 2.0 (the +@REM "License"); you may not use this file except in compliance +@REM with the License. You may obtain a copy of the License at +@REM +@REM http://www.apache.org/licenses/LICENSE-2.0 +@REM +@REM Unless required by applicable law or agreed to in writing, +@REM software distributed under the License is distributed on an +@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +@REM KIND, either express or implied. See the License for the +@REM specific language governing permissions and limitations +@REM under the License. +@REM ---------------------------------------------------------------------------- + +@REM ---------------------------------------------------------------------------- +@REM Apache Maven Wrapper startup batch script, version 3.3.4 +@REM +@REM Optional ENV vars +@REM MVNW_REPOURL - repo url base for downloading maven distribution +@REM MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven +@REM MVNW_VERBOSE - true: enable verbose log; others: silence the output +@REM ---------------------------------------------------------------------------- + +@IF "%__MVNW_ARG0_NAME__%"=="" (SET __MVNW_ARG0_NAME__=%~nx0) +@SET __MVNW_CMD__= +@SET __MVNW_ERROR__= +@SET __MVNW_PSMODULEP_SAVE=%PSModulePath% +@SET PSModulePath= +@FOR /F "usebackq tokens=1* delims==" %%A IN (`powershell -noprofile "& {$scriptDir='%~dp0'; $script='%__MVNW_ARG0_NAME__%'; icm -ScriptBlock ([Scriptblock]::Create((Get-Content -Raw '%~f0'))) -NoNewScope}"`) DO @( + IF "%%A"=="MVN_CMD" (set __MVNW_CMD__=%%B) ELSE IF "%%B"=="" (echo %%A) ELSE (echo %%A=%%B) +) +@SET PSModulePath=%__MVNW_PSMODULEP_SAVE% +@SET __MVNW_PSMODULEP_SAVE= +@SET __MVNW_ARG0_NAME__= +@SET MVNW_USERNAME= +@SET MVNW_PASSWORD= +@IF NOT "%__MVNW_CMD__%"=="" ("%__MVNW_CMD__%" %*) +@echo Cannot start maven from wrapper >&2 && exit /b 1 +@GOTO :EOF +: end batch / begin powershell #> + +$ErrorActionPreference = "Stop" +if ($env:MVNW_VERBOSE -eq "true") { + $VerbosePreference = "Continue" +} + +# calculate distributionUrl, requires .mvn/wrapper/maven-wrapper.properties +$distributionUrl = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionUrl +if (!$distributionUrl) { + Write-Error "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties" +} + +switch -wildcard -casesensitive ( $($distributionUrl -replace '^.*/','') ) { + "maven-mvnd-*" { + $USE_MVND = $true + $distributionUrl = $distributionUrl -replace '-bin\.[^.]*$',"-windows-amd64.zip" + $MVN_CMD = "mvnd.cmd" + break + } + default { + $USE_MVND = $false + $MVN_CMD = $script -replace '^mvnw','mvn' + break + } +} + +# apply MVNW_REPOURL and calculate MAVEN_HOME +# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-,maven-mvnd--}/ +if ($env:MVNW_REPOURL) { + $MVNW_REPO_PATTERN = if ($USE_MVND -eq $False) { "/org/apache/maven/" } else { "/maven/mvnd/" } + $distributionUrl = "$env:MVNW_REPOURL$MVNW_REPO_PATTERN$($distributionUrl -replace "^.*$MVNW_REPO_PATTERN",'')" +} +$distributionUrlName = $distributionUrl -replace '^.*/','' +$distributionUrlNameMain = $distributionUrlName -replace '\.[^.]*$','' -replace '-bin$','' + +$MAVEN_M2_PATH = "$HOME/.m2" +if ($env:MAVEN_USER_HOME) { + $MAVEN_M2_PATH = "$env:MAVEN_USER_HOME" +} + +if (-not (Test-Path -Path $MAVEN_M2_PATH)) { + New-Item -Path $MAVEN_M2_PATH -ItemType Directory | Out-Null +} + +$MAVEN_WRAPPER_DISTS = $null +if ((Get-Item $MAVEN_M2_PATH).Target[0] -eq $null) { + $MAVEN_WRAPPER_DISTS = "$MAVEN_M2_PATH/wrapper/dists" +} else { + $MAVEN_WRAPPER_DISTS = (Get-Item $MAVEN_M2_PATH).Target[0] + "/wrapper/dists" +} + +$MAVEN_HOME_PARENT = "$MAVEN_WRAPPER_DISTS/$distributionUrlNameMain" +$MAVEN_HOME_NAME = ([System.Security.Cryptography.SHA256]::Create().ComputeHash([byte[]][char[]]$distributionUrl) | ForEach-Object {$_.ToString("x2")}) -join '' +$MAVEN_HOME = "$MAVEN_HOME_PARENT/$MAVEN_HOME_NAME" + +if (Test-Path -Path "$MAVEN_HOME" -PathType Container) { + Write-Verbose "found existing MAVEN_HOME at $MAVEN_HOME" + Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD" + exit $? +} + +if (! $distributionUrlNameMain -or ($distributionUrlName -eq $distributionUrlNameMain)) { + Write-Error "distributionUrl is not valid, must end with *-bin.zip, but found $distributionUrl" +} + +# prepare tmp dir +$TMP_DOWNLOAD_DIR_HOLDER = New-TemporaryFile +$TMP_DOWNLOAD_DIR = New-Item -Itemtype Directory -Path "$TMP_DOWNLOAD_DIR_HOLDER.dir" +$TMP_DOWNLOAD_DIR_HOLDER.Delete() | Out-Null +trap { + if ($TMP_DOWNLOAD_DIR.Exists) { + try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null } + catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" } + } +} + +New-Item -Itemtype Directory -Path "$MAVEN_HOME_PARENT" -Force | Out-Null + +# Download and Install Apache Maven +Write-Verbose "Couldn't find MAVEN_HOME, downloading and installing it ..." +Write-Verbose "Downloading from: $distributionUrl" +Write-Verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName" + +$webclient = New-Object System.Net.WebClient +if ($env:MVNW_USERNAME -and $env:MVNW_PASSWORD) { + $webclient.Credentials = New-Object System.Net.NetworkCredential($env:MVNW_USERNAME, $env:MVNW_PASSWORD) +} +[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 +$webclient.DownloadFile($distributionUrl, "$TMP_DOWNLOAD_DIR/$distributionUrlName") | Out-Null + +# If specified, validate the SHA-256 sum of the Maven distribution zip file +$distributionSha256Sum = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionSha256Sum +if ($distributionSha256Sum) { + if ($USE_MVND) { + Write-Error "Checksum validation is not supported for maven-mvnd. `nPlease disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." + } + Import-Module $PSHOME\Modules\Microsoft.PowerShell.Utility -Function Get-FileHash + if ((Get-FileHash "$TMP_DOWNLOAD_DIR/$distributionUrlName" -Algorithm SHA256).Hash.ToLower() -ne $distributionSha256Sum) { + Write-Error "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised. If you updated your Maven version, you need to update the specified distributionSha256Sum property." + } +} + +# unzip and move +Expand-Archive "$TMP_DOWNLOAD_DIR/$distributionUrlName" -DestinationPath "$TMP_DOWNLOAD_DIR" | Out-Null + +# Find the actual extracted directory name (handles snapshots where filename != directory name) +$actualDistributionDir = "" + +# First try the expected directory name (for regular distributions) +$expectedPath = Join-Path "$TMP_DOWNLOAD_DIR" "$distributionUrlNameMain" +$expectedMvnPath = Join-Path "$expectedPath" "bin/$MVN_CMD" +if ((Test-Path -Path $expectedPath -PathType Container) -and (Test-Path -Path $expectedMvnPath -PathType Leaf)) { + $actualDistributionDir = $distributionUrlNameMain +} + +# If not found, search for any directory with the Maven executable (for snapshots) +if (!$actualDistributionDir) { + Get-ChildItem -Path "$TMP_DOWNLOAD_DIR" -Directory | ForEach-Object { + $testPath = Join-Path $_.FullName "bin/$MVN_CMD" + if (Test-Path -Path $testPath -PathType Leaf) { + $actualDistributionDir = $_.Name + } + } +} + +if (!$actualDistributionDir) { + Write-Error "Could not find Maven distribution directory in extracted archive" +} + +Write-Verbose "Found extracted Maven distribution directory: $actualDistributionDir" +Rename-Item -Path "$TMP_DOWNLOAD_DIR/$actualDistributionDir" -NewName $MAVEN_HOME_NAME | Out-Null +try { + Move-Item -Path "$TMP_DOWNLOAD_DIR/$MAVEN_HOME_NAME" -Destination $MAVEN_HOME_PARENT | Out-Null +} catch { + if (! (Test-Path -Path "$MAVEN_HOME" -PathType Container)) { + Write-Error "fail to move MAVEN_HOME" + } +} finally { + try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null } + catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" } +} + +Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD" diff --git a/pom.xml b/pom.xml new file mode 100644 index 0000000..baafa23 --- /dev/null +++ b/pom.xml @@ -0,0 +1,59 @@ + + + 4.0.0 + + org.springframework.boot + spring-boot-starter-parent + 4.0.5 + + + com.ironhack + lab-java-intermediate-jpa + 0.0.1-SNAPSHOT + lab-java-intermediate-jpa + lab-java-intermediate-jpa + + + + + + + + + + + + + + + 21 + + + + org.springframework.boot + spring-boot-starter-data-jpa + + + + com.mysql + mysql-connector-j + runtime + + + org.springframework.boot + spring-boot-starter-data-jpa-test + test + + + + + + + org.springframework.boot + spring-boot-maven-plugin + + + + + diff --git a/src/main/java/com/ironhack/Application.java b/src/main/java/com/ironhack/Application.java new file mode 100644 index 0000000..418d88a --- /dev/null +++ b/src/main/java/com/ironhack/Application.java @@ -0,0 +1,13 @@ +package com.ironhack; + +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; + +@SpringBootApplication +public class Application { + + public static void main(String[] args) { + SpringApplication.run(Application.class, args); + } + +} diff --git a/src/main/java/com/ironhack/entity/BillableTask.java b/src/main/java/com/ironhack/entity/BillableTask.java new file mode 100644 index 0000000..25bea58 --- /dev/null +++ b/src/main/java/com/ironhack/entity/BillableTask.java @@ -0,0 +1,28 @@ +package com.ironhack.entity; + +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.Table; + +import java.time.LocalDate; + +@Entity +@Table(name = "billable_tasks") +public class BillableTask extends Task { + @Column(nullable = false) + private Double hourlyRate; + + public BillableTask() {} + public BillableTask(LocalDate dueDate, Boolean status, Double hourlyRate) { + super(dueDate, status); + this.hourlyRate = hourlyRate; + } + + public Double getHourlyRate() { + return hourlyRate; + } + + public void setHourlyRate(Double hourlyRate) { + this.hourlyRate = hourlyRate; + } +} diff --git a/src/main/java/com/ironhack/entity/Contact.java b/src/main/java/com/ironhack/entity/Contact.java new file mode 100644 index 0000000..86de1f6 --- /dev/null +++ b/src/main/java/com/ironhack/entity/Contact.java @@ -0,0 +1,59 @@ +package com.ironhack.entity; + +import jakarta.persistence.*; + +import java.util.UUID; + +@Entity +@Table(name = "contacts") +public class Contact { + @Id + @GeneratedValue(strategy = GenerationType.UUID) + private UUID id; + + @Column(nullable = false) + private Name name; + + @Column(nullable = false) + private String title; + + private String company; + + public Contact() {} + public Contact(Name name, String title) { + this.name = name; + this.title = title; + } + + public UUID getId() { + return id; + } + + public void setId(UUID id) { + this.id = id; + } + + public Name getName() { + return name; + } + + public void setName(Name name) { + this.name = name; + } + + public String getTitle() { + return title; + } + + public void setTitle(String title) { + this.title = title; + } + + public String getCompany() { + return company; + } + + public void setCompany(String company) { + this.company = company; + } +} diff --git a/src/main/java/com/ironhack/entity/InternalTask.java b/src/main/java/com/ironhack/entity/InternalTask.java new file mode 100644 index 0000000..76b8f3c --- /dev/null +++ b/src/main/java/com/ironhack/entity/InternalTask.java @@ -0,0 +1,16 @@ +package com.ironhack.entity; + +import jakarta.persistence.Entity; +import jakarta.persistence.Table; + +import java.time.LocalDate; + +@Entity +@Table(name = "internal_tasks") +public class InternalTask extends Task { + public InternalTask() {} + + public InternalTask(LocalDate dueDate, Boolean status) { + super(dueDate, status); + } +} diff --git a/src/main/java/com/ironhack/entity/Name.java b/src/main/java/com/ironhack/entity/Name.java new file mode 100644 index 0000000..33c5e56 --- /dev/null +++ b/src/main/java/com/ironhack/entity/Name.java @@ -0,0 +1,54 @@ +package com.ironhack.entity; + +import jakarta.persistence.Column; +import jakarta.persistence.Embeddable; + +@Embeddable +public class Name { + @Column(nullable = false) + private String firstName; + + @Column(nullable = false) + private String lastName; + + private String middleName; + private String salutation; + + public Name() {} + public Name(String firstName, String lastName) { + this.firstName = firstName; + this.lastName = lastName; + } + + public String getFirstName() { + return firstName; + } + + public void setFirstName(String firstName) { + this.firstName = firstName; + } + + public String getLastName() { + return lastName; + } + + public void setLastName(String lastName) { + this.lastName = lastName; + } + + public String getMiddleName() { + return middleName; + } + + public void setMiddleName(String middleName) { + this.middleName = middleName; + } + + public String getSalutation() { + return salutation; + } + + public void setSalutation(String salutation) { + this.salutation = salutation; + } +} diff --git a/src/main/java/com/ironhack/entity/Task.java b/src/main/java/com/ironhack/entity/Task.java new file mode 100644 index 0000000..419cd46 --- /dev/null +++ b/src/main/java/com/ironhack/entity/Task.java @@ -0,0 +1,49 @@ +package com.ironhack.entity; + +import jakarta.persistence.*; + +import java.time.LocalDate; +import java.util.UUID; + +@MappedSuperclass +public abstract class Task { + @Id + @GeneratedValue(strategy = GenerationType.UUID) + private UUID id; + + @Column(nullable = false) + private LocalDate dueDate = LocalDate.now(); + + @Column(nullable = false) + private Boolean status = Boolean.FALSE; + + public Task() {} + public Task(LocalDate dueDate, Boolean status) { + this.dueDate = dueDate; + this.status = status; + } + + public UUID getId() { + return id; + } + + public void setId(UUID id) { + this.id = id; + } + + public LocalDate getDueDate() { + return dueDate; + } + + public void setDueDate(LocalDate dueDate) { + this.dueDate = dueDate; + } + + public Boolean getStatus() { + return status; + } + + public void setStatus(Boolean status) { + this.status = status; + } +} diff --git a/src/main/resources/application.properties b/src/main/resources/application.properties new file mode 100644 index 0000000..5ab734b --- /dev/null +++ b/src/main/resources/application.properties @@ -0,0 +1,8 @@ +spring.datasource.url=jdbc:mysql://localhost:3306/ironboard +spring.datasource.username=user +spring.datasource.password=password +spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver + +spring.jpa.hibernate.ddl-auto=update +spring.jpa.show-sql=true +spring.jpa.properties.hibernate.format_sql=true From 02731672b6d15db87606df41df9fc4a0e2c95639 Mon Sep 17 00:00:00 2001 From: AnonimProgrammer Date: Fri, 3 Apr 2026 15:32:35 +0400 Subject: [PATCH 2/5] Updates. --- src/main/java/com/ironhack/entity/Contact.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/main/java/com/ironhack/entity/Contact.java b/src/main/java/com/ironhack/entity/Contact.java index 86de1f6..9ffaf19 100644 --- a/src/main/java/com/ironhack/entity/Contact.java +++ b/src/main/java/com/ironhack/entity/Contact.java @@ -11,7 +11,7 @@ public class Contact { @GeneratedValue(strategy = GenerationType.UUID) private UUID id; - @Column(nullable = false) + @Embedded private Name name; @Column(nullable = false) From 80373745ae83334d2552c3b849f75e4697e641ae Mon Sep 17 00:00:00 2001 From: AnonimProgrammer Date: Fri, 3 Apr 2026 15:38:05 +0400 Subject: [PATCH 3/5] Updates. --- .../java/com/ironhack/entity/BillableTask.java | 4 ++-- .../java/com/ironhack/entity/InternalTask.java | 5 ++--- src/main/java/com/ironhack/entity/Task.java | 14 +++++++++++++- 3 files changed, 17 insertions(+), 6 deletions(-) diff --git a/src/main/java/com/ironhack/entity/BillableTask.java b/src/main/java/com/ironhack/entity/BillableTask.java index 25bea58..55ac474 100644 --- a/src/main/java/com/ironhack/entity/BillableTask.java +++ b/src/main/java/com/ironhack/entity/BillableTask.java @@ -13,8 +13,8 @@ public class BillableTask extends Task { private Double hourlyRate; public BillableTask() {} - public BillableTask(LocalDate dueDate, Boolean status, Double hourlyRate) { - super(dueDate, status); + public BillableTask(String title, LocalDate dueDate, Boolean status, Double hourlyRate) { + super(title, dueDate, status); this.hourlyRate = hourlyRate; } diff --git a/src/main/java/com/ironhack/entity/InternalTask.java b/src/main/java/com/ironhack/entity/InternalTask.java index 76b8f3c..8c05be8 100644 --- a/src/main/java/com/ironhack/entity/InternalTask.java +++ b/src/main/java/com/ironhack/entity/InternalTask.java @@ -9,8 +9,7 @@ @Table(name = "internal_tasks") public class InternalTask extends Task { public InternalTask() {} - - public InternalTask(LocalDate dueDate, Boolean status) { - super(dueDate, status); + public InternalTask(String title, LocalDate dueDate, Boolean status) { + super(title, dueDate, status); } } diff --git a/src/main/java/com/ironhack/entity/Task.java b/src/main/java/com/ironhack/entity/Task.java index 419cd46..aa157be 100644 --- a/src/main/java/com/ironhack/entity/Task.java +++ b/src/main/java/com/ironhack/entity/Task.java @@ -11,6 +11,9 @@ public abstract class Task { @GeneratedValue(strategy = GenerationType.UUID) private UUID id; + @Column(nullable = false) + private String title; + @Column(nullable = false) private LocalDate dueDate = LocalDate.now(); @@ -18,7 +21,8 @@ public abstract class Task { private Boolean status = Boolean.FALSE; public Task() {} - public Task(LocalDate dueDate, Boolean status) { + public Task(String title, LocalDate dueDate, Boolean status) { + this.title = title; this.dueDate = dueDate; this.status = status; } @@ -31,6 +35,14 @@ public void setId(UUID id) { this.id = id; } + public String getTitle() { + return title; + } + + public void setTitle(String title) { + this.title = title; + } + public LocalDate getDueDate() { return dueDate; } From c92d3debf17d03337feeef6d681d4763a9c5a755 Mon Sep 17 00:00:00 2001 From: AnonimProgrammer Date: Tue, 7 Apr 2026 14:37:24 +0400 Subject: [PATCH 4/5] Task 3 added. --- README.md | 303 +++--------------------------------------------------- 1 file changed, 13 insertions(+), 290 deletions(-) diff --git a/README.md b/README.md index 047890a..27f7daa 100644 --- a/README.md +++ b/README.md @@ -1,290 +1,13 @@ -![logo_ironhack_blue 7](https://user-images.githubusercontent.com/23629340/40541063-a07a0a8a-601a-11e8-91b5-2f13e4e6b441.png) - -# LAB Java | Intermediate JPA - -## Introduction - -We have just learned how to use JPQL and native SQL statements with Spring JPA to query a database as well as how to model object inheritance and component objects with JPA so let's practice a bit more. - -
- -## Requirements - -1. Fork this repo. -2. Clone this repo. -3. Add your instructor and the class graders as collaborators to your repository. If you are unsure who your class graders are, ask your instructor or refer to the day 1 slide deck. -4. In the repository, create a Java project and add the code for the following prompts. - -## Submission - -Once you finish the assignment, submit a URL link to your repository or your pull request in the field below. - -
- -## Instructions - -1. Model the relationships of a Task Management software using Spring JPA. Assume that you have the following requirements for data storage: - - - Tasks have a `title`, `dueDate` and a boolean `status`. - - There are 2 types of tasks: `BillableTask` and `InternalTask`. - - `BillableTask` have an additional `hourlyRate` attribute. - -2. Model the relationships of a PR company using Spring JPA. Assume that you have the following requirements for data storage: - - - The database consists of `Contacts`. Each Contact has a `name`, `title` and `company`. - - Names are their own object and have a `firstName`, `lastName`, `middleName` and `salutation`. - - Names should be embedded within the `Contact` entity and not be stored in a separate table. - -3. List 3 tasks that can be accomplished with native SQL that you cannot do with JPQL. Explain why you would choose to use native SQL over JPQL for these specific tasks. - -
- -## FAQs - -
- -
- I am stuck and don't know how to solve the problem or where to start. What should I do? - -
- - If you are stuck in your code and don't know how to solve the problem or where to start, you should take a step back and try to form a clear, straight forward question about the specific issue you are facing. The process you will go through while trying to define this question, will help you narrow down the problem and come up with potential solutions. - - For example, are you facing a problem because you don't understand the concept or are you receiving an error message that you don't know how to fix? It is usually helpful to try to state the problem as clearly as possible, including any error messages you are receiving. This can help you communicate the issue to others and potentially get help from classmates or online resources. - - Once you have a clear understanding of the problem, you should be able to start working toward the solution. - -
- - - -
- -
- -
- How do I create a Spring boot project? - -
- - Spring boot is a framework for creating stand-alone, production-grade applications that are easy to launch and run. The best way to create a Spring boot project is to use the Spring Initializer website. The website provides a convenient way to generate a basic project structure with all the necessary dependencies and configurations. - - - Step 1: Go to [start.spring.io](https://start.spring.io/) - - Step 2: Choose the type of project you want to create, such as Maven or Gradle. - - Step 3: Select the version of Spring Boot you want to use. - - Step 4: Choose the dependencies you need for your project. Some common dependencies include web, jpa and data-jpa. - - Step 5: Click the "Generate" button to download the project files. - - Alternatively, you can use an Integrated Development Environment (IDE) such as Eclipse or IntelliJ IDEA. These IDEs have plugins for creating Spring boot projects, making it easy to set up the environment and get started with coding. - -
- - - -
- -
- -
- What is JPA and how can I use it in Java? - -
- - JPA stands for Java Persistence API, which is a Java specification for accessing, persisting and managing data between Java objects and a relational database. JPA provides a standard interface for accessing databases, reducing the need for custom data access code and enabling efficient management of database connections. - - To use JPA in Java, you will need to include the necessary dependencies in your project, such as the Hibernate JPA implementation and create entity classes to represent your data. These entity classes will be annotated with JPA-specific annotations, such as `@Entity` and `@Id`, to indicate the mapping between the Java class and the database table. - - Here is a code snippet to show you how to create a JPA entity class in Java: - - ```java - @Entity - public class Employee { - @Id - @GeneratedValue(strategy=GenerationType.IDENTITY) - private int id; - - private String name; - private int age; - private String position; - - // Getters and Setters for the attributes - } - ``` - -
- - - -
- -
- -
- What is the purpose of using the "@Entity", "@Table" and "@Column" annotations in JPA (Java Persistence API)? - -
- - The `@Entity`, `@Table` and `@Column` annotations in JPA (Java Persistence API) are used to map Java objects to relational database tables. - - `@Entity` is used to mark a class as a persistent entity. This means that instances of the class can be stored in a database. - - `@Table` is used to define the name of the database table that the entity will be mapped to. - - `@Column` is used to define the columns in the table that correspond to the attributes of the entity. - - Here is an example of how to use these annotations: - - ```java - @Entity - @Table(name="employee") - public class Employee { - - @Id - @GeneratedValue(strategy=GenerationType.AUTO) - @Column(name="id") - private int id; - - @Column(name="first_name") - private String firstName; - - @Column(name="last_name") - private String lastName; - - //getters and setters - } - ``` - - In this example, the `Employee` class is marked as a persistent entity using the `@Entity` annotation. The name of the database table is defined using the `@Table` annotation as "employee". The `id`, `firstName` and `lastName` attributes are mapped to columns in the "employee" table using the `@Column` annotation. - -
- - - -
- -
- -
- What is the difference between "JOINED", "TABLE_PER_CLASS" and "SINGLE_TABLE" inheritance strategies in JPA and when to use them? - -
- - The `@Inheritance` annotation in JPA can be used to specify inheritance strategy for entities in JPA. There are three strategies available in JPA: `SINGLE_TABLE`, `JOINED` and `TABLE_PER_CLASS`. The inheritance strategy is specified using the strategy attribute in the `@Inheritance` annotation. - - The inheritance strategies in JPA determine how the data is stored in the database for the entities that inherit from a parent entity. - - - **JOINED strategy**: creates separate tables for each concrete entity and a join between them is used to retrieve the data. - - ```java - @Inheritance(strategy=InheritanceType.JOINED) - @Entity - public class Parent { - // ... - } - ``` - - - **TABLE_PER_CLASS strategy**: creates a separate table for each concrete entity and includes all the columns of the parent entity as well. - - ```java - @Inheritance(strategy=InheritanceType.TABLE_PER_CLASS) - @Entity - public class Parent { - // ... - } - ``` - - - **SINGLE_TABLE strategy**: creates a single table for all the entities in the hierarchy, including a discriminator column to distinguish between the entities. - - ```java - @Inheritance(strategy=InheritanceType.SINGLE_TABLE) - @Entity - public class Parent { - // ... - } - ``` - - The choice of inheritance strategy depends on the requirements of the application, such as the need for normalization, the number of columns in the table and the number of joins required to retrieve data. For example, if the entities have many columns and normalization is important, then JOINED strategy is appropriate. If there are fewer columns, the TABLE_PER_CLASS strategy may be more suitable. The SINGLE_TABLE strategy is the simplest and most compact but may result in a less flexible data model. - -
- - - -
- -
- -
- How do I use "@Embedded" and "@Embeddable" annotations in Java with JPA? - -
- - The `@Embedded` and `@Embeddable` annotations in JPA are used to map an embedded field or class in a JPA entity. - - These annotations are used to store a set of related fields within another JPA entity. This allows the developer to store complex data within a single entity, as opposed to having multiple entities for different data fields. - - The `@Embeddable` annotation is used to annotate the embedded class, while the `@Embedded` annotation is used to annotate the field within the JPA entity that will store the embedded class. - - Example: - - ```java - @Embeddable - public class Address { - private String street; - private String city; - private String state; - private String zipCode; - // getters and setters - } - - @Entity - public class Employee { - @Id - private long id; - private String name; - @Embedded - private Address address; - // getters and setters - } - ``` - - JPA will store the data in the embedded class as part of the owning entity in the database. When retrieving the entity from the database, the embedded class data will also be retrieved and stored as part of the entity. - - In conclusion, the `@Embedded` and `@Embeddable` annotations in JPA allow developers to store complex data within a single JPA entity, providing a more organized and efficient way to store and retrieve data from the database. - -
- - - -
- -
- -
- I am unable to push changes to my repository. What should I do? - -
- - If you are unable to push changes to your repository, here are a few steps that you can follow: - - 1. Check your internet connection: Ensure that your internet connection is stable and working. - 1. Verify your repository URL: Make sure that you are using the correct repository URL to push your changes. - 2. Check Git credentials: Ensure that your Git credentials are up-to-date and correct. You can check your credentials using the following command: - - ```bash - git config --list - ``` - - 4. Update your local repository: Before pushing changes, make sure that your local repository is up-to-date with the remote repository. You can update your local repository using the following command: - - ```bash - git fetch origin - ``` - - 5. Check for conflicts: If there are any conflicts between your local repository and the remote repository, resolve them before pushing changes. - 6. Push changes: Once you have resolved any conflicts and updated your local repository, you can try pushing changes again using the following command: - - ```bash - git push origin - ``` - -
+## Task 3 + +Use `SQL` when: +- You need database-specific functions (e.g., YEAR(), CONCAT()) +- Performance-critical queries that need manual optimization +- Working with views or stored procedures + +--- +Notes: +``` +I would prefer SQL over JPQL for complex queries requiring database-specific functions or optimizations. +- Example: Complex product search with many filters and sorting might be better suited for SQL. +``` \ No newline at end of file From 31db70d1e627424e287ceb60310d19b0dd758c53 Mon Sep 17 00:00:00 2001 From: AnonimProgrammer Date: Tue, 7 Apr 2026 14:42:32 +0400 Subject: [PATCH 5/5] Task 3 added. --- README.md | 305 ++++++++++++++++++++++++++++++++++++++++++++-- task3_jpql_sql.md | 13 ++ 2 files changed, 305 insertions(+), 13 deletions(-) create mode 100644 task3_jpql_sql.md diff --git a/README.md b/README.md index 27f7daa..f9c2635 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,292 @@ -## Task 3 - -Use `SQL` when: -- You need database-specific functions (e.g., YEAR(), CONCAT()) -- Performance-critical queries that need manual optimization -- Working with views or stored procedures - ---- -Notes: -``` -I would prefer SQL over JPQL for complex queries requiring database-specific functions or optimizations. -- Example: Complex product search with many filters and sorting might be better suited for SQL. -``` \ No newline at end of file +![logo_ironhack_blue 7](https://user-images.githubusercontent.com/23629340/40541063-a07a0a8a-601a-11e8-91b5-2f13e4e6b441.png) + +# LAB Java | Intermediate JPA + +## Introduction + +We have just learned how to use JPQL and native SQL statements with Spring JPA to query a database as well as how to model object inheritance and component objects with JPA so let's practice a bit more. + +
+ +## Requirements + +1. Fork this repo. +2. Clone this repo. +3. Add your instructor and the class graders as collaborators to your repository. If you are unsure who your class graders are, ask your instructor or refer to the day 1 slide deck. +4. In the repository, create a Java project and add the code for the following prompts. + +## Submission + +Once you finish the assignment, submit a URL link to your repository or your pull request in the field below. + +
+ +## Instructions + +1. Model the relationships of a Task Management software using Spring JPA. Assume that you have the following requirements for data storage: + + - Tasks have a `title`, `dueDate` and a boolean `status`. + - There are 2 types of tasks: `BillableTask` and `InternalTask`. + - `BillableTask` have an additional `hourlyRate` attribute. + +2. Model the relationships of a PR company using Spring JPA. Assume that you have the following requirements for data storage: + + - The database consists of `Contacts`. Each Contact has a `name`, `title` and `company`. + - Names are their own object and have a `firstName`, `lastName`, `middleName` and `salutation`. + - Names should be embedded within the `Contact` entity and not be stored in a separate table. + +3. List 3 tasks that can be accomplished with native SQL that you cannot do with JPQL. Explain why you would choose to use native SQL over JPQL for these specific tasks. + +
+ +## FAQs + +
+ +
+ I am stuck and don't know how to solve the problem or where to start. What should I do? + +
+ + If you are stuck in your code and don't know how to solve the problem or where to start, you should take a step back and try to form a clear, straight forward question about the specific issue you are facing. The process you will go through while trying to define this question, will help you narrow down the problem and come up with potential solutions. + + For example, are you facing a problem because you don't understand the concept or are you receiving an error message that you don't know how to fix? It is usually helpful to try to state the problem as clearly as possible, including any error messages you are receiving. This can help you communicate the issue to others and potentially get help from classmates or online resources. + + Once you have a clear understanding of the problem, you should be able to start working toward the solution. + +
+ + + +
+ +
+ +
+ How do I create a Spring boot project? + +
+ + Spring boot is a framework for creating stand-alone, production-grade applications that are easy to launch and run. The best way to create a Spring boot project is to use the Spring Initializer website. The website provides a convenient way to generate a basic project structure with all the necessary dependencies and configurations. + + - Step 1: Go to [start.spring.io](https://start.spring.io/) + - Step 2: Choose the type of project you want to create, such as Maven or Gradle. + - Step 3: Select the version of Spring Boot you want to use. + - Step 4: Choose the dependencies you need for your project. Some common dependencies include web, jpa and data-jpa. + - Step 5: Click the "Generate" button to download the project files. + + Alternatively, you can use an Integrated Development Environment (IDE) such as Eclipse or IntelliJ IDEA. These IDEs have plugins for creating Spring boot projects, making it easy to set up the environment and get started with coding. + +
+ + + +
+ +
+ +
+ What is JPA and how can I use it in Java? + +
+ + JPA stands for Java Persistence API, which is a Java specification for accessing, persisting and managing data between Java objects and a relational database. JPA provides a standard interface for accessing databases, reducing the need for custom data access code and enabling efficient management of database connections. + + To use JPA in Java, you will need to include the necessary dependencies in your project, such as the Hibernate JPA implementation and create entity classes to represent your data. These entity classes will be annotated with JPA-specific annotations, such as `@Entity` and `@Id`, to indicate the mapping between the Java class and the database table. + + Here is a code snippet to show you how to create a JPA entity class in Java: + + ```java + @Entity + public class Employee { + @Id + @GeneratedValue(strategy=GenerationType.IDENTITY) + private int id; + + private String name; + private int age; + private String position; + + // Getters and Setters for the attributes + } + ``` + +
+ + + +
+ +
+ +
+ What is the purpose of using the "@Entity", "@Table" and "@Column" annotations in JPA (Java Persistence API)? + +
+ + The `@Entity`, `@Table` and `@Column` annotations in JPA (Java Persistence API) are used to map Java objects to relational database tables. + + `@Entity` is used to mark a class as a persistent entity. This means that instances of the class can be stored in a database. + + `@Table` is used to define the name of the database table that the entity will be mapped to. + + `@Column` is used to define the columns in the table that correspond to the attributes of the entity. + + Here is an example of how to use these annotations: + + ```java + @Entity + @Table(name="employee") + public class Employee { + + @Id + @GeneratedValue(strategy=GenerationType.AUTO) + @Column(name="id") + private int id; + + @Column(name="first_name") + private String firstName; + + @Column(name="last_name") + private String lastName; + + //getters and setters + } + ``` + + In this example, the `Employee` class is marked as a persistent entity using the `@Entity` annotation. The name of the database table is defined using the `@Table` annotation as "employee". The `id`, `firstName` and `lastName` attributes are mapped to columns in the "employee" table using the `@Column` annotation. + +
+ + + +
+ +
+ +
+ What is the difference between "JOINED", "TABLE_PER_CLASS" and "SINGLE_TABLE" inheritance strategies in JPA and when to use them? + +
+ + The `@Inheritance` annotation in JPA can be used to specify inheritance strategy for entities in JPA. There are three strategies available in JPA: `SINGLE_TABLE`, `JOINED` and `TABLE_PER_CLASS`. The inheritance strategy is specified using the strategy attribute in the `@Inheritance` annotation. + + The inheritance strategies in JPA determine how the data is stored in the database for the entities that inherit from a parent entity. + + - **JOINED strategy**: creates separate tables for each concrete entity and a join between them is used to retrieve the data. + + ```java + @Inheritance(strategy=InheritanceType.JOINED) + @Entity + public class Parent { + // ... + } + ``` + + - **TABLE_PER_CLASS strategy**: creates a separate table for each concrete entity and includes all the columns of the parent entity as well. + + ```java + @Inheritance(strategy=InheritanceType.TABLE_PER_CLASS) + @Entity + public class Parent { + // ... + } + ``` + + - **SINGLE_TABLE strategy**: creates a single table for all the entities in the hierarchy, including a discriminator column to distinguish between the entities. + + ```java + @Inheritance(strategy=InheritanceType.SINGLE_TABLE) + @Entity + public class Parent { + // ... + } + ``` + + The choice of inheritance strategy depends on the requirements of the application, such as the need for normalization, the number of columns in the table and the number of joins required to retrieve data. For example, if the entities have many columns and normalization is important, then JOINED strategy is appropriate. If there are fewer columns, the TABLE_PER_CLASS strategy may be more suitable. The SINGLE_TABLE strategy is the simplest and most compact but may result in a less flexible data model. + +
+ + + +
+ +
+ +
+ How do I use "@Embedded" and "@Embeddable" annotations in Java with JPA? + +
+ + The `@Embedded` and `@Embeddable` annotations in JPA are used to map an embedded field or class in a JPA entity. + + These annotations are used to store a set of related fields within another JPA entity. This allows the developer to store complex data within a single entity, as opposed to having multiple entities for different data fields. + + The `@Embeddable` annotation is used to annotate the embedded class, while the `@Embedded` annotation is used to annotate the field within the JPA entity that will store the embedded class. + + Example: + + ```java + @Embeddable + public class Address { + private String street; + private String city; + private String state; + private String zipCode; + // getters and setters + } + + @Entity + public class Employee { + @Id + private long id; + private String name; + @Embedded + private Address address; + // getters and setters + } + ``` + + JPA will store the data in the embedded class as part of the owning entity in the database. When retrieving the entity from the database, the embedded class data will also be retrieved and stored as part of the entity. + + In conclusion, the `@Embedded` and `@Embeddable` annotations in JPA allow developers to store complex data within a single JPA entity, providing a more organized and efficient way to store and retrieve data from the database. + +
+ + + +
+ +
+ +
+ I am unable to push changes to my repository. What should I do? + +
+ + If you are unable to push changes to your repository, here are a few steps that you can follow: + + 1. Check your internet connection: Ensure that your internet connection is stable and working. + 1. Verify your repository URL: Make sure that you are using the correct repository URL to push your changes. + 2. Check Git credentials: Ensure that your Git credentials are up-to-date and correct. You can check your credentials using the following command: + + ```bash + git config --list + ``` + + 4. Update your local repository: Before pushing changes, make sure that your local repository is up-to-date with the remote repository. You can update your local repository using the following command: + + ```bash + git fetch origin + ``` + + 5. Check for conflicts: If there are any conflicts between your local repository and the remote repository, resolve them before pushing changes. + 6. Push changes: Once you have resolved any conflicts and updated your local repository, you can try pushing changes again using the following command: + + ```bash + git push origin + ``` + +
+ + diff --git a/task3_jpql_sql.md b/task3_jpql_sql.md new file mode 100644 index 0000000..27f7daa --- /dev/null +++ b/task3_jpql_sql.md @@ -0,0 +1,13 @@ +## Task 3 + +Use `SQL` when: +- You need database-specific functions (e.g., YEAR(), CONCAT()) +- Performance-critical queries that need manual optimization +- Working with views or stored procedures + +--- +Notes: +``` +I would prefer SQL over JPQL for complex queries requiring database-specific functions or optimizations. +- Example: Complex product search with many filters and sorting might be better suited for SQL. +``` \ No newline at end of file