Class Execute

  • All Implemented Interfaces:
    TemplateMethodModel, TemplateModel

    public class Execute
    extends java.lang.Object
    implements TemplateMethodModel

    Gives FreeMarker the the ability to execute external commands. Will fork a process, and inline anything that process sends to stdout in the template. Based on a patch submitted by Peter Molettiere.

    BE CAREFUL! this tag, depending on use, may allow you to set something up so that users of your web application could run arbitrary code on your server. This can only happen if you allow unchecked GET/POST submissions to be used as the command string in the exec tag.

    Usage:
    From java:

     SimpleHash root = new SimpleHash();
    
     root.put( "exec", new freemarker.template.utility.Execute() );
    
     ...
     

    From your FreeMarker template:

    
     The following is executed:
     ${exec( "/usr/bin/ls" )}
    
     ...
     
    • Constructor Summary

      Constructors 
      Constructor Description
      Execute()  
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      java.lang.Object exec​(java.util.List arguments)
      Executes a method call.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • Execute

        public Execute()
    • Method Detail

      • exec

        public java.lang.Object exec​(java.util.List arguments)
                              throws TemplateModelException
        Executes a method call.
        Specified by:
        exec in interface TemplateMethodModel
        Parameters:
        arguments - a List of String objects containing the values of the arguments passed to the method.
        Returns:
        the TemplateModel produced by the method, or null.
        Throws:
        TemplateModelException