wt.ixb.publicforapps
Class ApplicationExportHandlerForJar

java.lang.Object
  wt.ixb.publicforapps.ApplicationExportHandlerTemplate
      wt.ixb.publicforapps.ApplicationExportHandlerForJar

All Implemented Interfaces:

ApplicationExpImportHandler, ApplicationExportHandler

public class ApplicationExportHandlerForJar
extends ApplicationExportHandlerTemplate

This class provides methods for storing XML and content files in export jar file. It handles both ApplicationData content and content residing in local file system.

Supported API: true

Extendable: false

Constructor Summary

ApplicationExportHandlerForJar(File fileToSave, File dirToSave)


Supported API: true

Method Summary

void	addObjectToManifest(String userObjImage) Add the localized object identifier of the object (userObjImage) to the manifest.
void	cleanTempDir() Delete all files in the directory (including this directory) where is used to save the jar file.
void	createManifest() Create the manifest file in the jar.
void	createManifest(File manifestFile) Create the manifest file in the jar.
File	getJarFile() Gets the value of the attribute: jarFile; The jar file to store exportedinformation (meta data and content data) Supported API: true
protected File	getSaveDir() Gets the value of the attribute: saveDir; Directory where the jar file will be stored.
void	reallyStoreContent(Object contentHolder, Exporter exporter, InputStream content, String contentId) Stores the given content of the content parameter "contentAttr".
void	storeAdditionalInfo(Object object, IxbDocument fileXML, String fileId) Stores additional information related to object and its XML representation.
String	storeContent(File contentFile) Stores content files residing in the local file system (as in the case of Representation objects).
String	storeContent(File contentFile, String filename) Stores content files residing in the local file system (as in the case of Representation objects).
String	storeContent(Object contentAttr) Stores the given content of exported object.
String	storeDocument(IxbElement doc, String dtd) Stores the given XML element, which is the XML representation of exported object, based on the provided DTD.

Methods inherited from class wt.ixb.publicforapps.ApplicationExportHandlerTemplate

storeDocument, storeLogMessage

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ApplicationExportHandlerForJar

public ApplicationExportHandlerForJar(File fileToSave,
                                      File dirToSave)
                               throws WTException

Supported API: true

Parameters:

fileToSave - The jar file to store exportedinformation (meta data and content data)

dirToSave - Directory where the jar file will be stored.

Throws:

WTException

Method Detail

getJarFile

public File getJarFile()

Gets the value of the attribute: jarFile; The jar file to store exportedinformation (meta data and content data)

Supported API: true

Returns:

File

getSaveDir

protected File getSaveDir()

Gets the value of the attribute: saveDir; Directory where the jar file will be stored.

Supported API: true

Returns:

File

reallyStoreContent

public void reallyStoreContent(Object contentHolder,
                               Exporter exporter,
                               InputStream content,
                               String contentId)
                        throws WTException

Stores the given content of the content parameter "contentAttr". The parameter "contentId" is the unique content ID which was previously computed and returned by storeContent (Object contentAttr).

Supported API: true

Specified by:

reallyStoreContent in interface ApplicationExportHandler

Overrides:

reallyStoreContent in class ApplicationExportHandlerTemplate

Parameters:

contentHolder - The object holding the attribute (directly or indirectly) "contentAttr".

exporter -

content - The content as InputStream which is associated with the contentId.

contentId - The unique content ID which was previously computed by calling "storeContent (Object contentAttr)"

Throws:

WTException

storeContent

public String storeContent(File contentFile)
                    throws WTException

Stores content files residing in the local file system (as in the case of Representation objects).

Supported API: true

Specified by:

storeContent in interface ApplicationExportHandler

Overrides:

storeContent in class ApplicationExportHandlerTemplate

Parameters:

file -

Returns:

String

Throws:

WTException

storeContent

public String storeContent(File contentFile,
                           String filename)
                    throws WTException

Stores content files residing in the local file system (as in the case of Representation objects).

Supported API: true

Specified by:

storeContent in interface ApplicationExportHandler

Overrides:

storeContent in class ApplicationExportHandlerTemplate

Parameters:

file -

filename -

Returns:

String

Throws:

WTException

storeContent

public String storeContent(Object contentAttr)
                    throws WTException

Stores the given content of exported object. The return value is String, that will be used in XML file as an identifier of this content. Application should be able to find the content during the import process by this identifier. The content of the associated object might not be saved, depending on the implementation of the this interface.

Supported API: true

Specified by:

storeContent in interface ApplicationExportHandler

Overrides:

storeContent in class ApplicationExportHandlerTemplate

Parameters:

contentAttr - The content attribute which is related to InputStream or BLOB. e.g. it can be ApplicationData , File or String (full path of a file), etc

Returns:

String

Throws:

WTException

storeDocument

public String storeDocument(IxbElement doc,
                            String dtd)
                     throws WTException

Stores the given XML element, which is the XML representation of exported object, based on the provided DTD. If parameter dtd is null, Windchill's default DTD is assumed. Return XML file name or some other string identifier for the stored element.

Supported API: true

Specified by:

storeDocument in interface ApplicationExportHandler

Overrides:

storeDocument in class ApplicationExportHandlerTemplate

Parameters:

elem -

dtd -

Returns:

String

Throws:

WTException

See Also:

storeDocument (IxbElement elem)

storeAdditionalInfo

public void storeAdditionalInfo(Object object,
                                IxbDocument fileXML,
                                String fileId)
                         throws WTException

Stores additional information related to object and its XML representation. Currently it stores information regarding the source container of the object. This method is called from the handler after object is exported.

Supported API: true

Specified by:

storeAdditionalInfo in interface ApplicationExportHandler

Overrides:

storeAdditionalInfo in class ApplicationExportHandlerTemplate

Parameters:

object -

fileXML -

fileId -

Throws:

WTException

addObjectToManifest

public void addObjectToManifest(String userObjImage)

Add the localized object identifier of the object (userObjImage) to the manifest.

Supported API: true

Parameters:

userObjImage - The localized object identifier of the object

cleanTempDir

public void cleanTempDir()
                  throws WTException

Delete all files in the directory (including this directory) where is used to save the jar file. The directory was the one from the constructor ApplicationExportHandlerForJar( File fileToSave, File dirToSave ).

Supported API: true * @exception wt.util.WTException

Throws:

WTException

createManifest

public void createManifest()
                    throws WTException

Create the manifest file in the jar. The content of the manifest file will copy the information as accumulated by calling the method addObjectToManifest (String userObjImage).

Supported API: true * @exception wt.util.WTException

Throws:

WTException

createManifest

public void createManifest(File manifestFile)
                    throws WTException

Create the manifest file in the jar. The manifest file will copy the contents in the File file.

Supported API: true * @exception wt.util.WTException

Throws:

WTException