init

.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/

.mvn/wrapper/maven-wrapper.properties

@@ -0,0 +1,2 @@
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.6/apache-maven-3.9.6-bin.zip
+wrapperUrl=https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar

mvnw

@@ -0,0 +1,308 @@
+#!/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
+#
+#    https://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.2.0
+#
+# Required ENV vars:
+# ------------------
+#   JAVA_HOME - location of a JDK home dir
+#
+# Optional ENV vars
+# -----------------
+#   MAVEN_OPTS - parameters passed to the Java VM when running Maven
+#     e.g. to debug Maven itself, use
+#       set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000
+#   MAVEN_SKIP_RC - flag to disable loading of mavenrc files
+# ----------------------------------------------------------------------------
+
+if [ -z "$MAVEN_SKIP_RC" ] ; then
+
+  if [ -f /usr/local/etc/mavenrc ] ; then
+    . /usr/local/etc/mavenrc
+  fi
+
+  if [ -f /etc/mavenrc ] ; then
+    . /etc/mavenrc
+  fi
+
+  if [ -f "$HOME/.mavenrc" ] ; then
+    . "$HOME/.mavenrc"
+  fi
+
+fi
+
+# OS specific support.  $var _must_ be set to either true or false.
+cygwin=false;
+darwin=false;
+mingw=false
+case "$(uname)" in
+  CYGWIN*) cygwin=true ;;
+  MINGW*) mingw=true;;
+  Darwin*) darwin=true
+    # Use /usr/libexec/java_home if available, otherwise fall back to /Library/Java/Home
+    # See https://developer.apple.com/library/mac/qa/qa1170/_index.html
+    if [ -z "$JAVA_HOME" ]; then
+      if [ -x "/usr/libexec/java_home" ]; then
+        JAVA_HOME="$(/usr/libexec/java_home)"; export JAVA_HOME
+      else
+        JAVA_HOME="/Library/Java/Home"; export JAVA_HOME
+      fi
+    fi
+    ;;
+esac
+
+if [ -z "$JAVA_HOME" ] ; then
+  if [ -r /etc/gentoo-release ] ; then
+    JAVA_HOME=$(java-config --jre-home)
+  fi
+fi
+
+# For Cygwin, ensure paths are in UNIX format before anything is touched
+if $cygwin ; then
+  [ -n "$JAVA_HOME" ] &&
+    JAVA_HOME=$(cygpath --unix "$JAVA_HOME")
+  [ -n "$CLASSPATH" ] &&
+    CLASSPATH=$(cygpath --path --unix "$CLASSPATH")
+fi
+
+# For Mingw, ensure paths are in UNIX format before anything is touched
+if $mingw ; then
+  [ -n "$JAVA_HOME" ] && [ -d "$JAVA_HOME" ] &&
+    JAVA_HOME="$(cd "$JAVA_HOME" || (echo "cannot cd into $JAVA_HOME."; exit 1); pwd)"
+fi
+
+if [ -z "$JAVA_HOME" ]; then
+  javaExecutable="$(which javac)"
+  if [ -n "$javaExecutable" ] && ! [ "$(expr "\"$javaExecutable\"" : '\([^ ]*\)')" = "no" ]; then
+    # readlink(1) is not available as standard on Solaris 10.
+    readLink=$(which readlink)
+    if [ ! "$(expr "$readLink" : '\([^ ]*\)')" = "no" ]; then
+      if $darwin ; then
+        javaHome="$(dirname "\"$javaExecutable\"")"
+        javaExecutable="$(cd "\"$javaHome\"" && pwd -P)/javac"
+      else
+        javaExecutable="$(readlink -f "\"$javaExecutable\"")"
+      fi
+      javaHome="$(dirname "\"$javaExecutable\"")"
+      javaHome=$(expr "$javaHome" : '\(.*\)/bin')
+      JAVA_HOME="$javaHome"
+      export JAVA_HOME
+    fi
+  fi
+fi
+
+if [ -z "$JAVACMD" ] ; then
+  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"
+    else
+      JAVACMD="$JAVA_HOME/bin/java"
+    fi
+  else
+    JAVACMD="$(\unset -f command 2>/dev/null; \command -v java)"
+  fi
+fi
+
+if [ ! -x "$JAVACMD" ] ; then
+  echo "Error: JAVA_HOME is not defined correctly." >&2
+  echo "  We cannot execute $JAVACMD" >&2
+  exit 1
+fi
+
+if [ -z "$JAVA_HOME" ] ; then
+  echo "Warning: JAVA_HOME environment variable is not set."
+fi
+
+# traverses directory structure from process work directory to filesystem root
+# first directory with .mvn subdirectory is considered project base directory
+find_maven_basedir() {
+  if [ -z "$1" ]
+  then
+    echo "Path not specified to find_maven_basedir"
+    return 1
+  fi
+
+  basedir="$1"
+  wdir="$1"
+  while [ "$wdir" != '/' ] ; do
+    if [ -d "$wdir"/.mvn ] ; then
+      basedir=$wdir
+      break
+    fi
+    # workaround for JBEAP-8937 (on Solaris 10/Sparc)
+    if [ -d "${wdir}" ]; then
+      wdir=$(cd "$wdir/.." || exit 1; pwd)
+    fi
+    # end of workaround
+  done
+  printf '%s' "$(cd "$basedir" || exit 1; pwd)"
+}
+
+# concatenates all lines of a file
+concat_lines() {
+  if [ -f "$1" ]; then
+    # Remove \r in case we run on Windows within Git Bash
+    # and check out the repository with auto CRLF management
+    # enabled. Otherwise, we may read lines that are delimited with
+    # \r\n and produce $'-Xarg\r' rather than -Xarg due to word
+    # splitting rules.
+    tr -s '\r\n' ' ' < "$1"
+  fi
+}
+
+log() {
+  if [ "$MVNW_VERBOSE" = true ]; then
+    printf '%s\n' "$1"
+  fi
+}
+
+BASE_DIR=$(find_maven_basedir "$(dirname "$0")")
+if [ -z "$BASE_DIR" ]; then
+  exit 1;
+fi
+
+MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"}; export MAVEN_PROJECTBASEDIR
+log "$MAVEN_PROJECTBASEDIR"
+
+##########################################################################################
+# Extension to allow automatically downloading the maven-wrapper.jar from Maven-central
+# This allows using the maven wrapper in projects that prohibit checking in binary data.
+##########################################################################################
+wrapperJarPath="$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar"
+if [ -r "$wrapperJarPath" ]; then
+    log "Found $wrapperJarPath"
+else
+    log "Couldn't find $wrapperJarPath, downloading it ..."
+
+    if [ -n "$MVNW_REPOURL" ]; then
+      wrapperUrl="$MVNW_REPOURL/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar"
+    else
+      wrapperUrl="https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar"
+    fi
+    while IFS="=" read -r key value; do
+      # Remove '\r' from value to allow usage on windows as IFS does not consider '\r' as a separator ( considers space, tab, new line ('\n'), and custom '=' )
+      safeValue=$(echo "$value" | tr -d '\r')
+      case "$key" in (wrapperUrl) wrapperUrl="$safeValue"; break ;;
+      esac
+    done < "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.properties"
+    log "Downloading from: $wrapperUrl"
+
+    if $cygwin; then
+      wrapperJarPath=$(cygpath --path --windows "$wrapperJarPath")
+    fi
+
+    if command -v wget > /dev/null; then
+        log "Found wget ... using wget"
+        [ "$MVNW_VERBOSE" = true ] && QUIET="" || QUIET="--quiet"
+        if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then
+            wget $QUIET "$wrapperUrl" -O "$wrapperJarPath" || rm -f "$wrapperJarPath"
+        else
+            wget $QUIET --http-user="$MVNW_USERNAME" --http-password="$MVNW_PASSWORD" "$wrapperUrl" -O "$wrapperJarPath" || rm -f "$wrapperJarPath"
+        fi
+    elif command -v curl > /dev/null; then
+        log "Found curl ... using curl"
+        [ "$MVNW_VERBOSE" = true ] && QUIET="" || QUIET="--silent"
+        if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then
+            curl $QUIET -o "$wrapperJarPath" "$wrapperUrl" -f -L || rm -f "$wrapperJarPath"
+        else
+            curl $QUIET --user "$MVNW_USERNAME:$MVNW_PASSWORD" -o "$wrapperJarPath" "$wrapperUrl" -f -L || rm -f "$wrapperJarPath"
+        fi
+    else
+        log "Falling back to using Java to download"
+        javaSource="$MAVEN_PROJECTBASEDIR/.mvn/wrapper/MavenWrapperDownloader.java"
+        javaClass="$MAVEN_PROJECTBASEDIR/.mvn/wrapper/MavenWrapperDownloader.class"
+        # For Cygwin, switch paths to Windows format before running javac
+        if $cygwin; then
+          javaSource=$(cygpath --path --windows "$javaSource")
+          javaClass=$(cygpath --path --windows "$javaClass")
+        fi
+        if [ -e "$javaSource" ]; then
+            if [ ! -e "$javaClass" ]; then
+                log " - Compiling MavenWrapperDownloader.java ..."
+                ("$JAVA_HOME/bin/javac" "$javaSource")
+            fi
+            if [ -e "$javaClass" ]; then
+                log " - Running MavenWrapperDownloader.java ..."
+                ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$wrapperUrl" "$wrapperJarPath") || rm -f "$wrapperJarPath"
+            fi
+        fi
+    fi
+fi
+##########################################################################################
+# End of extension
+##########################################################################################
+
+# If specified, validate the SHA-256 sum of the Maven wrapper jar file
+wrapperSha256Sum=""
+while IFS="=" read -r key value; do
+  case "$key" in (wrapperSha256Sum) wrapperSha256Sum=$value; break ;;
+  esac
+done < "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.properties"
+if [ -n "$wrapperSha256Sum" ]; then
+  wrapperSha256Result=false
+  if command -v sha256sum > /dev/null; then
+    if echo "$wrapperSha256Sum  $wrapperJarPath" | sha256sum -c > /dev/null 2>&1; then
+      wrapperSha256Result=true
+    fi
+  elif command -v shasum > /dev/null; then
+    if echo "$wrapperSha256Sum  $wrapperJarPath" | shasum -a 256 -c > /dev/null 2>&1; then
+      wrapperSha256Result=true
+    fi
+  else
+    echo "Checksum validation was requested but neither 'sha256sum' or 'shasum' are available."
+    echo "Please install either command, or disable validation by removing 'wrapperSha256Sum' from your maven-wrapper.properties."
+    exit 1
+  fi
+  if [ $wrapperSha256Result = false ]; then
+    echo "Error: Failed to validate Maven wrapper SHA-256, your Maven wrapper might be compromised." >&2
+    echo "Investigate or delete $wrapperJarPath to attempt a clean download." >&2
+    echo "If you updated your Maven version, you need to update the specified wrapperSha256Sum property." >&2
+    exit 1
+  fi
+fi
+
+MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS"
+
+# For Cygwin, switch paths to Windows format before running java
+if $cygwin; then
+  [ -n "$JAVA_HOME" ] &&
+    JAVA_HOME=$(cygpath --path --windows "$JAVA_HOME")
+  [ -n "$CLASSPATH" ] &&
+    CLASSPATH=$(cygpath --path --windows "$CLASSPATH")
+  [ -n "$MAVEN_PROJECTBASEDIR" ] &&
+    MAVEN_PROJECTBASEDIR=$(cygpath --path --windows "$MAVEN_PROJECTBASEDIR")
+fi
+
+# Provide a "standardized" way to retrieve the CLI args that will
+# work with both Windows and non-Windows executions.
+MAVEN_CMD_LINE_ARGS="$MAVEN_CONFIG $*"
+export MAVEN_CMD_LINE_ARGS
+
+WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain
+
+# shellcheck disable=SC2086 # safe args
+exec "$JAVACMD" \
+  $MAVEN_OPTS \
+  $MAVEN_DEBUG_OPTS \
+  -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \
+  "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \
+  ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@"

