topic Re: Java backed webscript and Freemarker templates in Alfresco Archive

Java backed webscript and Freemarker templates

amenel — Mon, 30 Mar 2009 16:00:05 GMT

Hi all,I have spent some time trying to figure out how web scripts work in Alfresco 3.0 and also trying to set up a simple web script. For the first part, the information from the wiki pages got me started. For the second part, these same pages seem not enough to me. My task is to write a web script

Re: Java backed webscript and Freemarker templates

openpj — Mon, 30 Mar 2009 18:12:49 GMT

Where do you have deployed all resources needed for your feature?
Can you provide more details?

Re: Java backed webscript and Freemarker templates

amenel — Tue, 31 Mar 2009 08:40:17 GMT

Hi,
here is the list of the 4 things I deployed, base directory is "alfresco\tomcat'.
- wscript.get.desc.xml, in webapps\alfresco\WEB-INF\classes\alfresco\webscripts\extension\com\bluexml\xforms:


<webscript>
  <shortname>XForms for Alfresco 3.0</shortname>
  <description>BlueXML XForms data service for Alfresco 3.0</description>
  <url>/wscript</url>
  <format default="xml"/>any</format>
  <authentication>none</authentication>
  <transaction>none</transaction>
  <family>bluexml</family>
  <family>xforms</family>
</webscript>
‍‍‍‍‍‍‍‍‍‍‍‍

