REST APIs with Spring
89 likes26,602 views
The document is a comprehensive guide on building REST services using Spring, authored by Josh Long. It covers topics such as Spring framework features, RESTful principles, HTTP methods, status codes, content negotiation, and security measures. The guide emphasizes the importance of error handling, API versioning, and the role of HATEOAS in RESTful services.
![INSTALLING SPRING MVC
or, just fill out the form...
public class SimplerDispatcherServletInitializer
extends AbstractAnnotationConfigDispatcherServletInitializer {
!
!
!
}
@Override
protected Class<?>[] getRootConfigClasses() {
return new Class<?>[]{ ServiceConfiguration.class };
}
@Override
protected Class<?>[] getServletConfigClasses() {
return new Class<?>[]{ WebMvcConfiguration.class };
}
@Override
protected String[] getServletMappings() {
return new String[]{"/*"};
}
GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK](https://image.slidesharecdn.com/thespringreststack-130612235338-phpapp01/85/REST-APIs-with-Spring-18-320.jpg)
![INSTALLING SPRING MVC
GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK
or, just use Spring Boot and never worry about it
@ComponentScan
@EnableAutoConfiguration
public class Application extends SpringBootServletInitializer {
!
private static Class< Application> applicationClass = Application.class;
!
!
}
!
public static void main(String[] args) {
SpringApplication.run(applicationClass);
}
@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
return application.sources(applicationClass);
}](https://image.slidesharecdn.com/thespringreststack-130612235338-phpapp01/85/REST-APIs-with-Spring-19-320.jpg)
![DESCRIPTIVE ERRORS
GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK
Send meaningful errors along with status codes
{
"message": "authentication failed",
"errors": [
{
"resource": "Issue",
"field": "title",
"code": "missing_field"
}
]
}
{
"type": "authentication",
"message": “the username and
password provided are invalid” ,
"status": “401”
}
https://blog.apigee.com/detail/restful_api_design_what_about_errors](https://image.slidesharecdn.com/thespringreststack-130612235338-phpapp01/85/REST-APIs-with-Spring-56-320.jpg)
REST APIs with Spring
- 1. Josh Long (⻰龙之春) @starbuxman joshlong.com [email protected] slideshare.net/joshlong github.com/joshlong speakerdeck.com/joshlong BUILDING REST SERVICES WITH Spring github.com/joshlong/the-spring-rest-stack
- 2. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK ABOUT ME About Josh Long (⻰龙之春) Spring Developer Advocate, Pivotal Jean Claude van Damme! Java mascot Duke @starbuxman [email protected] slideshare.net/joshlong github.com/joshlong speakerdeck.com/joshlong some thing’s I’ve authored...
- 3. T H E S P R I N G R E S T S TA C K Starting with Spring
- 4. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK SPRING IO XD BOOT GRAILS Stream, Taps, Jobs Bootable, Minimal, Ops-Ready Full-stack, Web INTEGRATION BATCH BIG DATA WEB Channels, Adapters, Filters, Transformers Jobs, Steps, Readers, Writers Ingestion, Export, Orchestration, Hadoop Controllers, REST, WebSocket DATA RELATIONAL NON-RELATIONAL CORE FRAMEWORK SECURITY GROOVY REACTOR
- 5. A NEW HOME FOR SPRING GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK
- 6. A NEW HOME FOR SPRING GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK
- 7. SPRING 4 GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK websockets : supports JSR 356, native APIs ! Async RestTemplate based on NIO 2 HTTP client in JDK. Java SE 8 and Java EE 7 extends support to emerging platforms
- 8. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK SPRING 4 @Conditional provides the ability to conditionally create a bean ! ! @Conditional (NasdaqIsUpCondition.class) @Bean Mongo extraMongoNode(){ ! ! ! // ... } And, best of all, @Conditional powers Spring Boot!
- 9. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK SPRING BOOT single point of focus, productionready, easy to customize ! Installation: > Java 1.6 or better > Maven 3.0 or better > optionally install spring CLI (or gvm or brew)
- 10. Demonstration Take Spring Boot CLI for a spin around the block !
- 11. Demonstration Take Spring Boot around the track. !
- 12. T H E S P R I N G R E S T S TA C K Testing
- 13. Demonstration how to write unit tests with Spring
- 14. T H E S P R I N G R E S T S TA C K Spring MVC
- 15. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK MODEL VIEW CONTROLLER stop me if you’ve heard this one before ... incoming requests delegate request DispatcherServlet model delegate rendering of response return response model return control render response view template controller
- 16. INSTALLING SPRING MVC web.xml GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK <?xml version="1.0" encoding="UTF-8"?> <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> <distributable/> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <context-param> <param-name>contextInitializerClasses</param-name> <param-value>my.ApplicationContextInitializer</param-value> </context-param> <context-param> <param-name>contextClass</param-name> <param-value>org.springframework.web.context.support.AnnotationConfigWebApplicationContext </param-value> </context-param> <servlet> <servlet-name>appServlet</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value></param-value> </init-param> ` <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>appServlet</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> </web-app>
- 17. INSTALLING SPRING MVC GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK WebApplicationInitializer ~= Java web.xml ! public class SampleWebApplicationInitializer implements WebApplicationInitializer { ! public void onStartup(ServletContext sc) throws ServletException { AnnotationConfigWebApplicationContext ac = new AnnotationConfigWebApplicationContext(); ac.setServletContext(sc); ac.scan( “a.package.full.of.services”, “a.package.full.of.controllers” ); ! sc.addServlet("spring", new DispatcherServlet(ac)); ! // register filters, other servlets, etc., to get Spring and Spring Boot working } }
- 18. INSTALLING SPRING MVC or, just fill out the form... public class SimplerDispatcherServletInitializer extends AbstractAnnotationConfigDispatcherServletInitializer { ! ! ! } @Override protected Class<?>[] getRootConfigClasses() { return new Class<?>[]{ ServiceConfiguration.class }; } @Override protected Class<?>[] getServletConfigClasses() { return new Class<?>[]{ WebMvcConfiguration.class }; } @Override protected String[] getServletMappings() { return new String[]{"/*"}; } GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK
- 19. INSTALLING SPRING MVC GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK or, just use Spring Boot and never worry about it @ComponentScan @EnableAutoConfiguration public class Application extends SpringBootServletInitializer { ! private static Class< Application> applicationClass = Application.class; ! ! } ! public static void main(String[] args) { SpringApplication.run(applicationClass); } @Override protected SpringApplicationBuilder configure(SpringApplicationBuilder application) { return application.sources(applicationClass); }
- 20. A RICH SERVLET TOOLKIT GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK other niceties Spring’s web support provides: HttpRequestHandlers supports remoting technologies : Caucho, HTTP Invoker, etc. DelegatingFilterProxy javax.filter.Filter that delegates to a Spring-managed bean HandlerInterceptor wraps requests to HttpRequestHandlers ServletWrappingController lets you force requests to a servlet through the Spring Handler chain WebApplicationContextUtils look up the current ApplicationContext given a ServletContext HiddenHttpMethodFilter routes HTTP requests to the appropriate endpoint
- 21. T H E S P R I N G R E S T S TA C K REST Essentials
- 22. MOTIVATIONS FOR REST meanwhile, in the enterprise, somebody is using SOAP because it’s “SIMPLE” GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK
- 23. WHAT IS REST? GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK REST is an architectural constraint based on HTTP 1.1, and created as part of Roy Fielding’s doctoral dissertation in 2000. It embraces HTTP. It’s a style, not a standard http://en.wikipedia.org/wiki/Representational_state_transfer
- 24. WHAT IS REST? GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK REST has no hard and fast rules. REST is an architectural style, not a standard. REST uses Headers to describe requests & responses REST embraces HTTP verbs. (DRY)
- 25. HTTP VERBS GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK GET requests retrieve information. GET can have side-effects (but it’s unexpected) GET can be conditional, or partial: If-Modified-Since, Range ! GET /users/21
- 26. HTTP VERBS GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK DELETE requests that a resource be removed, though the deletion doesn’t have to be immediate. DELETE /users/21
- 27. HTTP VERBS GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK POST requests that the resource do something with the enclosed entity POST can be used to create or update. ! POST /users { “firstName”: “Juergen” }
- 28. HTTP VERBS GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK PUT requests that the entity be stored at a URI PUT can be used to create or update. PUT /users/21 { “firstName”: “Juergen” }
- 29. STATUS CODES GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK status codes convey the result of the server’s attempt to satisfy the request. Categories: 1xx: informational 2xx: success 3xx: redirection 4xx: client error 5xx: server error
- 30. STATUS CODES GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK 200 OK - Everything worked ! 201 Created - Returns a Location header for new resource ! 202 Accepted - server has accepted the request, but it is not yet complete. Status URI optionally conveyed in Location header
- 31. STATUS CODES GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK 400 Bad Request - Malformed Syntax. Retry with change. ! 401 Unauthorized - authentication is required 403 Forbidden - server has understood, but refuses request 404 Not Found - server can’t find a resource for URI 406 Incompatible - incompatible Accept headers specified 409 Conflict - resource conflicts with client request
- 32. CONTENT NEGOTIATION GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK Clients and services must agree on a representation media type through content negotiation. ! Client specifies what it wants through Accept header Server specifies what it produces through Content-Type header !
- 33. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK CONTENT NEGOTIATION If no match is made, the client will receive a 406 Not Acceptable
- 34. CONTENT NEGOTIATION GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK Spring MVC supports multiple types of content negotiation through its ContentNegotiationStrategy: e.g., Accept header, URL extension, request parameters, or a fixed type
- 35. SOME REST POWER TOOLS Advanced REST Client GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK
- 36. SOME REST POWER TOOLS Poster GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK
- 37. SOME REST POWER TOOLS curl GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK ➜ ~ curl -X POST -u android-crm:123456 http://localhost:8080/oauth/token -H "Accept: application/json" -d "password=......" ! {"access_token":"426481ea-c3eb-45a0-8b2d-d1f9cfae0fcc","token_type":"bearer","expires ! ➜ ~
- 38. T H E S P R I N G R E S T S TA C K Towards Hypermedia
- 39. THE MATURITY MODEL GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK The Richardson Maturity Model is a way to grade your API according to the REST constraints with 4 levels of increasing compliance ! http://martinfowler.com/articles/richardsonMaturityModel.html
- 40. THE MATURITY MODEL GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK The Richardson Maturity Model Level 0: swamp of POX Uses HTTP mainly as a tunnel through one URI e.g., SOAP, XML-RPC Usually features on HTTP verb (POST) http://martinfowler.com/articles/richardsonMaturityModel.html
- 41. THE MATURITY MODEL GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK The Richardson Maturity Model Level 1: resources Multiple URIs to distinguish related nouns e.g., /articles/1, /articles/2, vs. just /articles http://martinfowler.com/articles/richardsonMaturityModel.html
- 42. THE MATURITY MODEL GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK The Richardson Maturity Model Level 2: HTTP verbs leverage transport-native properties to enhance service e.g., HTTP GET and PUT and DELETE and POST Uses idiomatic HTTP controls like status codes, headers http://martinfowler.com/articles/richardsonMaturityModel.html
- 44. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK HATEOAS The Richardson Maturity Model Level 3: Hypermedia Controls (aka, HATEOAS) No a priori knowledge of service required Navigation options are provided by service and hypermedia controls Promotes longevity through a uniform interface http://martinfowler.com/articles/richardsonMaturityModel.html
- 45. HATEOAS GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK Links provide possible navigations from a given resource ! Links are dynamic, based on resource state. ! <link href=“http://...:8080/users/232/customers” rel= “customers”/> ! { href: “http://...:8080/users/232/customers”, rel: “customers” }
- 46. Demonstration Working with Hypermedia and Spring HATEOAS
- 47. SPRING DATA REST GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK Spring Data REST simplifies the generic data-centric @Controllers ! Builds on top of Spring Data Repository support: @RestResource (path = "users", rel = "users") public interface UserRepository extends PagingAndSortingRepository<User, Long> { ! ! User findByUsername(@Param ("username") String username);
- 48. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK SPRING DATA REST Spring Data REST simplifies the generic data-centric @Controllers ! Builds on top of Spring Data Repository support: @RestResource (path = "users", rel = "users") public interface UserRepository extends PagingAndSortingRepository<User, Long> { ! ! ! ! User findByUsername(@Param ("username") String username); select u from User where u.username = ?
- 49. SPRING DATA REST GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK Spring Data REST simplifies the generic data-centric @Controllers ! Builds on top of Spring Data Repository support: @RestResource (path = "users", rel = "users") public interface UserRepository extends PagingAndSortingRepository<User, Long> { ! } List<User> findUsersByFirstNameOrLastNameOrUsername( @Param ("firstName") String firstName, @Param ("lastName") String lastName, @Param ("username") String username);
- 50. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK SPRING DATA REST Spring Data REST simplifies the generic data-centric @Controllers ! Builds on top of Spring Data Repository support: @RestResource (path = "users", rel = "users") public interface UserRepository extends PagingAndSortingRepository<User, Long> { ! } List<User> findUsersByFirstNameOrLastNameOrUsername( @Param ("firstName") String firstName, @Param ("lastName") String lastName, @Param ("username") String username); select u from User u where u.username = ? or u.firstName = ? or u.lastName = ?
- 51. T H E S P R I N G R E S T S TA C K Testing REST
- 52. Demonstration Testing web services with Spring MVC Test framework
- 53. T H E S P R I N G R E S T S TA C K Error Handling
- 54. HANDLING ERRORS IN A REST API GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK Developers learn to use an API through errors Extreme programming and Test-Driven development embrace this truth ! Errors introduce transparency
- 55. STATUS CODES GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK Status codes map to errors pick a meaningful subset of the 70+ status codes 200 - OK 201 - Created 304 - Created - Not Modified 400 - Bad Request 401 - Unauthorized 403 - Forbidden 404 - Not Found 500 - Internal Server Error https://blog.apigee.com/detail/restful_api_design_what_about_errors
- 56. DESCRIPTIVE ERRORS GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK Send meaningful errors along with status codes { "message": "authentication failed", "errors": [ { "resource": "Issue", "field": "title", "code": "missing_field" } ] } { "type": "authentication", "message": “the username and password provided are invalid” , "status": “401” } https://blog.apigee.com/detail/restful_api_design_what_about_errors
- 57. DESCRIPTIVE ERRORS GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK application/vnd.error+json & application/vnd.error+xml { "logref": 42, "message": "Validation failed", "_links": { "help": { "href": "http://.../", "title": "Error Information" }, "describes": { "href": "http://.../", "title": "Error Description" } } } https://github.com/blongden/vnd.error
- 58. Demonstration Handling errors with vnd.errors and @ControllerAdvice
- 60. T H E S P R I N G R E S T S TA C K API Versioning
- 61. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK VERSIONING YOUR API Build a version into your API ! API versions can be dealt with one of two ways: through API URIs: https://api.foo.com/v1 through media types: application/vnd.company.urapp-v3+json
- 62. T H E S P R I N G R E S T S TA C K Security
- 63. SPRING SECURITY Security is hard. Don’t reinvent the wheel! ! Things to worry about when developing web applications? EVERYTHING ! (cross-site scripting, session fixation, identification, authorization, and authentication, encryption, and SO much more.) GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK
- 64. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK SPRING SECURITY Spring Security is a modern security framework for a modern age ! Yes client submits authentication credentials Authentication Mechanism collects the details No - retry! Authentication is valid? Store Authentication in SecurityContextHolder process original request
- 65. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK SPRING SECURITY Spring Security is a modern security framework for a modern age ! Yes client submits authentication credentials Authentication Mechanism collects the details Authentication Store Authentication in SecurityContextHolder Authentication is valid? Mechanism collects the details! ! No AuthenticationRequest is sent to AuthenticationManager! - retry! ! (passes it through a chain of AuthenticationProviders)! ! AuthenticationProvider asks a UserDetailsService for a UserDetails! ! The UserDetails object is used to build an Authentication object! ! ! process original request
- 66. Demonstration adding a Spring Security sign in form to a regular application ! !
- 67. SECURING REST SERVICES GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK Usernames and Passwords ! If you can trust the client to keep a secret like a password, then it can send the password using: ...HTTP Basic - passwords are sent plaintext! ... HTTP Digest - hashed passwords, but still plaintext. SSL/TLS encryption helps prevent man-in-the-middle attacks
- 68. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK SSL AND TLS So, SSL/TLS is...? ! so trust! wow an implementation of public key cryptography: ! public key cryptography only works because we ! all agree to trust well known root CAs !
- 69. SSL AND TLS GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK SSL/TLS is used routinely to verify the identify of servers. ! Normally, the client confirms the server, but the server rarely requires the client to transmit a certificate. ! It’s easy enough to setup SSL/TLS on your web server. !
- 70. Demonstration Setting up SSL/TLS with embedded Apache Tomcat 7 and Spring Boot ! !
- 71. SSL AND TLS SSL/TLS can be used to identify the client to the server, through mutual authentication. ! ! browser/client must send their certificate, as well. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK @Override protected void configure(HttpSecurity http) throws Exception { http .authorizeRequests() .anyRequest().authenticated() .and() .x509(); }
- 72. @Configuration @EnableWebMvcSecurity public class SecurityConfig extends WebSecurityConfigurerAdapter { ! ! } @Autowired public void configureGlobal(AuthenticationManagerBuilder auth) throws Exception { auth. inMemoryAuthentication() .withUser("mia").password("password").roles("USER").and() .withUser("mario").password("password").roles("USER","ADMIN"); } @Override protected void configure(HttpSecurity http) throws Exception { http .authorizeRequests() .anyRequest().authenticated() .and() .x509(); }
- 73. Demonstration X509 Java configuration demo ! !
- 74. THE TROUBLE WITH PASSWORDS Tim Bray says: Passwords don’t scale ! Too easy to compromise. ! Updating all your clients whenever you change your password would be a nightmare! ! GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK
- 75. THE TROUBLE WITH PASSWORDS GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK
- 76. X-AUTH GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK Most people just want their own clients to be able to talk securely to their own services. ! x-auth offers one way of achieving this based on tokens ! !
- 77. Demonstration A custom x-auth example
- 78. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK OAUTH OAuth is a way for one (automated) process to securely identify itself to another ! Assumes a user context: ! ! “I authorize $CLIENTX to act on $USER_Y’s behalf” OAuth is a way of authorizing a client with particular access (scopes) !
- 82. Demonstration Spring Security OAuth in the oauth module
- 83. Demonstration Writing a unit test for an OAuth service using the Spring MVC test framework
- 84. T H E S P R I N G R E S T S TA C K The Connected Web of APIs
- 85. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK A CONNECTED WORLD IN 60 SECONDS * source: visual.ly/60-seconds-social-media A Connected World in 00:60 seconds 700ksent messages 1090 visitors 2000 checkins 175k tweets 7610 searches 2MM videos viewed 3125 photos uploaded 7630sent messages
- 86. SPRING SOCIAL GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK Spring Social provides an authentication and authorization client for OAuth (1.0, 1.0a, 2.0) ! Provides type-safe API bindings for various services
- 87. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK SPRING SOCIAL BINDINGS BINDINGS... • Body Level One Body Level Two Body Level Three Body Level Four Body Level Five
- 89. Demonstration Using Spring Social in an Application
- 90. Demonstration Building Your own Spring Social binding
- 91. T H E S P R I N G R E S T S TA C K Deployment
- 92. GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK MICRO SERVICE ARCHITECTURE Micro Services ... ! Promote single responsibility principle ! * Promote loosely coupled, focused services. ! (SOLID at the architecture level) Don’t like it? Throw it away! * In object-oriented programming, the single responsibility principle states that every class should have a single responsibility, and that responsibility should be entirely encapsulated by the class. All its services should be narrowly aligned with that responsibility.! http://en.wikipedia.org/wiki/Single_responsibility_principle
- 93. EMBEDDED WEB SERVERS Spring Boot supports Apache Tomcat 7 by default. ! Easy to switch to Jetty, or Tomcat 8 GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK
- 94. Demonstration Switching embedded web servers
- 96. Demonstration From fat .jar to .war
- 97. SPRING WITH SPRING REST DESIGNWORKS WELL IN THE CLOUD CLOUD GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK
- 99. PRODUCTION READY REST GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK Spring Boot is production-ready, by default ! Comes out of the box with smart monitoring and management tools, the CrashD server, etc. ! ! !
- 100. Demonstration production ready REST services with Boot
- 101. NEXT STEPS GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK Spring IO Guides http://spring.io/guides ! Roy Fielding’s Dissertation introduces REST http://www.ics.uci.edu/~fielding/pubs/dissertation/evaluation.htm#sec_6_1%7C ! The Spring REST Shell http://github.com/jbrisbin/rest-shell ! Spring Security, Security OAuth, Spring Data REST, HATEOAS, Social http://github.com/spring-projects ! Spring MVC Test Framework http://docs.spring.io/spring/docs/4.0.x/spring-framework-reference/html/testing.html !
- 102. NEXT STEPS GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK Oliver Gierke’s talk on Hypermedia from Øredev @ http://vimeo.com/53214577 Lez Hazelwood’s talk on designing a beautiful JSON+REST API Ben Hale’s talk on REST API design with Spring from SpringOne2GX 2012 @ http://www.youtube.com/watch?v=wylViAqNiRA My links: github.com/joshlong/the-spring-rest-stack slideshare.net/joshlong/rest-apis-with-spring @starbuxman !
- 103. REST DESIGN WITH SPRING GITHUB.COM/JOSHLONG/THE-SPRING-REST-STACK @starbuxman [email protected] slideshare.net/joshlong github.com/joshlong speakerdeck.com/joshlong github.com/joshlong/the-spring-rest-stack