mvnw.cmd

@@ -0,0 +1,205 @@
+@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    https://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.2.0
+@REM
+@REM Required ENV vars:
+@REM JAVA_HOME - location of a JDK home dir
+@REM
+@REM Optional ENV vars
+@REM MAVEN_BATCH_ECHO - set to 'on' to enable the echoing of the batch commands
+@REM MAVEN_BATCH_PAUSE - set to 'on' to wait for a keystroke before ending
+@REM MAVEN_OPTS - parameters passed to the Java VM when running Maven
+@REM     e.g. to debug Maven itself, use
+@REM set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000
+@REM MAVEN_SKIP_RC - flag to disable loading of mavenrc files
+@REM ----------------------------------------------------------------------------
+
+@REM Begin all REM lines with '@' in case MAVEN_BATCH_ECHO is 'on'
+@echo off
+@REM set title of command window
+title %0
+@REM enable echoing by setting MAVEN_BATCH_ECHO to 'on'
+@if "%MAVEN_BATCH_ECHO%" == "on"  echo %MAVEN_BATCH_ECHO%
+
+@REM set %HOME% to equivalent of $HOME
+if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%")
+
+@REM Execute a user defined script before this one
+if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre
+@REM check for pre script, once with legacy .bat ending and once with .cmd ending
+if exist "%USERPROFILE%\mavenrc_pre.bat" call "%USERPROFILE%\mavenrc_pre.bat" %*
+if exist "%USERPROFILE%\mavenrc_pre.cmd" call "%USERPROFILE%\mavenrc_pre.cmd" %*
+:skipRcPre
+
+@setlocal
+
+set ERROR_CODE=0
+
+@REM To isolate internal variables from possible post scripts, we use another setlocal
+@setlocal
+
+@REM ==== START VALIDATION ====
+if not "%JAVA_HOME%" == "" goto OkJHome
+
+echo.
+echo Error: JAVA_HOME not found in your environment. >&2
+echo Please set the JAVA_HOME variable in your environment to match the >&2
+echo location of your Java installation. >&2
+echo.
+goto error
+
+:OkJHome
+if exist "%JAVA_HOME%\bin\java.exe" goto init
+
+echo.
+echo Error: JAVA_HOME is set to an invalid directory. >&2
+echo JAVA_HOME = "%JAVA_HOME%" >&2
+echo Please set the JAVA_HOME variable in your environment to match the >&2
+echo location of your Java installation. >&2
+echo.
+goto error
+
+@REM ==== END VALIDATION ====
+
+:init
+
+@REM Find the project base dir, i.e. the directory that contains the folder ".mvn".
+@REM Fallback to current working directory if not found.
+
+set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR%
+IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir
+
+set EXEC_DIR=%CD%
+set WDIR=%EXEC_DIR%
+:findBaseDir
+IF EXIST "%WDIR%"\.mvn goto baseDirFound
+cd ..
+IF "%WDIR%"=="%CD%" goto baseDirNotFound
+set WDIR=%CD%
+goto findBaseDir
+
+:baseDirFound
+set MAVEN_PROJECTBASEDIR=%WDIR%
+cd "%EXEC_DIR%"
+goto endDetectBaseDir
+
+:baseDirNotFound
+set MAVEN_PROJECTBASEDIR=%EXEC_DIR%
+cd "%EXEC_DIR%"
+
+:endDetectBaseDir
+
+IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig
+
+@setlocal EnableExtensions EnableDelayedExpansion
+for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a
+@endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS%
+
+:endReadAdditionalConfig
+
+SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe"
+set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar"
+set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain
+
+set WRAPPER_URL="https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar"
+
+FOR /F "usebackq tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO (
+    IF "%%A"=="wrapperUrl" SET WRAPPER_URL=%%B
+)
+
+@REM Extension to allow automatically downloading the maven-wrapper.jar from Maven-central
+@REM This allows using the maven wrapper in projects that prohibit checking in binary data.
+if exist %WRAPPER_JAR% (
+    if "%MVNW_VERBOSE%" == "true" (
+        echo Found %WRAPPER_JAR%
+    )
+) else (
+    if not "%MVNW_REPOURL%" == "" (
+        SET WRAPPER_URL="%MVNW_REPOURL%/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar"
+    )
+    if "%MVNW_VERBOSE%" == "true" (
+        echo Couldn't find %WRAPPER_JAR%, downloading it ...
+        echo Downloading from: %WRAPPER_URL%
+    )
+
+    powershell -Command "&{"^
+		"$webclient = new-object System.Net.WebClient;"^
+		"if (-not ([string]::IsNullOrEmpty('%MVNW_USERNAME%') -and [string]::IsNullOrEmpty('%MVNW_PASSWORD%'))) {"^
+		"$webclient.Credentials = new-object System.Net.NetworkCredential('%MVNW_USERNAME%', '%MVNW_PASSWORD%');"^
+		"}"^
+		"[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; $webclient.DownloadFile('%WRAPPER_URL%', '%WRAPPER_JAR%')"^
+		"}"
+    if "%MVNW_VERBOSE%" == "true" (
+        echo Finished downloading %WRAPPER_JAR%
+    )
+)
+@REM End of extension
+
+@REM If specified, validate the SHA-256 sum of the Maven wrapper jar file
+SET WRAPPER_SHA_256_SUM=""
+FOR /F "usebackq tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO (
+    IF "%%A"=="wrapperSha256Sum" SET WRAPPER_SHA_256_SUM=%%B
+)
+IF NOT %WRAPPER_SHA_256_SUM%=="" (
+    powershell -Command "&{"^
+       "$hash = (Get-FileHash \"%WRAPPER_JAR%\" -Algorithm SHA256).Hash.ToLower();"^
+       "If('%WRAPPER_SHA_256_SUM%' -ne $hash){"^
+       "  Write-Output 'Error: Failed to validate Maven wrapper SHA-256, your Maven wrapper might be compromised.';"^
+       "  Write-Output 'Investigate or delete %WRAPPER_JAR% to attempt a clean download.';"^
+       "  Write-Output 'If you updated your Maven version, you need to update the specified wrapperSha256Sum property.';"^
+       "  exit 1;"^
+       "}"^
+       "}"
+    if ERRORLEVEL 1 goto error
+)
+
+@REM Provide a "standardized" way to retrieve the CLI args that will
+@REM work with both Windows and non-Windows executions.
+set MAVEN_CMD_LINE_ARGS=%*
+
+%MAVEN_JAVA_EXE% ^
+  %JVM_CONFIG_MAVEN_PROPS% ^
+  %MAVEN_OPTS% ^
+  %MAVEN_DEBUG_OPTS% ^
+  -classpath %WRAPPER_JAR% ^
+  "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" ^
+  %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %*
+if ERRORLEVEL 1 goto error
+goto end
+
+:error
+set ERROR_CODE=1
+
+:end
+@endlocal & set ERROR_CODE=%ERROR_CODE%
+
+if not "%MAVEN_SKIP_RC%"=="" goto skipRcPost
+@REM check for post script, once with legacy .bat ending and once with .cmd ending
+if exist "%USERPROFILE%\mavenrc_post.bat" call "%USERPROFILE%\mavenrc_post.bat"
+if exist "%USERPROFILE%\mavenrc_post.cmd" call "%USERPROFILE%\mavenrc_post.cmd"
+:skipRcPost
+
+@REM pause the script if MAVEN_BATCH_PAUSE is set to 'on'
+if "%MAVEN_BATCH_PAUSE%"=="on" pause
+
+if "%MAVEN_TERMINATE_CMD%"=="on" exit %ERROR_CODE%
+
+cmd /C exit /B %ERROR_CODE%

