Values passed to the getCommand(String) method should use this as the delimiter between the "catalog" name and the "command" name.

 abstract public  void addCatalog(String name,
    Catalog catalog)
Adds a named instance of Catalog to the factory (for subsequent
retrieval later).

 public static  void clear() 
{
        synchronized (factories) {
            factories.remove(getClassLoader());
        }
}

Clear all references to registered catalogs, as well as to the relevant class loader. This method should be called, for example, when a web application utilizing this class is removed from service, to allow for garbage collection.

 abstract public Catalog getCatalog()
Gets the default instance of Catalog associated with the factory
(if any); otherwise, return null.

 abstract public Catalog getCatalog(String name)
Retrieves a Catalog instance by name (if any); otherwise
return null.

 public Command getCommand(String commandID) 
{
    // --------------------------------------------------------- Public Methods
        String commandName = commandID;
        String catalogName = null;
        Catalog catalog = null;
        if (commandID != null) {
            int splitPos = commandID.indexOf(DELIMITER);
            if (splitPos != -1) {
                catalogName = commandID.substring(0, splitPos);
                commandName = commandID.substring(splitPos + DELIMITER.length());
                if (commandName.indexOf(DELIMITER) != -1) {
                    throw new IllegalArgumentException("commandID [" +
                                                       commandID +
                                                       "] has too many delimiters (reserved for future use)");
                }
            }
        }
        if (catalogName != null) {
            catalog = this.getCatalog(catalogName);
            if (catalog == null) {
                Log log = LogFactory.getLog(CatalogFactory.class);
                log.warn("No catalog found for name: " + catalogName + ".");
                return null;
            }
        } else {
            catalog = this.getCatalog();
            if (catalog == null) {
                Log log = LogFactory.getLog(CatalogFactory.class);
                log.warn("No default catalog found.");
                return null;
            }
        }
        return catalog.getCommand(commandName);
}

Return a Command based on the given commandID.

At this time, the structure of commandID is relatively simple: if the commandID contains a DELIMITER, treat the segment of the commandID up to (but not including) the DELIMITER as the name of a catalog, and the segment following the DELIMITER as a command name within that catalog. If the commandID contains no DELIMITER, treat the commandID as the name of a command in the default catalog.

To preserve the possibility of future extensions to this lookup mechanism, the DELIMITER string should be considered reserved, and should not be used in command names. commandID values which contain more than one DELIMITER will cause an IllegalArgumentException to be thrown.

 public static CatalogFactory getInstance() 
{
    // -------------------------------------------------------- Static Methods
        CatalogFactory factory = null;
        ClassLoader cl = getClassLoader();
        synchronized (factories) {
            factory = (CatalogFactory) factories.get(cl);
            if (factory == null) {
                factory = new CatalogFactoryBase();
                factories.put(cl, factory);
            }
        }
        return factory;
}

Return the singleton CatalogFactory instance for the relevant ClassLoader. For applications that use a thread context class loader (such as web applications running inside a servet container), this will return a separate instance for each application, even if this class is loaded from a shared parent class loader.

 abstract public Iterator getNames()
Return an Iterator over the set of named
Catalog s known to this CatalogFactory .
If there are no known catalogs, an empty Iterator is returned.

 abstract public  void setCatalog(Catalog catalog)
Sets the default instance of Catalog associated with the factory.