• Document Up to Date

REST Content Retrieval APIs

Content can be accessed via the REST Content Retrieval APIs. To view the REST Content Retrieval APIs:

or in a new tab


Note

Make sure that the request includes the crafterSite parameter to set a project value. The content retrieval API’s are project specific, and so, it needs to know the project for each request made.

Here’s an example to get an Item from the content store:

http://localhost:8080/api/1/site/content_store/item.json?url=/site/website/index.xml&crafterSite=mysite

Examples

Below are some examples of creating RESTful services in CrafterCMS.

Render Page Components as JSON

CaaS (Content as a Service) is a common need in today’s multi-channel world. Typically CaaS use cases require that the content is devoid of presentation markup so that the consumer can present the content as it desires. Other times consumers may wish to pull rendered content. This provides a simple REST example (a single Groovy based rest controller script) that will give you a way to render all of the components associated to a page.

Prerequisites

  • None

Step 1: Create a REST Controller

  • Under Scripts/rest right click and click create controller
    • Enter get-rendered-components.get as the controller name

  • Add the following code to the controller.

  1import java.io.ByteArrayOutputStream
  2import java.io.IOException
  3import java.io.PrintWriter
  4
  5import javax.servlet.Filter
  6import javax.servlet.FilterChain
  7import javax.servlet.FilterConfig
  8import javax.servlet.ServletException
  9import javax.servlet.ServletOutputStream
 10import javax.servlet.ServletRequest
 11import javax.servlet.ServletResponse
 12import javax.servlet.http.HttpServletRequest
 13import javax.servlet.http.HttpServletResponse
 14import javax.servlet.http.HttpServletResponseWrapper
 15import javax.servlet.WriteListener
 16import groovy.util.XmlSlurper
 17
 18def result = [:]
 19def targetPage = params.pageId
 20
 21if (targetPage != null) {
 22        result.page = targetPage
 23
 24        def pageItem = siteItemService.getSiteItem(targetPage)
 25
 26        if (pageItem != null) {
 27                def componentPaths = pageItem.queryValues("//include")
 28                result.components = []
 29
 30                if (componentPaths != null) {
 31                        componentPaths.each { componentPath ->
 32                                if (componentPath.endsWith(".xml") && !componentPath.startsWith("/site/website") ) {
 33                                        logger.info("Including component ${componentPath} into JSON response")
 34
 35                                        def component = [:]
 36                                        component.id = componentPath
 37
 38                                        // wrap the response to capture the output
 39                                        def wrappedResponse = new CapturingResponseWrapper(response)
 40
 41                                        // "include" the page that does the actual work
 42                                        request.getRequestDispatcher("/crafter-controller/component?path=" + componentPath).include(request, wrappedResponse)
 43
 44                                        // get the captured output, parse it and prepare the actual response
 45                                        def capturedOut = wrappedResponse.getCaptureAsString()
 46
 47                                        component.markup = capturedOut
 48
 49                                        result.components.add(component)
 50                                }
 51                        }
 52                } else {
 53                        result.message = "No components found"
 54                }
 55        } else {
 56                result.message = "Page '${targetPage}` not found"
 57        }
 58} else {
 59        result.message = "Parameter pageId is required."
 60}
 61
 62return result
 63
 64protected class CapturingResponseWrapper extends HttpServletResponseWrapper {
 65
 66        private final ByteArrayOutputStream capture
 67        private ServletOutputStream output
 68        private PrintWriter writer
 69
 70        public CapturingResponseWrapper(HttpServletResponse response) {
 71                super(response)
 72                capture = new ByteArrayOutputStream(response.getBufferSize())
 73        }
 74
 75        @Override
 76        public ServletOutputStream getOutputStream() {
 77                if (writer != null) {
 78                        throw new IllegalStateException("getWriter() has already been called on this response.")
 79                }
 80
 81                if (output == null) {
 82                        output = new ServletOutputStream() {
 83
 84                                @Override
 85                                public void write(int b) throws IOException {
 86                                        capture.write(b)
 87                                }
 88
 89                                @Override
 90                                public void flush() throws IOException {
 91                                        capture.flush()
 92                                }
 93
 94                                @Override
 95                                public void close() throws IOException {
 96                                        capture.close()
 97                                }
 98
 99                                @Override
100                                public void setWriteListener(WriteListener writeListener) {
101                                }
102
103                                @Override
104                                public boolean isReady() {
105                                        return true
106                                }
107                        }
108                }
109
110                return output
111        }
112
113        @Override
114        public PrintWriter getWriter() throws IOException {
115                if (output != null) {
116                        throw new IllegalStateException("getOutputStream() has already been called on this response.")
117                }
118
119                if (writer == null) {
120                        writer = new PrintWriter(new OutputStreamWriter(capture, getCharacterEncoding()))
121                }
122
123                return writer
124        }
125
126        @Override
127        public void flushBuffer() throws IOException {
128                super.flushBuffer()
129
130                if (writer != null) {
131                        writer.flush()
132                }
133                else if (output != null) {
134                        output.flush()
135                }
136        }
137
138        public byte[] getCaptureAsBytes() throws IOException {
139                if (writer != null) {
140                        writer.close()
141                }
142                else if (output != null) {
143                        output.close()
144                }
145
146                return capture.toByteArray()
147        }
148
149        public String getCaptureAsString() throws IOException {
150                return new String(getCaptureAsBytes(), getCharacterEncoding())
151        }
152
153}

