En-Vi dictionary

Dictionary application (English to Vietnamese) for 2122H_INT2204_40 OOP Course written in Java

Note: This is the final GUI version of the dictionary. The CMD version is on branch cmd.

Update: We got second highest score of all the groups though.

Table of contents

• Authors
• Preview
• Features
• Set up
  • MYSQL Database
  • Run
    • Requirements
    • Steps

Authors

Group N1_02:

• Huỳnh Tiến Dũng - 21020007
• Lê Hải Đăng - 21020065
• Trần Mạnh Dũng - 21020119

Preview

Features

• An English-to-Vietnamese dictionary with a full-fledged words' database and Google Translate API integrated.
• Many features:
  • Search Vietnamese meaning.
  • Words' meaning in HTML format for beautiful look.
  • Add words.
  • Insert words from file.
  • Export words to file.
  • Edit words.
  • Delete words.
  • Google Translate translate sentences (Both from English to Vietnamese and Vietnamese to English).
  • Google Translate Text to speech (Both in English and in Vietnamese).
  • Connect to MYSQL for a rich words' database.
  • Switching between Light Mode and Dark Mode (TokyoNight colorscheme).

Set up

MYSQL Database

• Install XAMPP.
• Start XAMPP (Start Apache and MYSQL).
• Ensure localhost port is 3306 (XAMPP default port).
• Add a new user:
  • Name: en-vi-dictionary.
  • Password: n1-02-dictionary.
  • Enable option [o] Create database with same name and grant all privileges.
• Import dictionary.sql into the database en-vi-dictionary (src/main/resources/sql/dictionary.sql).

Note: You can configure your own username, port, password, ... by changing those accordingly in src/main/java/dictionary/server/DatabaseDictionary.java.

After uploading the dictionary.sql file, next time you only need to start XAMPP (Start Apache and MYSQL) if you want to use the dictionary with MYSQL Database.

Run

Requirements

• JDK 17 or higher. (Note for Windows user: Ensure that your JAVA_HOME environment variable is set to the correct folder of JDK17).
• Maven (Apache Maven).

Steps

• Clone this project down with git.

  git clone https://github.com/HynDuf7/dictionary.git
  

• Run with Maven.

  cd dictionary
  mvn clean javafx:run