/spring-angular2-starter

Spring Boot Angular 2 starter

Primary LanguageTypeScriptMIT LicenseMIT

SPRING BOOT ANGULAR 2 STARTER

Build Status

PROJECT DESCRIPTION:

This sample project demonstrates how to integrate Spring Boot application with Angular 2. It could be used as base for your future Angular2 Java projects. Node and npm are installed as part of maven build. Also webpack build and karma tests runs with maven. It also uses Spring Cloud microservices and Spring Security with Oauth2 JWT tokens.

LIVE DEMO: http://shardis.com/

EUREKA: http://shardis.com:8081/

FEATURES:

  • Build and testing process integrated with maven
  • Spring cloud microservices with service discovery
  • Spring security Oauth2 integration
  • Spring Boot application in development mode use resources from webpack dev server
  • Docker integration (optional)
  • Webpack2 integration
  • Scss support in angular components
  • Angular material integration
  • Font-awesome integration
  • Lazy loaded routes
  • Spring Boot admin support
  • Spring REST Docs support

MICROSERVICES:

docs/diagram.png

USAGE WITH DOCKER (RECOMMENDED)

DOCKER BUILD (PRODUCTION MODE):

Build the docker image for all services with default maven profile

mvn install

DOCKER BUILD (DEVELOPMENT MODE):

Build the docker image for all services with dev maven profile To use development mode you need also webpack development server running in background

mvn install -P dev

RUNNING CONTAINERS:

After building applications run all containers with docker-compose

docker-compose up

STANDALONE USAGE WITHOUT DOCKER (NO LONGER RECOMMENDED)

RUNNING IN PRODUCTION MODE:

If you want to work without docker you need to use prod-standalone maven profile

Compile and package project:

mvn clean package -P prod-standalone

Then run config server:

cd shardis-config/
java -jar ./target/shardis-config-2.1.0.jar

Then run discovery server:

cd shardis-discovery/
java -jar ./target/shardis-discovery-2.1.0.jar

Then run gateway server:

cd shardis-gateway/
java -jar ./target/shardis-gateway-2.1.0.jar

Then run api server:

cd shardis-api/
java -jar ./target/shardis-api-2.1.0.jar

Then run auth server:

cd shardis-auth/
java -jar ./target/shardis-auth-2.1.0.jar

Then run ui server:

cd shardis-api/
java -jar ./target/shardis-ui-2.1.0.jar

Then run admin server (optional):

cd shardis-admin/
java -jar ./target/shardis-admin-2.1.0.jar

RUNNING IN DEVELOPMENT MODE:

If you want to work without docker you need to use dev-standalone maven profile To use development mode you need also webpack development server running in background

Install all dependencies at first:

mvn clean install -P dev-standalone

Run config server in development mode:

cd shardis-config
mvn spring-boot:run -P dev-standalone

Run discovery server in development mode:

cd shardis-discovery
mvn spring-boot:run -P dev-standalone

Run gateway server in development mode:

cd shardis-gateway
mvn spring-boot:run -P dev-standalone

Run api server in development mode:

cd shardis-api
mvn spring-boot:run -P dev-standalone

Run auth server in development mode:

cd shardis-auth
mvn spring-boot:run -P dev-standalone

Run ui server in development mode:

cd shardis-ui
mvn spring-boot:run -P dev-standalone

Run admin server (optional) in development mode:

cd shardis-admin
mvn spring-boot:run -P dev-standalone

RUNNING WEBPACK DEV SERVER FOR DEVELOPMENT MODE:

Run webpack development server:

cd shardis-ui
npm run server

TESTING ANGULAR FRONTEND

Running unit tests:

cd shardis-ui
npm run test

Running e2e tests:

cd shardis-ui
npm run e2e

CHANGELOG:

2.1.0 (28.08.2016)

  • Added Spring Cloud Config server for centralized configuration
  • Added Spring REST Docs support for API microservices
  • Remapped coverage reports to typescript
  • Rewritten angular tests using Testbed
  • Updated Spring Cloud to Brixton.SR5
  • Updated angular2-material to 2.0.0-alpha.7-4
  • Updated dependencies
  • Removed typedoc (it doesn't support typescript2)

2.0.0 (16.08.2016)

  • Updated Spring Platform to Athens-RC1 and Spring Boot to 1.4.0
  • Updated Spring Cloud to Brixton.SR4
  • Updated Node to v6.3.1 and npm to 3.10.3
  • Updated dependencies
  • Removed shardis-parent project
  • Added docker support (thanks to Tarun Sukhu)
  • Disabled Eureka client in unit tests
  • Docker and standalone profiles
  • Spring Boot admin support
  • Added gateway service
  • Updated Angular to rc.5
  • Updated angular2-material to 2.0.0-alpha.7-2
  • Added live demo

1.9.0 (29.07.2016)

  • Updated dependencies
  • Updated Angular to rc.4
  • Switched back to awesome-ts-loader (faster)
  • Updated Spring Cloud to Brixton.SR1
  • Removed lombok from project
  • Added UUID to all entities
  • Moved styles from main.scss to separate module
  • Updated Spring Cloud to Brixton.SR2
  • Updated Spring Platform to 2.0.6 and Spring Boot to 1.3.6
  • Renamed java test classes to match surefire convention
  • Webpack 2 and Typescript 2
  • Reduced bundle size
  • Updated Spring Cloud to Brixton.SR3
  • Enabled gzip compression
  • Removed typings in favor of types
  • Updated angular2-material to 2.0.0-alpha.6-2
  • Updated Spring Platform to 2.0.7 and Spring Boot to 1.3.7

1.8.0 (30.06.2016)

  • Better directory structure for angular components
  • Dependency updates
  • Updated Angular to rc.2
  • Migrate awesome-ts-loader to ts-loader due to problems with karma
  • Migrate to router 3
  • Lazy routes with modified version of AngularClass webpack resolver
  • Updated Angular to rc.3
  • Added 404 page
  • Much cleaner webpack configuration
  • Role based visibility of menu items
  • CRUD example for authenticated users
  • Route access for selected roles (guards)
  • Switched to new Angular Forms
  • Updated angular2-material to 2.0.0-alpha.6

show full changelog