com.atlassian.bamboo.migration

Class BambooStAXMappingListHelperAbstractImpl<T>

java.lang.Object

com.atlassian.bamboo.migration.BambooStAXMappingHelperAbstractImpl<T>

com.atlassian.bamboo.migration.BambooStAXMappingListHelperAbstractImpl<T>

Type Parameters:

T -

All Implemented Interfaces:

BambooStAXMappingHelper<T>

Direct Known Subclasses:

AbstractPlanMapper, AbstractProjectDependencyMapper, AbstractProjectMapper, AbstractResultSummaryMapper, AceMapper, AclMapper, AgentAssignmentMapper, ArtifactDefinitionMapper, ArtifactLinkMapper, ArtifactMapper, ArtifactSubscriptionMapper, AuditLogMapper, AuthorMapper, BandanaItemMapper, CapabilitySetMapper, ChainBuildMapper, ChainStageMapper, CommentMapper, CommitFilesMapper, CommitMapper, ConsumedSubscriptionMapper, CustomDataMapper, DeploymentProjectItemMapper, DeploymentProjectMapper, DeploymentResultMapper, DeploymentVariableSubstitutionMapper, DeploymentVersionItemMapper, DeploymentVersionLinkedJiraIssueMapper, DeploymentVersionMapper, DeploymentVersionStatusMapper, DeploymentVersionVcsChangesetMapper, DeploymentVersionVcsCommitMapper, ElasticImageConfigurationMapper, ElasticInstanceScheduleMapper, EnvironmentMapper, EnvironmentRepositoryLinkMapper, ExternalEntityMapper, GroupMemberMapper, InstantMessagingServerMapper, JiraIssuesMapper, LabellingMapper, LabelMapper, LegacyArtifactMapper, LegacyJiraServerMapper, LegacyRequirementMapper, LinkedJiraIssuesMapper, LocalGroupMapper, LocalUserMapper, MailServerMapper, PipelineMapper, PlanBuildNumbersMapper, PlanRepositoryLinkMapper, PlanResultKeyListMapper, PlanVcsRevisionHistoryMapper, PropertyEntryMapper, RelevantChangesetsMapper, RemoteAgentAuthenticationMapper, RepositoryChangesetMapper, RepositoryDefinitionMapper, StageVariableContextMapper, TestCaseMapper, TestCaseResultErrorMapper, TestCaseResultMapper, TestClassMapper, TestClassResultMapper, TrustedApplicationsMapper, TrustedKeyMapper, VariableBaselineItemMapper, VariableContextBaselineMapper, VariableContextSnapshotMapper, VariableDefinitionMapper, VariableSubstitutionMapper, VcsBranchMapper

public abstract class BambooStAXMappingListHelperAbstractImpl<T>
extends BambooStAXMappingHelperAbstractImpl<T>

Skeleton implementation of StAX based export-import helper class for lists. The XML representation of such a list is: valueOfPropertyA ... ... ...

Nested Class Summary

Nested classes/interfaces inherited from interface com.atlassian.bamboo.migration.BambooStAXMappingHelper

BambooStAXMappingHelper.None

Field Summary

Fields inherited from class com.atlassian.bamboo.migration.BambooStAXMappingHelperAbstractImpl

transactionOperations

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BambooStAXMappingListHelperAbstractImpl(org.hibernate.SessionFactory sessionFactory, BambooStAXListImportStrategy listImportStrategy, org.springframework.transaction.support.TransactionOperations transactionOperations)
protected	BambooStAXMappingListHelperAbstractImpl(org.hibernate.SessionFactory sessionFactory, org.springframework.transaction.support.TransactionOperations transactionOperations)

Method Summary

