Package org.cip4.jdflib.extensions

Class XJDFHelper

    • Constructor Detail

      • XJDFHelper

        public XJDFHelper​(KElement xjdf)
        Parameters:
        xjdf - if null a new XJDF is generated, else the xjdf root to be manipulated

      • XJDFHelper

        public XJDFHelper​(java.lang.String jobID,
                  java.lang.String jobPartID,
                  VJDFAttributeMap parts)
        Parameters:
        jobID - , if null a new jobid is generated
        jobPartID -
        parts -

      • XJDFHelper

        public XJDFHelper​(JDFElement.EnumVersion version,
                  java.lang.String jobID)
        Parameters:
        jobID -
        jobPartID -

      • XJDFHelper

        public XJDFHelper​(java.lang.String jobID,
                  java.lang.String jobPartID)
        Parameters:
        jobID -
        jobPartID -

    • Method Detail

      • getHelper

        public static XJDFHelper getHelper​(XMLDoc doc)
        factory to create a helper from a doc
        Parameters:
        doc - the xmldoc to parse
        Returns:
        the helper

      • getHelper

        public static XJDFHelper getHelper​(KElement root)
        factory to create a helper from an element
        Parameters:
        root - the element to parse if not an XJDF - search in ancestors of element
        Returns:
        the helper

      • isXJDF

        public static boolean isXJDF​(KElement root)
        Parameters:
        root -
        Returns:

      • isXJMF

        public static boolean isXJMF​(KElement root)
        Parameters:
        root -
        Returns:

      • parseFile

        public static XJDFHelper parseFile​(java.lang.String fileName)
        Parameters:
        fileName -
        Returns:

      • parseFile

        public static XJDFHelper parseFile​(java.io.File fileName)
        Parameters:
        fileName -
        Returns:

      • getSets

        public java.util.Vector<SetHelper> getSets()
        Returns:
        the vector of parametersets and resourcesets

      • getSets

        public java.util.Vector<SetHelper> getSets​(java.lang.String setName,
                                           JDFResourceLink.EnumUsage usage)
        Parameters:
        setName -
        usage -
        Returns:
        the vector of parametersets and resourcesets

      • getCreateAuditPool

        public AuditPoolHelper getCreateAuditPool()
        Returns:

      • getSet

        public SetHelper getSet​(java.lang.String id)
        Parameters:
        id -
        Returns:
        the parameterset and resourceset with ID=iD

      • getNodeInfo

        public SetHelper getNodeInfo()
        Returns:

      • getCreateNodeInfo

        public SetHelper getCreateNodeInfo()
        Returns:

      • getSetForPartition

        public SetHelper getSetForPartition​(java.lang.String id)
        Parameters:
        id -
        Returns:
        the parameterset and resourceset with a child partiton with ID=iD

      • getPartition

        public ResourceHelper getPartition​(java.lang.String id)
        Parameters:
        id -
        Returns:
        the parameterset and resourceset with ID=iD

      • isSet

        @Deprecated
