com.sun.xml.ws.api.pipe

Class PipeClonerImpl

java.lang.Object

com.sun.xml.ws.api.pipe.TubeCloner

com.sun.xml.ws.api.pipe.PipeCloner

com.sun.xml.ws.api.pipe.PipeClonerImpl

public class PipeClonerImpl
extends PipeCloner

Clones the whole pipeline.

Since Pipes may form an arbitrary directed graph, someone needs to keep track of isomorphism for a clone to happen correctly. This class serves that role.

Field Summary

Fields inherited from class com.sun.xml.ws.api.pipe.TubeCloner

master2copy

Constructor Summary

Constructors

Modifier	Constructor and Description
	PipeClonerImpl()
protected	PipeClonerImpl(Map<Object,Object> master2copy)

Method Summary

Methods

Modifier and Type	Method and Description
void	add(AbstractTubeImpl original, AbstractTubeImpl copy) Disambiguation version.
void	add(Pipe original, Pipe copy) The Pipe version of add(Tube, Tube).
void	add(Tube original, Tube copy) This method must be called from within the copy constructor to notify that the copy was created.
<T extends Pipe> T	copy(T p) Pipe version of copy(Tube)
<T extends Tube> T	copy(T t) Invoked by a Tube#copy(TubeClonerImpl) implementation to copy a reference to another pipe.

Methods inherited from class com.sun.xml.ws.api.pipe.PipeCloner

clone

Methods inherited from class com.sun.xml.ws.api.pipe.TubeCloner

clone

Methods inherited from class java.lang.Object

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

Constructor Detail

PipeClonerImpl

public PipeClonerImpl()

PipeClonerImpl

protected PipeClonerImpl(Map<Object,Object> master2copy)

Method Detail

copy

public <T extends Pipe> T copy(T p)

Pipe version of copy(Tube)

Specified by:

copy in class PipeCloner

add

public void add(Pipe original,
       Pipe copy)

The Pipe version of add(Tube, Tube).

Specified by:

add in class PipeCloner

add

public void add(AbstractTubeImpl original,
       AbstractTubeImpl copy)

Disambiguation version.

add

public void add(Tube original,
       Tube copy)

Description copied from class: TubeCloner

This method must be called from within the copy constructor to notify that the copy was created.

When your pipe has references to other pipes, it's particularly important to call this method before you start copying the pipes you refer to, or else there's a chance of inifinite loop.

Specified by:

add in class TubeCloner

copy

public <T extends Tube> T copy(T t)

Description copied from class: TubeCloner

Invoked by a Tube#copy(TubeClonerImpl) implementation to copy a reference to another pipe.

This method is for Tube implementations, not for users.

If the given tube is already copied for this cloning episode, this method simply returns that reference. Otherwise it copies a tube, make a note, and returns a copied tube. This additional step ensures that a graph is cloned isomorphically correctly.

(Think about what happens when a graph is A->B, A->C, B->D, and C->D if you don't have this step.)

Specified by:

copy in class TubeCloner

Parameters:

t - The tube to be copied.

Returns:

The cloned tube. Always non-null.