Package com.redwood.scheduler.api.tool

Class ToolConnectionImpl

    • Method Detail

      • stderr

        protected void stderr​(com.redwood.scheduler.tool.messages.Console newConsole)
               throws IOException
        Specified by:
        stderr in class com.redwood.scheduler.tool.messages.CallHandler
        Throws:
        IOException

      • stdout

        protected void stdout​(com.redwood.scheduler.tool.messages.Console newConsole)
               throws IOException
        Specified by:
        stdout in class com.redwood.scheduler.tool.messages.CallHandler
        Throws:
        IOException

      • toRequest

        protected String toRequest​(com.redwood.scheduler.tool.messages.CallBase call)

      • toRequest

        protected String toRequest​(List<com.redwood.scheduler.tool.messages.CallBase> calls)

      • executeQuery

        public ToolResultSet executeQuery​(String query,
                                  Map<String,​String> options,
                                  Map<String,​Object> parameters)
                           throws ToolException,
                                  QueryException
        Description copied from interface: ToolConnection
        Execute a query and return the result as a ToolResultSet.
        Specified by:
        executeQuery in interface ToolConnection
        Parameters:
        query - the query to execute
        options - options for output (see the documentation for set option value).
        parameters - parameters to query (see the documentation for bind parameter type value). Accepted Java parameter types:
        • String - for String parameters
        • Long - for Integer parameters (the majority of numeric values, including UniqueId)
        • BigDecimal - for Numbers (mainly in/out values of job parameters)
        • Calendar - for DateTimeZone
        Example usage: 
         import com.redwood.scheduler.api.tool.*;

 public class Main
 {
   public static void main(String [] args)
   throws Exception
   {
     ToolConnection con = ToolConnectionFactory.createConnection(args[0], 60000);
     ToolResultSet rs = con.executeQuery("select JobDefinition.Name, JobDefinition.UniqueId from JobDefinition", null, null);
     while (rs.next())
     {
       System.out.println(rs.getString(1) + " = " + rs.getString(2));
     }
   }
 }
        Returns:
        a string representation of the query results.
        Throws:
        ToolException - if an exception occurs
        QueryException - if the query caused an error

      • uploadCAR

        public Map<String,​BigDecimal> uploadCAR​(File carFile,
                                              String importRuleSet)
                                       throws IOException,
                                              ToolException
        Description copied from interface: ToolConnection
        Upload a CAR file to the server.
        Specified by:
        uploadCAR in interface ToolConnection
        Parameters:
        carFile - the car file to upload, required.
        importRuleSet - the import rule set to use, may be null.
        Returns:
        a Map containing results from the server. The map will contain the job id of the submitted job, if the server supports it. The result will never be null, but may be an empty map
        Throws:
        IOException - if an IO exception occurs
        ToolException - if an exception occurs

      • uploadCAR

        public Map<String,​BigDecimal> uploadCAR​(File carFile,
                                              String importRuleSet,
                                              String targetPartition,
                                              Map<String,​String> ruleSetParameters)
                                       throws IOException,
                                              ToolException
        Description copied from interface: ToolConnection
        Upload a CAR file to the server.
        Specified by:
        uploadCAR in interface ToolConnection
        Parameters:
        carFile - the car file to upload, required.
        importRuleSet - the import rule set to use, may be null.
        targetPartition - the target partition, may be null.
        ruleSetParameters - the ruleSet parameters, may be null.
        Returns:
        a Map containing results from the server. The map will contain the job id of the submitted job, if the server supports it. The result will never be null, but may be an empty map
        Throws:
        IOException - if an IO exception occurs
        ToolException - if an exception occurs

      • uploadJAR

        public Map<String,​BigDecimal> uploadJAR​(File jarFile,
                                              String libraryName)
                                       throws IOException,
                                              ToolException
        Description copied from interface: ToolConnection
        Upload a JAR file to the server.
        Specified by:
        uploadJAR in interface ToolConnection
        Parameters:
        jarFile - the jar file to upload, required.
        libraryName - the library to upload it to, required.
        Returns:
        a Map containing results from the server. The map will contain the job id of the submitted job, if the server supports it. The result will never be null, but may be an empty map
        Throws:
        IOException - if an IO exception occurs
        ToolException - if an exception occurs

      • get

        public String get​(String newObjectType,
                  String newBusinessKey,
                  boolean search)
           throws ToolException,
                  IOException
        Description copied from interface: ToolConnection
        REST HTTP GET
        Specified by:
        get in interface ToolConnection
        Parameters:
        newObjectType - the object type to get from the REST server.
        newBusinessKey - the key of the object to get from the REST server
        search - if search is true then businessKey is a search pattern to match one or more objects
        Returns:
        the XML representation of the object
        Throws:
        ToolException - if an exception occurs
        IOException - if an IO exception occurs

      • get

        public String get​(String newObjectType,
                  String newBusinessKey,
                  boolean search,
                  String propertiesSet,
                  Set<String> includeProperties,
                  Set<String> excludeProperties)
           throws ToolException,
                  IOException
        Description copied from interface: ToolConnection
        REST HTTP GET
        Specified by:
        get in interface ToolConnection
        Parameters:
        newObjectType - the object type to get from the REST server.
        newBusinessKey - the key of the object to get from the REST server
        search - if search is true then businessKey is a search pattern to match one or more objects
        propertiesSet - is the name of the properties set to include in the returned XML
        includeProperties - are the properties to include on top of the given propertiesSet
        excludeProperties - are the properties to elide from the given propertiesSet
        Returns:
        the XML representation of the object
        Throws:
        ToolException - if an exception occurs
        IOException - if an IO exception occurs

      • get

        public File get​(String newObjectType,
                String newKey,
                String filename,
                String filepath,
                boolean search)
         throws ToolException,
                IOException
        Description copied from interface: ToolConnection
        REST HTTP GET
        Specified by:
        get in interface ToolConnection
        Parameters:
        newObjectType - the object type to get from the REST server.
        newKey - the key of the object to get from the REST server
        filename - the name of the file to be returned (optional)
        filepath - the path to store the file when it is downloaded
        search - if search is true then businessKey is a search pattern to match one or more objects
        Returns:
        the CAR file representation of the object
        Throws:
        ToolException - if an exception occurs
        IOException - if an IO exception occurs

      • list

        public String list​(String newObjectType,
                   String newFilter,
                   String newSearch,
                   boolean newStylesheet)
            throws ToolException,
                   IOException
        Description copied from interface: ToolConnection
        REST HTTP LIST
        Specified by:
        list in interface ToolConnection
        Parameters:
        newObjectType - is the list of objects requested
        newFilter - is the name of the query filter to apply when querying
        newSearch - is the search to use (on SearchName)
        newStylesheet - is to indicate if a stylesheet should be used to render the result. The stylesheet used the Document under path doc:/Redwood/REST/Custom_StyleSheet.xml, if that is not set, the default stylesheet doc:/Redwood/REST/Custom_StyleSheet.xml is used
        Returns:
        the list of objects
        Throws:
        ToolException - if an exception occurs
        IOException - if an IO exception occurs

      • list

        public String list​(String newObjectType,
                   String newFilter,
                   String newSearch,
                   String newCheck,
                   boolean newStylesheet)
            throws ToolException,
                   IOException
        Description copied from interface: ToolConnection
        REST HTTP LIST
        Specified by:
        list in interface ToolConnection
        Parameters:
        newObjectType - is the list of objects requested
        newFilter - is the name of the query filter to apply when querying
        newSearch - is the search to use (on SearchName)
        newCheck - is the name of the action that will be used to check if the object should be returned. This name will be passed into canPerform() and if it return false, it is not returned in the result. If null is passed in, the default "export" will be used, so only exportable objects will be returned. If the value "none" is passed in, no check will be performed.
        newStylesheet - is to indicate if a stylesheet should be used to render the result. The stylesheet used the Document under path doc:/Redwood/REST/Custom_StyleSheet.xml, if that is not set, the default stylesheet doc:/Redwood/REST/Custom_StyleSheet.xml is used
        Returns:
        the list of objects
        Throws:
        ToolException - if an exception occurs
        IOException - if an IO exception occurs

      • getJobFile

        public String getJobFile​(String newUniqueId,
                         String newDestination,
                         String defaultName)
                  throws ToolException,
                         IOException
        Description copied from interface: ToolConnection
        REST HTTP GET JOBFILE Get the jobfile identified by the given uniqueId, and store it in the given directory
        Specified by:
        getJobFile in interface ToolConnection
        Parameters:
        newUniqueId - is the uniqueId of the jobfile that must be retrieved
        newDestination - is the folder where the file will be written to
        defaultName - is the name that will be given to the file if the server does not provide with a name.
        Returns:
        the name of the file
        Throws:
        ToolException - if an exception occurs
        IOException - if an IO exception occurs

      • getRestCapabilitiesXML

        public String getRestCapabilitiesXML()
                              throws ToolException,
                                     IOException
        Description copied from interface: ToolConnection
        Retrieve the WADL file for the REST servlet. When this returns null, none was found (earlier version), and will not throw an exception, even though the server returned an error code.
        Specified by:
        getRestCapabilitiesXML in interface ToolConnection
        Returns:
        the WADL file if one exists
        Throws:
        ToolException - if an exception occurs
        IOException - if an IO exception occurs

      • scriptsList

        public String scriptsList()
                   throws ToolException,
                          IOException
        Description copied from interface: ToolConnection
        REST HTTP GET SCRIPTS-LIST This method returns all objects that have editable Redwood Script (JobDefinition, Trigger, ExtensionPoint etc.) either as a source, or via related objects like actions.
        Specified by:
        scriptsList in interface ToolConnection
        Returns:
        the objects that have editable Redwood Script
        Throws:
        ToolException - if an exception occurs
        IOException - if an IO exception occurs

      • getScripts

        public File getScripts​(Set<String> items,
                       String filename,
                       String filepath,
                       boolean includeLibraries)
                throws ToolException,
                       IOException
        Description copied from interface: ToolConnection
        REST HTTP POST
        Specified by:
        getScripts in interface ToolConnection
        Parameters:
        items - is the list of items to fetch from the server
        filename - the name of the file to be returned (optional)
        filepath - the path to store the file when it is downloaded
        includeLibraries - if true, it will also include the libraries that are referenced by the objects being requested.
        Returns:
        the CAR file representation of the object
        Throws:
        ToolException - if an exception occurs
        IOException - if an IO exception occurs