DomUtil (domui :: domui-core 1.1 API)

java.lang.Object
- to.etc.domui.util.DomUtil

public final class DomUtil
extends Object

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static interface DomUtil.IPerNode
Functor interface to handle tree walking.

Nested Classes
Modifier and Type	Class and Description
`static interface`	`DomUtil.IPerNode` Functor interface to handle tree walking.

Field Summary

Fields
Modifier and Type Field and Description

static String DOCROOT

static org.slf4j.Logger USERLOG

Fields
Modifier and Type	Field and Description
`static String`	`DOCROOT`
`static org.slf4j.Logger`	`USERLOG`

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static List<UIMessage>`	`addSingleShotMessage(NodeBase node, UIMessage message)`
`static void`	`addUrlParameters(StringBuilder sb, IPageParameters ctx, boolean first)`
`static void`	`addUrlParameters(StringBuilder sb, IPageParameters ctx, boolean first, Set<String> skipset)`
`static void`	`addUrlParameters(StringBuilder sb, IRequestContext ctx, boolean first)`
`static void`	`adjustTableColspans(Table table)` Walks the entire table and adjusts it's colspans.
`static List<NodeContainer>`	`appendContainer(List<NodeContainer> stack, NodeContainer it)`
`static <T> T`	`badCheck(T in)` Deprecated.
`static void`	`balanceTable(Table t)` This balances tables to ensure that all rows have an equal number of rows and columns, taking rowspans and colspans into effect.
`static void`	`buildTree(NodeBase p)` Ensures that all of a node tree has been built.
`static String`	`calcNodeText(NodeContainer nc)` Try to get some content text from this node, for displaying what the node "is".
`static String`	`calcPageLabel(Class<?> clz)` Lookup a page Title bar text..
`static String`	`calcPageTitle(Class<?> clz)` Lookup a page Title bar text..
`static String`	`calculateURL(IRequestContext ci, String rurl)` Calculate a full URL from a rurl.
`static boolean`	`classResourceExists(Class<?> clz, String name)` Returns T if the given Java Resource exists.
`static void`	`clearModifiedFlag(NodeBase root)` This clears the 'modified' flag for all nodes in the subtree that implement `IHasModifiedIndication`.
`static <T> boolean`	`contains(T[] array, T lookingFor)` Util that returns T if lookingFor object is contained in specified array
`static <V,T extends IIdentifyable<V>> boolean`	`containsLongIdentifyable(Collection<T> set, T lookingFor)` Util can be used to check if list contains item that has equal Long Id as specified one, while instanies itself does not need to be equal.
`static String`	`convertToID(String id)`
`static String`	`createOpenWindowJS(Class<?> targetClass, IPageParameters targetParameters, WindowParameters newWindowParameters)` This opens a new DomUI page, immediately creating a session for it.
`static String`	`createOpenWindowJS(String url, WindowParameters newWindowParameters)`
`static String`	`createPageRURL(Class<? extends UrlPage> clz, IPageParameters pp)` Create a relative URL for the specified page (an URL that is relative to the application's context, i.e.
`static String`	`createPageURL(Class<? extends UrlPage> clz, IPageParameters pp)` IMPORTANT: This method MUST be used only within UI threads, when UIContext.getRequestContext() != null! In all other, usually background running threads, other alternatives that are using stored appURL must be used!
`static String`	`createPageURL(String webAppUrl, Class<? extends UrlPage> clz, IPageParameters pp)` IMPORTANT: This method MUST be used for non UI threads, when UIContext.getRequestContext() == null! In all other, usually UI running threads, use other alternatives that is using appURL from UIContext.getRequestContext()!
`static String`	`createPageURL(String rurl, IPageParameters pageParameters)` Generate an URL to some page with parameters.
`static String`	`createRandomColor()`
`static void`	`dumpException(Exception x)`
`static void`	`dumpException(StringBuilder sb, Throwable x)`
`static void`	`dumpExceptionIfSevere(Exception x)` This method will first determine whether the exception is considered severe.
`static void`	`dumpRequest(javax.servlet.http.HttpServletRequest req)`
`static BundleRef`	`findBundle(UIMenu ma, Class<?> clz)`
`static Class<?>`	`findClass(ClassLoader cl, String name)`
`static <T extends NodeBase> T`	`findComponentInTree(NodeBase p, Class<T> clz)` Walks the tree starting at the node passed and returns the first instance of the given class that is found in a normal walk of the tree.
`static BundleRef`	`findPageBundle(UrlPage urlPage)` Locates the default page bundle for a page.
`static String`	`generateGUID()` Generate an unique identifier with reasonable expectations that it will be globally unique.
`static String`	`getAdjustedComponentUrl(NodeBase component, String command, IPageParameters pp)`
`static String`	`getAdjustedPageUrl(Page page, IPageParameters pp)`
`static String`	`getApplicationContext()` Returns application context part from current request.
`static String`	`getApplicationURL()` Returns application url part from current request.
`static BundleRef`	`getClassBundle(Class<?> clz)` Returns the bundle for the specified class, defined as classname[nls].properties.
`static String`	`getClassNameOnly(Class<?> clz)`
`static Object`	`getClassValue(Object inst, String name)` Retrieves a value from an object using introspection.
`static String`	`getComponentDetails(NodeBase n)`
`static String`	`getHintValue(String componentTypeHint, String name)` Decode a `PropertyMetaModel.getComponentTypeHint()` hint.
`static String`	`getJavaResourceRURL(Class<?> resourceBase, String name)`
`static Long`	`getLongParameter(IPageParameters pp, String name, Long def)` Deprecated.
`static String`	`getLorem()` Return a large string containing lorum ipsum text, for testing purposes.
`static IErrorFence`	`getMessageFence(NodeBase in)`
`static BundleRef`	`getPackageBundle(Class<?> base)`
`static Object`	`getPropertyValue(Object base, String path)` Resolve the property's value
`static String`	`getRelativeApplicationResourceURL(String resource)` Returns relative path for specified resource (without host name, like '/APP_CONTEXT/resource').
`static Object`	`getSessionAttribute(String attribute, boolean doReset)` Returns specified session attribute value if exists.
`static StackTraceElement[]`	`getTracepoint()`
`static <T> T`	`getValueSafe(IControl<T> node)`
`static boolean`	`hasResource(Class<? extends UrlPage> clz, String cn)` Returns T if the specified resource exists.
`static String`	`htmlRemoveAll(String html, boolean lf)`
`static void`	`htmlRemoveAll(StringBuilder outsb, String text, boolean lf)`
`static String`	`htmlRemoveUnsafe(String html)`
`static void`	`htmlRemoveUnsafe(StringBuilder outsb, String text)` This scans the input, and only copies "safe" html, which is HTML with only simple constructs.
`static void`	`ie8Capable(javax.servlet.http.HttpServletResponse req)` Deprecated.
`static <T> int`	`indexOf(T[] array, T lookingFor)` Util that returns index of lookingFor object inside specified array
`static <V,T extends IIdentifyable<V>> int`	`indexOfLongIdentifyable(List<T> list, T lookingFor)` Util that returns index of member in specified list that has same Long Id as specified member.
`static boolean`	`isBasicType(Class<?> t)` Returns T if this is one of the basic types: any numeric including BigDecimal and BigInteger; string, or date.
`static boolean`	`isBlank(String s)` Deprecated.
`static boolean`	`isBooleanOrWrapper(Class<?> clz)`
`static boolean`	`isByteOrWrapper(Class<?> clz)`
`static boolean`	`isDoubleOrWrapper(Class<?> clz)`
`static boolean`	`isEqual(Object... ar)`
`static boolean`	`isEqual(Object a, Object b)`
`static boolean`	`isEqualIgnoreCase(String a, String b)` Deprecated.
`static boolean`	`isEqualOLD(Object a, Object b)`
`static boolean`	`isFloatOrWrapper(Class<?> clz)`
`static <T> boolean`	`isIn(T value, T... values)` EXPENSIVE - USE WITH CARE Check if first primitive type paramater is equal to some from others.
`static boolean`	`isIntegerOrWrapper(Class<?> clz)`
`static boolean`	`isIntegerType(Class<?> clz)` Returns T if the class represents an integer numeric type.
`static boolean`	`isLongOrWrapper(Class<?> clz)`
`static boolean`	`isModified(NodeBase root)` Walks the subtree and asks any node implementing `IHasModifiedIndication` whether it has been modified; return as soon as one node tells us it has been modified.
`static boolean`	`isRealType(Class<?> clz)` Return T if the class represents a real (double or float) type.
`static boolean`	`isRelativeURL(String in)`
`static boolean`	`isShortOrWrapper(Class<?> clz)`
`static boolean`	`isWhitespace(char c)`
`static void`	`main(String[] args)`
`static <V,T extends IIdentifyable<V>> List<T>`	`merge(List<T> mergeSource, List<T> toJoinItems)` Appends non contained items from toJoinItems into mergeSource.
`static <V,T extends IIdentifyable<V>> List<T>`	`merge(List<T> mergeSource, T item)` Add item to mergeSource if it is not already contained.
`static String`	`nlsLabel(String label)`
`static <T> T`	`nullChecked(T in)` NULL CHECKING BELONGS IN THE LANGUAGE, NOT IN ANNOTATIONS, damnit! This fine idiocy is needed to handle null checking because the pathetic losers that make up the Java JSR board are so incredible stupid it boggles the mind.
`static int`	`percentSize(String css)` Convert a CSS percentage size string like '90%' into the 90...
`static int`	`pixelSize(String css)` Convert a CSS size string like '200px' into the 200...
`static int`	`pixelSize(String css, int defaultVal)` Convert a CSS size string like '200px' into the 200...
`static void`	`renderErrorMessage(NodeContainer d, UIMessage m)` This scans an error messages for simple HTML and renders that as DomUI nodes.
`static void`	`renderHtmlString(NodeContainer d, String text)` Render a text string that possibly contains some simple HTML constructs as a DomUI node set into the container passed.
`static void`	`setModifiedFlag(NodeBase node)` Update modified flag of node.
`static void`	`setPageCompatibility(javax.servlet.http.HttpServletResponse req, String comp)` Define (or clear) the x-ua-compatible value sent for this page.
`static void`	`setSessionAttribute(String attribute, Object value)` Set specified session attribute value.
`static void`	`stripHtml(StringBuilder sb, String in)` Remove all HTML tags from the input and keep only the text content.
`static void`	`time(String what, IExecute exec)`
`static Object`	`walkTree(NodeBase root, DomUtil.IPerNode handler)` Walks a node tree, calling the handler for every node in the tree.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

USERLOG

public static final org.slf4j.Logger USERLOG

DOCROOT
```
public static final String DOCROOT
```
See Also:

Constant Field Values

Method Detail

nullChecked
```
@Nonnull
public static <T> T nullChecked(@Nullable
                                         T in)
