Skip to content

Commit

Permalink
add utility methods to ERXComponentUtilities
Browse files Browse the repository at this point in the history 
deprecate corresponding methods in AjaxUtils
  • Loading branch information
@darkv
darkv committed Jun 11, 2012
1 parent d10fd15 commit 366b543
Show file tree
Hide file tree
Showing 2 changed files with 243 additions and 0 deletions.
33 changes: 33 additions & 0 deletions Frameworks/Ajax/Ajax/Sources/er/ajax/AjaxUtils.java
View file
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@
import er.extensions.appserver.ERXWOContext;
import er.extensions.appserver.ajax.ERXAjaxApplication;
import er.extensions.appserver.ajax.ERXAjaxSession;
import er.extensions.components.ERXComponentUtilities;
import er.extensions.formatters.ERXNumberFormatter;
import er.extensions.formatters.ERXTimestampFormatter;
import er.extensions.foundation.ERXProperties;
Expand Down Expand Up @@ -282,14 +283,26 @@ public static void appendScriptFooter(WOResponse response) {
response.appendContentString("</script>");
}

/**
* @deprecated use {@link ERXComponentUtilities#hasBinding(String, NSDictionary)} instead
*/
@Deprecated
public static boolean hasBinding(String name, NSDictionary<String, WOAssociation> associations) {
return associations.objectForKey(name) != null;
}

/**
* @deprecated use {@link ERXComponentUtilities#bindingNamed(String, NSDictionary)} instead
*/
@Deprecated
public static WOAssociation bindingNamed(String name, NSDictionary<String, WOAssociation> associations) {
return associations.objectForKey(name);
}