pom.xml

@@ -0,0 +1,140 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-parent</artifactId>
+        <version>3.2.5</version>
+        <relativePath/> <!-- lookup parent from repository -->
+    </parent>
+    <groupId>org.lanbom</groupId>
+    <artifactId>survey</artifactId>
+    <version>0.0.1-SNAPSHOT</version>
+    <name>survey</name>
+    <description>survey</description>
+    <properties>
+        <java.version>21</java.version>
+        <mapstruct.version>1.5.5.Final</mapstruct.version>
+        <lombok.version>1.18.32</lombok.version>
+        <lomstrcut-binding.version>0.2.0</lomstrcut-binding.version>
+        <poi.version>5.2.5</poi.version>
+        <commons-lang3.version>3.12.0</commons-lang3.version>
+        <open-api.version>2.5.0</open-api.version>
+    </properties>
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-data-jpa</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-validation</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-security</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.session</groupId>
+            <artifactId>spring-session-jdbc</artifactId>
+        </dependency>
+
+        <dependency>
+            <groupId>com.mysql</groupId>
+            <artifactId>mysql-connector-j</artifactId>
+            <scope>runtime</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <optional>true</optional>
+            <version>${lombok.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>org.mapstruct</groupId>
+            <artifactId>mapstruct</artifactId>
+            <version>${mapstruct.version}</version>
+        </dependency>
+
+        <dependency>
+            <groupId>org.apache.poi</groupId>
+            <artifactId>poi</artifactId>
+            <version>${poi.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.poi</groupId>
+            <artifactId>poi-ooxml</artifactId>
+            <version>${poi.version}</version>
+        </dependency>
+
+        <dependency>
+            <groupId>org.apache.commons</groupId>
+            <artifactId>commons-lang3</artifactId>
+            <version>${commons-lang3.version}</version>
+        </dependency>
+
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+            <version>${open-api.version}</version>
+        </dependency>
+
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <configuration>
+                    <excludes>
+                        <exclude>
+                            <groupId>org.projectlombok</groupId>
+                            <artifactId>lombok</artifactId>
+                        </exclude>
+                    </excludes>
+                </configuration>
+            </plugin>
+
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.8.1</version>
+                <configuration>
+                    <source>21</source>
+                    <target>21</target>
+                    <annotationProcessorPaths>
+                        <path>
+                            <groupId>org.mapstruct</groupId>
+                            <artifactId>mapstruct-processor</artifactId>
+                            <version>${mapstruct.version}</version>
+                        </path>
+                        <path>
+                            <groupId>org.projectlombok</groupId>
+                            <artifactId>lombok</artifactId>
+                            <version>${lombok.version}</version>
+                        </path>
+                        <path>
+                            <groupId>org.projectlombok</groupId>
+                            <artifactId>lombok-mapstruct-binding</artifactId>
+                            <version>${lomstrcut-binding.version}</version>
+                        </path>
+                    </annotationProcessorPaths>
+                </configuration>
+            </plugin>
+
+        </plugins>
+    </build>
+
+</project>

src/main/java/org/lanbom/survey/SurveyApplication.java

@@ -0,0 +1,16 @@
+package org.lanbom.survey;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.boot.autoconfigure.security.servlet.SecurityAutoConfiguration;
+import org.springframework.data.jpa.repository.config.EnableJpaAuditing;
+
+@SpringBootApplication(exclude = {SecurityAutoConfiguration.class })
+@EnableJpaAuditing
+public class SurveyApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(SurveyApplication.class, args);
+    }
+
+}

