Projeto de exemplo com API Rest com dois crud’s simples, utilizando Kotlin, Spring Boot, Gradle etc.
- Kotlin
- Spring Boot
- Gradle
- Docker
- Spring Data
- JPA/Hibernate
- Spring Fox
- Swagger
- Liquibase
- H2 Database
- Jacoco
Após a inicialização da aplicação, independente da forma, a mesma pode ser acessada ou ter a sua documentação acessada pelo link http://localhost:PORTA_INICIADA/.
OBS: Ao iniciar a aplicação, também é iniciado um banco de dados, H2 embutido, então não é necessário nenhuma dependência externa para a mesma ser iniciada e acessada.
Após o sistema ser iniciado podem ser acessadas as seguintes URLs.
URL para acesso a todos os recursos via Swagger UI.
URL: http://localhost:8080/swagger-ui.html#/ ou http://localhost:PORTA_INICIADA/swagger-ui.html#/.
URL para acesso a base de dados.
URL: http://localhost:8080/h2-console ou http://localhost:PORTA_INICIADA/h2-console.
Dados de acesso
- Setting Name:
Generic H2 (Embedded) - Driver Class:
org.h2.Driver - JDBC URL:
jdbc:h2:mem:testdb - User Name:
sa - Password: `` (vazio)
Localmente o projeto pode ser configurado nas ide’s IntelliJ e Eclipse, ambas possuem suporte via plugin para Kotlin, Spring Boot e Gradle.
OBS: Os arquivos e ferramentas de build, estão contidas dentro do projeto, então para execução do build, só é necessário ter o Java ou o Docker instalado.
# Execução do build
./gradlew build
# Execução da aplicação
java -jar build/libs/example-kotlin-springboot-rest-0.0.1-SNAPSHOTOBS: Com esses comandos a aplicação será iniciada, na porta 8080, mas isso pode ser alterado, informando o parâmetro: -Dserver.port=$PORTA_DESEJADA.
# Execução do build
docker build -t app:latest .
# Execução da aplicação
docker run -d -p 8080:8080 app:latestOBS: Com esses comandos a aplicação será iniciada, na porta 8080, mas isso pode ser alterado, informando o parâmetro docker: -p $PORTA_DESEJADA:8080.
# Execução da aplicação
docker run -d -p 8080:8080 justiandre/example-kotlin-springboot-rest:masterOBS: Com esse comando a aplicação será iniciada, na porta 8080, mas isso pode ser alterado, informando o parâmetro docker: -p $PORTA_DESEJADA:8080****************.
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ __ __ +
+ /\ \ __ /\ \__ __ +
+ __ ___ \_\ \ _ __ __ /\_\ __ __ ___\ \ ,_\/\_\ ___ ___ ___ ___ +
+ /'__`\ /' _ `\ /'_` \/\`'__\/'__`\\/\ \/\ \/\ \ /',__\ \ \/\/\ \ /'___\ / __`\ /' __` __`\ +
+ /\ \L\.\_/\ \/\ \/\ \L\ \ \ \//\ __/ \ \ \ \ \_\ \/\__, `\ \ \_\ \ \ __/\ \__//\ \L\ \/\ \/\ \/\ \ +
+ \ \__/.\_\ \_\ \_\ \___,_\ \_\\ \____\_\ \ \ \____/\/\____/\ \__\\ \_\/\_\ \____\ \____/\ \_\ \_\ \_\ +
+ \/__/\/_/\/_/\/_/\/__,_ /\/_/ \/____/\ \_\ \/___/ \/___/ \/__/ \/_/\/_/\/____/\/___/ \/_/\/_/\/_/ +
+ \ \____/ +
+ \/___/ +
+ +
+ App de exemplo: Kotlin + Spring Boot + rest +
+ https://github.com/justiandre/example-kotlin-springboot-rest +
+ Por: André Justi <justi.andre@gmail.com> - http://andrejusti.com +
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
$datetime INFO --- [ main] t.j.e.k.s.rest.ApplicationKt : Starting ApplicationKt on 108c4239b213 with PID 7 (/data/app.jar started by root in /data)
$datetime INFO --- [ main] t.j.e.k.s.rest.ApplicationKt : The following profiles are active: default
$datetime INFO --- [ main] ConfigServletWebServerApplicationContext : Refreshing org.springframework.boot.web.servlet.context.AnnotationConfigServletWebServerApplicationContext@32eebfca: startup date [Sun Sep 16 23:44:27 GMT 2018]; root of context hierarchy
$datetime INFO --- [ main] trationDelegate$BeanPostProcessorChecker : Bean 'org.springframework.transaction.annotation.ProxyTransactionManagementConfiguration' of type [org.springframework.transaction.annotation.ProxyTransactionManagementConfiguration$$EnhancerBySpringCGLIB$$ace23b85] is not eligible for getting processed by all BeanPostProcessors (for example: not eligible for auto-proxying)
$datetime INFO --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port(s): 8080 (http)
$datetime INFO --- [ main] o.apache.catalina.core.StandardService : Starting service [Tomcat]
$datetime INFO --- [ main] org.apache.catalina.core.StandardEngine : Starting Servlet Engine: Apache Tomcat/8.5.32
$datetime INFO --- [ost-startStop-1] o.a.catalina.core.AprLifecycleListener : The APR based Apache Tomcat Native library which allows optimal performance in production environments was not found on the java.library.path: [/usr/java/packages/lib/amd64:/usr/lib64:/lib64:/lib:/usr/lib]
$datetime INFO --- [ost-startStop-1] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext
$datetime INFO --- [ost-startStop-1] o.s.web.context.ContextLoader : Root WebApplicationContext: initialization completed in 2386 ms
$datetime INFO --- [ost-startStop-1] com.zaxxer.hikari.HikariDataSource : HikariPool-1 - Starting...
$datetime INFO --- [ost-startStop-1] com.zaxxer.hikari.HikariDataSource : HikariPool-1 - Start completed.
$datetime INFO --- [ost-startStop-1] liquibase : Successfully acquired change log lock
$datetime INFO --- [ost-startStop-1] liquibase : Creating database history table with name: PUBLIC.DATABASECHANGELOG
$datetime INFO --- [ost-startStop-1] liquibase : Reading from PUBLIC.DATABASECHANGELOG
$datetime INFO --- [ost-startStop-1] liquibase : classpath:/db/changelog/db.changelog-master.yaml: classpath:/db/changelog/db.changelog-master.yaml::1::andrejusti: Table Category created
$datetime INFO --- [ost-startStop-1] liquibase : classpath:/db/changelog/db.changelog-master.yaml: classpath:/db/changelog/db.changelog-master.yaml::1::andrejusti: Table Product created
$datetime INFO --- [ost-startStop-1] liquibase : classpath:/db/changelog/db.changelog-master.yaml: classpath:/db/changelog/db.changelog-master.yaml::1::andrejusti: Table Product_Category created
$datetime INFO --- [ost-startStop-1] liquibase : classpath:/db/changelog/db.changelog-master.yaml: classpath:/db/changelog/db.changelog-master.yaml::1::andrejusti: ChangeSet classpath:/db/changelog/db.changelog-master.yaml::1::andrejusti ran successfully in 12ms
$datetime INFO --- [ost-startStop-1] liquibase : Successfully released change log lock
$datetime INFO --- [ost-startStop-1] j.LocalContainerEntityManagerFactoryBean : Building JPA container EntityManagerFactory for persistence unit 'default'
$datetime INFO --- [ost-startStop-1] o.hibernate.jpa.internal.util.LogHelper : HHH000204: Processing PersistenceUnitInfo [ name: default ]
$datetime INFO --- [ost-startStop-1] org.hibernate.Version : HHH000412: Hibernate Core {5.2.17.Final}
$datetime INFO --- [ost-startStop-1] org.hibernate.cfg.Environment : HHH000206: hibernate.properties not found
$datetime INFO --- [ost-startStop-1] o.hibernate.annotations.common.Version : HCANN000001: Hibernate Commons Annotations {5.0.1.Final}
$datetime INFO --- [ost-startStop-1] org.hibernate.dialect.Dialect : HHH000400: Using dialect: org.hibernate.dialect.H2Dialect
$datetime INFO --- [ost-startStop-1] j.LocalContainerEntityManagerFactoryBean : Initialized JPA EntityManagerFactory for persistence unit 'default'
$datetime INFO --- [ost-startStop-1] o.s.b.w.servlet.ServletRegistrationBean : Servlet dispatcherServlet mapped to [/]
$datetime INFO --- [ost-startStop-1] o.s.b.w.servlet.ServletRegistrationBean : Servlet simpleRestServlet mapped to [/rest/*]
$datetime INFO --- [ost-startStop-1] o.s.b.w.servlet.ServletRegistrationBean : Servlet webServlet mapped to [/h2-console/*]
$datetime INFO --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean : Mapping filter: 'characterEncodingFilter' to: [/*]
$datetime INFO --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean : Mapping filter: 'hiddenHttpMethodFilter' to: [/*]
$datetime INFO --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean : Mapping filter: 'httpPutFormContentFilter' to: [/*]
$datetime INFO --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean : Mapping filter: 'requestContextFilter' to: [/*]
$datetime INFO --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean : Mapping filter: 'corsConfigurer' to: [/*]
$datetime INFO --- [ main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/**/favicon.ico] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
$datetime INFO --- [ main] s.w.s.m.m.a.RequestMappingHandlerAdapter : Looking for @ControllerAdvice: org.springframework.boot.web.servlet.context.AnnotationConfigServletWebServerApplicationContext@32eebfca: startup date [Sun Sep 16 23:44:27 GMT 2018]; root of context hierarchy
$datetime INFO --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/error],produces=[text/html]}" onto public org.springframework.web.servlet.ModelAndView org.springframework.boot.autoconfigure.web.servlet.error.BasicErrorController.errorHtml(javax.servlet.http.HttpServletRequest,javax.servlet.http.HttpServletResponse)
$datetime INFO --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/error]}" onto public org.springframework.http.ResponseEntity<java.util.Map<java.lang.String, java.lang.Object>> org.springframework.boot.autoconfigure.web.servlet.error.BasicErrorController.error(javax.servlet.http.HttpServletRequest)
javax.servlet.http.HttpServletResponse,java.util.Map<java.lang.String, java.lang.String>) throws java.io.IOException
$datetime INFO --- [ main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/webjars/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
$datetime INFO --- [ main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
$datetime INFO --- [ main] o.s.j.e.a.AnnotationMBeanExporter : Registering beans for JMX exposure on startup
$datetime INFO --- [ main] o.s.j.e.a.AnnotationMBeanExporter : Bean with name 'dataSource' has been autodetected for JMX exposure
$datetime INFO --- [ main] o.s.j.e.a.AnnotationMBeanExporter : Located MBean 'dataSource': registering with JMX server as MBean [com.zaxxer.hikari:name=dataSource,type=HikariDataSource]
$datetime INFO --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port(s): 8080 (http) with context path ''
$datetime INFO --- [ main] t.j.e.k.s.rest.ApplicationKt : Started ApplicationKt in 11.396 seconds (JVM running for 12.04)
$datetime INFO --- [nio-8080-exec-1] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring FrameworkServlet 'dispatcherServlet'
$datetime INFO --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet : FrameworkServlet 'dispatcherServlet': initialization started
$datetime INFO --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet : FrameworkServlet 'dispatcherServlet': initialization completed in 27 ms