- the template file wscript.get.xml.ftl, which contains the code below (I don't know whether "response" is a valid variable). I didn't try making it empty.


<?xml version="1.0" encoding="UTF-8"?>
<result>
   ${response}
</result>
‍‍‍‍‍‍

- the jar file, in webapps\alfresco\WEB-INF\lib
- web-scripts-custom-context, in shared\classes\alfresco\extension:


<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE beans PUBLIC '-//SPRING//DTD BEAN//EN' 'http://www.springframework.org/dtd/spring-beans.dtd'>
<beans>
   <!– BlueXML XForms Data Controller –>
   <bean id="webscript.extension.com.bluexml.xforms.wscript.get" 
            class="com.bluexml.xforms.controller.alfresco3x0.XFormsWebScript"
            parent="webscript">
         <property name="dictionaryService">
            <ref bean="dictionaryService" />
         </property>
   </bean>
</beans>
‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Re: Java backed webscript and Freemarker templates

amenel — Tue, 31 Mar 2009 10:03:46 GMT

Well, I just succeeded running my webscript…
The frustrating thing is that I don't know why I had problems previously. It seems like the only thing I did was to change the format from <format default="xml">extension</format> to <format default="xml">any</format>.
Since the script runs as wanted, I deleted the freemarker file, which is no longer asked for by Alfresco.

Re: Java backed webscript and Freemarker templates

loic — Thu, 04 Jun 2009 14:41:08 GMT

Hi,

I'm pretty new to Alfresco's WebScripts and I'm currentely trying to get the The World's Simplest Webscript working.

Here is my issue :

- The jar file is in webapps\alfresco\WEB-INF\lib

- I added these following lines to \webapps\alfresco\WEB-INF\classes\alfresco\web-scripts-application-context.xml


<!– SimpleWebScript –>
<bean id="webscript.org.alfresco.demo.simple.get" class="org.alfresco.module.demoscripts.SimpleWebScript" parent="webscript"><property name="dictionaryService" ref="DictionaryService"/>
</bean>
‍‍‍‍‍

- I uploaded the simple.get.desc.xml file to the Company Home/Data Dictionnary/Web Scripts space.

- I also refreshed all the web scripts by clicking the button at the following adress http://localhost:8080/alfresco/service/index.

The problem is when I call the web script at the following address > http://localhost:8080/alfresco/service/demo/simple I have this message :


The Web Script /alfresco/service/demo/simple has responded with a status of 500 - Internal Error.

500 Description:   An error inside the HTTP server which prevented it from fulfilling the request.
 
Message:   Web Script format '' is not registered

…blah blah blah
‍‍‍‍‍‍‍‍‍

If I explicitly ask for a format (http://localhost:8080/alfresco/service/demo/simple?format=json), the server responds me that I need a freemarker template…

How can I do ? Do I need a FreeMarker template (previous answers seems to say that i don't) ? If I really need one, how can I get the content filled in my java class (${var} ? ${response} ? I tried these with no luck )

Thanks.

Re: Java backed webscript and Freemarker templates

openpj — Mon, 08 Jun 2009 18:42:55 GMT

If you want to implement a Java Backed Webscript with the execution of a JavaScript and/or a template FreeMarker for your presentation layout, you need to extend the following Java Helper class for your custom WebScript:

org.alfresco.web.scripts.DeclarativeWebScript‍

In this way WebScript Dispatcher will execute your custom webscripts files in the following order:

Java class (extends DeclarativeWebScript)

JavaScript (optional)

FreeMarker Template (required)And you must define your own custom FreeMarker template to create the corrected output format.

If you need only to execute an action and take control of the request you only need to extend the following Java Helper class:

org.alfresco.web.scripts.AbstractWebScript‍

To see more information you can see the WebScript wiki page.

Hope this helps.

Re: Java backed webscript and Freemarker templates

rmfought — Thu, 20 Aug 2009 19:59:13 GMT

I think the point is that the example implements an AbstractWebScript, yet the engine is still looking for a Freemarker template.

I am having the same issues with the The World's Simplest WebScript. When following the example, I get the following error:

org.alfresco.web.scripts.WebScriptException: 07200000 Failed to process template org/alfresco/simple/simple.get.html.ftl

Is the bean not properly registered? In my case, I'm using a bare-bones Surf instance (not Alfresco) and I don't have a web-scripts-application-context.xml file in \WEB-INF\classes\alfresco\ - I tried creating one to register the bean in, but am getting the same error.

Re: Java backed webscript and Freemarker templates

rmfought — Thu, 20 Aug 2009 22:46:39 GMT

So I figured out that the bean wasn't even being recognized, because the web-scripts-application-context.xml file isn't being referenced in some other configuration file. So I moved the bean declaration to webapps\surf\WEB-INF\classes\alfresco\webscript-framework-application-context.xml

<bean id="webscript.org.alfresco.java.simple.get" class="test.webscript.SimpleWebScript" parent="webscript" />
 ‍‍

and now Surf recognizes the bean, but can't load the class:

org.springframework.beans.factory.CannotLoadBeanClassException: Cannot find class [test.webscript.SimpleWebScript] for bean with name 'webscript.org.alfresco.java.simple.get' defined in class path resource [alfresco/webscript-framework-application-context.xml]; nested exception is java.lang.ClassNotFoundException: test.webscript.SimpleWebScript

I compiled the java into a class, and placed it in a jar file in webapps\surf\WEB-INF\lib

package test.webscript;

import java.io.IOException;

import org.alfresco.web.scripts.AbstractWebScript;
import org.alfresco.web.scripts.WebScriptException;
import org.alfresco.web.scripts.WebScriptRequest;
import org.alfresco.web.scripts.WebScriptResponse;
import org.json.JSONException;
import org.json.JSONObject;

public class SimpleWebScript extends AbstractWebScript
{
    public void execute(WebScriptRequest req, WebScriptResponse res)
        throws IOException
    {
       try
       {
          // build a json object
          JSONObject obj = new JSONObject();
          
          // put some data on it
          obj.put("field1", "data1");
          
          // build a JSON string and send it back
          String jsonString = obj.toString();
          res.getWriter().write(jsonString);
       }
       catch(JSONException e)
       {
          throw new WebScriptException("Unable to serialize JSON");
       }
    }    
}
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Here is my webapps\surf\WEB-INF\classes\alfresco\webscripts\org\alfresco\java\simple.get.desc.xml :

<webscript>
  <shortname>The World's Simplest Webscript</shortname>
  <description>Hands back a little bit of JSON</description>
  <url>/java/simple</url>
  <authentication>none</authentication>
  <format default="">argument</format>
</webscript>‍‍‍‍‍‍‍

So why is the class not being found?

Thanks

Re: Java backed webscript and Freemarker templates

amenel — Fri, 21 Aug 2009 08:34:05 GMT

It may be because the name of the jar file is not explicit ? Maybe that there's a naming convention. Have you tried naming the file with the Java package ? That's how I have named my webscript and it caused no problem.

Other thing: whatever file whose name ends with "-context.xml" is read by Alfresco when loading… provided the file is in WEB-INF/classes/alfresco or in shared/classes/alfresco/extension (EDIT: it seems like user files that are placed into WEB-INF/classes/alfresco are not loaded); there's no need for such a file to be referenced somewhere else cause it is already implicitly referenced, by convention. So I guess your initial file wasn't in the appropriate directory. I put mine in tomcat/shared/classes/alfresco/extension and no problem either.

Re: Java backed webscript and Freemarker templates

rmfought — Fri, 21 Aug 2009 20:11:26 GMT

OK, it appears I have overcome the class hurdle, but now I am getting the following error from the Web Script Engine:

07210001 Web Script org/alfresco/java/simple.get already associated with the 'Presentation' container (classpath:alfresco/webscripts/org/alfresco/java/simple.get.desc.xml)‍

Re: Java backed webscript and Freemarker templates

amenel — Fri, 21 Aug 2009 20:39:01 GMT

The jar file has to go into webapps/alfresco/WEB-INF/lib. Is it there ?
EDIT: I didn't see that you did put the file into webapps/surf/WEB-INF/lib. The only times I encountered the "can't load class" message were when I forgot to drop it into WEB-INF/lib. I really don't see what the problem can be.

Re: Java backed webscript and Freemarker templates

rmfought — Fri, 21 Aug 2009 21:34:31 GMT

Thanks Amenel,

I'm sure it has something to do with the fact that I am using a bare Surf instance, and not a full-blown Alfresco install. Maybe something wonky with the myriad of configuration files?

EDIT: Perhaps I should be using a Java Bean Component instead of a Java-backed Web Script? Unfortunately, the documentation for this method is non-existent.

Rich

Re: Java backed webscript and Freemarker templates

hyperation — Wed, 16 Sep 2009 01:03:50 GMT

Hi Everyone,

I am also having problem trying to get a simple java backed webscript running.

Here is what I did so far:
web-scripts-application-context.xml:

   
<bean id="webscript.test.simple.get" class="com.test.webscript.SimpleWebscript" parent="webscript" />
‍‍‍

BTW, do I need some kind of <property> for the bean entry?

simple.get.json.ftl:


{
   "status" : "${status}",
   "x" : "${x}",
   "y" : "${y}"
}
‍‍‍‍‍‍‍

simple.get.desc.xml:


<webscript>
  <shortname>Simple Webscript</shortname>
  <description>Returns JSON results</description>
  <url>/test/simple</url>
  <format default="json">extension</format>
  <authentication>none</authentication>
</webscript>
‍‍‍‍‍‍‍‍‍

SimpleWebscript.java:


import java.util.HashMap;
import java.util.Map;
import org.alfresco.web.scripts.DeclarativeWebScript;
import org.alfresco.web.scripts.Status;
import org.alfresco.web.scripts.WebScriptRequest;

public class SimpleWebscript extends DeclarativeWebScript {
   @Override
   protected Map<String, Object> executeImpl(WebScriptRequest request, Status status) {

      String responseStatus = "200";
      String x = "xxx";
      String y = "yyy";
            
      Map<String, Object> model = new HashMap<String, Object>();
      model.put("status", responseStatus);
      model.put("x", x);
      model.put("y", y);
      
      return model;
   }
}
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Whenever I do a GET on the webscript I get the following error:


{
    "status" : 
  {
    "code" : 500,
    "name" : "Internal Error",
    "description" : "An error inside the HTTP server which prevented it from fulfilling the request."
  },  
  
  "message" : "Wrapped Exception (with status template): Error during processing of the template 'Expression x is undefined on line 3, column 20 in test\/simple.get.json.ftl.'. Please contact your system administrator.",  
  "exception" : "org.alfresco.web.scripts.WebScriptException - Wrapped Exception (with status template): Error during processing of the template 'Expression username is undefined on line 3, column 20 in test\/simple.get.json.ftl.'. Please contact your system administrator.",
….
‍‍‍‍‍‍‍‍‍‍‍‍‍

It seems like that class isn't even being touched. Any idea?

Thanks

Re: Java backed webscript and Freemarker templates

hyperation — Wed, 16 Sep 2009 02:23:41 GMT

Okay…

I was kind of correct, the Java class wasn't being called when invoking webscript. It seems like I placed the bean definition in the wrong file, I placed it in the none custom context.xml (web-scripts-application-context.xml). Instead, I should have created the bean in my own custom context.xml and place it in the extension folder in Alfresco.

Thanks

Re: Java backed webscript and Freemarker templates

juilee — Fri, 20 Jun 2014 16:00:00 GMT

Hello, I followed this tutorial to create a send email custom action using Java backed Webscript:
http://ecmstuff.blogspot.com/2012/04/adding-document-library-actions-in.html?showComment=1403279845779#c303784066266925848

As has been mentioned above, there is an AbstractWebScript class defined just to execute the action without using a freemaker template, but I get this error:
Cannot locate template processor for template sendDocInEmail.get.html

I have placed the services-context.xml file in the folder \tomcat\webapps\alfresco\WEB-INF\classes\alfresco\module

Please help!

Thanks,
Juilee