# gokulp-gp/samplejavaapp architecture

> Architecture diagram of the GitHub repository gokulp-gp/samplejavaapp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gokulp-gp/samplejavaapp
- Repository: https://github.com/gokulp-gp/samplejavaapp

## Overview

This repository is a small Java sample application whose visible product area is a Vaadin address book, alongside reusable Java utilities. The likely user-facing task is managing contacts through the address-book UI and form, with contact data and service logic in the backend; the supplied README does not document that workflow, and the address-book sources were not excerpted, so their call relationships are omitted. The graph also preserves the substantial comparator, property-loading, and string-conversion utilities. Edges shown among utilities are supported by the excerpted source or SOURCE INDEX; no storage system or external integration is evidenced.

Main entry points: [`src/main/java/com/devopsdemo/utilities/LoggerStackTraceUtil.java`](https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/LoggerStackTraceUtil.java) (Stack Trace Logger), [`src/main/java/com/devopsdemo/utilities/PropertyHelper.java`](https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/PropertyHelper.java) (Property Helper), [`src/main/java/com/devopsdemo/utilities/GenericComparator.java`](https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/GenericComparator.java) (Generic Comparator), [`src/main/java/com/devopsdemo/utilities/CaseInsensitiveComparator.java`](https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/CaseInsensitiveComparator.java) (Case-Insensitive Comparator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_addressbook["Address Book"]
  node_addressbook_ui["Address Book UI<br/>[AddressbookUI.java]"]
  node_contact_form["Contact Form<br/>[ContactForm.java]"]
end

subgraph group_backend["Contact Backend"]
  node_contact_service["Contact Service"]
  node_contact["Contact Model<br/>[Contact.java]"]
end

subgraph group_utilities["Utilities"]
  node_generic_comparator["Generic Comparator"]
  node_case_comparator["Case-Insensitive Comparator"]
  node_string_utilities["String Utilities"]
  node_hex_converter["Hex Converter"]
  node_logger["Stack Trace Logger"]
end

subgraph group_config["Configuration Helpers"]
  node_property_helper["Property Helper"]
  node_property_loader["Property Loader"]
  node_resource_bundle["Resource Bundle Helper"]
end

node_user(("User"))

node_generic_comparator -->|"logs errors"| node_logger
node_case_comparator -->|"extends"| node_generic_comparator
node_string_utilities -->|"logs errors"| node_logger
node_hex_converter -->|"logs errors"| node_logger
node_property_helper -->|"loads properties"| node_property_loader
node_property_helper -->|"logs errors"| node_logger

click node_addressbook_ui "https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/tutorial/addressbook/AddressbookUI.java"
click node_contact_form "https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/tutorial/addressbook/ContactForm.java"
click node_contact_service "https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/tutorial/addressbook/backend/ContactService.java"
click node_contact "https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/tutorial/addressbook/backend/Contact.java"
click node_generic_comparator "https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/GenericComparator.java"
click node_case_comparator "https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/CaseInsensitiveComparator.java"
click node_string_utilities "https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/StringUtilities.java"
click node_hex_converter "https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/HexAsciiConvertor.java"
click node_logger "https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/LoggerStackTraceUtil.java"
click node_property_helper "https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/PropertyHelper.java"
click node_property_loader "https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/PropertyLoader.java"
click node_resource_bundle "https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/helper/GenericResourceBundle.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_addressbook_ui,node_contact_form,node_user toneBlue
class node_contact_service,node_contact toneAmber
class node_generic_comparator,node_case_comparator,node_string_utilities,node_hex_converter,node_logger toneMint
class node_property_helper,node_property_loader,node_resource_bundle toneRose
```

## Components

### Address Book

- [Address Book UI](https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/tutorial/addressbook/AddressbookUI.java): `src/main/java/com/devopsdemo/tutorial/addressbook/AddressbookUI.java`
- [Contact Form](https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/tutorial/addressbook/ContactForm.java): `src/main/java/com/devopsdemo/tutorial/addressbook/ContactForm.java`

### Contact Backend

- [Contact Service](https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/tutorial/addressbook/backend/ContactService.java): `src/main/java/com/devopsdemo/tutorial/addressbook/backend/ContactService.java`
- [Contact Model](https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/tutorial/addressbook/backend/Contact.java): `src/main/java/com/devopsdemo/tutorial/addressbook/backend/Contact.java`

### Utilities

- [Generic Comparator](https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/GenericComparator.java): `src/main/java/com/devopsdemo/utilities/GenericComparator.java`
- [Case-Insensitive Comparator](https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/CaseInsensitiveComparator.java): `src/main/java/com/devopsdemo/utilities/CaseInsensitiveComparator.java`
- [String Utilities](https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/StringUtilities.java): `src/main/java/com/devopsdemo/utilities/StringUtilities.java`
- [Hex Converter](https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/HexAsciiConvertor.java): `src/main/java/com/devopsdemo/utilities/HexAsciiConvertor.java`
- [Stack Trace Logger](https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/LoggerStackTraceUtil.java): `src/main/java/com/devopsdemo/utilities/LoggerStackTraceUtil.java`

### Configuration Helpers

- [Property Helper](https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/PropertyHelper.java): `src/main/java/com/devopsdemo/utilities/PropertyHelper.java`
- [Property Loader](https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/utilities/PropertyLoader.java): `src/main/java/com/devopsdemo/utilities/PropertyLoader.java`
- [Resource Bundle Helper](https://github.com/gokulp-gp/samplejavaapp/blob/master/src/main/java/com/devopsdemo/helper/GenericResourceBundle.java): `src/main/java/com/devopsdemo/helper/GenericResourceBundle.java`

### Other components

- **User**

## Connections

- Generic Comparator → Stack Trace Logger: logs errors (evidence: `src/main/java/com/devopsdemo/utilities/GenericComparator.java`)
- Case-Insensitive Comparator → Generic Comparator: extends (evidence: `src/main/java/com/devopsdemo/utilities/CaseInsensitiveComparator.java`)
- String Utilities → Stack Trace Logger: logs errors (evidence: `src/main/java/com/devopsdemo/utilities/StringUtilities.java`)
- Hex Converter → Stack Trace Logger: logs errors (evidence: `src/main/java/com/devopsdemo/utilities/HexAsciiConvertor.java`)
- Property Helper → Property Loader: loads properties (evidence: `src/main/java/com/devopsdemo/utilities/PropertyHelper.java`)
- Property Helper → Stack Trace Logger: logs errors (evidence: `src/main/java/com/devopsdemo/utilities/PropertyHelper.java`)
