| <!-- |
| /*************************************************************************************************************************** |
| * Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an |
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the |
| * specific language governing permissions and limitations under the License. |
| ***************************************************************************************************************************/ |
| --> |
| |
| {8.0.0-new} |
| Installing in Eclipse |
| |
| <p> |
| Follow these instructions to import the REST examples project using Spring Boot into Eclipse. |
| </p> |
| <ol class='spaced-list'> |
| <li> |
| Download the <c>juneau-examples-rest-springboot-{@property juneauVersion}.zip</c> file from the downloads page |
| (located in the binaries) and import it into your workspace as an existing project: |
| <br><br> |
| <img class='bordered' src='doc-files/juneau-examples-rest-springboot.Installing.1.png' style='width:524px'> |
| <li> |
| Select the archive file and import the project: |
| <br><br> |
| <img class='bordered' src='doc-files/juneau-examples-rest-springboot.Installing.2.png' style='width:549px'> |
| <li> |
| In your workspace, you should now see the following project: |
| <br><br> |
| <img class='bordered' src='doc-files/juneau-examples-rest-springboot.Installing.3.png' style='width:400px'> |
| </ol> |
| <p> |
| The important elements in this project are: |
| </p> |
| <ul class='spaced-list'> |
| <li> |
| <l>App.java</l> - The entry point. |
| <br>This class creates and starts our microservice. |
| <br>Note that we're using the existing Spring Boot application logic for the microservice and we're retrieving |
| our root resource as a spring bean. |
| <br>Only the top-level resource needs to be annotated with {@link oaj.rest.springboot.annotation.JuneauRestRoot @JuneauRestRoot} |
| <br><br> |
| <p class='bcode w800'> |
| <ja>@SpringBootApplication</ja> |
| <ja>@Controller</ja> |
| <jk>public class</jk> App { |
| |
| <jk>public static void</jk> main(String[] args) { |
| <jk>new</jk> SpringApplicationBuilder(App.<jk>class</jk>) |
| .initializers(<jk>new</jk> JuneauRestInitializer(App.<jk>class</jk>)) |
| .run(args); |
| } |
| |
| <ja>@Bean @JuneauRestRoot</ja> |
| <jk>public</jk> RootResources getRootResources() { |
| <jk>return new</jk> RootResources(); |
| } |
| } |
| </p> |
| <li> |
| <l>RootResources.java</l> - The top-level REST resource. |
| <br>This class routes HTTP requests to child resources: |
| <br><br> |
| <p class='bcode w800'> |
| <ja>@Rest</ja>( |
| path=<js>"/*"</js>, |
| title=<js>"Root resources"</js>, |
| description=<js>"Example of a router resource page."</js>, |
| htmldoc=<ja>@HtmlDoc</ja>( |
| widgets={ |
| ContentTypeMenuItem.<jk>class</jk>, |
| ThemeMenuItem.<jk>class</jk> |
| }, |
| navlinks={ |
| <js>"options: ?method=OPTIONS"</js>, |
| <js>"$W{ContentTypeMenuItem}"</js>, |
| <js>"$W{ThemeMenuItem}"</js>, |
| <js>"source: $C{Source/gitHub}/org/apache/juneau/examples/rest/$R{servletClassSimple}.java"</js> |
| }, |
| aside={ |
| <js>"<div style='max-width:400px' class='text'>"</js>, |
| <js>" <p>This is an example of a 'router' page that serves as a jumping-off point to child resources.</p>"</js>, |
| <js>" <p>Resources can be nested arbitrarily deep through router pages.</p>"</js>, |
| <js>" <p>Note the <span class='link'>options</span> link provided that lets you see the generated swagger doc for this page.</p>"</js>, |
| <js>" <p>Also note the <span class='link'>sources</span> link on these pages to view the source code for the page.</p>"</js>, |
| <js>" <p>All content on pages in the UI are serialized POJOs. In this case, it's a serialized array of beans with 2 properties, 'name' and 'description'.</p>"</js>, |
| <js>" <p>Other features (such as this aside) are added through annotations.</p>"</js>, |
| <js>"</div>"</js> |
| } |
| ), |
| children={ |
| HelloWorldResource.<jk>class</jk>, |
| PetStoreResource.<jk>class</jk>, |
| DtoExamples.<jk>class</jk>, |
| ConfigResource.<jk>class</jk>, |
| LogsResource.<jk>class</jk>, |
| ShutdownResource.<jk>class</jk> |
| } |
| ) |
| <ja>@SerializerConfig</ja>( |
| <jc>// For testing purposes, we want to use single quotes in all the serializers so it's easier to do simple |
| // String comparisons.</jc> |
| quoteChar=<js>"'"</js> |
| ) |
| <jk>public class</jk> RootResources <jk>extends</jk> BasicRestServletJenaGroup { |
| <jc>// No code</jc> |
| } |
| </p> |
| <li> |
| <l>juneau.cfg</l> - The configuration file. |
| <br>Contains various useful settings. |
| <br>Can be used for your own resource configurations. |
| <br>Note that the Jetty configuration is not present. |
| <br>Also it's located in the classpath so that our microservice can be built as a single executable jar. |
| <br><br> |
| <p class='bcode w800'> |
| <cc>#======================================================================================================================= |
| # Basic configuration file for REST microservices |
| # Subprojects can use this as a starting point. |
| #=======================================================================================================================</cc> |
| |
| <cc>#======================================================================================================================= |
| # REST settings |
| #=======================================================================================================================</cc> |
| <cs>[REST]</cs> |
| |
| <cc># URL mappings to static files in the working directory or classpath.</cc> |
| <ck>staticFiles</ck> = htdocs:files/htdocs |
| |
| <cc># Stylesheet to use for HTML views.</cc> |
| <ck>theme</ck> = <cv>servlet:/htdocs/themes/devops.css</cv> |
| |
| <ck>headerIcon</ck> = <cv>servlet:/htdocs/images/juneau.png</cv> |
| <ck>headerLink</ck> = <cv>http://juneau.apache.org</cv> |
| <ck>footerIcon</ck> = <cv>servlet:/htdocs/images/asf.png</cv> |
| <ck>footerLink</ck> = <cv>http://www.apache.org</cv> |
| |
| <ck>favicon</ck> = <cv>$C{REST/headerIcon}</cv> |
| <ck>header</ck> = |
| <cv><a href='$U{$C{REST/headerLink}}'> |
| <img src='$U{$C{REST/headerIcon}}' style='position:absolute;top:5;right:5;background-color:transparent;height:30px'/> |
| </a></cv> |
| <ck>footer</ck> = |
| <cv><a href='$U{$C{REST/footerLink}}'> |
| <img src='$U{$C{REST/footerIcon}}' style='float:right;padding-right:20px;height:32px'/> |
| </a></cv> |
| </p> |
| </ul> |
| <p> |
| At this point, you're ready to start the microservice from your workspace. |
| </p> |