src/main/java/org/lanbom/survey/config/SessionConfig.java

@@ -0,0 +1,9 @@
+package org.lanbom.survey.config;
+
+import org.springframework.context.annotation.Configuration;
+import org.springframework.session.jdbc.config.annotation.web.http.EnableJdbcHttpSession;
+
+@Configuration
+@EnableJdbcHttpSession
+public class SessionConfig {
+}

src/main/java/org/lanbom/survey/config/SwaggerOpenApiConfig.java

@@ -0,0 +1,13 @@
+package org.lanbom.survey.config;
+
+import io.swagger.v3.oas.models.OpenAPI;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+public class SwaggerOpenApiConfig {
+    @Bean
+    public OpenAPI customOpenAPI() {
+        return new OpenAPI();
+    }
+}

src/main/java/org/lanbom/survey/controller/ExceptionContr.java

@@ -0,0 +1,27 @@
+package org.lanbom.survey.controller;
+
+import org.lanbom.survey.entity.resp.Resp;
+import org.springframework.context.support.DefaultMessageSourceResolvable;
+import org.springframework.web.bind.MethodArgumentNotValidException;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+import java.util.Optional;
+
+@RestControllerAdvice
+public class ExceptionContr {
+
+//    @ExceptionHandler(Exception.class)
+//    public Resp<Object> handler(Exception e) {
+//        return Resp.fail("系统异常");
+//    }
+
+    @ExceptionHandler(MethodArgumentNotValidException.class)
+    public Resp<Object> handler(MethodArgumentNotValidException e) {
+        String message = Optional.ofNullable(e.getBindingResult().getFieldError())
+                .map(DefaultMessageSourceResolvable::getDefaultMessage)
+                .orElse("参数错误");
+        return Resp.fail(message);
+    }
+
+}

src/main/java/org/lanbom/survey/controller/SurveyContr.java

@@ -0,0 +1,62 @@
+package org.lanbom.survey.controller;
+
+import jakarta.validation.constraints.NotNull;
+import org.lanbom.survey.entity.resp.Resp;
+import org.lanbom.survey.entity.resp.survey.SurveyResp;
+import org.lanbom.survey.service.SurveyServ;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.util.List;
+
+@RestController
+@RequestMapping("/survey")
+public class SurveyContr {
+
+    private final SurveyServ surveyServ;
+
+    public SurveyContr(SurveyServ surveyServ) {
+        this.surveyServ = surveyServ;
+    }
+
+    @PostMapping("/import")
+    public Resp<Object> importSurvey(@NotNull @RequestParam("file") MultipartFile file) {
+        surveyServ.importSurvey(file);
+        return Resp.success();
+    }
+
+    @GetMapping("/detail/{id}")
+    public Resp<SurveyResp> getSurveyDetail(@PathVariable("id") Long id) {
+        return Resp.success(surveyServ.getSurveyDetail(id));
+    }
+
+    @PostMapping("/publish/{id}")
+    public Resp<Object> publishSurvey(@PathVariable("id") Long id) {
+        surveyServ.publishSurvey(id);
+        return Resp.success();
+    }
+
+    @PostMapping("/close/{id}")
+    public Resp<Object> closeSurvey(@PathVariable("id") Long id) {
+        surveyServ.closeSurvey(id);
+        return Resp.success();
+    }
+
+    @PostMapping("/delete/{id}")
+    public Resp<Object> deleteSurvey(@PathVariable("id") Long id) {
+        surveyServ.deleteSurvey(id);
+        return Resp.success();
+    }
+
+    @GetMapping("/listAll")
+    public Resp<List<SurveyResp>> listAllSurvey() {
+        return Resp.success(surveyServ.listAllSurvey());
+    }
+
+    @GetMapping("/listByCreator/{creatorId}")
+    public Resp<List<SurveyResp>> listSurveyByCreator(@PathVariable("creatorId") Long creatorId) {
+        return Resp.success(surveyServ.listSurveyByCreator(creatorId));
+    }
+
+
+}

src/main/java/org/lanbom/survey/controller/UserContr.java

@@ -0,0 +1,35 @@
+package org.lanbom.survey.controller;
+
+import jakarta.servlet.http.HttpSession;
+import org.lanbom.survey.entity.req.user.LoginReq;
+import org.lanbom.survey.entity.req.user.RegisterReq;
+import org.lanbom.survey.entity.resp.Resp;
+import org.lanbom.survey.service.UserServ;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/user")
+public class UserContr {
+    private final UserServ userServ;
+
+    UserContr(UserServ userServ) {
+        this.userServ = userServ;
+    }
+
+    @PostMapping("/register")
+    public Resp<Object> listAll(@Validated @RequestBody RegisterReq req) {
+        userServ.register(req);
+        return Resp.success();
+    }
+
+    @PostMapping("/login")
+    public Resp<Object> login(@Validated @RequestBody LoginReq req, HttpSession session) {
+        System.out.println(session.getAttribute("username"));
+        boolean success = userServ.login(req, session);
+        return success ? Resp.success() : Resp.fail("账号或密码错误。");
+    }
+}

src/main/java/org/lanbom/survey/entity/enums/ExcelType.java

@@ -0,0 +1,21 @@
+package org.lanbom.survey.entity.enums;
+
+import org.apache.commons.lang3.EnumUtils;
+
+import java.util.EnumMap;
+import java.util.Map;
+import java.util.Optional;
+
+public enum ExcelType {
+    XLS, XLSX;
+
+    public static ExcelType fromFilename(String filename) {
+        return Optional.ofNullable(
+                        EnumUtils.getEnum(
+                                ExcelType.class,
+                                filename.substring(filename.lastIndexOf(".") + 1).toUpperCase()
+                        )
+                )
+                .orElseThrow(() -> new IllegalArgumentException("不支持的Excel类型"));
+    }
+}

src/main/java/org/lanbom/survey/entity/enums/QuestionType.java

