Class ViewModelUtils

java.lang.Object
org.kuali.rice.krad.uif.util.ViewModelUtils

public class ViewModelUtils extends Object
Provides methods for getting property values, types, and paths within the context of a View

The view provides a special map named 'abstractTypeClasses' that indicates concrete classes that should be used in place of abstract property types that are encountered on the object graph. This classes takes into account that map while dealing with properties. e.g. suppose we have propertyPath 'document.name' on the form, with the type of the document property set to the interface Document. Using class introspection we would get back the interface type for document and this would not be able to get the property type for name. Using the view map, we can replace document with a concrete class and then use it to get the name property

Author:
Kuali Rice Team (rice.collab@kuali.org)
  • Constructor Details

    • ViewModelUtils

      public ViewModelUtils()
  • Method Details

    • getPropertyTypeByClassAndView

      public static Class<?> getPropertyTypeByClassAndView(View view, Object model, String propertyPath)
      Determines the associated type for the property within the View context

      Property path is full path to property from the View Form class. The abstract type classes map configured on the View will be consulted for any entries that match the property path. If the property path given contains a partial match to an abstract class (somewhere on path is an abstract class), the property type will be retrieved based on the given concrete class to use and the part of the path remaining. If no matching entry is found, standard reflection is used to get the type

      Parameters:
      view - view instance providing the context (abstract map)
      model - the model
      propertyPath - full path to property to retrieve type for (relative to the form class)
      Returns:
      Classinvalid input: '<'?> type of property in model, or Null if type could not be determined
      See Also:
    • getParentObjectPath

      public static String getParentObjectPath(DataField field)
      Gets the parent object path of the data field
      Parameters:
      field -
      Returns:
      parent object path
    • getParentObjectClassForMetadata

      public static Class<?> getParentObjectClassForMetadata(View view, Object model, DataField field)
      Determines the associated type for the property within the View context

      If the parent object instance is not null, get the class through it. Otherwise, use the following logic: The abstract type classes map configured on the View will be consulted for any entries that match the property path. If the parent object path for the given field contains a partial match to an abstract class (somewhere on path is an abstract class), the property type will be retrieved based on the given concrete class to use and the part of the path remaining. If no matching entry is found, standard reflection is used to get the type

      Parameters:
      view - view instance providing the context (abstract map)
      model - object model
      field - field to retrieve type for
      Returns:
      the class of the object instance if not null or the type of property in model, or Null if type could not be determined
      See Also:
    • getObjectClassForMetadata

      public static Class<?> getObjectClassForMetadata(View view, Object model, String propertyPath)
      Determines the associated type for the property within the View context

      If the parent object instance is not null, get the class through it. Otherwise, use the following logic: The abstract type classes map configured on the View will be consulted for any entries that match the property path. If the parent object path for the given field contains a partial match to an abstract class (somewhere on path is an abstract class), the property type will be retrieved based on the given concrete class to use and the part of the path remaining. If no matching entry is found, standard reflection is used to get the type

      Parameters:
      view - view instance providing the context (abstract map)
      model - object model
      propertyPath - full path to property to retrieve type for (relative to the form class)
      Returns:
      the class of the object instance if not null or the type of property in model, or Null if type could not be determined
      See Also:
    • getParentObjectForMetadata

      public static Object getParentObjectForMetadata(View view, Object model, DataField field)
      Retrieves the parent object if it exists or attempts to create a new instance
      Parameters:
      view - view instance providing the context (abstract map)
      model - object model
      field - field to retrieve type for
      Returns:
      the class of the object instance if not null or the type of property in model, or Null if type could not be determined
      See Also:
    • getStringValFromPVs

      public static String getStringValFromPVs(org.springframework.beans.PropertyValues propertyValues, String propertyName)
      Helper method for getting the string value of a property from a PropertyValues
      Parameters:
      propertyValues - property values instance to pull from
      propertyName - name of property whose value should be retrieved
      Returns:
      String value for property or null if property was not found