Class XPathEngine


  • public class XPathEngine
    extends Object

    Purpose: Perform operations based on SDO XPath against DataObjects.

    • Method Detail

      • getInstance

        public static XPathEngine getInstance()
      • isSet

        public boolean isSet​(String path,
                             commonj.sdo.DataObject caller)
        Handle queries about setting status of a property through path base access.
        Parameters:
        path - the String representation of path based access
        caller - the DataObject that pass path information in
        Returns:
        true if queried property is set, otherwise false
      • unset

        public void unset​(String path,
                          commonj.sdo.DataObject caller)
        Unset the value of a property through the path base access.
        Parameters:
        path - the String representation of path based access
        caller - the DataObject that pass path information in
      • set

        public void set​(String path,
                        Object value,
                        commonj.sdo.DataObject caller,
                        boolean convertValue)
        Set a property's value through the path base access.
        Parameters:
        path - the String representation of path based access
        value - the value to be set as the target property's value
        caller - the DataObject that pass path information in
        convertValue - boolean used for set if we should convert the value
      • get

        public Object get​(String path,
                          commonj.sdo.DataObject caller)
        When accessing values corresponding to properties of DataObject by path base accessors, the accessed getters will pass informations to this method to process information and acquire wanted values.
        Parameters:
        path - the String representation of path based access
        caller - the DataObject that pass path information in
        Returns:
        the value gotten by accessing through path
      • convertObjectToValueByPath

        public Object convertObjectToValueByPath​(String path,
                                                 Class cls,
                                                 commonj.sdo.DataObject caller)
                                          throws ClassCastException
        access the wanted values through path and convert it into required java class. If conversion is not supported, exception is thrown.
        Parameters:
        path - string representation of accessing path
        cls - the java class that accessed value is to be converted to
        caller - the DataObject that pass the path in
        Returns:
        values to be accessed
        Throws:
        ClassCastException