- * Precise to the second. - * - * @param time - * the specified number of milliseconds since the standard base - * time known as "the epoch", namely January 1, 1970, 00:00:00 - * GMT - * - * @return the time as a {@link String} - */ - static public String fromTime(long time) { - SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); - return sdf.format(new Date(time)); - } - - /** - * Convert between the time as a {@link String} to milliseconds in a "fixed" - * way (to exchange data over the wire, for instance). - *
- * Precise to the second. - * - * @param displayTime - * the time as a {@link String} - * - * @return the number of milliseconds since the standard base time known as - * "the epoch", namely January 1, 1970, 00:00:00 GMT, or -1 in case - * of error - * - * @throws ParseException - * in case of parse error - */ - static public long toTime(String displayTime) throws ParseException { - SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); - return sdf.parse(displayTime).getTime(); - } - - /** - * Return a hash of the given {@link String}. - * - * @param input - * the input data - * - * @return the hash - */ - static public String getMd5Hash(String input) { - try { - MessageDigest md = MessageDigest.getInstance("MD5"); - md.update(getBytes(input)); - byte byteData[] = md.digest(); - - StringBuffer hexString = new StringBuffer(); - for (int i = 0; i < byteData.length; i++) { - String hex = Integer.toHexString(0xff & byteData[i]); - if (hex.length() == 1) - hexString.append('0'); - hexString.append(hex); - } - - return hexString.toString(); - } catch (NoSuchAlgorithmException e) { - return input; - } - } - - /** - * Remove the HTML content from the given input, and un-html-ize the rest. - * - * @param html - * the HTML-encoded content - * - * @return the HTML-free equivalent content - */ - public static String unhtml(String html) { - StringBuilder builder = new StringBuilder(); - - int inTag = 0; - for (char car : html.toCharArray()) { - if (car == '<') { - inTag++; - } else if (car == '>') { - inTag--; - } else if (inTag <= 0) { - builder.append(car); - } - } - - char nbsp = 'Â '; // non-breakable space (a special char) - char space = ' '; - return HtmlEscape.unescapeHtml(builder.toString()).replace(nbsp, space); - } - - /** - * Escape the given {@link String} so it can be used in XML, as content. - * - * @param input - * the input {@link String} - * - * @return the escaped {@link String} - */ - public static String xmlEscape(String input) { - if (input == null) { - return ""; - } - - return HtmlEscape.escapeHtml(input, - HtmlEscapeType.HTML4_NAMED_REFERENCES_DEFAULT_TO_HEXA, - HtmlEscapeLevel.LEVEL_1_ONLY_MARKUP_SIGNIFICANT); - } - - /** - * Escape the given {@link String} so it can be used in XML, as text content - * inside double-quotes. - * - * @param input - * the input {@link String} - * - * @return the escaped {@link String} - */ - public static String xmlEscapeQuote(String input) { - if (input == null) { - return ""; - } - - return HtmlEscape.escapeHtml(input, - HtmlEscapeType.HTML4_NAMED_REFERENCES_DEFAULT_TO_HEXA, - HtmlEscapeLevel.LEVEL_1_ONLY_MARKUP_SIGNIFICANT); - } - - /** - * Zip the data and then encode it into Base64. - * - * @param data - * the data - * - * @return the Base64 zipped version - * - * @throws IOException - * in case of I/O error - */ - public static String zip64(String data) throws IOException { - try { - return zip64(getBytes(data)); - } catch (UnsupportedEncodingException e) { - // All conforming JVM are required to support UTF-8 - e.printStackTrace(); - return null; - } - } - - /** - * Zip the data and then encode it into Base64. - * - * @param data - * the data - * - * @return the Base64 zipped version - * - * @throws IOException - * in case of I/O error - */ - public static String zip64(byte[] data) throws IOException { - // 1. compress - ByteArrayOutputStream bout = new ByteArrayOutputStream(); - try { - OutputStream out = new GZIPOutputStream(bout); - try { - out.write(data); - } finally { - out.close(); - } - } finally { - data = bout.toByteArray(); - bout.close(); - } - - // 2. base64 - InputStream in = new ByteArrayInputStream(data); - try { - in = new Base64InputStream(in, true); - return new String(IOUtils.toByteArray(in), "UTF-8"); - } finally { - in.close(); - } - } - - /** - * Unconvert from Base64 then unzip the content, which is assumed to be a - * String. - * - * @param data - * the data in Base64 format - * - * @return the raw data - * - * @throws IOException - * in case of I/O error - */ - public static String unzip64s(String data) throws IOException { - return new String(unzip64(data), "UTF-8"); - } - - /** - * Unconvert from Base64 then unzip the content. - * - * @param data - * the data in Base64 format - * - * @return the raw data - * - * @throws IOException - * in case of I/O error - */ - public static byte[] unzip64(String data) throws IOException { - InputStream in = new Base64InputStream(new ByteArrayInputStream( - getBytes(data)), false); - try { - in = new GZIPInputStream(in); - return IOUtils.toByteArray(in); - } finally { - in.close(); - } - } - - /** - * Convert the given data to Base64 format. - * - * @param data - * the data to convert - * - * @return the Base64 {@link String} representation of the data - * - * @throws IOException - * in case of I/O errors - */ - public static String base64(String data) throws IOException { - return base64(getBytes(data)); - } - - /** - * Convert the given data to Base64 format. - * - * @param data - * the data to convert - * - * @return the Base64 {@link String} representation of the data - * - * @throws IOException - * in case of I/O errors - */ - public static String base64(byte[] data) throws IOException { - Base64InputStream in = new Base64InputStream(new ByteArrayInputStream( - data), true); - try { - return new String(IOUtils.toByteArray(in), "UTF-8"); - } finally { - in.close(); - } - } - - /** - * Unconvert the given data from Base64 format back to a raw array of bytes. - * - * @param data - * the data to unconvert - * - * @return the raw data represented by the given Base64 {@link String}, - * - * @throws IOException - * in case of I/O errors - */ - public static byte[] unbase64(String data) throws IOException { - Base64InputStream in = new Base64InputStream(new ByteArrayInputStream( - getBytes(data)), false); - try { - return IOUtils.toByteArray(in); - } finally { - in.close(); - } - } - - /** - * Unonvert the given data from Base64 format back to a {@link String}. - * - * @param data - * the data to unconvert - * - * @return the {@link String} represented by the given Base64 {@link String} - * - * @throws IOException - * in case of I/O errors - */ - public static String unbase64s(String data) throws IOException { - return new String(unbase64(data), "UTF-8"); - } - - /** - * Return a display {@link String} for the given value, which can be - * suffixed with "k" or "M" depending upon the number, if it is big enough. - *
- *
- * Examples: - *
- * Examples (assuming decimalPositions = 1): - *
- * Of course, the conversion to and from display form is lossy (example: - * 6870 to "6.5k" to 6500). - * - * @param value - * the value in display form with possible "M" and "k" suffixes, - * can be NULL - * - * @return the value as a number, or 0 if not possible to convert - */ - public static long toNumber(String value) { - return toNumber(value, 0l); - } - - /** - * The reverse operation to {@link StringUtils#formatNumber(long)}: it will - * read a "display" number that can contain a "M" or "k" suffix and return - * the full value. - *
- * Of course, the conversion to and from display form is lossy (example:
- * 6870 to "6.5k" to 6500).
- *
- * @param value
- * the value in display form with possible "M" and "k" suffixes,
- * can be NULL
- * @param def
- * the default value if it is not possible to convert the given
- * value to a number
- *
- * @return the value as a number, or 0 if not possible to convert
- */
- public static long toNumber(String value, long def) {
- long count = def;
- if (value != null) {
- value = value.trim().toLowerCase();
- try {
- long mult = 1;
- if (value.endsWith("g")) {
- value = value.substring(0, value.length() - 1).trim();
- mult = 1000000000;
- } else if (value.endsWith("m")) {
- value = value.substring(0, value.length() - 1).trim();
- mult = 1000000;
- } else if (value.endsWith("k")) {
- value = value.substring(0, value.length() - 1).trim();
- mult = 1000;
- }
-
- long deci = 0;
- if (value.contains(".")) {
- String[] tab = value.split("\\.");
- if (tab.length != 2) {
- throw new NumberFormatException(value);
- }
- double decimal = Double.parseDouble("0."
- + tab[tab.length - 1]);
- deci = ((long) (mult * decimal));
- value = tab[0];
- }
- count = mult * Long.parseLong(value) + deci;
- } catch (Exception e) {
- }
- }
-
- return count;
- }
-
- /**
- * Return the bytes array representation of the given {@link String} in
- * UTF-8.
- *
- * @param str
- * the {@link String} to transform into bytes
- * @return the content in bytes
- */
- static public byte[] getBytes(String str) {
- try {
- return str.getBytes("UTF-8");
- } catch (UnsupportedEncodingException e) {
- // All conforming JVM must support UTF-8
- e.printStackTrace();
- return null;
- }
- }
-
- /**
- * The "remove accents" pattern.
- *
- * @return the pattern, or NULL if a problem happens
- */
- private static Pattern getMarks() {
- try {
- return Pattern
- .compile("[\\p{InCombiningDiacriticalMarks}\\p{IsLm}\\p{IsSk}]+");
- } catch (Exception e) {
- // Can fail on Android...
- return null;
- }
- }
-
- //
- // justify List
- * Note that we consider an empty line as full, and a line ending with
- * spaces as not complete.
- *
- * @param line
- * the line to check
- *
- * @return TRUE if it does
- */
- static private boolean isFullLine(StringBuilder line) {
- if (line.length() == 0) {
- return true;
- }
-
- char lastCar = line.charAt(line.length() - 1);
- switch (lastCar) {
- case '.': // points
- case '?':
- case '!':
-
- case '\'': // quotes
- case 'â':
- case 'â':
-
- case '"': // double quotes
- case 'â':
- case 'â':
- case '»':
- case '«':
- return true;
- default:
- return false;
- }
- }
-
- /**
- * Check if this line represent an item in a list or description (i.e.,
- * check that the first non-space char is "-").
- *
- * @param line
- * the line to check
- *
- * @return TRUE if it is
- */
- static private boolean isItemLine(String line) {
- String spacing = getItemSpacing(line);
- return spacing != null && !spacing.isEmpty()
- && line.charAt(spacing.length()) == '-';
- }
-
- /**
- * Return all the spaces that start this line (or Empty if none).
- *
- * @param line
- * the line to get the starting spaces from
- *
- * @return the left spacing
- */
- static private String getItemSpacing(String line) {
- int i;
- for (i = 0; i < line.length(); i++) {
- if (line.charAt(i) != ' ') {
- return line.substring(0, i);
- }
- }
-
- return "";
- }
-
- /**
- * This line is an horizontal spacer line.
- *
- * @param line
- * the line to test
- *
- * @return TRUE if it is
- */
- static private boolean isHrLine(CharSequence line) {
- int count = 0;
- if (line != null) {
- for (int i = 0; i < line.length(); i++) {
- char car = line.charAt(i);
- if (car == ' ' || car == '\t' || car == '*' || car == '-'
- || car == '_' || car == '~' || car == '=' || car == '/'
- || car == '\\') {
- count++;
- } else {
- return false;
- }
- }
- }
-
- return count > 2;
- }
-
- // Deprecated functions, please do not use //
-
- /**
- * @deprecated please use {@link StringUtils#zip64(byte[])} or
- * {@link StringUtils#base64(byte[])} instead.
- *
- * @param data
- * the data to encode
- * @param zip
- * TRUE to zip it before Base64 encoding it, FALSE for Base64
- * encoding only
- *
- * @return the encoded data
- *
- * @throws IOException
- * in case of I/O error
- */
- @Deprecated
- public static String base64(String data, boolean zip) throws IOException {
- return base64(getBytes(data), zip);
- }
-
- /**
- * @deprecated please use {@link StringUtils#zip64(String)} or
- * {@link StringUtils#base64(String)} instead.
- *
- * @param data
- * the data to encode
- * @param zip
- * TRUE to zip it before Base64 encoding it, FALSE for Base64
- * encoding only
- *
- * @return the encoded data
- *
- * @throws IOException
- * in case of I/O error
- */
- @Deprecated
- public static String base64(byte[] data, boolean zip) throws IOException {
- if (zip) {
- return zip64(data);
- }
-
- Base64InputStream b64 = new Base64InputStream(new ByteArrayInputStream(
- data), true);
- try {
- return IOUtils.readSmallStream(b64);
- } finally {
- b64.close();
- }
- }
-
- /**
- * @deprecated please use {@link Base64OutputStream} and
- * {@link GZIPOutputStream} instead.
- *
- * @param breakLines
- * NOT USED ANYMORE, it is always considered FALSE now
- */
- @Deprecated
- public static OutputStream base64(OutputStream data, boolean zip,
- boolean breakLines) throws IOException {
- OutputStream out = new Base64OutputStream(data);
- if (zip) {
- out = new java.util.zip.GZIPOutputStream(out);
- }
-
- return out;
- }
-
- /**
- * Unconvert the given data from Base64 format back to a raw array of bytes.
- *
- * Will automatically detect zipped data and also uncompress it before
- * returning, unless ZIP is false.
- *
- * @deprecated DO NOT USE ANYMORE (bad perf, will be dropped)
- *
- * @param data
- * the data to unconvert
- * @param zip
- * TRUE to also uncompress the data from a GZIP format
- * automatically; if set to FALSE, zipped data can be returned
- *
- * @return the raw data represented by the given Base64 {@link String},
- * optionally compressed with GZIP
- *
- * @throws IOException
- * in case of I/O errors
- */
- @Deprecated
- public static byte[] unbase64(String data, boolean zip) throws IOException {
- byte[] buffer = unbase64(data);
- if (!zip) {
- return buffer;
- }
-
- try {
- GZIPInputStream zipped = new GZIPInputStream(
- new ByteArrayInputStream(buffer));
- try {
- ByteArrayOutputStream out = new ByteArrayOutputStream();
- try {
- IOUtils.write(zipped, out);
- return out.toByteArray();
- } finally {
- out.close();
- }
- } finally {
- zipped.close();
- }
- } catch (Exception e) {
- return buffer;
- }
- }
-
- /**
- * Unconvert the given data from Base64 format back to a raw array of bytes.
- *
- * Will automatically detect zipped data and also uncompress it before
- * returning, unless ZIP is false.
- *
- * @deprecated DO NOT USE ANYMORE (bad perf, will be dropped)
- *
- * @param data
- * the data to unconvert
- * @param zip
- * TRUE to also uncompress the data from a GZIP format
- * automatically; if set to FALSE, zipped data can be returned
- *
- * @return the raw data represented by the given Base64 {@link String},
- * optionally compressed with GZIP
- *
- * @throws IOException
- * in case of I/O errors
- */
- @Deprecated
- public static InputStream unbase64(InputStream data, boolean zip)
- throws IOException {
- return new ByteArrayInputStream(unbase64(IOUtils.readSmallStream(data),
- zip));
- }
-
- /**
- * @deprecated DO NOT USE ANYMORE (bad perf, will be dropped)
- */
- @Deprecated
- public static byte[] unbase64(byte[] data, int offset, int count,
- boolean zip) throws IOException {
- byte[] dataPart = Arrays.copyOfRange(data, offset, offset + count);
- return unbase64(new String(dataPart, "UTF-8"), zip);
- }
-
- /**
- * @deprecated DO NOT USE ANYMORE (bad perf, will be dropped)
- */
- @Deprecated
- public static String unbase64s(String data, boolean zip) throws IOException {
- return new String(unbase64(data, zip), "UTF-8");
- }
-
- /**
- * @deprecated DO NOT USE ANYMORE (bad perf, will be dropped)
- */
- @Deprecated
- public static String unbase64s(byte[] data, int offset, int count,
- boolean zip) throws IOException {
- return new String(unbase64(data, offset, count, zip), "UTF-8");
- }
-}