Alfresco : Hello World Java Backed Webscript

What is webscript?

A Web Script is a service bound to a URL that responds to HTTP methods like GET, POST, PUT and DELETE.

A Webscript consists of the following three files:

A Webscript descriptor XML file.

Controller file: Either it can be a server-side JavaScript or Java backed.

Presentation file: Free Marker Template file.

In this article I show how to create a simple Java backed webscript for Alfresco Repository.

Step 1:
 Create a new Java project with the following structure:
 

Image1.jpg

Step 2: Extend the helloWorld.java using DeclarativeWebScript.

Step 3: Override the executeImpl method. In this method create a new HashMap object, add a greeting message and return it. Refer to the following image:

Image 2.jpg

Step 4: Now, we need to create a webscript descriptor XML file ("helloWorld.get.desc.xml") in the "config/alfresco/extension/templates/webscripts/com/murali/webscripts" path.
 

Image 3.jpg


Step 5: Now we need to create a simple FreeMarker Template file ("helloWorld.get.json.ftl") to render the output.
 

Image4.jpg

Step 6: Register the webscript bean like:
 

Image5.jpg

Step 7:
 Create the "module.properties" file in the "config/alfresco" path.
 

Image6.jpg

Step 8:
 Create the alfresco amp by using following build.xml file.
 

Image7.jpg



Step 9:
 Install the amp, delete the exploded directory of Alfresco.

Refer : http://mralfresco.blogspot.in/2013/01/alfresco-module-packages-amp.html

Step 10:
 Restart Tomcat.

Step 11:
 Navigate to http://localhost:<portNumber>/alfresco/service/index/all

Step 12:
 Search for your "/com/murali/webscripts" package and click "GET /alfresco/service/com/murali/webscripts/helloWorld/" URL to invoke the webscript.
 

Image8.jpg

Step 13: 
Webscript output
 

Image9.jpg

Hope this helps someone !

Up Next
    Ebook Download
    View all
    Learn
    View all