com.atlassian.confluence.content.render.xhtml.links

Class XhtmlLinksUpdater

java.lang.Object

com.atlassian.confluence.content.render.xhtml.links.XhtmlLinksUpdater

All Implemented Interfaces:

LinksUpdater

public class XhtmlLinksUpdater
extends Object
implements LinksUpdater

Updates all canonical links in an XHTML document to reflect a modified space key or title or both. This will update space keys and titles in page, blogpost and attachment links.

Nested Class Summary

Nested classes/interfaces inherited from interface com.atlassian.confluence.content.render.xhtml.links.LinksUpdater

LinksUpdater.AttachmentReferenceDetails, LinksUpdater.PartialReferenceDetails

Constructor Summary

Constructors

Constructor and Description
XhtmlLinksUpdater(XmlEventReaderFactory xmlEventReaderFactory, XMLOutputFactory xmlOutputFactory, XMLEventFactory xmlEventFactory, Marshaller<ResourceIdentifier> resourceIdentifierMarshaller, ResourceIdentifierFactory resourceIdentifierFactory)

Method Summary

Modifier and Type	Method and Description
String	canonicalize(String content) Applies the same rewriter as on any of contract/expand methods.
String	contractAbsoluteReferencesInContent(SpaceContentEntityObject content) A companion method to {LinksUpdater.expandRelativeReferencesInContent(SpaceContentEntityObject) that will convert any absolute references to itself to be relative.
String	expandRelativeReferencesInContent(Comment comment) Expand any relative links or embedded files/images encountered in the supplied comment.
String	expandRelativeReferencesInContent(SpaceContentEntityObject content) Expand any relative links or embedded images encountered in the supplied content.
String	updateAttachmentReferencesInContent(String content, LinksUpdater.AttachmentReferenceDetails old, LinksUpdater.AttachmentReferenceDetails updated) Update all the attachment references in the content that referred to the 'old' attachment to now refer to the 'updated' attachment.
String	updateAttachmentReferencesInContent(String content, Map<LinksUpdater.AttachmentReferenceDetails,LinksUpdater.AttachmentReferenceDetails> oldToNewLinkDetails) Update all the attachment references in the content that referred to the 'old' attachment to now refer to the 'updated' attachment.
String	updateReferencesInContent(String content, LinksUpdater.PartialReferenceDetails oldLinkDetails, LinksUpdater.PartialReferenceDetails newLinkDetails) Update all the links and embedded image references in the content that referred to 'oldDetails' to now refer to 'newDetails'.
String	updateReferencesInContent(String content, Map<LinksUpdater.PartialReferenceDetails,LinksUpdater.PartialReferenceDetails> oldToNewLinkDetails) Update all the links and embedded image references in the content that referred to 'oldDetails' to now refer to 'newDetails'.

Methods inherited from class java.lang.Object

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

Constructor Detail

XhtmlLinksUpdater

public XhtmlLinksUpdater(XmlEventReaderFactory xmlEventReaderFactory,
                         XMLOutputFactory xmlOutputFactory,
                         XMLEventFactory xmlEventFactory,
                         Marshaller<ResourceIdentifier> resourceIdentifierMarshaller,
                         ResourceIdentifierFactory resourceIdentifierFactory)

Method Detail

updateReferencesInContent

public String updateReferencesInContent(String content,
                                        LinksUpdater.PartialReferenceDetails oldLinkDetails,
                                        LinksUpdater.PartialReferenceDetails newLinkDetails)

Description copied from interface: LinksUpdater

Update all the links and embedded image references in the content that referred to 'oldDetails' to now refer to 'newDetails'. It should be noted that any relative references encountered in the content will not be modified since it cannot be known whether they would be a match for the 'oldDetails' parameter. You should call LinksUpdater.expandRelativeReferencesInContent(SpaceContentEntityObject) prior to calling this method to ensure there are no relative links in the content to confuse matters.

Specified by:

updateReferencesInContent in interface LinksUpdater

Parameters:

content - the content to update references in

oldLinkDetails - specifies the references to be modified

newLinkDetails - specifies the reference to be used in place of those identified by 'oldDetails'.

Returns:

content with relevant references updated

updateReferencesInContent

public String updateReferencesInContent(String content,
                                        Map<LinksUpdater.PartialReferenceDetails,LinksUpdater.PartialReferenceDetails> oldToNewLinkDetails)

Description copied from interface: LinksUpdater

Update all the links and embedded image references in the content that referred to 'oldDetails' to now refer to 'newDetails'. It should be noted that any relative references encountered in the content will not be modified since it cannot be known whether they would be a match for the 'oldDetails' parameter. You should call LinksUpdater.expandRelativeReferencesInContent(SpaceContentEntityObject) prior to calling this method to ensure there are no relative links in the content to confuse matters.

Specified by:

updateReferencesInContent in interface LinksUpdater

Parameters:

content - the content to update references in

oldToNewLinkDetails - the map from old reference to new reference

Returns:

content with relevant references updated

expandRelativeReferencesInContent

public String expandRelativeReferencesInContent(SpaceContentEntityObject content)

Description copied from interface: LinksUpdater

Expand any relative links or embedded images encountered in the supplied content. A relative reference is one that either has no space key (implying "current space") or one with no ResourceIdentifier at all.

This method will convert such references to an absolute reference to either it's containing space or itself (in the case of an attachment or link with no resource identifier at all).

Specified by:

expandRelativeReferencesInContent in interface LinksUpdater

Parameters:

content - the content to be expanded

Returns:

the body of the supplied SpaceContentEntityObject with all relative references expanded.

expandRelativeReferencesInContent

public String expandRelativeReferencesInContent(Comment comment)

Description copied from interface: LinksUpdater

Expand any relative links or embedded files/images encountered in the supplied comment. A relative reference is one that either has no space key (implying "current space") or one with no ResourceIdentifier at all.

This method will convert such references to an absolute reference to either it's containing space or itself (in the case of an attachment or link with no resource identifier at all).

Specified by:

expandRelativeReferencesInContent in interface LinksUpdater

Parameters:

comment - the comment to be expanded

Returns:

the body of the supplied SpaceContentEntityObject with all relative references expanded.

updateAttachmentReferencesInContent

public String updateAttachmentReferencesInContent(String content,
                                                  LinksUpdater.AttachmentReferenceDetails old,
                                                  LinksUpdater.AttachmentReferenceDetails updated)

Description copied from interface: LinksUpdater

Update all the attachment references in the content that referred to the 'old' attachment to now refer to the 'updated' attachment. It should be noted that any relative links encountered in the content will not be modified since it cannot be known whether they would be a match for the 'old' parameter. You should call LinksUpdater.expandRelativeReferencesInContent(SpaceContentEntityObject) prior to calling this method to ensure there are no relative attachment references in the content to confuse matters.

Specified by:

updateAttachmentReferencesInContent in interface LinksUpdater

Parameters:

content - the content to update attachment references in

old - specifies the attachment references to be modified

updated - specifies the new attachment reference to replace the old one with

Returns:

content with specified attachment references updated.

updateAttachmentReferencesInContent

public String updateAttachmentReferencesInContent(String content,
                                                  Map<LinksUpdater.AttachmentReferenceDetails,LinksUpdater.AttachmentReferenceDetails> oldToNewLinkDetails)

Description copied from interface: LinksUpdater

Update all the attachment references in the content that referred to the 'old' attachment to now refer to the 'updated' attachment. It should be noted that any relative links encountered in the content will not be modified since it cannot be known whether they would be a match for the 'old' parameter. You should call LinksUpdater.expandRelativeReferencesInContent(SpaceContentEntityObject) prior to calling this method to ensure there are no relative attachment references in the content to confuse matters.

Specified by:

updateAttachmentReferencesInContent in interface LinksUpdater

Parameters:

content - the content to update attachment references in

oldToNewLinkDetails - the map from old reference to new reference

Returns:

content with specified attachment references updated. * @since 5.10

contractAbsoluteReferencesInContent

public String contractAbsoluteReferencesInContent(SpaceContentEntityObject content)

Description copied from interface: LinksUpdater

A companion method to {LinksUpdater.expandRelativeReferencesInContent(SpaceContentEntityObject) that will convert any absolute references to itself to be relative. So in a ResourceIdentifier, if a space key is present for the same space as the supplied content then this will be dropped. If the ResourceIdentifier actually refers to the SpaceContentEntityObject supplied then it will be dropped altogether.

Specified by:

contractAbsoluteReferencesInContent in interface LinksUpdater

Parameters:

content - the content to have any suitable absolute references contracted.

Returns:

the body of the supplied SpaceContentEntityObject modified as appropriate.

canonicalize

public String canonicalize(String content)

Description copied from interface: LinksUpdater

Applies the same rewriter as on any of contract/expand methods.

This method is needed because even if xml structure of content is the same entity replacing by javax.xml.* and substitution done in ConfluenceXMLEventWriter will make two equal contents look different on equals method.

Specified by:

canonicalize in interface LinksUpdater

Returns:

canonicalized content