# giusyann/enjoyourbooks architecture

> Architecture diagram of the GitHub repository giusyann/enjoyourbooks, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/giusyann/enjoyourbooks
- Repository: https://github.com/giusyann/enjoyourbooks

## Overview

##### Project type and purpose
- Full-stack Java EE/MVC web application
- Purpose: an e-commerce site for buying books (digital/print), users can publish manuscripts (admin approval), manage wishlists, orders, invoices, reviews.

##### File structure
- src/main/webapp – all client-facing resources (JSP views, static JS/CSS/images, error pages, index.jsp).
- src/main/java/com/.../control – Servlet controllers handling HTTP requests (e.g., catalogoServlet, checkoutServlet, registrazioneServlet).
- src/main/java/com/.../dao – Data Access Objects (bookDao, orderDao, userDao, etc.).
- src/main/java/com/.../model – Domain beans (bookBean, orderBean, userBean) and DriverManagerConnectionPool.
- src/main/resources/META-INF – beans.xml & persistence.xml for DI/JPA configs.
- External libs in WEB-INF/lib: MySQL connector, Gson (JSON), Protobuf, javax.mvc-api, jQuery.

##### Key architectural patterns
- MVC (Model – View – Controller) / “Model2” Java EE
- DAO pattern for data persistence
- JDBC (via connection pool) and optional JPA settings
- REST or MVC annotations in HelloResource (JAX-RS or javax.mvc API)