```
NULL CHECKING BELONGS IN THE LANGUAGE, NOT IN ANNOTATIONS, damnit! This fine idiocy is needed to handle null checking because the pathetic losers that make up the Java JSR board are so incredible stupid it boggles the mind. Java == cobol 8-(

Parameters:

in -

Returns:

badCheck
```
@Deprecated
 @Nonnull
public static <T> T badCheck(T in)
```
Deprecated.

Don not use. We are not sure that it's checked before. This is a potential null pointer access. Adding this mean that we didn't want to introduce risk but we are marking this as a bad part of code.

Parameters:

in -

Returns:

setPageCompatibility

public static final void setPageCompatibility(@Nonnull
                                              javax.servlet.http.HttpServletResponse req,
                                              @Nullable
                                              String comp)
                                       throws IOException

Define (or clear) the x-ua-compatible value sent for this page. When not called this defaults to the value defined by the ms-emulation property in web.xml.

Parameters:: comp -
Throws:: IOException

ie8Capable

@Deprecated
public static final void ie8Capable(javax.servlet.http.HttpServletResponse req)
                                         throws IOException

Deprecated.

FIXME REMOVE!??!

Parameters:: req -
Throws:: IOException

isEqualOLD

public static final boolean isEqualOLD(Object a,
                                       Object b)

isEqual

public static final boolean isEqual(Object a,
                                    Object b)

isEqualIgnoreCase

@Deprecated
public static final boolean isEqualIgnoreCase(@Nullable
                                                          String a,
                                                          @Nullable
                                                          String b)

Deprecated.

Use StringTool.isEqualIgnoreCase(String, String) please.

Parameters:: a -; b -
Returns:

isEqual

public static final boolean isEqual(Object... ar)

getValueSafe

public static <T> T getValueSafe(IControl<T> node)

classResourceExists

public static boolean classResourceExists(Class<?> clz,
                                          String name)

Returns T if the given Java Resource exists.

Parameters:: clz -; name -
Returns:

findClass

public static final Class<?> findClass(@Nonnull
                                       ClassLoader cl,
                                       @Nonnull
                                       String name)

isIntegerType
```
public static boolean isIntegerType(Class<?> clz)
```
Returns T if the class represents an integer numeric type.

Parameters:

clz -

Returns:

isDoubleOrWrapper

public static boolean isDoubleOrWrapper(Class<?> clz)

isFloatOrWrapper

public static boolean isFloatOrWrapper(Class<?> clz)

isIntegerOrWrapper

public static boolean isIntegerOrWrapper(Class<?> clz)

isShortOrWrapper

public static boolean isShortOrWrapper(Class<?> clz)

isByteOrWrapper

public static boolean isByteOrWrapper(Class<?> clz)

isLongOrWrapper

public static boolean isLongOrWrapper(Class<?> clz)

isBooleanOrWrapper

public static boolean isBooleanOrWrapper(Class<?> clz)

isRealType
```
public static boolean isRealType(Class<?> clz)
```
Return T if the class represents a real (double or float) type.

Parameters:

clz -

Returns:

isBasicType
```
public static boolean isBasicType(Class<?> t)
```
Returns T if this is one of the basic types: any numeric including BigDecimal and BigInteger; string, or date.

Parameters:

t -

Returns:

getClassValue

public static final Object getClassValue(@Nonnull
                                         Object inst,
                                         @Nonnull
                                         String name)
                                  throws Exception

Retrieves a value from an object using introspection. The name is the direct name of a method that *must* exist; it does not add a "get". If the method does not exist this throws an exception.

Parameters:: inst -; name -
Returns:
Throws:: Exception

getPropertyValue

public static Object getPropertyValue(@Nonnull
                                      Object base,
                                      @Nonnull
                                      String path)

Resolve the property's value

Parameters:: base -; path -
Returns:

createRandomColor

public static String createRandomColor()

getMessageFence

@Nonnull
public static IErrorFence getMessageFence(@Nonnull
                                                   NodeBase in)

generateGUID
```
@Nonnull
public static String generateGUID()
```
Generate an unique identifier with reasonable expectations that it will be globally unique. This does not use the known GUID format but shortens the string by encoding into base64-like encoding.

Returns:

addUrlParameters

public static void addUrlParameters(StringBuilder sb,
                                    IRequestContext ctx,
                                    boolean first)

addUrlParameters

public static void addUrlParameters(@Nonnull
                                    StringBuilder sb,
                                    @Nonnull
                                    IPageParameters ctx,
                                    boolean first)

addUrlParameters

public static void addUrlParameters(@Nonnull
                                    StringBuilder sb,
                                    @Nonnull
                                    IPageParameters ctx,
                                    boolean first,
                                    @Nonnull
                                    Set<String> skipset)

getApplicationURL
```
public static String getApplicationURL()
```
Returns application url part from current request. Call depends on existing of request, so it can't be used within backend threads.

Returns:

getApplicationContext
```
public static String getApplicationContext()
```
Returns application context part from current request. Returns the webapp context as either an empty string for the ROOT context or a string starting without a slash and always ending in one, like "viewpoint/". Call depends on existing of request, so it can't be used within backend threads.

Returns:

getRelativeApplicationResourceURL
```
public static String getRelativeApplicationResourceURL(String resource)
```
Returns relative path for specified resource (without host name, like '/APP_CONTEXT/resource'). Call depends on existing of request, so it can't be used within backend threads.

Parameters:

resource -

Returns:

createPageURL
```
public static String createPageURL(Class<? extends UrlPage> clz,
                                   IPageParameters pp)
