org.josql.contrib
Class JoSQLAntFileSelector

java.lang.Object
  org.josql.Query
      org.josql.contrib.JoSQLAntFileSelector

public class JoSQLAntFileSelector
extends Query

A custom file selector for use with Ant.

See: Custom Ant Selectors for more details.

Allows a JoSQL WHERE clause to be applied to each file passed to the selector isSelected(File,String,File).

An obvious question to ask here is "why do I need this when Ant has lots of custom file selectors". Well, in short, you don't "need" this selector, but I've found that trying to remember all the custom elements and their attributes can be painful and doesn't give me all the power needed to select the files I want. This custom selector however does.

The selector supports the following "param"s.

• where - multiple where params are supported, the value of each param is concatenated with the others to form the full WHERE clause. It is up to you to decide how you split up your where clause.
• debug - when set to on (case-insensitive) debug information about the WHERE clause actually used and for each file passed to isSelected(File,String,File) what the WHERE clause evaluated to, either true or false.

Usage:

A typical usage may be:

   <fileset dir="myDir" 
            includes="**">
     <custom classpath="[PATH_TO_JOSQL]/JoSQL-1.0.jar:[PATH_TO_JOSQL]/3rd-party-jars/gentlyWEB-utils-1.1.jar"
             classname="org.josql.contrib.JoSQLAntFileSelector">
       <param name="debug" value="on" />
       <param name="where" value="toDate (lastModified) > toDate ('22/Sep/2005')" />
       <param name="where" value="AND length > 10000" />
     </custom>
   </fileset>
 

This will create a file set containing all the files modified after 22/Sep/2005 and have a length greater than 10000 bytes.

Compare this to how it would be "normally" be done with standard Ant fileset selectors:

   <fileset dir="myDir" 
            includes="**">
     <date datetime="22/Sep/2005"
           pattern="dd/MMM/yyyy"
           when="after" />
     <size value="10000"
           when="more" />
   </fileset>
 

Of course it is perfectly possible to mix and match this selector and other custom selectors or the built-in selectors.

Field Summary

static String	DEBUG
static String	WHERE

Fields inherited from class org.josql.Query

ALL, ALL_OBJS_VAR_NAME, CURR_OBJ_VAR_NAME, GROUP_BY_RESULTS, GRPBY_OBJ_VAR_NAME, GRPBY_OBJ_VAR_NAME_SYNONYM, HAVING_RESULTS, INT_BIND_VAR_PREFIX, nullQueryList, ORDER_BY_ASC, ORDER_BY_DESC, PARENT_BIND_VAR_NAME, QUERY_BIND_VAR_NAME, RESULTS, WHERE_RESULTS

Constructor Summary

JoSQLAntFileSelector()

Method Summary

boolean	isSelected(File basedir, String filename, File file)
void	setParameters(Parameter[] parms)

Methods inherited from class org.josql.Query

addBindVariableChangedListener, addFunctionHandler, addSaveValueChangedListener, addTiming, doExecuteOn, execute, execute, execute, fireBindVariableChangedEvent, fireSaveValueChangedEvent, getAliases, getAllObjects, getAnonymousBindVariableName, getClassLoader, getColumns, getCurrentObject, getDefaultFunctionHandlers, getExecuteOnFunctions, getFrom, getFromObjectClass, getFunctionHandler, getFunctionHandlers, getGroupByColumns, getGroupBySaveValue, getGroupBySaveValues, getGroupByVariable, getHavingClause, getLimit, getOrderByColumns, getOrderByComparator, getParent, getQuery, getQueryResults, getSaveValue, getTopLevelQuery, getVariable, getVariable, getVariableClass, getVariables, getWhereClause, getWildcardCharacter, init, initOrderByComparator, isWantObjects, isWhereTrue, loadClass, parse, parseAndExec, parsed, removeBindVariableChangedListener, removeSaveValueChangedListener, reorder, reorder, setAllObjects, setClassLoader, setClassName, setColumns, setCurrentGroupByObjects, setCurrentObject, setExecuteOnFunctions, setFrom, setFromObjectClass, setGroupByColumns, setGroupByLimit, setGroupByOrderColumns, setHaving, setLimit, setOrderByColumns, setParent, setSaveValue, setSaveValues, setVariable, setVariable, setVariables, setWantDistinctResults, setWantObjects, setWantTimings, setWhere, setWildcardCharacter, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

WHERE

public static final String WHERE

See Also:

Constant Field Values

DEBUG

public static final String DEBUG

See Also:

Constant Field Values

Constructor Detail

JoSQLAntFileSelector

public JoSQLAntFileSelector()

Method Detail

setParameters

public void setParameters(Parameter[] parms)

isSelected

public boolean isSelected(File basedir,
                          String filename,
                          File file)
                   throws BuildException

Throws:

BuildException