##### Main components
[Client Browser –> HTTP]
↳ Static assets (JS/CSS) & JSP pages
[Servlet Container / Web Server]
– Controller layer
- Servlets (control/*.java)
- HelloServlet / HelloResource endpoints
– View layer
- JSP templates rendering HTML + EL + JSTL
– Business / Service layer
- Calls to DAO objects
– Data layer
- model/*.java beans
- DriverManagerConnectionPool (JDBC)
- persistence.xml (if JPA used)
[Database]
– MySQL instance (schemas for books, users, orders, reviews, etc.)
[External libraries]
– Gson (JSON serialization for AJAX responses via JSONResponse.java)
– Protobuf (if used for RPC or data exchange)
– jQuery (AJAX on the client)

##### Relationships and data flow
1. Browser issues an HTTP request (e.g., “/catalogoServlet”).
2. Servlet Container dispatches to the appropriate Servlet.
3. Servlet reads request params, calls DAO(s) for CRUD operations.
4. DAO uses DriverManagerConnectionPool to open JDBC connection → executes SQL against MySQL.
5. DAO returns JavaBean(s) to the Servlet.
6. Servlet places beans in request/session scope, forwards to a JSP.
7. JSP renders HTML + embeds data, returns response.
8. Browser may use jQuery to call JSONResponse endpoints (e.g., for dynamic “add to cart” AJAX), processed by control/JSONResponse.java with Gson.

##### Architectural principles to highlight
- Separation of concerns – clear layers for view, controller, service/DAO, persistence.
- Reusable DAOs & JavaBeans as model objects.
- Configuration via Maven (pom.xml), beans.xml for DI, persistence.xml for JPA.
- Monolithic deployment – one WAR deployed to any Servlet container (Tomcat/Jetty).

##### Detailed elements
- Frontend: Browser → JS/CSS → JSP pages (catalog, checkout, login, etc.)
- Controllers: List of major Servlets (catalogoServlet, checkoutServlet, registrazioneServlet, etc.) and HelloResource
- Service/DAO: bookDao, orderDao, recensioneDao, userDao
- Models/Beans: bookBean, orderBean, userBean, recensioneBean
- Persistence: DriverManagerConnectionPool, MySQL schema
- External libs: Gson (for JSONResponse), Protobuf, jQuery, JDBC driver
- Config: beans.xml, persistence.xml, web.xml, pom.xml

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        Browser["Client Browser"]:::presentation
        Index["index.jsp"]:::presentation
        JSP["JSP Views"]:::presentation
        JS["Static JS"]:::presentation
        CSS["Static CSS"]:::presentation
        Img["Images"]:::presentation
    end

    %% Application Layer
    subgraph "Application Layer"
        direction TB
        subgraph "Controllers" 
            direction TB
            Catalogo["catalogoServlet"]:::logic
            Checkout["checkoutServlet"]:::logic
            Registrazione["registrazioneServlet"]:::logic
            JSONResp["JSONResponse.java"]:::logic
            HelloServ["HelloServlet"]:::logic
            HelloRes["HelloResource"]:::logic
            HelloApp["HelloApplication"]:::logic
        end
        subgraph "DAO Layer"
            direction TB
            BookDAO["bookDao"]:::logic
            OrderDAO["orderDao"]:::logic
            RecDAO["recensioneDao"]:::logic
            UserDAO["userDao"]:::logic
            DetDAO["dettagliDao"]:::logic
        end
        subgraph "Model Layer"
            direction TB
            BookBean["bookBean"]:::logic
            OrderBean["orderBean"]:::logic
            RecBean["recensioneBean"]:::logic
            UserBean["userBean"]:::logic
            DetBean["dettagliBean"]:::logic
            FattBean["fatturaBean"]:::logic
            CartBean["cartBean"]:::logic
            Pool["DriverManagerConnectionPool"]:::logic
        end
        subgraph "Config & Build"
            direction TB
            BeansXML["beans.xml"]:::logic
            PersXML["persistence.xml"]:::logic
            WebXML["web.xml"]:::logic
            POM["pom.xml"]:::logic
        end
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        MySQL["MySQL Database"]:::data
    end

    %% External Libraries
    subgraph "External Libraries"
        direction TB
        MySQLDrv["MySQL Connector"]:::external
        GsonLib["Gson"]:::external
        ProtobufLib["Protobuf"]:::external
        MVCAPI["javax.mvc API"]:::external
        JQuery["jQuery"]:::external
    end

    %% Connections
    Browser -->|requests| Index
    Browser -->|requests| JSP
    Browser -->|AJAX| JSONResp
    Index -->|dispatches| Catalogo
    JSP -->|forwards| Catalogo
    Catalogo -->|uses| BookDAO
    Catalogo -->|uses| OrderDAO
    Checkout -->|uses| OrderDAO
    Registrazione -->|uses| UserDAO
    JSONResp -->|uses Gson| GsonLib
    JSONResp -->|uses| BookDAO
    HelloServ -->|REST call| HelloRes
    HelloRes -->|config| HelloApp
    BookDAO -->|JDBC| Pool
    OrderDAO -->|JDBC| Pool
    RecDAO -->|JDBC| Pool
    UserDAO -->|JDBC| Pool
    DetDAO -->|JDBC| Pool
    Pool -->|connects| MySQL
    BookDAO -->|manages| BookBean
    OrderDAO -->|manages| OrderBean
    RecDAO -->|manages| RecBean
    UserDAO -->|manages| UserBean
    DetDAO -->|manages| DetBean
    Registrazione -->|forwards| JSP
    Checkout -->|forwards| JSP
    Catalogo -->|forwards| JSP

    %% Click Events
    click JSP "https://github.com/giusyann/enjoyourbooks/tree/master/src/main/webapp/JSP"
    click JS "https://github.com/giusyann/enjoyourbooks/tree/master/src/main/webapp/JS"
    click CSS "https://github.com/giusyann/enjoyourbooks/tree/master/src/main/webapp/css"
    click Img "https://github.com/giusyann/enjoyourbooks/tree/master/src/main/webapp/Img"
    click Index "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/webapp/index.jsp"
    click Catalogo "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/control/catalogoServlet.java"
    click Checkout "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/control/checkoutServlet.java"
    click Registrazione "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/control/registrazioneServlet.java"
    click JSONResp "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/control/JSONResponse.java"
    click HelloRes "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/com/example/EnjoYourBooks/HelloResource.java"
    click HelloServ "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/com/example/EnjoYourBooks/HelloServlet.java"
    click HelloApp "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/com/example/EnjoYourBooks/HelloApplication.java"
    click BookDAO "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/dao/bookDao.java"
    click OrderDAO "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/dao/orderDao.java"
    click RecDAO "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/dao/recensioneDao.java"
    click UserDAO "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/dao/userDao.java"
    click DetDAO "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/dao/dettagliDao.java"
    click BookBean "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/model/bookBean.java"
    click OrderBean "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/model/orderBean.java"
    click RecBean "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/model/recensioneBean.java"
    click UserBean "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/model/userBean.java"
    click DetBean "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/model/dettagliBean.java"
    click FattBean "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/model/fatturaBean.java"
    click CartBean "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/model/cartBean.java"
    click Pool "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/java/model/DriverManagerConnectionPool.java"
    click BeansXML "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/resources/META-INF/beans.xml"
    click PersXML "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/resources/META-INF/persistence.xml"
    click WebXML "https://github.com/giusyann/enjoyourbooks/blob/master/src/main/webapp/WEB-INF/web.xml"
    click POM "https://github.com/giusyann/enjoyourbooks/blob/master/pom.xml"

    %% Styles
    classDef presentation fill:#AEDFF7,stroke:#036; 
    classDef logic fill:#CFF7AE,stroke:#390; 
    classDef data fill:#F7DFAE,stroke:#963; 
    classDef external fill:#E0E0E0,stroke:#888;
```