```
IMPORTANT: This method MUST be used only within UI threads, when UIContext.getRequestContext() != null! In all other, usually background running threads, other alternatives that are using stored appURL must be used!

Parameters:

clz -

pp -

Returns:

createPageRURL

@Nonnull
public static String createPageRURL(@Nonnull
                                             Class<? extends UrlPage> clz,
                                             @Nullable
                                             IPageParameters pp)

Create a relative URL for the specified page (an URL that is relative to the application's context, i.e. without hostname nor webapp context).

Parameters:: clz -; pp -
Returns:

createPageURL

public static String createPageURL(@Nonnull
                                   String webAppUrl,
                                   @Nonnull
                                   Class<? extends UrlPage> clz,
                                   @Nullable
                                   IPageParameters pp)

IMPORTANT: This method MUST be used for non UI threads, when UIContext.getRequestContext() == null! In all other, usually UI running threads, use other alternatives that is using appURL from UIContext.getRequestContext()!

Parameters:: webAppUrl - web app url, must be ended with '/'; clz -; pp -
Returns:

createPageURL

public static String createPageURL(String rurl,
                                   IPageParameters pageParameters)

Generate an URL to some page with parameters.

Parameters:: rurl - The absolute or relative URL to whatever resource.; pageParameters -
Returns:

getAdjustedPageUrl

@Nonnull
public static String getAdjustedPageUrl(@Nonnull
                                                 Page page,
                                                 @Nullable
                                                 IPageParameters pp)

getAdjustedComponentUrl

@Nonnull
public static String getAdjustedComponentUrl(@Nonnull
                                                      NodeBase component,
                                                      @Nonnull
                                                      String command,
                                                      @Nullable
                                                      IPageParameters pp)

calculateURL
```
public static String calculateURL(IRequestContext ci,
                                  String rurl)
