Class HelperProvider


  • public abstract class HelperProvider
    extends java.lang.Object
    A HelperProvider obtains specific default helpers and other implementation-specific objects used by a Java implementation of SDO.
    • Field Detail

      • INSTANCE

        public static HelperProvider INSTANCE
        The default HelperProvider INSTANCE. This is located using the ClassLoader used to load the HelperProvider class itself and if no default implementation is available this field will be set to null.
      • SERVICE_RESOURCE_NAME

        public static final java.lang.String SERVICE_RESOURCE_NAME
        The name of the resource that is used for service location.
        See Also:
        Constant Field Values
      • PROPERTY_NAME

        public static final java.lang.String PROPERTY_NAME
        The name of the system property that will be checked for an implementation name.
        See Also:
        Constant Field Values
    • Constructor Detail

      • HelperProvider

        public HelperProvider()
    • Method Detail

      • setDefaultInstance

        public static void setDefaultInstance​(java.lang.ClassLoader cl)
      • getInstance

        public static HelperProvider getInstance()
                                          throws NoHelperProviderException
        Locate and instantiate a HelperProvider.

        Attempt to locate a HelperProvider using first the Thread's current context classloader and then, if that is not set, not readable, or does not provide an implementation, using the classloader used to load the HelperProvider class itself.

        A new instance is returned for each sucessful invocation.

        Returns:
        an implementation of HelperProvider
        Throws:
        NoHelperProviderException - if no provider implementation was defined or it could not be instantiated
      • getInstance

        public static HelperProvider getInstance​(java.lang.ClassLoader cl)
                                          throws NoHelperProviderException
        Locate and instantiate a HelperProvider using the supplied ClassLoader.

        The name of the implementation to use is determined by the value of the "commonj.sdo.impl.HelperProvider" system property. If this is not set or this code does not have permission to read it then the name will be retrieved from the META-INF/services/commonj.sdo.impl.HelperProvider resource as returned by the supplied classloader as described in the JAR file specification.

        A new instance is returned for each sucessful invocation.

        Parameters:
        cl - the classloader to use to locate and instantiate the implementation
        Returns:
        the specified implementation of HelperProvider
        Throws:
        NoHelperProviderException - if no provider implementation was defined or it could not be instantiated
      • copyHelper

        public abstract CopyHelper copyHelper()
        Returns a CopyHelper obtained from this implementation.
        Returns:
        a CopyHelper obtained from this implementation
      • dataFactory

        public abstract DataFactory dataFactory()
        Returns a DataFactory obtained from this implementation.
        Returns:
        a DataFactory obtained from this implementation
      • dataHelper

        public abstract DataHelper dataHelper()
        Returns a DataHelper obtained from this implementation.
        Returns:
        a DataHelper obtained from this implementation
      • equalityHelper

        public abstract EqualityHelper equalityHelper()
        Returns a EqualityHelper obtained from this implementation.
        Returns:
        a EqualityHelper obtained from this implementation
      • typeHelper

        public abstract TypeHelper typeHelper()
        Returns a TypeHelper obtained from this implementation.
        Returns:
        a TypeHelper obtained from this implementation
      • xmlHelper

        public abstract XMLHelper xmlHelper()
        Returns a XMLHelper obtained from this implementation.
        Returns:
        a XMLHelper obtained from this implementation
      • xsdHelper

        public abstract XSDHelper xsdHelper()
        Returns a XSDHelper obtained from this implementation.
        Returns:
        a XSDHelper obtained from this implementation
      • resolvable

        public abstract ExternalizableDelegator.Resolvable resolvable()
        Create a Resolvable using this implementation
        Returns:
        a Resolvable created using this implementation
      • resolvable

        public abstract ExternalizableDelegator.Resolvable resolvable​(java.lang.Object target)
        Create a Resolvable using this implementation
        Parameters:
        target - the object to be resolved
        Returns:
        a Resolvable created using this implementation
      • getCopyHelper

        public static CopyHelper getCopyHelper()
        Returns a CopyHelper obtained from the default HelperProvider.
        Returns:
        a CopyHelper obtained from the default HelperProvider
      • getDataFactory

        public static DataFactory getDataFactory()
        Returns a DataFactory obtained from the default HelperProvider.
        Returns:
        a DataFactory obtained from the default HelperProvider
      • getDataHelper

        public static DataHelper getDataHelper()
        Returns a DataHelper obtained from the default HelperProvider.
        Returns:
        a DataHelper obtained from the default HelperProvider
      • getEqualityHelper

        public static EqualityHelper getEqualityHelper()
        Returns a EqualityHelper obtained from the default HelperProvider.
        Returns:
        a EqualityHelper obtained from the default HelperProvider
      • getTypeHelper

        public static TypeHelper getTypeHelper()
        Returns a TypeHelper obtained from the default HelperProvider.
        Returns:
        a TypeHelper obtained from the default HelperProvider
      • getXMLHelper

        public static XMLHelper getXMLHelper()
        Returns a XMLHelper obtained from the default HelperProvider.
        Returns:
        a XMLHelper obtained from the default HelperProvider
      • getXSDHelper

        public static XSDHelper getXSDHelper()
        Returns a XSDHelper obtained from the default HelperProvider.
        Returns:
        a XSDHelper obtained from the default HelperProvider
      • createResolvable

        public static ExternalizableDelegator.Resolvable createResolvable()
        Create a Resolvable using the default HelperProvider
        Returns:
        a Resolvable created using the default HelperProvider
      • createResolvable

        public static ExternalizableDelegator.Resolvable createResolvable​(java.lang.Object target)
        Create a Resolvable using the default HelperProvider
        Parameters:
        target - the object to be resolved
        Returns:
        a Resolvable created using the default HelperProvider
      • getDefaultContext

        public static HelperContext getDefaultContext()
        Gets the default HelperContext
        Returns:
        a HelperContext object