CategoljJ2 is a micro blog system. This backend provides REST API for blog system and admin console to manage these data. You can create any blog frontend using this APIs ;)

The following technologies are used.

• Java 8
• Spring Boot 1.2
  • Spring 4.1
  • Spring MVC
  • Spring Security OAuth
  • Spring Data JPA
  • JPA 2.1
  • Flyway
  • ThymeLeaf
• Hibernate Search
• Backbone.js
• ...

Download categolj2-backend.jar (0.20.0+) from release page. This jar is executable by Spring Boot.

Note that CategoLJ2 requires Java8.

$ java -Xms512m -Xmx1g -jar categolj2-backend.jar --server.port 8080

Access

• Backend
  • http://localhost:8080/admin
  • login with initial account (admin/demo)
• Sample frontend
  • http://localhost:8080
  • see Setup frontend to customize frontend screen.

CategoLJ2 supports H2 and MySQL and embedded H2 is used as default.

You can change H2 data location as following:

$ java -Xms512m -Xmx1g -jar categolj2-backend.jar --server.port 8080 --categolj2.h2.datadir=./foobar

When you would like to use MySQL then:

$ java -Xms512m -Xmx1g -jar categolj2-backend.jar --server.port 8080 --spring.jpa.database=MYSQL --spring.datasource.driverClassName=com.mysql.jdbc.Driver --spring.datasource.url=jdbc:mysql://localhost:3306/categolj2?zeroDateTimeBehavior=convertToNull --spring.datasource.username=root --spring.datasource.password=password

In this case, you have to run create database categolj2 using mysql command in advance.

Other properties are explained in Configurable properties.

If Docker is not installed follow this: https://docs.docker.com/installation/

• Build Application

cd categolj2-backend
(Optional) mvn clean install -f frontend-ui/pom.xml -Dgpg.skip=true
(Optional) mvn clean install -f backend-ui/pom.xml -Dgpg.skip=true
cd backend-api
mvn clean package
cd target
docker build -t categolj2-backend .

• Deploy to Docker Container

docker images # List all Docker images
docker run -p 8080:8080 -p 8443:8443 <image id>

Supported REST APIs are following.

Admin console is a single page application using AJAX/REST API mentioned above.

You can write contents using Markdown or raw HTML.

Live preview is available.

You can upload files to use the entry on the fly. HTML5 multiple attribute is supported.

You can insert book link using Amazon Product API.

run with --aws.accesskey.id=<Your Accesskey ID for AWS> --aws.secret.accesskey=<Your Secret Accesskey for AWS> --aws.associate.tag=<Your Associate Tag>

Full text search is available.

Inline edit is available.

The following sample fronted is embedded by default:

You can use your own frontend.

Create static/index.html at the same directory with categol2-backend.jar like bellow:

$ find .
.
./categolj2-backend.jar
./static
./static/index.html

After run java -jar categolj2-backend.jar, you can find the following log which tells your own welcome page was picked.

2014-12-20 20:48:13.126  INFO                                    --- [           main] o.s.w.s.c.a.WebMvcConfigurerAdapter      : Adding welcome page: file:/xxx/yyy/zzz/static/index.html

You can reuse embedded frontend. Embedded html/css/javascript are zipped in categol2-backend.jar.

$ unzip -d foo categol2-backend.jar
$ unzip -d bar foo/lib/categolj2-embedded-frontend-ui*
$ cp -r bar/static .

If you want suppress debug logs, run with like --log.verbose=warn --log.sql=warn.

See also Spring Boot's common application properties.

Licensed under the Apache License, Version 2.0.