@@ -0,0 +1,41 @@
+package org.lanbom.survey.entity.enums;
+
+import lombok.Getter;
+import org.apache.commons.collections4.SetUtils;
+import org.apache.commons.lang3.EnumUtils;
+import org.lanbom.survey.entity.pojo.Option;
+
+import java.util.HashSet;
+import java.util.Map;
+import java.util.Optional;
+import java.util.Set;
+import java.util.stream.Collectors;
+
+@Getter
+public enum QuestionType {
+
+    QA("问答题"),
+    MC("多选题"),
+    SC("单选题");
+
+    private final String desc;
+
+    private static final Map<String, QuestionType> descEnumMap = EnumUtils.getEnumList(QuestionType.class).stream()
+            .collect(Collectors.toMap(QuestionType::getDesc, questionType -> questionType));
+
+    private static final Set<QuestionType> optionTypes = Set.of(MC, SC);
+
+    QuestionType(String desc) {
+        this.desc = desc;
+    }
+
+    public static QuestionType fromDesc(String desc) {
+        return Optional.ofNullable(descEnumMap.get(desc))
+                .orElseThrow(() -> new IllegalArgumentException("不支持的问题类型"));
+    }
+
+    public boolean hasOption() {
+        return optionTypes.contains(this);
+    }
+
+}

src/main/java/org/lanbom/survey/entity/enums/SurveyStatus.java

@@ -0,0 +1,14 @@
+package org.lanbom.survey.entity.enums;
+
+public enum SurveyStatus {
+
+    UNPUBLISHED("未发布"),
+    PUBLISHED("已发布"),
+    CLOSED("已关闭");
+
+    private final String desc;
+
+    SurveyStatus(String desc) {
+        this.desc = desc;
+    }
+}

src/main/java/org/lanbom/survey/entity/exception/ErrorUploadFileException.java

@@ -0,0 +1,7 @@
+package org.lanbom.survey.entity.exception;
+
+public class ErrorUploadFileException extends RuntimeException {
+    public ErrorUploadFileException(String msg) {
+        super(msg);
+    }
+}

src/main/java/org/lanbom/survey/entity/exception/ExcelRuleException.java

@@ -0,0 +1,7 @@
+package org.lanbom.survey.entity.exception;
+
+public class ExcelRuleException extends RuntimeException {
+    public ExcelRuleException(String message) {
+        super(message);
+    }
+}

src/main/java/org/lanbom/survey/entity/mapper/survey/SurveyMap.java

@@ -0,0 +1,52 @@
+package org.lanbom.survey.entity.mapper.survey;
+
+import org.lanbom.survey.entity.pojo.Option;
+import org.lanbom.survey.entity.pojo.Question;
+import org.lanbom.survey.entity.pojo.Survey;
+import org.lanbom.survey.entity.req.survey.ExcelOptionReq;
+import org.lanbom.survey.entity.req.survey.ExcelQuestionReq;
+import org.lanbom.survey.entity.req.survey.ExcelSurveyReq;
+import org.lanbom.survey.entity.resp.survey.OptionResp;
+import org.lanbom.survey.entity.resp.survey.QuestionResp;
+import org.lanbom.survey.entity.resp.survey.SurveyResp;
+import org.mapstruct.Mapper;
+import org.mapstruct.Mapping;
+
+@Mapper(componentModel = "spring")
+public interface SurveyMap {
+    @Mapping(target = "id", ignore = true)
+    @Mapping(target = "updateBy", ignore = true)
+    @Mapping(target = "updateAt", ignore = true)
+    @Mapping(target = "createBy", ignore = true)
+    @Mapping(target = "createAt", ignore = true)
+    @Mapping(target = "status", expression = "java(org.lanbom.survey.entity.enums.SurveyStatus.UNPUBLISHED)")
+    @Mapping(target = "isDeleted", constant = "0")
+    Survey excelSurveyReq2Pojo(ExcelSurveyReq req);
+
+    @Mapping(target = "id", ignore = true)
+    @Mapping(target = "updateAt", ignore = true)
+    @Mapping(target = "createBy", ignore = true)
+    @Mapping(target = "createAt", ignore = true)
+    @Mapping(target = "updateBy", ignore = true)
+    @Mapping(target = "isDeleted", constant = "0")
+    Question excelQuestionReq2Pojo(ExcelQuestionReq req, Long surveyId);
+
+    @Mapping(target = "id", ignore = true)
+    @Mapping(target = "updateBy", ignore = true)
+    @Mapping(target = "updateAt", ignore = true)
+    @Mapping(target = "createBy", ignore = true)
+    @Mapping(target = "createAt", ignore = true)
+    @Mapping(target = "isDeleted", constant = "0")
+    Option excelOptionReq2Pojo(ExcelOptionReq req, Long surveyId, Long questionId);
+
+
+    @Mapping(target = "questions", ignore = true)
+    SurveyResp surveyPojo2Resp(Survey survey);
+
+    @Mapping(target = "options", ignore = true)
+    QuestionResp questionPojo2Resp(Question question);
+
+    OptionResp optionPojo2Resp(Option option);
+
+
+}

src/main/java/org/lanbom/survey/entity/mapper/user/UserMap.java

@@ -0,0 +1,17 @@
+package org.lanbom.survey.entity.mapper.user;
+
+
+import org.lanbom.survey.entity.pojo.User;
+import org.lanbom.survey.entity.req.user.RegisterReq;
+import org.mapstruct.Mapper;
+import org.mapstruct.Mapping;
+
+@Mapper(componentModel = "spring")
+public interface UserMap {
+    @Mapping(target = "updateAt", ignore = true)
+    @Mapping(target = "id", ignore = true)
+    @Mapping(target = "createAt", ignore = true)
+    @Mapping(target = "status", constant = "1")
+    @Mapping(target = "role", constant = "1")
+    User registerReq2Pojo(RegisterReq req);
+}

src/main/java/org/lanbom/survey/entity/pojo/Option.java

@@ -0,0 +1,54 @@
+package org.lanbom.survey.entity.pojo;
+
+import jakarta.persistence.*;
+import lombok.Data;
+import org.hibernate.annotations.SQLDelete;
+import org.hibernate.annotations.SQLRestriction;
+import org.springframework.data.annotation.CreatedBy;
+import org.springframework.data.annotation.CreatedDate;
+import org.springframework.data.annotation.LastModifiedBy;
+import org.springframework.data.annotation.LastModifiedDate;
+import org.springframework.data.jpa.domain.support.AuditingEntityListener;
+
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "`option`")
+@SQLRestriction("is_deleted = 0")
+@EntityListeners(value = AuditingEntityListener.class)
+@SQLDelete(sql = "update `option` set is_deleted = 1 where id = ?")
+public class Option {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(name = "survey_id", nullable = false)
+    private Long surveyId;
+
+    @Column(name = "question_id", nullable = false)
+    private Long questionId;
+
+    @Column(name = "`order`", nullable = false)
+    private Integer order;
+
+    @Column(name = "content", length = 1000, nullable = false)
+    private String content;
+
+    @Column(name = "is_deleted", nullable = false)
+    private Integer isDeleted;
+
+    @CreatedBy
+    private Long createBy;
+
+    @LastModifiedBy
+    private Long updateBy;
+
+    @CreatedDate
+    private LocalDateTime createAt;
+
+    @LastModifiedDate
+    private LocalDateTime updateAt;
+
+}

src/main/java/org/lanbom/survey/entity/pojo/Question.java

