org.cip4.jdflib.extensions

Class XJDFHelper

java.lang.Object

org.cip4.jdflib.extensions.BaseXJDFHelper

org.cip4.jdflib.extensions.XJDFHelper

All Implemented Interfaces:

Cloneable

public class XJDFHelper
extends BaseXJDFHelper
implements Cloneable

Author:

Rainer Prosi, Heidelberger Druckmaschinen *

Field Summary

Fields

Modifier and Type	Field and Description
static String	PARAMETER Deprecated.
static String	RESOURCE
static String	XJDF
static String	XJMF

Fields inherited from class org.cip4.jdflib.extensions.BaseXJDFHelper

log, theElement

Constructor Summary

Constructors

Constructor and Description
XJDFHelper(KElement xjdf)
XJDFHelper(String jobID, String jobPartID, VJDFAttributeMap parts)

Method Summary

Modifier and Type	Method and Description
XJDFHelper	addType(JDFNode.EnumType typ) append a enumerated types token
XJDFHelper	addType(String typ) append a types token
void	addType(String typ, int iSkip) add a types token
SetHelper	appendParameter(String name, JDFResourceLink.EnumUsage usage) Deprecated.
ProductHelper	appendProduct()
SetHelper	appendResource(String name, JDFResourceLink.EnumUsage usage) Deprecated.
SetHelper	appendResourceSet(String name, JDFResourceLink.EnumUsage usage)
SetHelper	appendSet(String family, String name, JDFResourceLink.EnumUsage usage)
void	cleanUp() generic cleanup routine
XJDFHelper	clone()
AuditPoolHelper	getAuditPool()
String	getCategory()
AuditPoolHelper	getCreateAuditPool()
SetHelper	getCreateParameterSet(String name, JDFResourceLink.EnumUsage usage) Deprecated.
ProductHelper	getCreateProduct(String id)
SetHelper	getCreateResourceSet(String name, JDFResourceLink.EnumUsage usage) Deprecated. use getCreateSet
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
SetHelper	getCreateSet(String name, JDFResourceLink.EnumUsage usage)
SetHelper	getCreateSet(String name, JDFResourceLink.EnumUsage usage, String processUsage) get or create a ResourceSet with a name, usage and processUsage
SetHelper	getCreateSet(String family, String name, JDFResourceLink.EnumUsage usage)
VString	getDependentJobParts(JDFResourceLink.EnumUsage usage)
static XJDFHelper	getHelper(KElement root) factory to create a helper from an element
static XJDFHelper	getHelper(XMLDoc doc) factory to create a helper from a doc
String	getJobID()
String	getJobPartID()
ResourceHelper	getPartition(String id)
ResourceHelper	getPartition(String name, int iSet, int iPart)
VJDFAttributeMap	getPartMapVector()
ProductHelper	getProduct(String id)
Vector<ProductHelper>	getProductHelpers() the vector of product helpers; null if no ProductList or no ProductList/Product
KElement	getResource(String name, int iSet, int iPart)
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
Vector<ProductHelper>	getRootProductHelpers()
SetHelper	getSet(String id)
SetHelper	getSet(String name, int iSkip)
SetHelper	getSet(String name, JDFResourceLink.EnumUsage usage)
SetHelper	getSet(String name, JDFResourceLink.EnumUsage usage, String processUsage)
SetHelper	getSetForPartition(String id)
Vector<SetHelper>	getSets()
Vector<SetHelper>	getSets(String setName, JDFResourceLink.EnumUsage usage)
JDFNode.EnumType	getType()
VString	getTypes()
int	indexOfType(String typ, int iSkip)
boolean	isSet(KElement e) Deprecated. use SetHelper.isSet
int	numProductHelpers(boolean rootOnly)
void	removeSet(String name)
void	removeType(String typ, int iSkip) remove a types token
void	reorder() ensure we always have auditpool and productlist first
void	setJobID(String jobID)
void	setJobPartID(String jobPartID)
void	setTypes(String types)
void	setTypes(VString vtypes)
String	toString()
File	writeToDir(String dir) write to a directory - potentially generating a jobPartID
boolean	writeToFile(String file)
void	writeToStream(OutputStream os)

Methods inherited from class org.cip4.jdflib.extensions.BaseXJDFHelper

appendElement, copyHelper, deleteNode, ensureID, equals, getAttribute, getCreateElement, getGeneralID, getID, getRoot, getXPathElement, getXPathValue, hashCode, isEqual, removeAttribute, setAttribute, setGeneralID, setID, setXPathValue

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

RESOURCE

public static final String RESOURCE

See Also:

Constant Field Values

XJDF

public static final String XJDF

See Also:

Constant Field Values

XJMF

public static final String XJMF

See Also:

Constant Field Values

PARAMETER

@Deprecated
public static final String PARAMETER

Deprecated.

See Also:

Constant Field Values

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(String jobID,
                  String jobPartID,
                  VJDFAttributeMap parts)

Parameters:

jobID - , if null a new jobid is generated

jobPartID -

parts -

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

getSets

public Vector<SetHelper> getSets()

Returns:

the vector of parametersets and resourcesets

