Package org.docx4j.openpackaging.contenttype

Class ContentTypeManager

java.lang.Object

org.docx4j.openpackaging.contenttype.ContentTypeManager

public class ContentTypeManager
extends Object

Manage package content types ([Content_Types].xml ) .

Version:

1.0

Author:

Julien Chable

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CONTENT_TYPES_PART_NAME	Content type part name.
protected static org.slf4j.Logger	log
static final String	TYPES_NAMESPACE_URI	Content type namespace

Constructor Summary

Constructors

Constructor	Description
ContentTypeManager()

Method Summary

Modifier and Type	Method	Description
void	addDefaultContentType(String extension, String contentType)
void	addDefaultContentType(String extension, CTDefault contentType)	Add a content type associated with the specified extension.
void	addOverrideContentType(URI partUri, String contentType)
void	addOverrideContentType(URI partUri, CTOverride contentType)	Add an override content type for a specific part.
void	addOverrideContentType(PartName partName, String contentType)
void	clearAll()	Clear all content types.
void	clearOverrideContentTypes()	Clear all override content types.
Part	CreateCommentsPartObject(String partName)
Part	CreateCustomXmlDataStoragePropertiesPartObject(String partName)
Part	CreateDefaultXmlPartObject(String partName)
Part	CreateDocPropsCorePartObject(String partName)
Part	CreateDocPropsCustomPartObject(String partName)
Part	CreateDocPropsExtendedPartObject(String partName)
Part	CreateDocumentSettingsPartObject(String partName)
Part	CreateEndnotesPartObject(String partName)
Part	CreateFontTablePartObject(String partName)
Part	CreateFooterPartObject(String partName)
Part	CreateFootnotesPartObject(String partName)
Part	CreateGlossaryDocumentPartObject(String partName)
Part	CreateHeaderPartObject(String partName)
Part	CreateMainDocumentPartObject(String partName)
Part	CreateNumberingPartObject(String partName)
Part	CreateObfuscatedFontPartObject(String partName)
OpcPackage	createPackage(String pkgContentType)	Return a package of the appropriate type.
Part	CreateStyleDefinitionsPartObject(String partName)
Part	CreateThemePartObject(String partName)
Part	CreateWebSettingsPartObject(String partName)
String	getContentType(PartName partName)	Get the content type for the specified part, if any.
TreeMap<String,CTDefault>	getDefaultContentType()
TreeMap<URI,CTOverride>	getOverrideContentType()
Part	getPart(String partName, Relationship rel)
URI	getPartNameOverridenByContentType(String contentType)
boolean	isContentEqual(ContentTypeManager other)
boolean	isContentTypeRegistered(String contentType)	Check if the specified content type is already registered as a default content type.
boolean	isOverrideContentTypeRegistered(String contentType)	Check if the specified content type is already registered as a default content type.
void	marshal(OutputStream os)
void	marshal(Node node)
Part	newPartForContentType(String contentType, String partName, Relationship rel)
void	parseContentTypesFile(InputStream contentTypes)
void	removeContentType(PartName partName)	Deprecated.
void	removeDefaultContentType(String ext)	Delete a default content type based on the specified part name.
void	removeOverrideContentType(PartName partName)	Delete an override content type based on the specified part name.
String	toString()

Methods inherited from class java.lang.Object

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

Field Details

log

protected static org.slf4j.Logger log

CONTENT_TYPES_PART_NAME

public static final String CONTENT_TYPES_PART_NAME

Content type part name.

See Also:

• Constant Field Values

TYPES_NAMESPACE_URI

public static final String TYPES_NAMESPACE_URI

Content type namespace

See Also:

• Constant Field Values

Constructor Details

ContentTypeManager

public ContentTypeManager()

Method Details

getDefaultContentType

public TreeMap<String,CTDefault> getDefaultContentType()

Returns:

the defaultContentType

Since:

2.8.1

getOverrideContentType

public TreeMap<URI,CTOverride> getOverrideContentType()

Returns:

the overrideContentType

Since:

2.8.1

addOverrideContentType

public void addOverrideContentType(URI partUri,
 CTOverride contentType)

Add an override content type for a specific part.

Parameters:

partUri - Uri of the part.

contentType - Content type of the part.

addOverrideContentType

public void addOverrideContentType(URI partUri,
 String contentType)

getPartNameOverridenByContentType

public URI getPartNameOverridenByContentType(String contentType)

getPart

public Part getPart(String partName,
 Relationship rel)
             throws URISyntaxException,
PartUnrecognisedException,
InvalidFormatException

Throws:

URISyntaxException

PartUnrecognisedException

InvalidFormatException

newPartForContentType

public Part newPartForContentType(String contentType,
 String partName,
 Relationship rel)
                           throws InvalidFormatException,
PartUnrecognisedException

Throws:

InvalidFormatException

PartUnrecognisedException

CreateDefaultXmlPartObject

public Part CreateDefaultXmlPartObject(String partName)
                                throws InvalidFormatException

Throws:

InvalidFormatException

CreateMainDocumentPartObject

public Part CreateMainDocumentPartObject(String partName)
                                  throws InvalidFormatException

Throws:

InvalidFormatException

CreateStyleDefinitionsPartObject

public Part CreateStyleDefinitionsPartObject(String partName)
                                      throws InvalidFormatException

Throws:

InvalidFormatException

CreateDocumentSettingsPartObject

public Part CreateDocumentSettingsPartObject(String partName)
                                      throws InvalidFormatException

Throws:

InvalidFormatException

CreateWebSettingsPartObject

public Part CreateWebSettingsPartObject(String partName)
                                 throws InvalidFormatException

