Blossom on the web

Magnolia is a registered trademark owned by Magnolia International Ltd.Version 1.1

Tobias Mattsson, Senior Software Engineer

07.03.2014 at Magnolia Amplify

Blossom on the WebSpring and Content Management

1

Thursday, 7 March 2013

Version 1.1Magnolia is a registered trademark owned by Magnolia

International Ltd.2

Spring Framework

Spring is a java based application framework• Focus on web applications and enterprise

applications• One of the most popular frameworks in the Java

space

Pioneered a broad feature set• Lightweight container• Dependency Injection (DI)• Aspect Oriented Programming (AOP)• Enterprise Service Abstraction



International Ltd.3

Spring is everywhere

2.5 million developers use Spring (two thirds!)

More than half of the Fortune 500 power their Java applications with Spring

More than 70 percent of enterprises cite improved productivity, faster project completion, improved portability and application quality as reasons for using Spring



International Ltd.

Spring projects

Spring Web MVC

Spring WebFlowSpring Security

Spring WebServicesSpring Social

• Twitter, Facebook, LinkedIn etc

Spring Data• MongoDB, Neo4j, Riak, Cassandra etc

4



Spring and the CMS



International Ltd.6

Blossom integrates it for you

Integrates Spring into the Magnolia module mechanism

• Module Lifecycle

Extends Spring Web MVC for templatingAnd additional bridging



International Ltd.7

Spring Web MVC with Content

No configuration just code

Based on annotationsNon-intrusive

Spring centric approach• The controller is the template• The controller is the component• and they’re automatically available in Magnolia



International Ltd.

Spring Web MVC

8

@Controllerpublic class ExampleController {

@RequestMapping("/customers/list") public String render(ModelMap model) { model.put("title", "List of all customers"); model.put("customers", customerService.findAllCustomers()); return "customers/list"; }}



International Ltd.9

Templates

@Controller@Template(title = "Main template", id = "blossomSample:pages/main")public class MainTemplate {

@RequestMapping("/mainTemplate") public String render(Node page, ModelMap model) { return "pages/main.ftl"; }}



International Ltd.10

Areas


@Controller @Area("main") public static class MainArea {

@RequestMapping("/mainTemplate/main") public String render() { return "areas/mainArea.ftl"; } }

...}




Components

@Controller@Template(title = "Shopping Cart", id = "blossomSample:components/shoppingCart")@TemplateDescription("Shopping cart")public class ShoppingCartComponent {

@RequestMapping("/shoppingCart") public String handleRequest() { ... return "components/shoppingCart.ftl"; }

...}




Specifying what goes into an area

@Controller@Area("promos")@AvailableComponentClasses({TextComponent.class, ShoppingCartComponent.class})public static class PromosArea {

@RequestMapping("/mainTemplate/promos") public String render() { return "areas/promosArea.ftl"; }

}




Inheritance

@Controller@Area("promos")@Inherits@AvailableComponentClasses({TextComponent.class, ShoppingCartComponent.class})public static class PromosArea { @RequestMapping("/mainTemplate/promos") public String render() { return "areas/promos.jsp"; }}




Dialogs

Dialogs are created using code, not configuration

Based on annotationsDynamic behavior

Validation of dialog inputDetected and automatically available in Magnolia



International Ltd.

Dialog factories

15

@DialogFactory("page-dialog")public class PageDialog {

@TabFactory("Content") public void contentTab(TabBuilder tab) { tab.addEdit("title", "Title", "Title of this page"); tab.addCheckbox("navigation", "Navigation", "Include page in menu"); }

@TabFactory("Meta") public void metaTab(TabBuilder tab) { tab.addEdit("author", "Author", ""); tab.addEdit("keywords", "Keywords", "Keywords for this page"); tab.addEdit("description", "Description", "Concise page explanation"); }}



International Ltd.

Dialog inheritance

16

public abstract class BaseDialog { @TabFactory("Meta") public void metaTab(TabBuilder tab) { tab.addEdit("keywords", "Keywords", "Keywords for this page"); tab.addEdit("description", "Description", "Concise page explanation"); }}

@DialogFactory("news-properties")@TabOrder("Content", “Meta”)public class NewsPageDialog extends BaseDialog { @TabFactory("Content") public void contentTab(TabBuilder tab) { tab.addEdit("subject", "Subject", "News subject"); tab.addDate("date", "Publication Date", "Date of publication"); tab.addFckEditor("text", "Text", ""); tab.addFile("image", "Image", ""); }}



International Ltd.

Inline dialogs

17


@RequestMapping("/mainTemplate") public String render(Node page, ModelMap model) { return "pages/main.ftl"; }

@TabFactory("Content") public void propertiesDialog(TabBuilder tab) { tab.addEdit("title", "Title", ""); }}



International Ltd.

Inline dialogs

18


@Controller @Area("main") public static class MainArea {

@TabFactory("Content") public void contentTab(TabBuilder tab) { tab.addEdit("borderWidth", "Border width", "Width of the border around the area"); }

@RequestMapping("/mainTemplate/main") public String render() { return "areas/mainArea.ftl"; } }

...}



International Ltd.

Dynamic dialogs

19

@Controller@Template(id="blossomSample:components/book", title="Book")public class BookComponent {

@Inject private BookStoreWebService webService;

@TabFactory("Content") public void contentTab(TabBuilder tab) { tab.addSelect("id", "Book", "Select the book", webService.getBooks()); }

@RequestMapping("/book") public String handleRequest(ModelMap model, Node content) { String bookId = content.getProperty("id").getString(); model.put("book", webService.getBook(bookId)); return "components/book.ftl"; }}



International Ltd.

Validation

20

@DialogFactory("page-properties")public class PagePropertiesDialog {

@TabFactory("Meta") public void metaTab(TabBuilder tab) { tab.addEdit("description", "Description", "A concise page explanation"); }

@TabValidator("Meta") public void validateMetaTab(DialogTab tab) { if (tab.getSub("description").getValue().length() < 20) AlertUtil.setMessage("Meta description needs to be longer"); }}




Pre-execution

Portal like semantics

Allows a component to fully process a requestDevelopers can implement backing logic entirely in the components



International Ltd.

View technologies

Best of both worlds approach

Magnolia and Spring constructs work side by sideBuilt-in support for Freemarker and JSP

Everything Spring supports work out-of-the-box, such as JSON, PDF, XML and RSS

22



Blossom in the wild




Maglev - Magnolia and Grails

Brings Magnolia to the Grails platform

Development entirely in groovy and GSPGrails productivity

Builds on Blossom



International Ltd.

Summary

Enables access to Spring features and technologies• Directly in templates, components and dialogs

Spring centric approach on templating• Based on annotations• Connects the CMS with Spring Web MVC

Code over configuration• Versioning• Collaboration

25



Questions?



www.magnolia-cms.com

Tobias Mattsson, Senior Software EngineerMagnolia International Ltd.

07.03.2013 at Magnolia [email protected]

27

Thanks for listening!


http://www.magnolia-cms.com

http://www.magnolia-cms.com

mailto:[email protected]

mailto:[email protected]

Blossom on the web

Technology

Transcript of Blossom on the web