Skip to content

Conversation

@Tomas-Kraus
Copy link
Member

@Tomas-Kraus Tomas-Kraus commented Aug 21, 2025

Contains 3 examples for Helidon Data:

  • SE imperative
  • SE declarative
  • MP

Added MethodName checkstyle suppression for examples/data/, examples/declarative/data/ and examples/microprofile/data/ because required QbMN method name must contain '_' character.

@Tomas-Kraus Tomas-Kraus self-assigned this Aug 21, 2025
@oracle-contributor-agreement oracle-contributor-agreement bot added the OCA Verified All contributors have signed the Oracle Contributor Agreement. label Aug 21, 2025
@Tomas-Kraus Tomas-Kraus changed the title Helidon Data basics example. [DRAFT] Helidon Data basics example. Aug 22, 2025
@Tomas-Kraus Tomas-Kraus force-pushed the data-basics branch 4 times, most recently from a9e0602 to e4ec3fb Compare August 25, 2025 12:06
@Tomas-Kraus Tomas-Kraus changed the base branch from helidon-4.x to dev-4.x August 25, 2025 12:07
@Tomas-Kraus Tomas-Kraus force-pushed the data-basics branch 2 times, most recently from 5614b59 to 509a2b2 Compare August 28, 2025 13:53
@Tomas-Kraus Tomas-Kraus force-pushed the data-basics branch 2 times, most recently from 41ba5c7 to 226203c Compare September 10, 2025 14:41
@Tomas-Kraus Tomas-Kraus marked this pull request as ready for review September 10, 2025 15:13
@Tomas-Kraus Tomas-Kraus changed the title [DRAFT] Helidon Data basics example. Helidon Data examples Sep 10, 2025
@Tomas-Kraus Tomas-Kraus changed the title Helidon Data examples [4.x] Helidon Data examples Sep 10, 2025
Copy link
Contributor

@romain-grecourt romain-grecourt left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Directory structure:

  • SE examples go at the top level
  • MP examples go under microprofile
  • Declarative examples go under declarative

Avoid the se, mp suffixes / prefixes.


Keep the examples simple, with a small number of classes:

  • Single entity
  • Single table
  • Single HTTP endpoint
  • Single Java package, if possible

Ideally, a basic Helidon Data CRUD example has only 3 classes:

  • the JPA entity
  • the Repository class
  • the HTTP service class.

Anything advanced (E.g. transaction) should go in separate examples.


The existing database examples have been updated recently, make sure you align with those.

The examples are duplicated per database, the current choices of databases is MySQL, Oracle, Postgres.

The examples implement the same identical CRUD application, based on the Pokemon theme.

The instructions in the README match the default configuration, the test uses Testcontainers to exercises the HTTP endpoint documented in the README.

Add-on (health, metrics, tracing) are implemented as separate examples.

Tomáš Kraus added 3 commits October 8, 2025 16:23
Signed-off-by: Tomáš Kraus <[email protected]>
@Tomas-Kraus Tomas-Kraus marked this pull request as draft October 9, 2025 14:52
@Tomas-Kraus Tomas-Kraus marked this pull request as ready for review October 9, 2025 14:53
@Tomas-Kraus
Copy link
Member Author

This PR seems to be broken (git changesets were not updated). Moving to #210

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

OCA Verified All contributors have signed the Oracle Contributor Agreement.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants