com.atlassian.confluence.it.export
Class Exporter

java.lang.Object
  com.atlassian.confluence.it.export.Exporter

public class Exporter
extends Object

Contains methods for testing export. There are no good reasons why the only export space method is by webTester and the only site export is by RPC. It's just what is currently used.

Nested Class Summary

static class	Exporter.AttachmentOption
static class	Exporter.CommentOption
static class	Exporter.ContentOption
static interface	Exporter.ExporterFormOption

Constructor Summary

Exporter()

Method Summary

static SimpleSiteStructure	downloadAndParseExport(URL url, User user) Download and parse xml backup into SimpleSiteStructure, useful to validate site exports in acceptance tests.
static org.dom4j.Document	downloadAndReadExport(URL url, User user)
static File	downloadExportToTemp(URL url, User user)
static URL	exportSite(ConfluenceRpc rpc, boolean exportAttachments) Deprecated. use exportSite(com.atlassian.confluence.it.rpc.ConfluenceRpc, com.atlassian.confluence.it.export.Exporter.AttachmentOption)
static URL	exportSite(ConfluenceRpc rpc, Exporter.AttachmentOption attachmentOption) Export a site via RPC.
static URL	exportSpace(Space space, net.sourceforge.jwebunit.junit.WebTester webTester, Collection<Long> excludedPageIds, Exporter.ExporterFormOption... options) Export a space through the web interface.
static URL	exportSpace(Space space, net.sourceforge.jwebunit.junit.WebTester webTester, Exporter.ContentOption contentOption) Export a space through the web interface.
static URL	exportSpace(Space space, net.sourceforge.jwebunit.junit.WebTester webTester, Exporter.ContentOption contentOption, Collection<Long> excludedPageIds) Export a space through the web interface.
static SimpleHtmlSpaceExportStructure	getSimpleHtmlExportStructure(Space space, File htmlExportZip) Given an export html zip, returns a structure that represents the export.
static SimpleSiteStructure	getSimpleSiteStructure(File file) Return SimpleSiteStructure object useful to validate site exports in acceptance tests.

Methods inherited from class java.lang.Object

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

Constructor Detail

Exporter

public Exporter()

Method Detail

exportSpace

public static URL exportSpace(Space space,
                              net.sourceforge.jwebunit.junit.WebTester webTester,
                              Collection<Long> excludedPageIds,
                              Exporter.ExporterFormOption... options)

Export a space through the web interface.

Parameters:

space - the target space

webTester - should have the appropriate user logged in already

options - any of the various Exporter.ExporterFormOptions

excludedPageIds - a collection of page IDs that should not be selected for export, others are selected by default

Returns:

a URL from which the space can be downloaded by whatever user was logged in to the WebTester.

exportSpace

public static URL exportSpace(Space space,
                              net.sourceforge.jwebunit.junit.WebTester webTester,
                              Exporter.ContentOption contentOption,
                              Collection<Long> excludedPageIds)

Export a space through the web interface.

Parameters:

space - the target space

webTester - should have the appropriate user logged in already

contentOption - can be ALL, VISIBLE, or DEFAULT

excludedPageIds - a collection of page IDs that should not be selected for export, others are selected by default

Returns:

a URL from which the space can be downloaded by whatever user was logged in to the WebTester.

exportSpace

public static URL exportSpace(Space space,
                              net.sourceforge.jwebunit.junit.WebTester webTester,
                              Exporter.ContentOption contentOption)

Export a space through the web interface.

Parameters:

space - the target space

webTester - should have the appropriate user logged in already

contentOption - can be ALL, VISIBLE, or DEFAULT

Returns:

a URL from which the space can be downloaded by whatever user was logged in to the WebTester.

exportSite

@Deprecated
public static URL exportSite(ConfluenceRpc rpc,
                                        boolean exportAttachments)
                      throws MalformedURLException

Deprecated. use exportSite(com.atlassian.confluence.it.rpc.ConfluenceRpc, com.atlassian.confluence.it.export.Exporter.AttachmentOption)

Export a site via RPC.

Parameters:

rpc - the rpc object

exportAttachments - true for exporting attachments, false otherwise

Returns:

a URL from which the site can be downloaded

Throws:

MalformedURLException - if the URL is malformed

exportSite

public static URL exportSite(ConfluenceRpc rpc,
                             Exporter.AttachmentOption attachmentOption)
                      throws MalformedURLException

Export a site via RPC.

Parameters:

rpc - the rpc object

attachmentOption - true for exporting attachments, false otherwise

Returns:

a URL from which the site can be downloaded

Throws:

MalformedURLException - if the URL is malformed

downloadAndParseExport

public static SimpleSiteStructure downloadAndParseExport(URL url,
                                                         User user)
                                                  throws Exception

Download and parse xml backup into SimpleSiteStructure, useful to validate site exports in acceptance tests.

Parameters:

url - where export can be downloaded

user - with sufficient permission to download export

Returns:

SimpleSiteStructure a simple representation of an exported Confluence backup to easily validate site exports in acceptance tests

Throws:

IOException - if file does not exist in the given url.

Exception - if it failed to create InputStream for entities.xml entry.

downloadAndReadExport

public static org.dom4j.Document downloadAndReadExport(URL url,
                                                       User user)
                                                throws Exception

Throws:

Exception

downloadExportToTemp

public static File downloadExportToTemp(URL url,
                                        User user)
                                 throws IOException

Throws:

IOException

getSimpleSiteStructure

public static SimpleSiteStructure getSimpleSiteStructure(File file)
                                                  throws Exception

Return SimpleSiteStructure object useful to validate site exports in acceptance tests.

Parameters:

file - XML backup

Returns:

SimpleSiteStructure

Throws:

IOException - if file does not exist.

Exception - if it failed to create InputStream for entities.xml entry.

getSimpleHtmlExportStructure

public static SimpleHtmlSpaceExportStructure getSimpleHtmlExportStructure(Space space,
                                                                          File htmlExportZip)
                                                                   throws IOException

Given an export html zip, returns a structure that represents the export.

Parameters:

space -

htmlExportZip - a space export zip file

Returns:

Throws:

IOException