EUSurvey 开源项目安装与使用教程

EUSurvey 开源项目安装与使用教程

EUSURVEY EUSurvey is an opensource surveying tool. It features different types of questions, free text fields as well as more complex elements like editable tables and gallery elements. Results can be displayed as histograms, percentages or in full details and can be exported to different formats. All submitted answers (or a sub-set) can be published automatically on a dedicated webpage within the application. It is freely available for any organisation or administration, public or private and can also be deployed as an open source version. 项目地址: https://gitcode.com/gh_mirrors/eu/EUSURVEY

1. 项目的目录结构及介绍

EUSurvey 项目的目录结构如下：

EUSURVEY/
├── docker/
├── src/
│   ├── main/
│   │   ├── config/
│   │   ├── java/
│   │   ├── resources/
│   │   └── webapp/
│   └── test/
├── .gitignore
├── .travis.yml
├── LICENSE.txt
├── README.md
├── buildNumber.properties
├── checkstyle.xml
├── pom.xml
├── publiccode.yml
└── sonar-project.properties

目录结构介绍

• docker/: 包含 Docker 相关的配置文件。
• src/: 项目的源代码目录。
  • main/: 主代码目录。
    • config/: 配置文件目录。
    • java/: Java 源代码目录。
    • resources/: 资源文件目录。
    • webapp/: Web 应用相关文件目录。
  • test/: 测试代码目录。
• .gitignore: Git 忽略文件配置。
• .travis.yml: Travis CI 配置文件。
• LICENSE.txt: 项目许可证文件。
• README.md: 项目说明文件。
• buildNumber.properties: 构建编号配置文件。
• checkstyle.xml: Checkstyle 配置文件。
• pom.xml: Maven 项目配置文件。
• publiccode.yml: 公共代码配置文件。
• sonar-project.properties: SonarQube 配置文件。

2. 项目的启动文件介绍

EUSurvey 项目的启动文件主要依赖于 Maven 和 Tomcat。以下是启动项目的步骤：

2.1 使用 Maven 构建项目

在项目根目录下执行以下命令来构建项目：

mvn clean install -Denvironment=oss

2.2 部署到 Tomcat

构建完成后，使用以下命令将项目部署到 Tomcat：

mvn clean tomcat7:deploy -Dtomcat.admin.password=your_tomcat_password -Dtomcat.admin=your_tomcat_username -Dtomcat.deploy.url=your_tomcat_url -Denvironment=oss

2.3 启动 Tomcat

启动 Tomcat 服务器，项目将自动部署并启动。

3. 项目的配置文件介绍

EUSurvey 项目的配置文件主要位于 src/main/config/ 目录下。以下是主要的配置文件及其作用：

3.1 application.properties

该文件包含了应用的基本配置，如数据库连接、日志级别等。

3.2 database.properties

该文件包含了数据库相关的配置，如数据库 URL、用户名、密码等。

3.3 spring.properties

该文件包含了 Spring 框架的相关配置，如 Bean 定义、事务管理等。

3.4 log4j.properties

该文件包含了日志系统的配置，如日志级别、输出格式等。

3.5 checkstyle.xml

该文件包含了代码风格检查的配置，用于确保代码风格的一致性。

3.6 sonar-project.properties

该文件包含了 SonarQube 代码质量分析的配置。

通过以上配置文件，可以灵活地调整 EUSurvey 项目的运行环境和行为。

EUSURVEY EUSurvey is an opensource surveying tool. It features different types of questions, free text fields as well as more complex elements like editable tables and gallery elements. Results can be displayed as histograms, percentages or in full details and can be exported to different formats. All submitted answers (or a sub-set) can be published automatically on a dedicated webpage within the application. It is freely available for any organisation or administration, public or private and can also be deployed as an open source version. 项目地址: https://gitcode.com/gh_mirrors/eu/EUSURVEY