public boolean isSet​(KElement e)
        Deprecated.
        use SetHelper.isSet
        is the element a set?
        Parameters:
        e -
        Returns:

      • getJobID

        public java.lang.String getJobID()
        Returns:
        the

      • getDependentJobParts

        public VString getDependentJobParts​(JDFResourceLink.EnumUsage usage)
        Parameters:
        usage - if Input, get predecessors, if Output get followers, if null get any
        Returns:
        the list of dependents, null if none were found

      • getProduct

        public ProductHelper getProduct​(java.lang.String id)
        Parameters:
        id -
        Returns:

      • getProductByExternalID

        public ProductHelper getProductByExternalID​(java.lang.String id)
        Parameters:
        id -
        Returns:

      • getCreateProduct

        public ProductHelper getCreateProduct​(java.lang.String id)
        Parameters:
        id -
        Returns:

      • getCreateProduct

        public ProductHelper getCreateProduct​(java.lang.String id,
                                      java.lang.String externalID)
        Parameters:
        id -
        externalID - TODO
        Returns:

      • getRootProduct

        public ProductHelper getRootProduct​(int iProduct)
        get the Root product by index - note that this need not be the index in the product list but rather depends on the index of the ID in ProductList/@RootProducts
        Parameters:
        iProduct - the index of root products
        Returns:
        the product, null if no matching product exists

      • getCreateRootProduct

        public ProductHelper getCreateRootProduct​(int iProduct)
        get the Root product by index - note that this need not be the index in the product list but rather depends on the index of the ID in ProductList/@RootProducts
        Parameters:
        iProduct - the index of root products
        Returns:
        the product, null if no matching product exists

      • numProductHelpers

        public int numProductHelpers​(boolean rootOnly)
        Parameters:
        rootOnly -
        Returns:

      • getRootProductHelpers

        public java.util.Vector<ProductHelper> getRootProductHelpers()
        Returns:
        the xjdf root element

      • getProductHelpers

        public java.util.Vector<ProductHelper> getProductHelpers()
        the vector of product helpers; null if no ProductList or no ProductList/Product
        Returns:
        the vector of product helpers

      • getPartition

        public ResourceHelper getPartition​(java.lang.String name,
                                   int iSet,
                                   int iPart)
        Parameters:
        name -
        iSet -
        iPart -
        Returns:
        PartitionHelper for the requested partition, null if it ain't there

      • getResource

        public KElement getResource​(java.lang.String name,
                            int iSet,
                            int iPart)
        Parameters:
        name -
        iSet -
        iPart -
        Returns:
        resource for the requested partition, null if it ain't there

      • getSet

        public SetHelper getSet​(java.lang.String name,
                        int iSkip)
        Parameters:
        name -
        iSkip -
        Returns:
        the SetHelper for the resourceset with a given name

      • getSet

        public SetHelper getSet​(java.lang.String name,
                        JDFResourceLink.EnumUsage usage,
                        java.lang.String processUsage)
        Parameters:
        name -
        usage -
        processUsage - - if uses as a type then the cpi is calculated and returned
        Returns:
        the SetHelper for the vector of resourcesets

      • getSet

        public SetHelper getSet​(java.lang.String name,
                        JDFResourceLink.EnumUsage usage,
                        java.lang.String processUsage,
                        JDFIntegerList cpi)
        Parameters:
        name -
        usage -
        processUsage -
        Returns:
        the SetHelper for the vector of resourcesets

      • getSet

        public SetHelper getSet​(java.lang.String name,
                        JDFResourceLink.EnumUsage usage,
                        java.lang.String processUsage,
                        int cpi)
        Parameters:
        name -
        usage -
        processUsage -
        Returns:
        the SetHelper

      • getSet

        public SetHelper getSet​(java.lang.String name,
                        JDFResourceLink.EnumUsage usage)
        Parameters:
        name -
        usage -
        Returns:
        the SetHelper for the vector of resourcesets

      • appendSet

        public SetHelper appendSet​(java.lang.String family,
                           java.lang.String name,
                           JDFResourceLink.EnumUsage usage)
        Parameters:
        family - - always RESOURCE better use appendResourceSet
        name -
        usage -
        Returns:
        a new set element

      • getCreateSet

        @Deprecated
public SetHelper getCreateSet​(java.lang.String family,
                              java.lang.String name,
                              JDFResourceLink.EnumUsage usage)
        Deprecated.
        - all sets are now resource sets
        Parameters:
        family -
        name -
        usage -
        Returns:
        a new set element

      • getCreateResourceSet

        @Deprecated
public SetHelper getCreateResourceSet​(java.lang.String name,
                                      JDFResourceLink.EnumUsage usage)
        Deprecated.
        use getCreateSet
        Parameters:
        name -
        usage -
        Returns:
        a new set element

      • getCreateResource

        public KElement getCreateResource​(java.lang.String name,
                                  JDFResourceLink.EnumUsage usage,
                                  java.lang.String processUsage)
        Parameters:
        name -
        usage -
        Returns:
        a new set element

      • getCreateSet

        public SetHelper getCreateSet​(java.lang.String name,
                              JDFResourceLink.EnumUsage usage,
                              java.lang.String processUsage)
        get or create a ResourceSet with a name, usage and processUsage
        Parameters:
        name -
        usage -
        processUsage -
        Returns:
        a new set element

      • getCreateParameterSet

        @Deprecated
public SetHelper getCreateParameterSet​(java.lang.String name,
                                       JDFResourceLink.EnumUsage usage)
        Deprecated.
        Parameters:
        name -
        usage -
        Returns:
        a new set element

      • removeSet

        public void removeSet​(java.lang.String name)
        Parameters:
        name -

      • appendParameter

        @Deprecated
