}
        this.defaultEncoding = defaultEncoding;
    }

    /**
     * Adds an encoding mapping from source to target encoding.
     *
     * @param source the source encoding name
     * @param target the target encoding name
     * @throws IllegalArgumentException if source or target is blank
     */
    public void addEncodingMapping(final String source, final String target) {

   * lies outside that, then {@link #escapeUnsafe} is called, otherwise no escaping is performed.
   *
   * @param replacementMap a map of characters to their escaped representations
   * @param safeMin the lowest character value in the safe range
   * @param safeMax the highest character value in the safe range
   * @param unsafeReplacement the default replacement for unsafe characters or null if no default
   *     replacement is required
   */

     *
     * @param o
     *            the object to convert
     * @return the converted {@link Long}
     */
    public static Long toLong(final Object o) {
        return toLong(o, null);
    }

    /**
     * Converts the given object to a {@link Long}.
     *
     * @param o
     *            the object to convert
     * @param pattern
     *            the pattern string

    /**
     * Sets the message ID.
     *
     * @param k the message ID to set
     */
    void setMid(long k);

    /**
     * Gets the message ID.
     *
     * @return mid
     */
    long getMid();

    /**
     * Verifies the signature of this response.
     *
     * @param buffer the buffer containing the signature data
     * @param i the starting index in the buffer

         *
         * @param lang the language to use for normalization
         */
        protected LangAnalyzerNormalizer(final String lang) {
            this.lang = lang;
        }

        /**
         * Normalizes the given text based on the specified field.
         *
         * @param text  the text to normalize
         * @param field the field to use for normalization

    //                                                                      ==============
    /**
     * Create the access context.
     * @param resource The access context resource.
     * @param userTypeSupplier The supplier of user type.
     * @param userBeanSupplier The supplier of user bean.
     * @param appTypeSupplier The supplier of application type.
     * @return The access context.
     */

     */
    protected InputStreamUtil() {
    }

    /** Default buffer size. */
    private static final int BUF_SIZE = 4096;

    /**
     * Creates a {@link FileInputStream}.
     *
     * @param file the file (must not be {@literal null})
     * @return a {@link FileInputStream} to read from the file
     * @see FileInputStream#FileInputStream(File)
     */
    public static FileInputStream create(final File file) {

    private final DcerpcHandle handle;
    private boolean opened;

    /**
     * Creates a new SAM domain handle.
     *
     * @param handle the DCE/RPC handle for communication
     * @param policyHandle the policy handle for this domain
     * @param access the desired access rights
     * @param sid the security identifier of the domain
     * @throws IOException if an I/O error occurs during handle creation
     */

    /**
     * @param useCachedSettings if true, doesn't reload the user settings
     * @return a <code>Settings</code> object from the user settings file.
     * @throws IOException if any
     * @throws XmlPullParserException if any
     */
    Settings buildSettings(boolean useCachedSettings) throws IOException, XmlPullParserException;

    /**
     * @param userSettingsFile a given user settings file

  }

  /**
   * Waits for the {@link Service} to reach the {@linkplain State#RUNNING running state} for no more
   * than the given time.
   *
   * @param timeout the maximum time to wait
   * @param unit the time unit of the timeout argument
   * @throws TimeoutException if the service has not reached the given state within the deadline