Modifier and Type	Method and Description
void	afterImportListItem(org.codehaus.staxmate.in.SMInputCursor inputCursor, List<T> list, T object, long objectIndex, org.hibernate.Session session) Called after parser completes parsing all child nodes in list's element node.
void	beforeImportListItem(org.codehaus.staxmate.in.SMInputCursor inputCursor, List<T> list, org.hibernate.Session session) Called when parser reaches the list's element node.
protected org.codehaus.staxmate.out.SMOutputElement	createListRootElement(org.codehaus.staxmate.out.SMOutputElement outputElement) Creates list root node
protected org.codehaus.staxmate.out.SMOutputElement	createRootElement(org.codehaus.staxmate.out.SMOutputElement outputElement) Creates list item node
protected void	eventEndElementOfListItemSaveObject(org.hibernate.Session session, T object, long objectIndex, long flushSize)
<E extends T> void	exportListXml(org.hibernate.Session session, org.codehaus.staxmate.out.SMOutputElement outputElement, Iterable<E> iterable, ExportDetailsBean exportDetailsBean) Exports a collection to the XML.
<E extends T> void	exportListXml(org.codehaus.staxmate.out.SMOutputElement outputElement, Iterable<E> iterable, ExportDetailsBean exportDetailsBean) Exports a collection to the XML.
protected void	flushIfNeeded(org.hibernate.Session session, long objectIndex, long flushSize)
String	getXmlElementNodeName() Returns local name of list element node
String	getXmlRootNodeName() Returns local name of the XML parent node that will contain exported/imported object's properties
List<T>	importListXml(org.hibernate.Session session, org.codehaus.staxmate.in.SMInputCursor inputCursor) Import list from XML
List<T>	importListXml(org.codehaus.staxmate.in.SMInputCursor inputCursor) Import list from XML
protected void	importListXmlInTransaction(org.codehaus.staxmate.in.SMInputCursor inputCursor)

Methods inherited from class com.atlassian.bamboo.migration.BambooStAXMappingHelperAbstractImpl

createItemInstance, exportProperties, exportXml, exportXml, getSession, getSessionFactory, importProperties, importXml, importXml, isShouldExport, saveBambooObject

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.atlassian.bamboo.migration.BambooStAXMappingHelper

exportXml, importXml

Constructor Detail

BambooStAXMappingListHelperAbstractImpl

protected BambooStAXMappingListHelperAbstractImpl(org.hibernate.SessionFactory sessionFactory,
                                                  @NotNull
                                                  BambooStAXListImportStrategy listImportStrategy,
                                                  @NotNull
                                                  org.springframework.transaction.support.TransactionOperations transactionOperations)

BambooStAXMappingListHelperAbstractImpl

protected BambooStAXMappingListHelperAbstractImpl(org.hibernate.SessionFactory sessionFactory,
                                                  @NotNull
                                                  org.springframework.transaction.support.TransactionOperations transactionOperations)

Method Detail

getXmlElementNodeName

@NotNull
public String getXmlElementNodeName()

Returns local name of list element node

Returns:

local name of list element node

getXmlRootNodeName

@NotNull
public String getXmlRootNodeName()

Description copied from interface: BambooStAXMappingHelper

Returns local name of the XML parent node that will contain exported/imported object's properties

Specified by:

getXmlRootNodeName in interface BambooStAXMappingHelper<T>

Overrides:

getXmlRootNodeName in class BambooStAXMappingHelperAbstractImpl<T>

Returns:

local name of the XML parent node

beforeImportListItem

public void beforeImportListItem(@NotNull
                                 org.codehaus.staxmate.in.SMInputCursor inputCursor,
                                 @NotNull
                                 List<T> list,
                                 @NotNull
                                 org.hibernate.Session session)
                          throws Exception

Called when parser reaches the list's element node.

Parameters:

inputCursor - inputCursor pointing to the list's element opening node

list - list of elements being imported

session - Hibernate session object

Throws:

Exception - when something went wrong

afterImportListItem

public void afterImportListItem(@NotNull
                                org.codehaus.staxmate.in.SMInputCursor inputCursor,
                                @NotNull
                                List<T> list,
                                @NotNull
                                T object,
                                long objectIndex,
                                @NotNull
                                org.hibernate.Session session)
                         throws Exception

