org.apache.poi.openxml4j.opc
Interface RelationshipSource

All Known Implementing Classes:
DigitalCertificatePart, MemoryPackagePart, OPCPackage, Package, PackageDigitalSignature, PackagePart, PackagePropertiesPart, ZipPackage, ZipPackagePart

public interface RelationshipSource


Method Summary
 PackageRelationship addExternalRelationship(java.lang.String target, java.lang.String relationshipType)
          Adds an external relationship to a part (except relationships part).
 PackageRelationship addExternalRelationship(java.lang.String target, java.lang.String relationshipType, java.lang.String id)
          Adds an external relationship to a part (except relationships part).
 PackageRelationship addRelationship(PackagePartName targetPartName, TargetMode targetMode, java.lang.String relationshipType)
          Add a relationship to a part (except relationships part).
 PackageRelationship addRelationship(PackagePartName targetPartName, TargetMode targetMode, java.lang.String relationshipType, java.lang.String id)
          Add a relationship to a part (except relationships part).
 void clearRelationships()
          Delete all the relationships attached to this.
 PackageRelationship getRelationship(java.lang.String id)
          Retrieves a package relationship from its id.
 PackageRelationshipCollection getRelationships()
          Retrieve all the relationships attached to this.
 PackageRelationshipCollection getRelationshipsByType(java.lang.String relationshipType)
          Retrieve all relationships attached to this part which have the specified type.
 boolean hasRelationships()
          Knows if the part have any relationships.
 boolean isRelationshipExists(PackageRelationship rel)
          Checks if the specified relationship is part of this package part.
 void removeRelationship(java.lang.String id)
          Delete the relationship specified by its id.
 

Method Detail

addRelationship

PackageRelationship addRelationship(PackagePartName targetPartName,
                                    TargetMode targetMode,
                                    java.lang.String relationshipType)
Add a relationship to a part (except relationships part).

Parameters:
targetPartName - Name of the target part. This one must be relative to the source root directory of the part.
targetMode - Mode [Internal|External].
relationshipType - Type of relationship.
Returns:
The newly created and added relationship

addRelationship

PackageRelationship addRelationship(PackagePartName targetPartName,
                                    TargetMode targetMode,
                                    java.lang.String relationshipType,
                                    java.lang.String id)
Add a relationship to a part (except relationships part).

Check rule M1.25: The Relationships part shall not have relationships to any other part. Package implementers shall enforce this requirement upon the attempt to create such a relationship and shall treat any such relationship as invalid.

Parameters:
targetPartName - Name of the target part. This one must be relative to the source root directory of the part.
targetMode - Mode [Internal|External].
relationshipType - Type of relationship.
id - Relationship unique id.
Returns:
The newly created and added relationship
Throws:
InvalidFormatException - If the URI point to a relationship part URI.

addExternalRelationship

PackageRelationship addExternalRelationship(java.lang.String target,
                                            java.lang.String relationshipType)
Adds an external relationship to a part (except relationships part). The targets of external relationships are not subject to the same validity checks that internal ones are, as the contents is potentially any file, URL or similar.

Parameters:
target - External target of the relationship
relationshipType - Type of relationship.
Returns:
The newly created and added relationship
See Also:
addExternalRelationship(java.lang.String, java.lang.String)

addExternalRelationship

PackageRelationship addExternalRelationship(java.lang.String target,
                                            java.lang.String relationshipType,
                                            java.lang.String id)
Adds an external relationship to a part (except relationships part). The targets of external relationships are not subject to the same validity checks that internal ones are, as the contents is potentially any file, URL or similar.

Parameters:
target - External target of the relationship
relationshipType - Type of relationship.
id - Relationship unique id.
Returns:
The newly created and added relationship
See Also:
addExternalRelationship(java.lang.String, java.lang.String)

clearRelationships

void clearRelationships()
Delete all the relationships attached to this.


removeRelationship

void removeRelationship(java.lang.String id)
Delete the relationship specified by its id.

Parameters:
id - The ID identified the part to delete.

getRelationships

PackageRelationshipCollection getRelationships()
                                               throws InvalidFormatException,
                                                      OpenXML4JException
Retrieve all the relationships attached to this.

Returns:
This part's relationships.
Throws:
OpenXML4JException
InvalidFormatException

getRelationship

PackageRelationship getRelationship(java.lang.String id)
Retrieves a package relationship from its id.

Parameters:
id - ID of the package relationship to retrieve.
Returns:
The package relationship

getRelationshipsByType

PackageRelationshipCollection getRelationshipsByType(java.lang.String relationshipType)
                                                     throws InvalidFormatException,
                                                            java.lang.IllegalArgumentException,
                                                            OpenXML4JException
Retrieve all relationships attached to this part which have the specified type.

Parameters:
relationshipType - Relationship type filter.
Returns:
All relationships from this part that have the specified type.
Throws:
InvalidFormatException - If an error occurs while parsing the part.
InvalidOperationException - If the package is open in write only mode.
java.lang.IllegalArgumentException
OpenXML4JException

hasRelationships

boolean hasRelationships()
Knows if the part have any relationships.

Returns:
true if the part have at least one relationship else false.

isRelationshipExists

boolean isRelationshipExists(PackageRelationship rel)
Checks if the specified relationship is part of this package part.

Parameters:
rel - The relationship to check.
Returns:
true if the specified relationship exists in this part, else returns false


Copyright 2012 The Apache Software Foundation or its licensors, as applicable.