```
Calculate a full URL from a rurl. If the rurl starts with a scheme it is returned verbatim; if it starts with slash (host-relative path absolute) it is returned verbatim; in all other cases it is returned with the webapp context appended. Examples:
- img/text.gif becomes /Itris_VO02/img/text.gif
- /ui/generic.gif remains the same
Parameters:

ci -

rurl -

Returns:

buildTree

public static void buildTree(NodeBase p)
                      throws Exception

Ensures that all of a node tree has been built.

Parameters:: p -
Throws:: Exception

findComponentInTree

public static <T extends NodeBase> T findComponentInTree(NodeBase p,
                                                         Class<T> clz)
                                                  throws Exception

Walks the tree starting at the node passed and returns the first instance of the given class that is found in a normal walk of the tree.

Type Parameters:: T -
Parameters:: p -; clz -
Returns:
Throws:: Exception

nlsLabel

public static String nlsLabel(String label)

adjustTableColspans
```
public static void adjustTableColspans(Table table)
```
Walks the entire table and adjusts it's colspans.

Parameters:

t -

balanceTable
```
public static void balanceTable(Table t)
```
This balances tables to ensure that all rows have an equal number of rows and columns, taking rowspans and colspans into effect. FIXME Boring, lotso work, complete later.

Parameters:

t -

stripHtml
```
public static void stripHtml(StringBuilder sb,
                             String in)
