/*
* Smart GWT (GWT for SmartClient)
* Copyright 2008 and beyond, Isomorphic Software, Inc.
*
* Smart GWT is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License version 3
* is published by the Free Software Foundation. Smart GWT is also
* available under typical commercial license terms - see
* http://smartclient.com/license
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*/
//package com.smartgwt.client.util;
public class StringUtil {
/**
* Convert all tag symbols ( < and > ) into displayable HTML
* by changing them to < and > respectively.
*
* @param str the string to convert
* @param prefix text to tack onto the beginning of result (eg: "<PRE>")
* @param suffix text to tack onto the end of result (eg: "</PRE>")
* @return prefix + converted text + suffix as a single string
*/
public static native String convertTags(String str, String prefix, String suffix)/*-{
return str == null ? null : new $wnd.String(str).convertTags(prefix, suffix);
}-*/;
/**
* Convert plain text into into displayable HTML.
*
* This prevents HTML-special characters like < and > from being interpreted as tags, and
* preserves line breaks and extra spacing.
*
* converts to
* -------- ---------------------------
* & &
* < <
* > >
* \r,\n,\r\n1space
* \r,\n,\r\n
* \t
* 2 spaces 1space
*
*
* @param str the string to convert
* @return the plain text into into displayable HTM
*/
public static native String asHTML(String str)/*-{
return str == null ? null : new $wnd.String(str).asHTML();
}-*/;
/**
* Convert plain text into into displayable HTML.
*
* This prevents HTML-special characters like < and > from being interpreted as tags, and
* preserves line breaks and extra spacing.
*
* converts to
* -------- ---------------------------
* & &
* < <
* > >
* \r,\n,\r\n1space
* \r,\n,\r\n
* \t
* 2 spaces 1space
*
*
* @param str the string to convert
* @param noAutoWrap
* @return the plain text into into displayable HTM
*/
public static native String asHTML(String str, boolean noAutoWrap)/*-{
return str == null ? null : new $wnd.String(str).asHTML(noAutoWrap);
}-*/;
/**
* Reverses {@link #asHTML(String)}.
*
* @param str the input str
* @return unescaped HTML
*/
public static native String unescapeHTML(String str)/*-{
return str == null ? null : new $wnd.String(str).unescapeHTML();
}-*/;
/**
* Escapes special characters in XML values - so called 'unparsed data'
*
* " -> "
* ' -> '
* & -> &
* < -> <
* > -> >
* \r -> &x000D;
*
*
* @param str the String to escape
* @return xml safe String
*/
public static native String makeXMLSafe(String str)/*-{
return str == null ? null : $wnd.isc.makeXMLSafe(str);
}-*/;
/**
* Abbreviates a String using ellipses. StringUtils.abbreviate("abcdefg", 6) = "abc..."
*
* @param str the String to abbreviate
* @param maxWidth maximum length of result String, must be at least 4
* @return the abbreviated String
* @throws IllegalArgumentException when the width is too small
*/
public static String abbreviate(String str, int maxWidth) {
if (str == null) {
return null;
}
if (str.length() < maxWidth) {
return str;
}
if (maxWidth < 4) {
throw new IllegalArgumentException("Minimum required width is 4");
}
return str.substring(0, maxWidth - 3) + "...";
}
}
SmartGWT.zip( 9,880 k)