Step 2: Execute the Service

  • Open a browser and hit the following URL:
    • http://localhost:8080/api/1/services/get-rendered-components.json?pageId=/site/website/index.xml

Get the Names of Sites Running in Crafter Engine

In this example we create a simple RESTful service that returns the list of sites running in Crafter Engine. You can find the API for the Context Manager HERE

Prerequisites

  • None

Step 1: Create a REST Controller

  • Under Scripts/rest right click and click create controller
    • Enter get-sites.get as the controller name

  • Add the following code to the controller.

 1def siteContextManager = applicationContext["crafter.siteContextManager"]
 2def siteContextList = siteContextManager.listContexts()
 3def siteNames = []
 4
 5siteContextList.each { siteContext ->
 6    def name = siteContext.getSiteName()
 7    siteNames.add(name)
 8}
 9
10return siteNames

Step 2: Execute the Service

  • Open a browser and hit the following URL:
    • http://localhost:8080/api/1/services/get-sites.json

    • See results

Get Pages for a Given Site

In this example we create a simple RESTful service that returns the list of Pages in a site. The service is parameterized to allow the caller to set a starting point and depth.

Prerequisites

  • None

Step 1: Create a REST Controller

  • Under Scripts/rest right click and click create controller
    • Enter get-pages.get as the controller name

  • Add the following code to the controller.

 1def pathParam = (params.path != null) ? params.path : ""
 2def depthParam = (params.depth != null) ? params.depth.toInteger() : 0
 3
 4def path = "/site/website" + pathParam
 5def depth = depthParam != 0 ? depthParam : 2
 6
 7def navItems = [:]
 8def siteDir = siteItemService.getSiteTree(path, depth)
 9
10if(siteDir) {
11    def dirs = siteDir.childItems
12    dirs.each { dir ->
13            def dirName = dir.getStoreName()
14            def dirItem = siteItemService.getSiteItem("/site/website/${dirName}/index.xml")
15
16            if (dirItem != null) {
17                def dirDisplayName = dirItem.queryValue('internal-name')
18
19                navItems.put(dirName, dirDisplayName)
20            }
21   }
22}
23
24return navItems

Step 2: Execute the Service

  • Open a browser and hit the following URL:
    • http://localhost:8080/api/1/services/get-pages.json

    • See results