```
Remove all HTML tags from the input and keep only the text content. Things like script tags and the like will be removed but their contents will be kept.

Parameters:

sb -

in -

dumpException

public static void dumpException(Exception x)

dumpExceptionIfSevere
```
public static void dumpExceptionIfSevere(@Nonnull
                                         Exception x)
```
This method will first determine whether the exception is considered severe. Based on that outcome it will dump it or not.

Parameters:

x -

dumpException

public static void dumpException(@Nonnull
                                 StringBuilder sb,
                                 Throwable x)

dumpRequest

public static void dumpRequest(javax.servlet.http.HttpServletRequest req)

getJavaResourceRURL

public static String getJavaResourceRURL(Class<?> resourceBase,
                                         String name)

convertToID

@Nonnull
public static String convertToID(@Nonnull
                                          String id)

hasResource

public static boolean hasResource(Class<? extends UrlPage> clz,
                                  String cn)

Returns T if the specified resource exists.

Parameters:: clz -; cn -
Returns:

getClassNameOnly

public static String getClassNameOnly(Class<?> clz)

findBundle

public static BundleRef findBundle(UIMenu ma,
                                   Class<?> clz)

Parameters:: ma -; clz -
Returns:

getClassBundle
```
public static BundleRef getClassBundle(Class<?> clz)
```
Returns the bundle for the specified class, defined as classname[nls].properties.

Parameters:

clz -

Returns:

getPackageBundle

public static BundleRef getPackageBundle(Class<?> base)

calcPageTitle
```
@Nonnull
public static String calcPageTitle(Class<?> clz)
```
Lookup a page Title bar text.. FIXME Bad logic, bad name; should have a version passing in class instance.

Parameters:

clz -

Returns:

calcPageLabel
```
public static String calcPageLabel(Class<?> clz)
```
Lookup a page Title bar text..

Parameters:

clz -

Returns:

findPageBundle
```
public static BundleRef findPageBundle(UrlPage urlPage)
```
Locates the default page bundle for a page. The lookup of the bundle is as follows (first match returns):
- If the page has an @UIMenu annotation use it's bundleBase and bundleName to find the page bundle. It is an error to specify a nonexistent bundle here.
- Try a bundle with the same name as the page class
If this fails return null.
Parameters:

urlPage -

Returns:

renderHtmlString
```
public static void renderHtmlString(NodeContainer d,
                                    String text)
