JustDoIt

Просто сделай это

Заявка на управление делом для Java. Школьный проект для лекционных приложений на основе баз данных на основе DHBW Karlsruhe.

Краткое описание

Это пример веб-приложения MVC на стороне сервера, реализованного в Java. Приложение устанавливается на «Jakarta Enterprise Edition» (ранее «Java Enterprise Edition») и, следовательно, работает на специально разработанном сервере приложений. Вся логика приложений реализована сервером, так что для каждого URL-шаблона приложения вызывается полностью сгенерированная сервером страница HTML и отображается в браузере.

Примечания по развертыванию

Используемые технологии

Во время разработки мы использовали специально настроенный сервер Tomee. База данных Дерби использовалась в качестве базы данных. Оба содержатся в наших файлах, которые загружаются в доставку проекта. Приложение использует Maven в качестве инструмента сборки и управления пакетами. Таким образом, API, необходимые для Джакарты, но дальнейшие зависимости, интегрируются в проект. Исходный код приложения структурирован следующим образом:

• Сервлеты служат контроллером и получают все запросы HTTP.
• Предприятие Java Beans служат модельным слоем и капсулами профессиональной логики приложения.
• Организации постоянств моделируют модель данных и используются для всех доступа к базе данных.
• Страницы Java Server и различные статические файлы формируют представление и генерируют HTML -код, отображаемый на экране.

Используются следующие инструменты разработки:

• Netbeans: интегрированная среда разработки для Java и других языков
• Maven: сборка и управление зависимостями
• GIT: Управление версией для совместной работы над исходным кодом
• Tomee: сервер приложений для локального тестирования приложения
• Дерби: база данных SQL, реализованная в Java для тестирования приложения

Конфигурация аутентификации пользователя

На классах JustDoit.common.jpa.user и JustDoit.common.ejb.userbean Администрация пользователя была реализована. Приложение управляет отдельной таблицей в базе данных, в которой сохраняются пользователи, пароли и назначенные группы пользователей.

Однако аутентификация и авторизация выполняются сервером приложений, который должен быть настроен соответствующим образом. Это означает, что сервер приложений должен знать, в каких таблицах сохраняются пользователи. Это основано на параметрах в файлах /Web Pages/WEB-INF/web.xml .

Существуют специфические настройки приложения, которые требуют действий, которые позволяют требовать. В конце концов, следующая строка

    <realm-name>justdoit</realm-name>

назначен царство. Realm - это всего лишь хороший термин для любой базы данных с пользователями, вашими паролями и разрешениями.

В Tomee это происходит через следующие строки в файле конфигурации conf/server.xml : определение сферы выполняется следующими строками в файлах /Web Pages/META-INF/context.xml :

    <Realm
            className      = "org.apache.catalina.realm.DataSourceRealm"

            dataSourceName = "Default-Database-Unmanaged"
            userTable      = "justdoit.justdoit_user"
            userNameCol    = "username"
            userCredCol    = "password_hash"

            userRoleTable  = "justdoit.user_group"
            roleNameCol    = "groupname"
        >
            <CredentialHandler
                className = "org.apache.catalina.realm.MessageDigestCredentialHandler"
                algorithm = "SHA-256"
            />
    </Realm>

Подключение к базе данных, упомянутое в разделе dataSourceName должно быть определена следующим образом в файле conf/tomee.xml :

    <Resource id="Derby-Sample-Managed" type="javax.sql.DataSource">
        JdbcDriver = org.apache.derby.jdbc.ClientDriver
        JdbcUrl    = jdbc:derby://localhost:1527/sample
        UserName   = app
        Password   = app
        JtaManaged = true
    </Resource>

    <Resource id="Derby-Sample-Unmanaged" type="javax.sql.DataSource">
        JdbcDriver = org.apache.derby.jdbc.ClientDriver
        JdbcUrl    = jdbc:derby://localhost:1527/sample
        UserName   = app
        Password   = app
        JtaManaged = false
    </Resource>

Пример основан на базе данных примеров Дерби, которая является частью NetBeans.

Примечания по доставке по электронной почте

Доставка электронной почты реализована с помощью API Javamail. Часть необходимых настроек сохраняется в файле JSON: src/main/resources/mailConfig.json

 {
    "from": "",
    "host": "",
    "port": "",
    "username": "",
    "password": ""
}

• from : адрес, который должен отображаться в качестве адреса отправителя.
• host : Адрес почтового выхода пола (SMTP -сервер)
• port : порт сервера вывода (SMTP -сервер)
• username : имя пользователя учетной записи у поставщика почты
• password : пароль учетной записи у поставщика почты

Авторское право

Этот проект лицензирован в рамках Creative Commons Name 4.0 International

© 2018 - 2019 Андре Гёллер, Тим Шнайдер, Ансгар Лихтер