@@ -0,0 +1,52 @@
+package org.lanbom.survey.entity.pojo;
+import jakarta.persistence.*;
+import lombok.Data;
+import org.hibernate.annotations.SQLDelete;
+import org.hibernate.annotations.SQLRestriction;
+import org.lanbom.survey.entity.enums.QuestionType;
+import org.springframework.data.annotation.CreatedBy;
+import org.springframework.data.annotation.CreatedDate;
+import org.springframework.data.annotation.LastModifiedBy;
+import org.springframework.data.annotation.LastModifiedDate;
+import org.springframework.data.jpa.domain.support.AuditingEntityListener;
+
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "question")
+@SQLRestriction("is_deleted = 0")
+@EntityListeners(value = AuditingEntityListener.class)
+@SQLDelete(sql = "update question set is_deleted = 1 where id = ?")
+public class Question {
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(name = "survey_id", nullable = false)
+    private Long surveyId;
+
+    @Column(name = "`order`", nullable = false)
+    private Integer order;
+
+    @Enumerated
+    private QuestionType type;
+
+    @Column(name = "content", length = 1000, nullable = false)
+    private String content;
+
+    @Column(name = "is_deleted", nullable = false)
+    private Integer isDeleted;
+
+    @CreatedBy
+    private Long createBy;
+
+    @LastModifiedBy
+    private Long updateBy;
+
+    @CreatedDate
+    private LocalDateTime createAt;
+
+    @LastModifiedDate
+    private LocalDateTime updateAt;
+}

src/main/java/org/lanbom/survey/entity/pojo/Survey.java

@@ -0,0 +1,48 @@
+package org.lanbom.survey.entity.pojo;
+
+import jakarta.persistence.*;
+import lombok.Data;
+import org.hibernate.annotations.SQLDelete;
+import org.hibernate.annotations.SQLRestriction;
+import org.lanbom.survey.entity.enums.SurveyStatus;
+import org.springframework.data.annotation.CreatedBy;
+import org.springframework.data.annotation.CreatedDate;
+import org.springframework.data.annotation.LastModifiedBy;
+import org.springframework.data.annotation.LastModifiedDate;
+import org.springframework.data.jpa.domain.support.AuditingEntityListener;
+
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "survey")
+@SQLRestriction("is_deleted = 0")
+@EntityListeners(value = AuditingEntityListener.class)
+@SQLDelete(sql = "update survey set is_deleted = 1 where id = ?")
+public class Survey {
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(name = "title", length = 100, nullable = false)
+    private String title;
+
+    @Enumerated
+    private SurveyStatus status;
+
+    @Column(name = "is_deleted", nullable = false)
+    private Integer isDeleted;
+
+    @CreatedBy
+    private Long createBy;
+
+    @LastModifiedBy
+    private Long updateBy;
+
+    @CreatedDate
+    private LocalDateTime createAt;
+
+    @LastModifiedDate
+    private LocalDateTime updateAt;
+
+}

src/main/java/org/lanbom/survey/entity/pojo/User.java

@@ -0,0 +1,38 @@
+package org.lanbom.survey.entity.pojo;
+
+import jakarta.persistence.*;
+import lombok.Data;
+import org.springframework.data.annotation.CreatedDate;
+import org.springframework.data.annotation.LastModifiedDate;
+import org.springframework.data.jpa.domain.support.AuditingEntityListener;
+
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "user")
+@EntityListeners(value = AuditingEntityListener.class)
+public class User {
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)    private Long id;
+
+    @Column(name = "username", length = 20, nullable = false, unique = true)
+    private String username;
+
+    @Column(name = "password", length = 100, nullable = false)
+    private String password;
+
+    // 0: admin, 1: normal
+    @Column(name = "role", nullable = false)
+    private Integer role;
+
+    // 0: banned, 1: normal
+    @Column(name = "status", nullable = false)
+    private Integer status;
+
+    @CreatedDate
+    private LocalDateTime createAt;
+
+    @LastModifiedDate
+    private LocalDateTime updateAt;
+}

src/main/java/org/lanbom/survey/entity/req/survey/ExcelOptionReq.java

@@ -0,0 +1,9 @@
+package org.lanbom.survey.entity.req.survey;
+
+import lombok.Data;
+
+@Data
+public class ExcelOptionReq {
+    private Integer order;
+    private String content;
+}

src/main/java/org/lanbom/survey/entity/req/survey/ExcelQuestionReq.java

@@ -0,0 +1,14 @@
+package org.lanbom.survey.entity.req.survey;
+
+import lombok.Data;
+import org.lanbom.survey.entity.enums.QuestionType;
+
+import java.util.List;
+
+@Data
+public class ExcelQuestionReq {
+    private Integer order;
+    private String content;
+    private QuestionType type;
+    private List<ExcelOptionReq> options;
+}

src/main/java/org/lanbom/survey/entity/req/survey/ExcelSurveyReq.java

@@ -0,0 +1,11 @@
+package org.lanbom.survey.entity.req.survey;
+
+import lombok.Data;
+
+import java.util.List;
+
+@Data
+public class ExcelSurveyReq {
+    private String title;
+    private List<ExcelQuestionReq> questions;
+}

src/main/java/org/lanbom/survey/entity/req/user/LoginReq.java

@@ -0,0 +1,13 @@
+package org.lanbom.survey.entity.req.user;
+
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+@Data
+public class LoginReq {
+    @Pattern(regexp = "^[a-zA-Z0-9]{4,16}$", message = "账号由大小写字母和数字组成，长度4-16位")
+    private String username;
+
+    @Pattern(regexp = "^[a-zA-Z0-9]{8,18}$", message = "密码由大小写字母和数字组成，长度8-18位")
+    private String password;
+}

src/main/java/org/lanbom/survey/entity/req/user/RegisterReq.java

@@ -0,0 +1,15 @@
+package org.lanbom.survey.entity.req.user;
+
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+@Data
+public class RegisterReq {
+    @Pattern(regexp = "^[a-zA-Z0-9]{4,16}$", message = "账号由大小写字母和数字组成，长度4-16位")
+    private String username;
+
+    @Pattern(regexp = "^[a-zA-Z0-9]{8,18}$", message = "密码由大小写字母和数字组成，长度8-18位")
+    private String password;
+}

src/main/java/org/lanbom/survey/entity/resp/Resp.java

@@ -0,0 +1,25 @@
+package org.lanbom.survey.entity.resp;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+
+@Data
+@AllArgsConstructor
+public class Resp<T> {
+    private int code;
+    private String msg;
+    private T data;
+
+    public static <T> Resp<T> success(T data) {
+        return new Resp<>(200, "success", data);
+    }
+
+
+    public static Resp<Object> success() {
+        return new Resp<>(200, "success", null);
+    }
+
+    public static Resp<Object> fail(String msg) {
+        return new Resp<>(400, msg, null);
+    }
+}

src/main/java/org/lanbom/survey/entity/resp/survey/OptionResp.java

@@ -0,0 +1,16 @@
+package org.lanbom.survey.entity.resp.survey;
+
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Data
+public class OptionResp {
+    private Long id;
+    private Integer order;
+    private String content;
+    private Long createBy;
+    private Long updateBy;
+    private LocalDateTime createAt;
+    private LocalDateTime updateAt;
+}

src/main/java/org/lanbom/survey/entity/resp/survey/QuestionResp.java