```
Render a text string that possibly contains some simple HTML constructs as a DomUI node set into the container passed. The code currently accepts: B, BR, I, EM, STRONG as tags.

htmlRemoveUnsafe
```
public static void htmlRemoveUnsafe(StringBuilder outsb,
                                    String text)
```
This scans the input, and only copies "safe" html, which is HTML with only simple constructs. It checks to make sure the resulting document is xml-safe (well-formed), if the input is not well-formed it will add or remove tags until the result is valid.

Parameters:

sb -

html -

htmlRemoveUnsafe

public static String htmlRemoveUnsafe(String html)

htmlRemoveAll

public static void htmlRemoveAll(StringBuilder outsb,
                                 String text,
                                 boolean lf)

htmlRemoveAll

public static String htmlRemoveAll(String html,
                                   boolean lf)

appendContainer

public static List<NodeContainer> appendContainer(List<NodeContainer> stack,
                                                  NodeContainer it)

renderErrorMessage
```
public static void renderErrorMessage(NodeContainer d,
                                      UIMessage m)
```
This scans an error messages for simple HTML and renders that as DomUI nodes. The rendered content gets added to the container passed.

getLongParameter

@Deprecated
public static Long getLongParameter(IPageParameters pp,
                                                String name,
                                                Long def)

Deprecated.

Should use {@link PageParameters#getLongW(String, Long) instead. Obtain a parameter and convert it to a Long wrapper.

Parameters:: pp -; name -; def -
Returns:

pixelSize
```
public static int pixelSize(String css)
```
Convert a CSS size string like '200px' into the 200... If the size string is in any way invalid this returns -1.

Parameters:

css -

Returns:

pixelSize
```
public static int pixelSize(String css,
                            int defaultVal)