getSets

public Vector<SetHelper> getSets(String setName,
                                 JDFResourceLink.EnumUsage usage)

Parameters:

setName -

usage -

Returns:

the vector of parametersets and resourcesets

getAuditPool

public AuditPoolHelper getAuditPool()

Returns:

getCreateAuditPool

public AuditPoolHelper getCreateAuditPool()

Returns:

getSet

public SetHelper getSet(String id)

Parameters:

id -

Returns:

the parameterset and resourceset with ID=iD

getSetForPartition

public SetHelper getSetForPartition(String id)

Parameters:

id -

Returns:

the parameterset and resourceset with a child partiton with ID=iD

getPartition

public ResourceHelper getPartition(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 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(String id)

Parameters:

id -

Returns:

getCreateProduct

public ProductHelper getCreateProduct(String id)

Parameters:

id -

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 Vector<ProductHelper> getRootProductHelpers()

Returns:

the xjdf root element

getProductHelpers

public 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(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(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(String name,
                        int iSkip)

Parameters:

name -

iSkip -

Returns:

the SetHelper for the vector of parametersets and resourcesets

getSet

public SetHelper getSet(String name,
                        JDFResourceLink.EnumUsage usage,
                        String processUsage)

Parameters:

name -

usage -

processUsage -

Returns:

the SetHelper for the vector of resourcesets

getSet

public SetHelper getSet(String name,
                        JDFResourceLink.EnumUsage usage)

Parameters:

name -

usage -

Returns:

the SetHelper for the vector of resourcesets

appendSet

public SetHelper appendSet(String family,
                           String name,
                           JDFResourceLink.EnumUsage usage)

Parameters:

family - - always RESOURCE better use appendResourceSet

name -

usage -

Returns:

a new set element

getCreateSet

public SetHelper getCreateSet(String family,
                              String name,
                              JDFResourceLink.EnumUsage usage)

Parameters:

family -

name -

usage -

Returns:

a new set element

getCreateResourceSet

@Deprecated
public SetHelper getCreateResourceSet(String name,
                                                  JDFResourceLink.EnumUsage usage)

Deprecated. use getCreateSet

Parameters:

name -

usage -

Returns:

a new set element

getCreateSet

public SetHelper getCreateSet(String name,
                              JDFResourceLink.EnumUsage usage)

Parameters:

name -

usage -

Returns:

a new set element

getCreateSet

public SetHelper getCreateSet(String name,
                              JDFResourceLink.EnumUsage usage,
                              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(String name,
                                                   JDFResourceLink.EnumUsage usage)

Deprecated.

Parameters:

name -

usage -

Returns:

a new set element

removeSet

public void removeSet(String name)

Parameters:

name -

appendParameter

@Deprecated
public SetHelper appendParameter(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(String name,
                                            JDFResourceLink.EnumUsage usage)

Deprecated.

Parameters:

name -

usage -

Returns:

a new set element

appendResourceSet

public SetHelper appendResourceSet(String name,
                                   JDFResourceLink.EnumUsage usage)

Parameters:

name -

usage -

Returns:

a new set element

toString

public String toString()

Overrides:

toString in class BaseXJDFHelper

Returns:

See Also:

Object.toString()

writeToFile

public boolean writeToFile(String file)

Parameters:

file -

Returns:

writeToDir

public File writeToDir(String dir)

write to a directory - potentially generating a jobPartID

Parameters:

dir -

Returns:

writeToStream

public void writeToStream(OutputStream os)
                   throws IOException

Parameters:

os -

Throws:

IOException

setTypes

public void setTypes(String types)

Parameters:

types -

setTypes

public void setTypes(VString vtypes)

Parameters:

vtypes -

getTypes

public VString getTypes()

Returns:

types the vector of types

getCategory

public 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

cleanUp

public void cleanUp()

Description copied from class: BaseXJDFHelper

generic cleanup routine

Overrides:

cleanUp in class BaseXJDFHelper

See Also:

BaseXJDFHelper.cleanUp()

clone

public XJDFHelper clone()

Overrides:

clone in class Object

Returns:

a clone of this; any underlying documents or elements are also cloned

getJobPartID

public String getJobPartID()

Returns:

setJobPartID

public void setJobPartID(String jobPartID)

Parameters:

jobPartID -

setJobID

public void setJobID(String jobID)

Parameters:

jobID -

reorder

public void reorder()

ensure we always have auditpool and productlist first

Overrides:

reorder in class BaseXJDFHelper

See Also:

BaseXJDFHelper.reorder()

removeType

public void removeType(String typ,
                       int iSkip)

remove a types token

Parameters:

typ -

iSkip -

addType

public XJDFHelper addType(String typ)

append a types token

Parameters:

typ -

addType

public XJDFHelper addType(JDFNode.EnumType typ)

append a enumerated types token

Parameters:

typ -

addType

public void addType(String typ,
                    int iSkip)

add a types token

Parameters:

typ -

iSkip - <0 for append

indexOfType

public int indexOfType(String typ,
                       int iSkip)

Parameters:

typ -

iSkip -

Returns:

the cpi of the iSkip occurrence of typ