Called after parser completes parsing all child nodes in list's element node.

Parameters:

inputCursor - cursor pointing to the list's element opening node

list - list of elements being imported

object - object that has been imported

objectIndex - one-based index of the object being parsed

session - Hibernate session object

Throws:

Exception - when something went wrong

createListRootElement

@NotNull
protected org.codehaus.staxmate.out.SMOutputElement createListRootElement(@NotNull
                                                                                   org.codehaus.staxmate.out.SMOutputElement outputElement)
                                                                            throws XMLStreamException

Creates list root node

Parameters:

outputElement - parent node for list root node

Returns:

list root node

Throws:

XMLStreamException - when something went wrong

createRootElement

@NotNull
protected org.codehaus.staxmate.out.SMOutputElement createRootElement(@NotNull
                                                                               org.codehaus.staxmate.out.SMOutputElement outputElement)
                                                                        throws XMLStreamException

Creates list item node

Overrides:

createRootElement in class BambooStAXMappingHelperAbstractImpl<T>

Parameters:

outputElement - list root node

Returns:

list item node

Throws:

XMLStreamException - when something went wrong

exportListXml

public final <E extends T> void exportListXml(@NotNull
                                              org.codehaus.staxmate.out.SMOutputElement outputElement,
                                              @NotNull
                                              Iterable<E> iterable,
                                              ExportDetailsBean exportDetailsBean)
                                       throws Exception

Exports a collection to the XML.

Parameters:

outputElement - parent node for collection root node

iterable - collection to be exported

exportDetailsBean -

Throws:

Exception - when something went wrong

exportListXml

public <E extends T> void exportListXml(@NotNull
                                        org.hibernate.Session session,
                                        @NotNull
                                        org.codehaus.staxmate.out.SMOutputElement outputElement,
                                        @NotNull
                                        Iterable<E> iterable,
                                        ExportDetailsBean exportDetailsBean)
                                 throws Exception

Exports a collection to the XML. If collection is empty collection root not will not be created.

Parameters:

session - Hibernate session object

outputElement - parent node for collection root node

iterable - collection to be exported

exportDetailsBean -

Throws:

Exception - when something went wrong

importListXml

@NotNull
public final List<T> importListXml(@NotNull
                                            org.codehaus.staxmate.in.SMInputCursor inputCursor)
                                     throws Exception

Import list from XML

Parameters:

inputCursor - parent node for list root node

Returns:

list of the imported elements

Throws:

Exception - when something went wrong

importListXml

@NotNull
public List<T> importListXml(@NotNull
                                      org.hibernate.Session session,
                                      @NotNull
                                      org.codehaus.staxmate.in.SMInputCursor inputCursor)
                               throws Exception

Import list from XML

Parameters:

session - Hibernate session object

inputCursor - parent node for list root node

Returns:

list of the imported elements

Throws:

Exception - when something went wrong

importListXmlInTransaction

protected void importListXmlInTransaction(org.codehaus.staxmate.in.SMInputCursor inputCursor)

eventEndElementOfListItemSaveObject

protected void eventEndElementOfListItemSaveObject(@NotNull
                                                   org.hibernate.Session session,
                                                   @NotNull
                                                   T object,
                                                   long objectIndex,
                                                   long flushSize)
                                            throws org.hibernate.HibernateException,
                                                   SQLException

Parameters:

session - Hibernate session object

object - object to be saved

objectIndex - one-based index of the object in the list of object being read

flushSize - number of objects to be saved before session.flush() is executed

Throws:

SQLException - when something went wrong

org.hibernate.HibernateException - when something went wrong

flushIfNeeded

protected void flushIfNeeded(org.hibernate.Session session,
                             long objectIndex,
                             long flushSize)
                      throws org.hibernate.HibernateException

Throws:

org.hibernate.HibernateException