Jeeshop is a e-commerce solution allowing you to setup quickly your online store.
It provides you with a store management GUI, Jeeshop-Admin and an complete set of REST APIs designed for your store front-end application (typically a javascript rich client application):
- Products catalog
- Discounts
- Shopping cart
- Users management
Jeeshop relies on following technologies :
- Java EE 7 and Java 8 for REST APIs
- AngularJS for Jeeshop-Admin
Compared to other e-commerce solutions / frameworks Jeeshop aims at being
- simple - you don't need a master degree in rocket science to use and understand Jeeshop concepts
- light - thanks to Java EE platform and design choices
- interoperable - thanks again to Java EE platform
Project website: http://jeeshop.org
Jeeshop-Admin is a responsive AngularJS client application designed to manage efficiently an e-commerce store. It consumes Jeeshop REST api backend to perform common store management operations.
Jeeshop REST APIs are designed to enable e-commerce and user management easily for a store front-end application. They are also used internally by Jeeshop-Admin.
Jeeshop REST APIs are organized per business domain:
Jeestore is a front-end demonstration application application which uses Jeeshop REST APIs You can take a look at it or start with it to build your e-commerce store
Jeeshop can be deployed to any Java EE 7 application server. (Web and full profile) As of today, it has only be tested on Wildfy
This section describes deployment of Jeeshop components to a Wildfly server.
The following XA datasources are currently used by jeeshop modules and have to be created in server configuration
- JeeshopDS, for user and order data
- JeeshopCatalogDS for product catalog data
Below is an example of Jeeshop datasources configuration for a standalone server:
<xa-datasource jndi-name="java:/JeeshopDS" pool-name="JeeshopDS" enabled="true">
<xa-datasource-property name="ServerName">
localhost
</xa-datasource-property>
<xa-datasource-property name="DatabaseName">
jeeshop
</xa-datasource-property>
<driver>mysql</driver>
<security>
<user-name>jeeshop</user-name>
<password>test</password>
</security>
<validation>
<valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker"/>
<exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLExceptionSorter"/>
</validation>
</xa-datasource>
<xa-datasource jndi-name="java:/JeeshopCatalogDS" pool-name="JeeshopCatalogDS" enabled="true">
<xa-datasource-property name="ServerName">
localhost
</xa-datasource-property>
<xa-datasource-property name="DatabaseName">
jeeshop
</xa-datasource-property>
<driver>mysql</driver>
<security>
<user-name>jeeshop</user-name>
<password>test</password>
</security>
<validation>
<valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker"/>
<exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLExceptionSorter"/>
</validation>
</xa-datasource>
<driver name="mysql" module="com.mysql">
<driver-class>com.mysql.jdbc.Driver</driver-class>
<xa-datasource-class>com.mysql.jdbc.jdbc2.optional.MysqlXADataSource</xa-datasource-class>
</driver>
A security domain named "jeeshop" has to be created to allow BASIC authentication and Role based access to protected REST Resources, using JaaS.
- Sample of configuration for a standalone server:
<security-domain name="jeeshop" cache-type="default">
<authentication>
<login-module code="Database" flag="required">
<module-option name="dsJndiName" value="java:/JeeshopDS"/>
<module-option name="principalsQuery" value="select password from User where login = ? and (disabled is null or disabled = 0) and activated = 1"/>
<module-option name="rolesQuery" value="select name,'Roles' from Role r, User_Role ur, User u where u.login=? and u.id = ur.userId and r.id = ur.roleId"/>
<module-option name="hashAlgorithm" value="SHA-256"/>
<module-option name="hashEncoding" value="base64"/>
<module-option name="unauthenticatedIdentity" value="guest"/>
</login-module>
</authentication>
</security-domain>
SSL has to be configured in order to secure credentials sent in requests performed by store customers or Jeeshop-admin users (ie store administrators). This action is not required under a PaaS such as Openshift. (See Openshift deployment)
- Create server certificate
Execute the following command in a temp directory
keytool -genkeypair -alias serverkey -keyalg RSA -keysize 2048 -validity 7360 -keystore server.keystore -keypass <PASSWORD FOR PRIVATE KEY> -storepass <PASSWORD FOR KEYSTORE> -dname "cn=Server Administrator,o=jeeshop,c=FR"
Copy the server.keystore file in to the ${jboss.home.dir}/standalone/configuration folder
- In standalone.xml configuration file
Add the following security realm block :
<security-realms>
...
<security-realm name="SSLRealm">
<server-identities>
<ssl>
<keystore path="server.keystore" relative-to="jboss.server.config.dir" keystore-password="THE KEYSTORE PASSWORD"/>
</ssl>
</server-identities>
</security-realm>
</security-realms>
Add the following http-listener line to the server block (in undertow subsystem)
<server name="default-server">
...
<https-listener name="default-https" socket-binding="https" security-realm="SSLRealm"/>
...
</server>
A JBOSS Module named "jeeshop" have to be created to /modules directory. It contains multiple configuration properties such as:
- Mailer parameters (SMTP parameters, Sender...) Sample of this module configuration is available in .openshift directory
To serve Jeeshop catalog media files uploaded through Jeeshop-Admin, the following configurations have to be added in standalone.xml configuration file:
Add the following in undertow subsystem
<subsystem xmlns="urn:jboss:domain:undertow:1.2">
...
<server name="default-server">
...
<host name="default-host" alias="localhost">
...
<location name="/jeeshop-media" handler="jeeshop-media"/>
...
</host>
</server>
...
<handlers>
...
<file name="jeeshop-media" path="/home/remi/jeeshop-media" directory-listing="true"/>
...
</handlers>
...
</subsystem>
Database setup scripts are provided in ./install/src/main/db directory for each supported databases
- Vx.x_1__jeeshop-install.sql creates jeeshop ddl and reference data. It creates also a single user with login/password [email protected]/jeeshop (password is hashed using SHA-256 in this script, which must match security domain configuration, see Security domain configuration). This user should be deleted in production environment for security reason.
- Vx.x__jeeshop-drop.sql empties database
- Vx.x_2__demo-catalog-data configures jeeshop demonstration catalog data
To setup or update your Jeeshop db with latest SQL scripts version, you can check a "flyway" maven profile, such as flyway-mysql, and execute "install" maven goal like this:
mvn install
This command applies Jeeshop SQL scripts using FLYWAY database migration tool. So you always get your Jeeshop database up-to date applying SQL scripts this way.
Notes: Current database scripts are made for a single database. But you can also use one database for product catalog data and another for user and order data. (See Datasources section above)
This section describes deployment of Jeeshop components to Apache TomEE 2.x. TODO
This section describes deployment of Jeeshop components to Openshift PaaS. TODO
Jeeshop db update / setup is performed automatically on Openshift cartridges with maven openshift profile.