Requirement

• System: Ubuntu
• openjdk version "11.0.16" is needed to be installed to Ubuntu
• Docker is needed to be installed to Ubuntu

How to start through Terminal

1. cd to docker directory
2. run . web/start_mariadb.sh and then wait till database is ready
3. run . web/deploy_2_wildfly.sh

Test REST API endpoint:

http://localhost/dictionary/rest/lexicalitems/1

Ubiquitous Language

lexical item

reference: https://en.wikipedia.org/wiki/Lexical_item

Critical question on definition of lexical item :

• could one lexical item have multiple meanings? yes
• does definition belong to lexical item? no. Based on Gemini, the defintion is deparated from lexical item

Based on Gemini, lexical entry has the detail information of lexical item, including the definition, part of speech etc`.

According to Crystal (1980: 274), polysemy is a term used in semantic analysis to refer to a lexical item which has a range of different meanings.

Reference: https://www.iasj.net/iasj/download/5784a6a9435b5c81

lexical entry

reference: https://www.vocabulary.com/dictionary/lexical%20entry

Design Analysis

Critical things to consider

• Key ID generated by the server
• full update is impossible usually since in practice an update is only as per language => PATCH can be used instead of POST for update

New entity Explanation is introduced to aggregate defintion , part of speech , pronunciation etc. along with LexicalItem as foreign key. There is an invariant relationship from lexical item to explanation, i.e. one-to-many. However, when implementing it with JPA/Hibernate, there are at least three ways

Daybook

20250706

Github Action workflow

trigger is compulsory

20250914