private Strings() {
    }

    /**
     * Encodes a string into bytes using the specified encoding.
     *
     * @param str the string to encode
     * @param encoding the character encoding to use
     * @return encoded byte array, or empty array if str is null
     */
    public static byte[] getBytes(final String str, final Charset encoding) {
        if (str == null) {
            return new byte[0];
        }

        assertFileExistence(dir, filename, true);

        File file = new File(dir, filename);

        String contents = FileUtils.fileRead(file, encoding);

        assertEquals(contentsTest, contents);
    }

    public File createFile(File dir, String filename, String contents, String encoding) throws IOException {

     */
    void setData(byte[] data);

    /**
     * Retrieves the encoding used for the access result data.
     *
     * @return the encoding as a String.
     */
    String getEncoding();

    /**
     * Sets the encoding for the access result data.
     *
     * @param encoding the encoding to set
     */
    void setEncoding(String encoding);

 * It allows setting a default encoding, mapping various encoding names to preferred ones,
 * and normalizing an encoding string to its preferred form or the default if no mapping is found.
 */
public class EncodingHelper {

    /** The default encoding to use when no mapping is found */
    protected String defaultEncoding;

    /** Map of encoding names to their preferred forms */

     * @param params The parameter string.
     * @param paramList Additional parameters.
     * @param encoding The encoding.
     * @return The HttpEntity containing the parsed parameters.
     */
    protected HttpEntity parseRequestParameters(final String params, final List<Pair<String, String>> paramList, final String encoding) {
        try {
            final List<BasicNameValuePair> parameters =

    /**
     * Reads text from a file with the specified encoding.
     *
     * @param path
     *            The file path. Must not be {@literal null} or empty.
     * @param encoding
     *            The encoding. Must not be {@literal null} or empty.
     * @return The text read from the file.
     */
    public static String readText(final String path, final String encoding) {
        assertArgumentNotEmpty("path", path);

    }

    /**
     * Gets the encoding used for the response content.
     *
     * @return the encoding.
     */
    public String getEncoding() {
        return encoding;
    }

    /**
     * Sets the encoding for the response content.
     *
     * @param encoding the encoding to set.
     */
    public void setEncoding(final String encoding) {
        this.encoding = encoding;
    }

                        logger.debug("Invalid encoding: {}, using default: {}", encodingParam, encoding, e);
                    }
                }
            }
        }
        return Charset.forName(encoding);
    }

    /**
     * Sets the encoding for CSV files.
     *
     * @param encoding the encoding
     */
    public void setEncoding(final String encoding) {
        this.encoding = encoding;
    }

            throw new ExtractException("Failed to extract text content using encoding: " + getEncoding(), e);
        }
    }

    /**
     * Returns the encoding used for text extraction.
     * @return the encoding
     */
    public String getEncoding() {
        return encoding;
    }

    /**
     * Sets the encoding.
     * @param encoding The encoding to set.
     */
    public void setEncoding(final String encoding) {

            assertTrue("Error message should contain encoding information", e.getMessage().contains("encoding"));
            assertTrue("Error message should contain the specific encoding", e.getMessage().contains(customEncoding));
            assertTrue("Error message should indicate extraction failure", e.getMessage().contains("Failed to extract"));
        } finally {
            // Reset to default encoding
            textExtractor.setEncoding("UTF-8");