@@ -0,0 +1,20 @@
+package org.lanbom.survey.entity.resp.survey;
+
+import lombok.Data;
+import org.lanbom.survey.entity.enums.QuestionType;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Data
+public class QuestionResp {
+    private Long id;
+    private Integer order;
+    private QuestionType type;
+    private String content;
+    private List<OptionResp> options;
+    private Long createBy;
+    private Long updateBy;
+    private LocalDateTime createAt;
+    private LocalDateTime updateAt;
+}

src/main/java/org/lanbom/survey/entity/resp/survey/SurveyResp.java

@@ -0,0 +1,19 @@
+package org.lanbom.survey.entity.resp.survey;
+
+import lombok.Data;
+import org.lanbom.survey.entity.enums.SurveyStatus;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Data
+public class SurveyResp {
+    private Long id;
+    private String title;
+    private SurveyStatus status;
+    private List<QuestionResp> questions;
+    private Long createBy;
+    private Long updateBy;
+    private LocalDateTime createAt;
+    private LocalDateTime updateAt;
+}

src/main/java/org/lanbom/survey/repository/OptionRepo.java

@@ -0,0 +1,12 @@
+package org.lanbom.survey.repository;
+
+import org.lanbom.survey.entity.pojo.Option;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.Collection;
+import java.util.List;
+
+public interface OptionRepo extends JpaRepository<Option, Long> {
+    List<Option> findAllByQuestionIdIn(Collection<Long> questionId);
+    void deleteAllBySurveyId(Long surveyId);
+}

src/main/java/org/lanbom/survey/repository/QuestionRepo.java

@@ -0,0 +1,11 @@
+package org.lanbom.survey.repository;
+
+import org.lanbom.survey.entity.pojo.Question;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.List;
+
+public interface QuestionRepo extends JpaRepository<Question, Long> {
+    List<Question> findAllBySurveyId(Long surveyId);
+    void deleteAllBySurveyId(Long surveyId);
+}

src/main/java/org/lanbom/survey/repository/SurveyRepo.java

@@ -0,0 +1,10 @@
+package org.lanbom.survey.repository;
+
+import org.lanbom.survey.entity.pojo.Survey;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.List;
+
+public interface SurveyRepo extends JpaRepository<Survey, Long> {
+    List<Survey> findAllByCreateBy(Long creatorId);
+}

src/main/java/org/lanbom/survey/repository/UserRepo.java

@@ -0,0 +1,8 @@
+package org.lanbom.survey.repository;
+
+import org.lanbom.survey.entity.pojo.User;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface UserRepo extends JpaRepository<User, Long> {
+    User findByUsername(String username);
+}

src/main/java/org/lanbom/survey/service/SurveyServ.java

@@ -0,0 +1,184 @@
+package org.lanbom.survey.service;
+
+import org.apache.commons.lang3.StringUtils;
+import org.apache.poi.ss.usermodel.Row;
+import org.apache.poi.ss.usermodel.Workbook;
+import org.lanbom.survey.entity.enums.ExcelType;
+import org.lanbom.survey.entity.enums.QuestionType;
+import org.lanbom.survey.entity.enums.SurveyStatus;
+import org.lanbom.survey.entity.exception.ErrorUploadFileException;
+import org.lanbom.survey.entity.exception.ExcelRuleException;
+import org.lanbom.survey.entity.mapper.survey.SurveyMap;
+import org.lanbom.survey.entity.pojo.Option;
+import org.lanbom.survey.entity.pojo.Question;
+import org.lanbom.survey.entity.pojo.Survey;
+import org.lanbom.survey.entity.req.survey.ExcelOptionReq;
+import org.lanbom.survey.entity.req.survey.ExcelQuestionReq;
+import org.lanbom.survey.entity.req.survey.ExcelSurveyReq;
+import org.lanbom.survey.entity.resp.survey.QuestionResp;
+import org.lanbom.survey.entity.resp.survey.SurveyResp;
+import org.lanbom.survey.repository.OptionRepo;
+import org.lanbom.survey.repository.QuestionRepo;
+import org.lanbom.survey.repository.SurveyRepo;
+import org.lanbom.survey.util.ExcelUtils;
+import org.springframework.stereotype.Service;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.IOException;
+import java.util.*;
+import java.util.stream.Collectors;
+
+@Service
+public class SurveyServ {
+
+    private final SurveyRepo surveyRepo;
+    private final QuestionRepo questionRepo;
+    private final OptionRepo optionRepo;
+    private final SurveyMap surveyMap;
+
+    public SurveyServ(SurveyRepo surveyRepo, QuestionRepo questionRepo, OptionRepo optionRepo, SurveyMap surveyMap) {
+        this.surveyRepo = surveyRepo;
+        this.questionRepo = questionRepo;
+        this.optionRepo = optionRepo;
+        this.surveyMap = surveyMap;
+    }
+
+    public void importSurvey(MultipartFile file) {
+        validExcel(file);
+        Workbook wb;
+        try {
+            wb = ExcelUtils.getWorkbookFromFile(file.getInputStream(), ExcelType.fromFilename(file.getOriginalFilename()));
+        } catch (IOException e) {
+            throw new IllegalArgumentException("读取文件失败");
+        }
+
+        // TODO: batch insert
+        List<ExcelSurveyReq> surveyReqs = List.of(extractExcelSurveyReq(wb));
+        surveyReqs.forEach(surveyReq -> {
+            Survey survey = surveyRepo.save(surveyMap.excelSurveyReq2Pojo(surveyReq));
+            surveyReq.getQuestions().forEach(questionReq -> {
+                Question question = questionRepo.save(surveyMap.excelQuestionReq2Pojo(questionReq, survey.getId()));
+                questionReq.getOptions().forEach(optionReq -> {
+                    optionRepo.save(surveyMap.excelOptionReq2Pojo(optionReq, survey.getId(), question.getId()));
+                });
+            });
+        });
+    }
+
+    public SurveyResp getSurveyDetail(Long id) {
+        Survey survey = surveyRepo.findById(id).orElseThrow(() -> new IllegalArgumentException("问卷不存在"));
+        List<Question> questions = questionRepo.findAllBySurveyId(survey.getId()).stream()
+                .sorted(Comparator.comparing(Question::getOrder))
+                .toList();
+        List<Option> options = optionRepo.findAllByQuestionIdIn(questions.stream().map(Question::getId).toList());
+        return assembleSurveyResp(survey, questions, options);
+    }
+
+    // TODO: 鉴权
+    public void publishSurvey(Long id) {
+        Survey survey = surveyRepo.findById(id).orElseThrow(() -> new IllegalArgumentException("问卷不存在"));
+        survey.setStatus(SurveyStatus.PUBLISHED);
+        surveyRepo.save(survey);
+    }
+
+    // TODO: 鉴权
+    public void closeSurvey(Long id) {
+        Survey survey = surveyRepo.findById(id).orElseThrow(() -> new IllegalArgumentException("问卷不存在"));
+        survey.setStatus(SurveyStatus.CLOSED);
+        surveyRepo.save(survey);
+    }
+
+    // TODO: 鉴权
+    public void deleteSurvey(Long id) {
+        surveyRepo.findById(id).orElseThrow(() -> new IllegalArgumentException("问卷不存在"));
+        surveyRepo.deleteById(id);
+        questionRepo.deleteAllBySurveyId(id);
+        optionRepo.deleteAllBySurveyId(id);
+    }
+
+    // TODO: 鉴权
+    public List<SurveyResp> listAllSurvey() {
+        return surveyRepo.findAll().stream().map(surveyMap::surveyPojo2Resp).toList();
+    }
+
+    // TODO: 鉴权
+    public List<SurveyResp> listSurveyByCreator(Long creatorId) {
+        return surveyRepo.findAllByCreateBy(creatorId).stream().map(surveyMap::surveyPojo2Resp).toList();
+    }
+
+    /**
+     * ---------------------------------private---------------------------------
+     **/
+    private void validExcel(MultipartFile file) {
+        if (file.isEmpty() || StringUtils.isBlank(file.getOriginalFilename())) {
+            throw new ErrorUploadFileException("文件为空");
+        }
+    }
+
+    private void validRow(Row row) {
+        if (Objects.isNull(row)) {
+            throw new ExcelRuleException("表格数据为空");
+        }
+        if (row.getPhysicalNumberOfCells() < 2) {
+            throw new ExcelRuleException("表格数据不完整");
+        }
+        for (int c = 0; c < row.getPhysicalNumberOfCells(); c++) {
+            if (StringUtils.isBlank(row.getCell(c).toString())) {
+                throw new ExcelRuleException("表格数据不完整");
+            }
+        }
+        QuestionType type;
+        try {
+            type = QuestionType.fromDesc(row.getCell(1).toString());
+        } catch (IllegalArgumentException e) {
+            throw new ExcelRuleException("问题类型错误");
+        }
+        if (type.hasOption()) {
+            if (row.getPhysicalNumberOfCells() < 3) {
+                throw new ExcelRuleException("表格数据不完整");
+            }
+        }
+    }
+
+    private ExcelSurveyReq extractExcelSurveyReq(Workbook wb) {
+        ExcelSurveyReq surveyReq = new ExcelSurveyReq();
+        surveyReq.setTitle(wb.getSheetName(0));
+        surveyReq.setQuestions(new ArrayList<>());
+        for (int r = 1; r < wb.getSheetAt(0).getPhysicalNumberOfRows(); r++) {
+            Row row = wb.getSheetAt(0).getRow(r);
+            validRow(row);
+            ExcelQuestionReq questionReq = new ExcelQuestionReq();
+            questionReq.setOrder(r);
+            questionReq.setContent(row.getCell(0).toString());
+            questionReq.setType(QuestionType.fromDesc(row.getCell(1).toString()));
+            questionReq.setOptions(new ArrayList<>());
+            for (int c = 2; c < row.getPhysicalNumberOfCells(); c++) {
+                ExcelOptionReq optionReq = new ExcelOptionReq();
+                optionReq.setOrder(c - 1);
+                optionReq.setContent(row.getCell(c).toString());
+                questionReq.getOptions().add(optionReq);
+            }
+            surveyReq.getQuestions().add(questionReq);
+        }
+        return surveyReq;
+    }
+
+    private SurveyResp assembleSurveyResp(Survey survey, List<Question> questions, List<Option> options) {
+        Map<Long, List<Option>> questionId2Option = options.stream()
+                .collect(Collectors.groupingBy(Option::getQuestionId));
+
+        SurveyResp surveyResp = surveyMap.surveyPojo2Resp(survey);
+        surveyResp.setQuestions(questions.stream().map(question -> {
+            QuestionResp questionResp = surveyMap.questionPojo2Resp(question);
+            questionResp.setOptions(Optional.ofNullable(questionId2Option.get(question.getId()))
+                    .orElse(List.of())
+                    .stream()
+                    .sorted(Comparator.comparing(Option::getOrder))
+                    .map(surveyMap::optionPojo2Resp)
+                    .toList());
+            return questionResp;
+        }).toList());
+
+        return surveyResp;
+    }
+}

