* Converts an object to {@link Date}.
     *
     * @param src the source object
     * @return the converted {@link Date}
     */
    public static Date toDate(final Object src) {
        return toDate(src, null, LocaleUtil.getDefault());
    }

    /**
     * Converts an object to {@link Date}.
     *
     * @param src the source object
     * @param pattern the pattern string

     * <p>
     * Returns <code>null</code> if the protocol of the URL is unknown.
     * </p>
     *
     * @param url
     *            The URL of the resource.
     * @param rootPackage
     *            The root package.
     * @param rootDir
     *            The root directory.
     * @return A {@link Traverser} for handling the specified URL.
     */

    //                                               Details
    //                                               -------
    /**
     * Show the details page.
     * @param dictId The dictionary ID.
     * @param crudMode The CRUD mode.
     * @param id The ID of the char mapping item.
     * @return The HTML response.
     */
    @Execute
    @Secured({ ROLE, ROLE + VIEW })

    }

    /**
     * Get a DFS referral for the specified target
     *
     * @param tf the CIFS context
     * @param trans the SMB transport
     * @param target the target path
     * @param targetDomain the target domain
     * @param targetHost the target host
     * @param root the DFS root
     * @param path the DFS path
     * @return the DFS referral data or null if not found

     * value containing a <code>delim</code> separated list of host names and/or
     * ip addresses.
     *
     * @param props the properties to search in
     * @param key the property key to look up
     * @param delim the delimiter to use for splitting the property value
     * @param def the default value to return if key is not found
     * @return an array of InetAddress objects or the default value
     */

 */
public interface StorageClient extends AutoCloseable {

    /**
     * Uploads an object to storage.
     *
     * @param objectName the name/path for the object
     * @param inputStream the input stream of data to upload
     * @param size the size of the data in bytes
     * @param contentType the MIME type of the content
     */
    void uploadObject(String objectName, InputStream inputStream, long size, String contentType);

    }

    /**
     * Common method to delete words by kind.
     *
     * @param index The index name
     * @param freqField The frequency field name
     * @param kindToRemove The kind to remove
     * @param freqSetter The consumer to set frequency to 0
     * @param excludeKinds The kinds to exclude from deletion
     * @return The SuggestDeleteResponse
     */

     * @param query The query string.
     */
    public void setQuery(final String query) {
        this.query = query;
    }

    /**
     * Adds a tag to filter by.
     * @param tag The tag.
     */
    public void addTag(final String tag) {
        tags.add(tag);
    }

    /**
     * Adds a role to filter by.
     * @param role The role.
     */

     *
     * @param tf the CIFS context
     * @param domain the domain name
     * @return connection to the domain controller
     * @throws CIFSException if the connection fails
     */
    SmbTransport getDc(CIFSContext tf, String domain) throws CIFSException;

    /**
     * Resolve the location of a DFS path
     *
     * @param domain the domain for the DFS referral

     * Default implementation delegates to the basic process method.
     *
     * @param target the document data to process
     * @param params the data store parameters
     * @return the processed document data
     */
    public Map<String, Object> process(final Map<String, Object> target, final DataStoreParams params) {
        return process(target);
    }

    /**