public abstract class TubeCloner extends Object
Since Tube
s may form an arbitrary directed graph, someone needs
to keep track of isomorphism for a clone to happen correctly. This class
serves that role.
Modifier and Type | Field and Description |
---|---|
Map<Object,Object> |
master2copy |
Constructor and Description |
---|
TubeCloner(Map<Object,Object> master2copy) |
Modifier and Type | Method and Description |
---|---|
abstract void |
add(Tube original,
Tube copy)
This method must be called from within the copy constructor
to notify that the copy was created.
|
static Tube |
clone(Tube p)
Invoked by a client of a tube to clone the whole pipeline.
|
abstract <T extends Tube> |
copy(T t)
Invoked by a
Tube#copy(TubeClonerImpl) implementation
to copy a reference to another pipe. |
public static Tube clone(Tube p)
Tube
s implementing the Tube#copy(TubeClonerImpl)
method
shall use copy(Tube)
method.
p
- The entry point of a pipeline to be copied. must not be null.public abstract <T extends Tube> T copy(T t)
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.)
t
- The tube to be copied.public abstract void add(Tube original, Tube copy)
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.
Copyright (c) 1997-2012 Oracle and/or its affiliates. All rights reserved.