Class IDResolver

  • Direct Known Subclasses:
    IDResolver

    public abstract class IDResolver
    extends Object

    IDResolver can be subclassed to allow customization of the ID/IDREF processing of Unmarshaller. A custom IDResolver can be specified on the Unmarshaller as follows:

    IDResolver customResolver = new MyIDResolver(); unmarshaller.setIDResolver(customResolver);

    Since:
    EclipseLink 2.5.0
    • Constructor Detail

      • IDResolver

        public IDResolver()
    • Method Detail

      • resolve

        public abstract Callable<?> resolve​(Object id,
                                            Class type)
                                     throws SAXException

        Resolve the object of Class type, uniquely identified by id.

        Parameters:
        id - The Object that uniquely identifies the object to be found.
        type - The Class of the object to be found.
        Returns:
        a Callable that will return the resolved object.
        Throws:
        SAXException
      • resolve

        public abstract Callable<?> resolve​(Map<String,​Object> id,
                                            Class type)
                                     throws SAXException

        Resolve the object of Class type, uniquely identified by the composite key information specified in the id Map.

        Parameters:
        id - A Map of id values, keyed on the attribute name.
        type - The Class of the object to be found.
        Returns:
        a Callable that will return the resolved object.
        Throws:
        SAXException
      • bind

        public abstract void bind​(Object id,
                                  Object obj)
                           throws SAXException

        Bind the object obj to the identifier id.

        Parameters:
        id - The id Object that uniquely identifies the object to be bound.
        obj - The object that will be bound to this id.
        Throws:
        SAXException
      • bind

        public abstract void bind​(Map<String,​Object> id,
                                  Object obj)
                           throws SAXException

        Bind the object obj to the composite key information specified in the id Map.

        Parameters:
        id - A Map of id values, keyed on attribute name.
        obj - The object that will be bound to this id.
        Throws:
        SAXException
      • startDocument

        public void startDocument​(ErrorHandler errorHandler)
                           throws SAXException

        Called when unmarshalling begins.

        Parameters:
        errorHandler - Any errors encountered during the unmarshal process should be reported to this handler.
        Throws:
        SAXException