org.oddjob.arooa.parsing

Class DragConfiguration

java.lang.Object

org.oddjob.arooa.parsing.DragConfiguration

All Implemented Interfaces:

ArooaConfiguration, DragPoint

public class DragConfiguration
extends Object
implements DragPoint

A DragPoint for an ArooaConfiguration.

This DragPoint only has enough implementation to support the Designer for the configuration. It won't support drag and drop within the configuration. That will be supported by the Design View once the configuration is parsed.

Author:

rob

Constructor Summary

Constructors

Constructor and Description
DragConfiguration(ArooaConfiguration configuration, NamespaceMappings namespaceMappings)

Method Summary

Modifier and Type	Method and Description
DragTransaction	beginChange(ChangeHow how) Begin a change.
String	copy() Provide a copy of the configuration at from this DragPoint as XML.
String	cut() Copy this DragPoints configuration and remove it.
void	delete() Remove this DragPoint from it's underlying configuration and remove any components in the configuration from the ComponentPool
<P extends ParseContext<P>> ConfigurationHandle<P>	parse(P parentContext) Parse the encapsulated configuration.
void	paste(int index, String config) Parse an XML Text configuration and add the resultant component to this DragPoint with the given index.
QTag[]	possibleChildren() List the possible children a Drag Point can have for Add Job functionality.
boolean	supportsCut() True if this DragPoint supports the cut operation.
boolean	supportsPaste() True if this DragPoint supports the paste operation.

Methods inherited from class java.lang.Object

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

Constructor Detail

DragConfiguration

public DragConfiguration(ArooaConfiguration configuration,
                         NamespaceMappings namespaceMappings)

Method Detail

beginChange

public DragTransaction beginChange(ChangeHow how)

Description copied from interface: DragPoint

Begin a change. Changes must happen in a transaction because when dragging a component within the same session the cut must be done before the paste otherwise duplicate IDs would occur.

Specified by:

beginChange in interface DragPoint

Parameters:

how - Should an existing transaction be in progress or not.

Returns:

A transaction. Never null.

parse

public <P extends ParseContext<P>> ConfigurationHandle<P> parse(P parentContext)
                                                         throws ArooaParseException

Description copied from interface: ArooaConfiguration

Parse the encapsulated configuration.

Specified by:

parse in interface ArooaConfiguration

Type Parameters:

P - The type of the context in which parsing occurs.

Parameters:

parentContext - The context in which this configuration will be parsed. This context will provide the ArooaHandler, and therefore subsequent child contexts.

Returns:

A ConfigurationHandle. The handle provides access to the context created as the result of the parse and a way of saving this context back into the configuration.

Throws:

ArooaParseException - If parsing fails.

supportsPaste

public boolean supportsPaste()

Description copied from interface: DragPoint

True if this DragPoint supports the paste operation.

Specified by:

supportsPaste in interface DragPoint

Returns:

true/false.

supportsCut

public boolean supportsCut()

Description copied from interface: DragPoint

True if this DragPoint supports the cut operation.

Specified by:

supportsCut in interface DragPoint

Returns:

true/false.

copy

public String copy()

Description copied from interface: DragPoint

Provide a copy of the configuration at from this DragPoint as XML.

Specified by:

copy in interface DragPoint

Returns:

Text XML.

cut

public String cut()

Description copied from interface: DragPoint

Copy this DragPoints configuration and remove it.

This is used by the Web Front end. The Swing UI uses DragPoint.delete().

Specified by:

cut in interface DragPoint

delete

public void delete()

Description copied from interface: DragPoint

Remove this DragPoint from it's underlying configuration and remove any components in the configuration from the ComponentPool

This is used by the swing GUI ArooaTransferHandler to perform the CUT operation.

This operation must be done within the context of a transaction.

Specified by:

delete in interface DragPoint

paste

public void paste(int index,
                  String config)

Description copied from interface: DragPoint

Parse an XML Text configuration and add the resultant component to this DragPoint with the given index.

This operation must be done within the context of a transaction.

Specified by:

paste in interface DragPoint

Parameters:

index - The index. -1 will append.

config - The configuration.

possibleChildren

public QTag[] possibleChildren()

Description copied from interface: DragPoint

List the possible children a Drag Point can have for Add Job functionality. DragPoint.supportsPaste() must be true for this to work.

Specified by:

possibleChildren in interface DragPoint

Returns:

All that child tags that could be added with a paste operation.