Throws:

InvalidFormatException

CreateFontTablePartObject

public Part CreateFontTablePartObject(String partName)
                               throws InvalidFormatException

Throws:

InvalidFormatException

CreateThemePartObject

public Part CreateThemePartObject(String partName)
                           throws InvalidFormatException

Throws:

InvalidFormatException

CreateDocPropsCorePartObject

public Part CreateDocPropsCorePartObject(String partName)
                                  throws InvalidFormatException

Throws:

InvalidFormatException

CreateDocPropsExtendedPartObject

public Part CreateDocPropsExtendedPartObject(String partName)
                                      throws InvalidFormatException

Throws:

InvalidFormatException

CreateDocPropsCustomPartObject

public Part CreateDocPropsCustomPartObject(String partName)
                                    throws InvalidFormatException

Throws:

InvalidFormatException

CreateCommentsPartObject

public Part CreateCommentsPartObject(String partName)
                              throws InvalidFormatException

Throws:

InvalidFormatException

CreateCustomXmlDataStoragePropertiesPartObject

public Part CreateCustomXmlDataStoragePropertiesPartObject(String partName)
                                                    throws InvalidFormatException

Throws:

InvalidFormatException

CreateEndnotesPartObject

public Part CreateEndnotesPartObject(String partName)
                              throws InvalidFormatException

Throws:

InvalidFormatException

CreateFooterPartObject

public Part CreateFooterPartObject(String partName)
                            throws InvalidFormatException

Throws:

InvalidFormatException

CreateFootnotesPartObject

public Part CreateFootnotesPartObject(String partName)
                               throws InvalidFormatException

Throws:

InvalidFormatException

CreateGlossaryDocumentPartObject

public Part CreateGlossaryDocumentPartObject(String partName)
                                      throws InvalidFormatException

Throws:

InvalidFormatException

CreateHeaderPartObject

public Part CreateHeaderPartObject(String partName)
                            throws InvalidFormatException

Throws:

InvalidFormatException

CreateNumberingPartObject

public Part CreateNumberingPartObject(String partName)
                               throws InvalidFormatException

Throws:

InvalidFormatException

CreateObfuscatedFontPartObject

public Part CreateObfuscatedFontPartObject(String partName)
                                    throws InvalidFormatException

Throws:

InvalidFormatException

addDefaultContentType

public void addDefaultContentType(String extension,
 CTDefault contentType)

Add a content type associated with the specified extension.

Parameters:

extension - The part name extension to bind to a content type.

contentType - The content type associated with the specified extension.

addDefaultContentType

public void addDefaultContentType(String extension,
 String contentType)

addOverrideContentType

public void addOverrideContentType(PartName partName,
 String contentType)

Parameters:

partName -

contentType -

Since:

6.1.0

removeContentType

@Deprecated
public void removeContentType(PartName partName)

Deprecated.

Delete a content type based on the specified part name. If the specified part name is registered with an override content type, then this content type is removed, else the content type is removed in the default content type list if it exists. Deprecated since you'd typically NOT want to accidentally remove *.xml or *.rels from the default Content type list

Parameters:

partUri - The part URI associated with the override content type to delete.

removeOverrideContentType

public void removeOverrideContentType(PartName partName)

Delete an override content type based on the specified part name.

Parameters:

partUri - The part URI associated with the override content type to delete.

Since:

6.1.0

removeDefaultContentType

public void removeDefaultContentType(String ext)

Delete a default content type based on the specified part name. Note that you'd typically NOT want to remove *.xml or *.rels from the default Content type list

Parameters:

partUri - The part URI associated with the override content type to delete.

Since:

6.1.0

isContentTypeRegistered

public boolean isContentTypeRegistered(String contentType)

Check if the specified content type is already registered as a default content type. We don't currently have a method to check whether its registered as an override content type; getContentType(PartName partName) may suffice for that purpose.

Parameters:

contentType - The content type to check.

Returns:

true if the specified content type is already registered, then false.

isOverrideContentTypeRegistered

public boolean isOverrideContentTypeRegistered(String contentType)

Check if the specified content type is already registered as a default content type. We don't currently have a method to check whether its registered as an override content type; getContentType(PartName partName) may suffice for that purpose.

Parameters:

contentType - The content type to check.

Returns:

true if the specified content type is already registered, then false.

Since:

6.1.0

getContentType

public String getContentType(PartName partName)

Get the content type for the specified part, if any.

Parameters:

partUri - The URI part to check.

Returns:

The content type associated with the URI (in case of an override content type) or the extension (in case of default content type), else null.

clearAll

public void clearAll()

Clear all content types.

clearOverrideContentTypes

public void clearOverrideContentTypes()

Clear all override content types.

parseContentTypesFile

public void parseContentTypesFile(InputStream contentTypes)
                           throws InvalidFormatException

Throws:

InvalidFormatException

marshal

public void marshal(Node node)
             throws jakarta.xml.bind.JAXBException

Throws:

jakarta.xml.bind.JAXBException

marshal

public void marshal(OutputStream os)
             throws jakarta.xml.bind.JAXBException

Throws:

jakarta.xml.bind.JAXBException

createPackage

public OpcPackage createPackage(String pkgContentType)
                         throws InvalidFormatException

Return a package of the appropriate type. Used when loading an existing Package, with an already populated [Content_Types].xml. When creating a new Package, start with the new WordprocessingMLPackage constructor.

Throws:

InvalidFormatException

isContentEqual

public boolean isContentEqual(ContentTypeManager other)
                       throws Docx4JException

Throws:

Docx4JException

toString

public String toString()

Overrides:

toString in class Object