|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.sun.xml.ws.api.pipe.TubeCloner
public class TubeCloner
Clones the whole pipeline.
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.
Field Summary | |
---|---|
protected Map<Object,Object> |
master2copy
|
Constructor Summary | |
---|---|
TubeCloner()
|
Method Summary | ||
---|---|---|
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. |
|
|
copy(T t)
Invoked by a Tube.copy(TubeCloner) implementation
to copy a reference to another pipe. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected final Map<Object,Object> master2copy
Constructor Detail |
---|
TubeCloner()
Method Detail |
---|
public static Tube clone(Tube p)
Tube
s implementing the Tube.copy(TubeCloner)
method
shall use copy(Tube)
method.
p
- The entry point of a pipeline to be copied. must not be null.
public <T extends Tube> T copy(T t)
Tube.copy(TubeCloner)
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 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.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |