https://github.com/adminfaces/admin-starter-persistence

Admin starter project with persistence layer
https://github.com/adminfaces/admin-starter-persistence

Last synced: 6 days ago
JSON representation

Admin starter project with persistence layer

• Host: GitHub
• URL: https://github.com/adminfaces/admin-starter-persistence
• Owner: adminfaces
• Created: 2017-08-23T22:55:11.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2022-07-07T22:54:18.000Z (over 2 years ago)
• Last Synced: 2024-04-16T18:12:49.313Z (7 months ago)
• Language: HTML
• Homepage: https://adminfaces.github.io/admin-starter
• Size: 3.83 MB
• Stars: 10
• Watchers: 3
• Forks: 10
• Open Issues: 4
• Metadata Files:
  • Readme: README.adoc

Awesome Lists containing this project

README

        
= AdminFaces Starter Persistence

:toc: preamble

:sectanchors:

:sectlink:

:numbered:

:tip-caption: :bulb:

:note-caption: :information_source:

:important-caption: :heavy_exclamation_mark:

:caution-caption: :fire:

:warning-caption: :warning:

image:https://travis-ci.org/adminfaces/admin-starter-persistence.svg[Build Status (Travis CI), link=https://travis-ci.org/adminfaces/admin-starter-persistence]

image:https://sonarcloud.io/api/project_badges/measure?project=com.github.adminfaces:admin-starter&metric=alert_status["Sonar", link="https://sonarcloud.io/dashboard?id=com.github.adminfaces%3Aadmin-starter"]

A simple project to get you started with https://github.com/adminfaces[AdminFaces^] using https://github.com/adminfaces/admin-persistence[Admin Persistence^] for utility persistence layer.

.Login page

image:starter1.png[link="https://raw.githubusercontent.com/adminfaces/admin-starter-persistence/master/starter1.png"]

.Car list

image:starter2.png[link="https://raw.githubusercontent.com/adminfaces/admin-starter-persistence/master/starter2.png"]

.Car search

image:starter5.png[link="https://raw.githubusercontent.com/adminfaces/admin-starter-persistence/master/starter5.png"]

.Car form

image:starter3.png[link="https://raw.githubusercontent.com/adminfaces/admin-starter-persistence/master/starter3.png"]

.Car form responsive

image:starter4.png[link="https://raw.githubusercontent.com/adminfaces/admin-starter-persistence/master/starter4.png"]

== Running

Run `mvn clean package` and deploy on any JavaEE 6 or greater application server.

IMPORTANT: If you are not running on `JBoss/Wildfly` you'll need to configure the datasource declared in https://github.com/adminfaces/admin-starter-persistence/blob/master/src/main/resources/META-INF/persistence.xml[persistence.xml^].

TIP: To run on `Java EE 6` app server you'll need to downgrade OmniFaces to version `2.1`.

You can also run via http://wildfly-swarm.io/[wildfly-swarm^] with command `mvn wildfly-swarm:run -Pswarm`.

Or using docker:

----

docker run -it -p 8080:8080 rmpestano/admin-starter-persistence

----

[TIP]

====

Use the `bash build-and-run.sh` to easily start the application on a docker container.

TIP: To run on `Payara` or `Tomee` just replace Dockerfile content with `Dockerfile-payara` or `Dockerfile-tomee` and run the build-and-run script.

====

The application is available at http://localhost:8080/admin-starter

== Demo

A live demo is available on https://adminfaces.github.io/admin-starter/[Openshift here^]

== Test

To run tests execute following maven command:

* `mvn test -Ptests` for all tests

* `mvn test -Pblackbox` for functional tests

* `mvn test -Pwhitebox` for integration tests

See the following video to see the tests in action: https://youtu.be/9_khZVsDO0Y