```
Convert a CSS size string like '200px' into the 200... If the size string is in any way invalid this returns specified defaultVal.

Parameters:

css -

defaultVal -

Returns:

percentSize
```
public static int percentSize(String css)
```
Convert a CSS percentage size string like '90%' into the 90... If the size string is in any way invalid this returns -1.

Parameters:

css -

Returns:

walkTree
```
public static Object walkTree(NodeBase root,
                              DomUtil.IPerNode handler)
                       throws Exception
```
Walks a node tree, calling the handler for every node in the tree. As soon as a handler returns not-null traversing stops and that object gets returned.

Parameters:

handler -

Returns:

Throws:

Exception

clearModifiedFlag
```
public static void clearModifiedFlag(NodeBase root)
```
This clears the 'modified' flag for all nodes in the subtree that implement IHasModifiedIndication.

Parameters:

root - The subtree to traverse

isModified
```
public static boolean isModified(NodeBase root)
```
Walks the subtree and asks any node implementing IHasModifiedIndication whether it has been modified; return as soon as one node tells us it has been modified.

Parameters:

root -

setModifiedFlag
```
public static void setModifiedFlag(NodeBase node)
```
Update modified flag of node. Propagate notify signal up to final modified fence in parant tree, if any is defined. Use it to set modified flag as result of handling of user data modification.

Parameters:

node -

isBlank
```
@Deprecated
public static boolean isBlank(String s)
```
Deprecated.
Use StringTool.isBlank(String s) instead.
```
 Checks if string is blank.
 
```
Parameters:

s - String to be validated.

Returns:

true if it is blank, false otherwise.

isRelativeURL

public static boolean isRelativeURL(String in)

isIn
```
public static <T> boolean isIn(T value,
                               T... values)
```
EXPENSIVE - USE WITH CARE Check if first primitive type paramater is equal to some from others. Use only for primitive types and enums, for other complex types use MetaManager.areObjectsEqual(Object, Object, ClassMetaModel).

Parameters:

value -

values -

Returns:

createOpenWindowJS

@Nonnull
public static String createOpenWindowJS(@Nonnull
                                                 Class<?> targetClass,
                                                 @Nullable
                                                 IPageParameters targetParameters,
                                                 @Nullable
                                                 WindowParameters newWindowParameters)

This opens a new DomUI page, immediately creating a session for it.

Parameters:: targetClass -; targetParameters -; newWindowParameters -
Returns:

createOpenWindowJS

@Nonnull
public static String createOpenWindowJS(@Nonnull
                                                 String url,
                                                 @Nullable
                                                 WindowParameters newWindowParameters)

isWhitespace

public static boolean isWhitespace(char c)

getTracepoint

public static StackTraceElement[] getTracepoint()

getLorem
```
public static String getLorem()
                       throws Exception
```
Return a large string containing lorum ipsum text, for testing purposes.

Returns:

Throws:

Exception

containsLongIdentifyable

public static <V,T extends IIdentifyable<V>> boolean containsLongIdentifyable(@Nonnull
                                                                              Collection<T> set,
                                                                              @Nonnull
                                                                              T lookingFor)

Util can be used to check if list contains item that has equal Long Id as specified one, while instanies itself does not need to be equal.

Type Parameters:: T -
Parameters:: set -; lookingFor -
Returns:

indexOfLongIdentifyable

public static <V,T extends IIdentifyable<V>> int indexOfLongIdentifyable(@Nonnull
                                                                         List<T> list,
                                                                         @Nonnull
                                                                         T lookingFor)

Util that returns index of member in specified list that has same Long Id as specified member.

Type Parameters:: T -
Parameters:: list -; member -
Returns:: -1 if member object Long Id is not found in specified list, otherwise returns found index.

merge

@Nonnull
public static <V,T extends IIdentifyable<V>> List<T> merge(@Nonnull
                                                                    List<T> mergeSource,
                                                                    @Nonnull
                                                                    T item)

Add item to mergeSource if it is not already contained.

Type Parameters:: T -
Parameters:: mergeSource -; item -
Returns:: (not)appended mergeSource

merge

public static <V,T extends IIdentifyable<V>> List<T> merge(@Nonnull
                                                           List<T> mergeSource,
                                                           @Nonnull
                                                           List<T> toJoinItems)

Appends non contained items from toJoinItems into mergeSource. Uses linear search, not suitable for large lists.

Type Parameters:: T -
Parameters:: mergeSource -; toJoinItems -
Returns:: (not)appended mergeSource

contains
```
public static <T> boolean contains(T[] array,
                                   T lookingFor)