/**
* @deprecated use {@link ERXComponentUtilities#valueForBinding(String, Object, NSDictionary, WOComponent)} instead
*/
@Deprecated
public static Object valueForBinding(String name, Object defaultValue, NSDictionary<String, WOAssociation> associations, WOComponent component) {
Object value = AjaxUtils.valueForBinding(name, associations, component);
if (value != null) {
Expand All @@ -298,6 +311,10 @@ public static Object valueForBinding(String name, Object defaultValue, NSDiction
return defaultValue;
}

/**
* @deprecated use {@link ERXComponentUtilities#stringValueForBinding(String, String, NSDictionary, WOComponent)} instead
*/
@Deprecated
public static String stringValueForBinding(String name, String defaultValue, NSDictionary<String, WOAssociation> associations, WOComponent component) {
String value = AjaxUtils.stringValueForBinding(name, associations, component);
if (value != null) {
Expand All @@ -306,6 +323,10 @@ public static String stringValueForBinding(String name, String defaultValue, NSD
return defaultValue;
}

/**
* @deprecated use {@link ERXComponentUtilities#stringValueForBinding(String, NSDictionary, WOComponent)} instead
*/
@Deprecated
public static String stringValueForBinding(String name, NSDictionary<String, WOAssociation> associations, WOComponent component) {
WOAssociation association = associations.objectForKey(name);
if (association != null) {
Expand All @@ -314,6 +335,10 @@ public static String stringValueForBinding(String name, NSDictionary<String, WOA
return null;
}

/**
* @deprecated use {@link ERXComponentUtilities#valueForBinding(String, NSDictionary, WOComponent)} instead
*/
@Deprecated
public static Object valueForBinding(String name, NSDictionary<String, WOAssociation> associations, WOComponent component) {
WOAssociation association = associations.objectForKey(name);
if (association != null) {
Expand All @@ -322,6 +347,10 @@ public static Object valueForBinding(String name, NSDictionary<String, WOAssocia
return null;
}

/**
* @deprecated use {@link ERXComponentUtilities#booleanValueForBinding(String, boolean, NSDictionary, WOComponent)} instead
*/
@Deprecated
public static boolean booleanValueForBinding(String name, boolean defaultValue, NSDictionary<String, WOAssociation> associations, WOComponent component) {
WOAssociation association = associations.objectForKey(name);
if (association != null) {
Expand All @@ -330,6 +359,10 @@ public static boolean booleanValueForBinding(String name, boolean defaultValue,
return defaultValue;
}

/**
* @deprecated use {@link ERXComponentUtilities#setValueForBinding(Object, String, NSDictionary, WOComponent)} instead
*/
@Deprecated
public static void setValueForBinding(Object value, String name, NSDictionary<String, WOAssociation> associations, WOComponent component) {
WOAssociation association = associations.objectForKey(name);
if (association != null) {
Expand Down
210 changes: 210 additions & 0 deletions Frameworks/Core/ERExtensions/Sources/er/extensions/components/ERXComponentUtilities.java
View file
Original file line number Diff line number Diff line change
Expand Up @@ -387,4 +387,214 @@ public static <T extends WOComponent> T pageWithName(Class<T> componentClass) {
return (T) ERXApplication.erxApplication().pageWithName(componentClass);
}

/**
* Checks if there is an association for a binding with the given name.
*
* @param name binding name
* @param associations array of associations
* @return <code>true</code> if the association exists
*/
public static boolean hasBinding(String name, NSDictionary<String, WOAssociation> associations) {
return associations.objectForKey(name) != null;
}

/**
* Returns the association for a binding with the given name. If there is
* no such association <code>null</code> will be returned.
*
* @param name binding name
* @param associations array of associations
* @return association for given binding or <code>null</code>
*/
public static WOAssociation bindingNamed(String name, NSDictionary<String, WOAssociation> associations) {
return associations.objectForKey(name);
}

/**
* Checks if the association for a binding with the given name can assign
* values at runtime.
*
* @param name binding name
* @param associations array of associations
* @return <code>true</code> if binding is settable
*/
public static boolean bindingIsSettable(String name, NSDictionary<String, WOAssociation> associations) {
boolean isSettable = false;
WOAssociation association = bindingNamed(name, associations);
if (association != null) {
isSettable = association.isValueSettable();
}
return isSettable;
}

/**
* Will try to set the given binding in the component to the passed value.
*
* @param value new value for the binding
* @param name binding name
* @param associations array of associations
* @param component component to set the value in
*/
public static void setValueForBinding(Object value, String name, NSDictionary<String, WOAssociation> associations, WOComponent component) {
WOAssociation association = bindingNamed(name, associations);
if (association != null) {
association.setValue(value, component);
}
}

/**
* Retrieves the current value of the given binding from the component. If there
* is no such binding or its value evaluates to <code>null</code> the default
* value will be returned.
*
* @param name binding name
* @param defaultValue default value
* @param associations array of associations
* @param component component to get value from
* @return retrieved value or default value
*/
public static Object valueForBinding(String name, Object defaultValue, NSDictionary<String, WOAssociation> associations, WOComponent component) {
Object value = valueForBinding(name, associations, component);
if (value != null) {
return value;
}
return defaultValue;
}

/**
* Retrieves the current value of the given binding from the component. If there
* is no such binding <code>null</code> will be returned.
*
* @param name binding name
* @param associations array of associations
* @param component component to get value from
* @return retrieved value or <code>null</code>
*/
public static Object valueForBinding(String name, NSDictionary<String, WOAssociation> associations, WOComponent component) {
WOAssociation association = bindingNamed(name, associations);
if (association != null) {
return association.valueInComponent(component);
}
return null;
}

/**
* Retrieves the current string value of the given binding from the component. If there
* is no such binding or its value evaluates to <code>null</code> the default
* value will be returned.
*
* @param name binding name
* @param defaultValue default value
* @param associations array of associations
* @param component component to get value from
* @return retrieved string value or default value
*/
public static String stringValueForBinding(String name, String defaultValue, NSDictionary<String, WOAssociation> associations, WOComponent component) {
String value = stringValueForBinding(name, associations, component);
if (value != null) {
return value;
}
return defaultValue;
}

/**
* Retrieves the current string value of the given binding from the component. If there
* is no such binding <code>null</code> will be returned.
*
* @param name binding name
* @param associations array of associations
* @param component component to get value from
* @return retrieved string value or <code>null</code>
*/
public static String stringValueForBinding(String name, NSDictionary<String, WOAssociation> associations, WOComponent component) {
WOAssociation association = bindingNamed(name, associations);
if (association != null) {
return (String) association.valueInComponent(component);
}
return null;
}

/**
* Retrieves the current boolean value of the given binding from the component. If there
* is no such binding the default value will be returned.
*
* @param name binding name
* @param defaultValue default value
* @param associations array of associations
* @param component component to get value from
* @return retrieved boolean value or default value
*/
public static boolean booleanValueForBinding(String name, boolean defaultValue, NSDictionary<String, WOAssociation> associations, WOComponent component) {
WOAssociation association = bindingNamed(name, associations);
if (association != null) {
return association.booleanValueInComponent(component);
}
return defaultValue;
}

/**
* Retrieves the current boolean value of the given binding from the component. If there
* is no such binding <code>false</code> will be returned.
*
* @param name binding name
* @param associations array of associations
* @param component component to get value from
* @return retrieved boolean value or <code>false</code>
*/
public static boolean booleanValueForBinding(String name, NSDictionary<String, WOAssociation> associations, WOComponent component) {
return booleanValueForBinding(name, false, associations, component);
}

/**
* Retrieves the current int value of the given binding from the component. If there
* is no such binding the default value will be returned.
*
* @param name binding name
* @param defaultValue default value
* @param associations array of associations
* @param component component to get value from
* @return retrieved int value or default value
*/
public static int integerValueForBinding(String name, int defaultValue, NSDictionary<String, WOAssociation> associations, WOComponent component) {
WOAssociation association = bindingNamed(name, associations);
if (association != null) {
Object value = association.valueInComponent(component);
return ERXValueUtilities.intValueWithDefault(value, defaultValue);
}
return defaultValue;
}


/**
* Retrieves the current array value of the given binding from the component. If there
* is no such binding or its value evaluates to <code>null</code> the default
* value will be returned.
*
* @param name binding name
* @param defaultValue default value
* @param associations array of associations
* @param component component to get value from
* @return retrieved array value or default value
*/
public static <T> NSArray<T> arrayValueForBinding(String name, NSArray<T> defaultValue, NSDictionary<String, WOAssociation> associations, WOComponent component) {
WOAssociation association = bindingNamed(name, associations);
if (association != null) {
Object value = association.valueInComponent(component);
return ERXValueUtilities.arrayValueWithDefault(value, defaultValue);
}
return defaultValue;
}

/**
* Retrieves the current array value of the given binding from the component. If there
* is no such binding <code>null</code> will be returned.
*
* @param name binding name
* @param associations array of associations
* @param component component to get value from
* @return retrieved array value or <code>null</code>
*/
public static NSArray arrayValueForBinding(String name, NSDictionary<String, WOAssociation> associations, WOComponent component) {
return arrayValueForBinding(name, null, associations, component);
}
}

0 comments on commit 366b543

Please sign in to comment.