src/main/java/org/lanbom/survey/service/UserServ.java

@@ -0,0 +1,45 @@
+package org.lanbom.survey.service;
+
+import jakarta.servlet.http.HttpSession;
+import org.lanbom.survey.entity.mapper.user.UserMap;
+import org.lanbom.survey.entity.pojo.User;
+import org.lanbom.survey.entity.req.user.LoginReq;
+import org.lanbom.survey.entity.req.user.RegisterReq;
+import org.lanbom.survey.repository.UserRepo;
+import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
+import org.springframework.stereotype.Service;
+
+@Service
+public class UserServ {
+
+    private final UserMap userMap;
+    private final UserRepo userRepo;
+
+    private final BCryptPasswordEncoder encoder = new BCryptPasswordEncoder();
+
+    public UserServ(UserMap userMap, UserRepo userRepo) {
+        this.userMap = userMap;
+        this.userRepo = userRepo;
+    }
+
+    public void register(RegisterReq req) {
+        User user = userMap.registerReq2Pojo(req);
+        user.setPassword(encoder.encode(user.getPassword()));
+        System.out.println(user);
+        userRepo.save(user);
+    }
+
+    public boolean login(LoginReq req, HttpSession session) {
+        User user = userRepo.findByUsername(req.getUsername());
+        if (user == null || !validatePassword(req.getPassword(), user.getPassword())) {
+            return false;
+        }
+//        session.setAttribute("user", user);
+        return true;
+    }
+
+    private boolean validatePassword(String password, String encodedPassword) {
+        return encoder.matches(password, encodedPassword);
+    }
+
+}

src/main/java/org/lanbom/survey/util/ExcelUtils.java

@@ -0,0 +1,19 @@
+package org.lanbom.survey.util;
+
+import org.apache.poi.hssf.usermodel.HSSFWorkbook;
+import org.apache.poi.ss.usermodel.Workbook;
+import org.apache.poi.xssf.usermodel.XSSFWorkbook;
+import org.lanbom.survey.entity.enums.ExcelType;
+
+import java.io.IOException;
+import java.io.InputStream;
+
+public class ExcelUtils {
+    public static Workbook getWorkbookFromFile(InputStream inputStream, ExcelType excelType) throws IOException {
+        return switch (excelType) {
+            case XLSX -> new XSSFWorkbook(inputStream);
+            case XLS -> new HSSFWorkbook(inputStream);
+            default -> throw new IllegalArgumentException("不支持的Excel类型");
+        };
+    }
+}

src/main/resources/application.yml

@@ -0,0 +1,13 @@
+spring:
+  application:
+    name: survey
+  datasource:
+    url: jdbc:mysql://myhost.fallen-angle.com:3306/survey
+    username: root
+    password: 13291004986@lm
+    driver-class-name: com.mysql.cj.jdbc.Driver
+
+  jpa:
+    hibernate:
+      ddl-auto: update
+    show-sql: true

src/test/java/org/lanbom/survey/SurveyApplicationTests.java

@@ -0,0 +1,13 @@
+package org.lanbom.survey;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.boot.test.context.SpringBootTest;
+
+@SpringBootTest
+class SurveyApplicationTests {
+
+    @Test
+    void contextLoads() {
+    }
+
+}

src/test/java/org/lanbom/survey/TempTest.java

@@ -0,0 +1,9 @@
+package org.lanbom.survey;
+
+import java.util.List;
+
+public class TempTest {
+    public static void main(String[] args) {
+        List<String> list = List.of("a", "b", "c");
+    }
+}