public SetHelper appendParameter​(java.lang.String name,
                                 JDFResourceLink.EnumUsage usage)
        Deprecated.
        Parameters:
        name -
        usage -
        Returns:
        a new set element

      • appendProduct

        public ProductHelper appendProduct()
        Returns:
        a new producthelper

      • appendResource

        @Deprecated
public SetHelper appendResource​(java.lang.String name,
                                JDFResourceLink.EnumUsage usage)
        Deprecated.
        Parameters:
        name -
        usage -
        Returns:
        a new set element

      • appendResourceSet

        public SetHelper appendResourceSet​(java.lang.String name,
                                   JDFResourceLink.EnumUsage usage)
        Parameters:
        name -
        usage -
        Returns:
        a new set element

      • toString

        public java.lang.String toString()
        Overrides:
        toString in class BaseXJDFHelper
        Returns:
        See Also:
        Object.toString()

      • writeToFile

        public boolean writeToFile​(java.lang.String file)
        Parameters:
        file -
        Returns:

      • writeToDir

        public java.io.File writeToDir​(java.lang.String dir)
        write to a directory - potentially generating a jobPartID
        Parameters:
        dir -
        Returns:

      • writeToStream

        public void writeToStream​(java.io.OutputStream os)
                   throws java.io.IOException
        Parameters:
        os -
        Throws:
        java.io.IOException

      • setTypes

        public void setTypes​(java.lang.String types)
        Parameters:
        types -

      • setTypes

        public void setTypes​(VString vtypes)
        Parameters:
        vtypes -

      • getTypes

        public VString getTypes()
        Returns:
        types the vector of types

      • getCategory

        public java.lang.String getCategory()
        Returns:
        the category

      • getPartMapVector

        public VJDFAttributeMap getPartMapVector()
        Returns:
        the category

      • getType

        public JDFNode.EnumType getType()
        Returns:
        the implied JDF/@Type - if only one type in @Types, then we use said @Types, else ProcessGroup

      • clone

        public XJDFHelper clone()
        Overrides:
        clone in class java.lang.Object
        Returns:
        a clone of this; any underlying documents or elements are also cloned

      • getJobPartID

        public java.lang.String getJobPartID()
        Returns:

      • setJobPartID

        public void setJobPartID​(java.lang.String jobPartID)
        Parameters:
        jobPartID -

      • setJobID

        public void setJobID​(java.lang.String jobID)
        Parameters:
        jobID -

      • setCategory

        public void setCategory​(java.lang.String cat)
        Parameters:
        cat -

      • getDescriptiveName

        public java.lang.String getDescriptiveName()
        Overrides:
        getDescriptiveName in class BaseXJDFHelper
        Returns:
        the productID of the product

      • removeType

        public void removeType​(java.lang.String typ,
                       int iSkip)
        remove a types token
        Parameters:
        typ -
        iSkip -

      • addType

        public XJDFHelper addType​(java.lang.String typ)
        append a types token
        Parameters:
        typ -

      • addType

        public void addType​(java.lang.String typ,
                    int iSkip)
        add a types token
        Parameters:
        typ -
        iSkip - <0 for append

      • indexOfType

        public int indexOfType​(java.lang.String typ,
                       int iSkip)
        Parameters:
        typ -
        iSkip -
        Returns:
        the cpi of the iSkip occurrence of typ

      • defaultVersion

        public static JDFElement.EnumVersion defaultVersion()
        Returns:
        default version - currently 2.0

      • setICSVersions

        public VString setICSVersions​(ICSVersion... versions)
        set attribute ICSVersions
        Parameters:
        value - the value to set the attribute to

      • appendICSVersion

        public java.lang.String appendICSVersion​(ICSVersion v)

      • setExternalID

        public void setExternalID​(java.lang.String newID)
        See Also:
        BaseXJDFHelper.setExternalID(java.lang.String)

      • setDescriptiveName

        public void setDescriptiveName​(java.lang.String description)
        See Also:
        BaseXJDFHelper.setDescriptiveName(java.lang.String)

      • setGeneralID

        public void setGeneralID​(java.lang.String idUsage,
                         java.lang.String idValue)
        See Also:
        BaseXJDFHelper.setGeneralID(java.lang.String, java.lang.String)