Package org.glassfish.hk2.xml.internal

Class XmlRootHandleImpl<T>

java.lang.Object
org.glassfish.hk2.xml.internal.XmlRootHandleImpl<T>
All Implemented Interfaces:
XmlRootHandle<T>
public class XmlRootHandleImpl<T> extends Object implements XmlRootHandle<T>
Author:
jwells

  • Method Details

    • getRoot

      public T getRoot()
      Description copied from interface: XmlRootHandle
      Gets the root of the JavaBean tree
      Specified by:
      getRoot in interface XmlRootHandle<T>
      Returns:
      The root of the JavaBean tree. Will only return null if the tree has not yet been created

    • getRootClass

      public Class<T> getRootClass()
      Description copied from interface: XmlRootHandle
      Returns the root interface of this handle
      Specified by:
      getRootClass in interface XmlRootHandle<T>
      Returns:
      The root class or interface of this handle. Will not return null

    • getURI

      public URI getURI()
      Description copied from interface: XmlRootHandle
      Represents the original URI from which this tree was parsed (or null if this tree did not come from a URI)
      Specified by:
      getURI in interface XmlRootHandle<T>
      Returns:
      The original URI from which this tree was parsed, or null if this tree did not come from a URI

    • isAdvertisedInLocator

      public boolean isAdvertisedInLocator()
      Description copied from interface: XmlRootHandle
      Returns true if this handles root and children are advertised in it service locator
      Specified by:
      isAdvertisedInLocator in interface XmlRootHandle<T>
      Returns:
      true if the root and children are advertised in the associated service locator

    • isAdvertisedInHub

      public boolean isAdvertisedInHub()
      Description copied from interface: XmlRootHandle
      Returns true if this handles root and children are advertised in the Hub
      Specified by:
      isAdvertisedInHub in interface XmlRootHandle<T>
      Returns:
      true if the root and children are advertised in the associated Hub

    • overlay

      public void overlay(XmlRootHandle<T> newRoot)
      Description copied from interface: XmlRootHandle
      This method overlays the current root and children with the root and children from newRoot. newRoot must have the same rootClass and must NOT be advertised in either the locator or the hub. The system will calculate the set of changes needed to convert this root into the root from newRoot.

      All nodes that are at the same spot in the tree (have the same xpath and same instance name) will not be modified, but will instead have attributes changed. All nodes present in newRoot but not in this root will be considered adds. All nodes not present in newRoot but in this root will be considered deletes

      The URI will not be modified by this call, nor will the state of advertisement

      Specified by:
      overlay in interface XmlRootHandle<T>
      Parameters:
      newRoot - The non-null root that will be overlayed onto this handle

    • getXmlRootCopy

      public XmlRootCopy<T> getXmlRootCopy()
      Description copied from interface: XmlRootHandle
      Creates a copy of this tree that is not advertised. Modifications can be made to this copy and then merged back into the parent in a single transaction

      There is no requirement to call XmlRootCopy.merge() since the parent keeps no track of children. However, the XmlRootCopy.merge() method will fail if a modification has been made to the parent since the time the copy was created

      Specified by:
      getXmlRootCopy in interface XmlRootHandle<T>
      Returns:
      A non-null copy of this root that can be modified and then merged back in a single transaction

    • addRoot

      public void addRoot(T newRoot)
      Description copied from interface: XmlRootHandle
      If this handle does not already have a root bean this method will add the one given
      Specified by:
      addRoot in interface XmlRootHandle<T>
      Parameters:
      newRoot - The non-null instance of the root type of this handle

    • addRoot

      public void addRoot()
      Description copied from interface: XmlRootHandle
      This method can be used if the root of the tree has no required fields, and is the combination of XmlService.createBean(Class) and XmlRootHandle.addRoot(Object). This method will throw an exception from the validator (if validation is enabled) if the root type has required fields or fails other validation
      Specified by:
      addRoot in interface XmlRootHandle<T>

    • removeRoot

      public T removeRoot()
      Description copied from interface: XmlRootHandle
      If this handle has a root this method will delete it and all children, leaving the root of this tree null
      Specified by:
      removeRoot in interface XmlRootHandle<T>
      Returns:
      The root that was deleted, or null if the root was already null

    • getReadOnlyRoot

      public T getReadOnlyRoot(boolean representDefaults)
      Description copied from interface: XmlRootHandle
      This method returns a read-only copy of the existing tree. Any method that would change anything in this tree will fail. Methods that are customized will also fail

      If representsDefaults is true then getters for unset fields will return the default value. If representsDefaults is false then getters for unset fields will return null (or 0 (and false) for scalars). Setting representsDefault to false is useful if this tree is to be used to marshall back to XML, since JAXB will then not write the values back out to the file

      Specified by:
      getReadOnlyRoot in interface XmlRootHandle<T>
      Parameters:
      representDefaults - If true getters will return default values, if false getters will return null (or zero/false for scalars)
      Returns:
      A read-only copy of this xml tree or null if there is no current root for this handle

    • addChangeListener

      public void addChangeListener(VetoableChangeListener... listeners)
      Description copied from interface: XmlRootHandle
      Adds a change listener to be invoked before any property is set or a bean is added. The listener must be suitable for storage in a HashSet.

      Rules for change listener:

      • Adds of beans with children will get called back for each child and sub-child added
      • Add listener callbacks will happen parent first but children at the same level are handled in any order
      • When adding a bean the following events will be generated:
        1. An event with an empty string as the propertyName, oldValue null, newValue and source set to the added bean
        2. An event for the parent being added to with propertyName, oldValue the old list or array or direct child, new value the new list or array or direct child
      • Remove listener callbacks will happen child first but children at the same level are handled in any order
      • When removing a bean the following events will be generated:
        1. An event with an empty string as the propertyName, oldValue the removed bean, newValue null, and source set to the removed bean
        2. An event for the parent being removed from with propertyName, oldValue the old list or array or direct child, new value the new list or array or null for the direct child
      • Listeners are run in the order in which they are added
      • If a listener throws a PropertyVetoException subsequent listeners are NOT called and the update will not happen
      • If a listener throws any exception other than PropertyVertoException subsequent listeners WILL be called and the update will not happen
      • If any exceptions happen in any listeners they will end up all being reported in a MultiException
      Specified by:
      addChangeListener in interface XmlRootHandle<T>
      Parameters:
      listeners - non-null listeners to be called whenever a property is changed in any bean in this root. Must be suitable for storage in a HashSet

    • removeChangeListener

      public void removeChangeListener(VetoableChangeListener... listeners)
      Description copied from interface: XmlRootHandle
      Removes a change listener. The listener must be suitable for lookup in a HashSet
      Specified by:
      removeChangeListener in interface XmlRootHandle<T>

    • getChangeListeners

      public List<VetoableChangeListener> getChangeListeners()
      Description copied from interface: XmlRootHandle
      Gets the current list of change listeners
      Specified by:
      getChangeListeners in interface XmlRootHandle<T>
      Returns:
      The non-null but possibly empty list of change listeners to be called when a bean is added, removed or modified

    • lockForTransaction

      public XmlHandleTransaction<T> lockForTransaction() throws IllegalStateException
      Description copied from interface: XmlRootHandle
      This method will lock the bean tree represented by this XmlRootHandle and start a transaction. Any changes made while this transaction is in-flight will not be visible to any other thread until this transaction is committed. This transaction MUST be committed or abandoned before any other thread can get access to any beans in this tree.

      In particular, the code using this transaction should logically behave like the following code: 

       XmlHandleTransaction transaction = root.lockForTransaction();
 try {
   // Do many many edits all at once
 }
 finally {
   transaction.commit();
 }
      Specified by:
      lockForTransaction in interface XmlRootHandle<T>
      Returns:
      The never null transaction object that must either be abandoned or committed before the write lock on this bean tree is released
      Throws:
      IllegalStateException - if this bean tree is not allowed to have a transaction started on it

    • startValidating

      public void startValidating()
      Description copied from interface: XmlRootHandle
      Does javax validation on the root bean from the root. This will cause every change hereafter to be validated
      Specified by:
      startValidating in interface XmlRootHandle<T>

    • stopValidating

      public void stopValidating()
      Description copied from interface: XmlRootHandle
      Stops this root handle from doing javax validation on modifications
      Specified by:
      stopValidating in interface XmlRootHandle<T>

    • isValidating

      public boolean isValidating()
      Description copied from interface: XmlRootHandle
      True if this handle is currently validating changes
      Specified by:
      isValidating in interface XmlRootHandle<T>

    • marshal

      public void marshal(OutputStream outputStream) throws IOException
      Description copied from interface: XmlRootHandle
      Will marshal this tree into the given stream. Will hold the read lock of this tree while it does so that the tree cannot change underneath while it is being written out. It will use a basic indentation and new-line scheme
      Specified by:
      marshal in interface XmlRootHandle<T>
      Parameters:
      outputStream - A non-closed output stream. This method will not close the output stream
      Throws:
      IOException - On any exception that might happen

    • marshal

      public void marshal(OutputStream outputStream, Map<String,Object> options) throws IOException
      Description copied from interface: XmlRootHandle
      Will marshal this tree into the given stream. Will hold the read lock of this tree while it does so that the tree cannot change underneath while it is being written out. It will use a basic indentation and new-line scheme
      Specified by:
      marshal in interface XmlRootHandle<T>
      Parameters:
      outputStream - A non-closed output stream. This method will not close the output stream
      options - optional (possibly null) options from the caller
      Throws:
      IOException - On any exception that might happen

    • getPackageNamespace

      public Map<String,String> getPackageNamespace(Class<?> clazz)

    • toString

      public String toString()
      Overrides:
      toString in class Object