```
Util that returns T if lookingFor object is contained in specified array

Type Parameters:

T -

Parameters:

array -

lookingFor -

Returns:

indexOf
```
public static <T> int indexOf(T[] array,
                              T lookingFor)
```
Util that returns index of lookingFor object inside specified array

Type Parameters:

T -

Parameters:

array -

lookingFor -

Returns:

-1 if lookingFor object is not found in specified array, otherwise returns its index

getSessionAttribute
```
@Nullable
public static Object getSessionAttribute(@Nonnull
                                                   String attribute,
                                                   boolean doReset)
```
Returns specified session attribute value if exists. If specified, it clears value to support easier 'one time purpose actions'. Must be called within valid request UI context.

Parameters:

attribute -

doReset - if T attribute value is set to null after reading.

Returns:

setSessionAttribute

public static void setSessionAttribute(@Nonnull
                                       String attribute,
                                       @Nullable
                                       Object value)

Set specified session attribute value. Attribute would be accessible until session expires. Must be called within valid request UI context.

Parameters:: attribute -; value -

getHintValue

@Nullable
public static String getHintValue(String componentTypeHint,
                                            String name)

Decode a PropertyMetaModel.getComponentTypeHint() hint.

Parameters:: componentTypeHint -; string -
Returns:

getComponentDetails

@Nonnull
public static String getComponentDetails(NodeBase n)

main

public static void main(String[] args)

addSingleShotMessage

@Nonnull
public static List<UIMessage> addSingleShotMessage(@Nonnull
                                                            NodeBase node,
                                                            @Nonnull
                                                            UIMessage message)

calcNodeText

public static String calcNodeText(@Nonnull
                                  NodeContainer nc)

Try to get some content text from this node, for displaying what the node "is".

Parameters:: nc -
Returns:

time

public static void time(@Nonnull
                        String what,
                        @Nonnull
                        IExecute exec)
                 throws Exception

Throws:: Exception

Class DomUtil

Nested Class Summary

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

USERLOG

DOCROOT

Method Detail

nullChecked

badCheck

setPageCompatibility

ie8Capable

isEqualOLD

isEqual

isEqualIgnoreCase

isEqual

getValueSafe

classResourceExists

findClass

isIntegerType

isDoubleOrWrapper

isFloatOrWrapper

isIntegerOrWrapper

isShortOrWrapper

isByteOrWrapper

isLongOrWrapper

isBooleanOrWrapper

isRealType

isBasicType

getClassValue

getPropertyValue

createRandomColor

getMessageFence

generateGUID

addUrlParameters

addUrlParameters

addUrlParameters

getApplicationURL

getApplicationContext

getRelativeApplicationResourceURL

createPageURL

createPageRURL

createPageURL

createPageURL

getAdjustedPageUrl

getAdjustedComponentUrl

calculateURL

buildTree

findComponentInTree

nlsLabel

adjustTableColspans

balanceTable

stripHtml

dumpException

dumpExceptionIfSevere

dumpException

dumpRequest

getJavaResourceRURL

convertToID

hasResource

getClassNameOnly

findBundle

getClassBundle

getPackageBundle

calcPageTitle

calcPageLabel

findPageBundle

renderHtmlString

htmlRemoveUnsafe

htmlRemoveUnsafe

htmlRemoveAll

htmlRemoveAll

appendContainer

renderErrorMessage

getLongParameter

pixelSize

pixelSize

percentSize

walkTree