Thu, 31 Aug 2017 15:18:52 +0800
merge
1 /*
2 * Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
26 package com.sun.xml.internal.ws.api.pipe.helper;
28 import com.sun.xml.internal.ws.api.message.Packet;
29 import com.sun.xml.internal.ws.api.pipe.Fiber;
30 import com.sun.xml.internal.ws.api.pipe.NextAction;
31 import com.sun.xml.internal.ws.api.pipe.Pipe;
32 import com.sun.xml.internal.ws.api.pipe.PipeCloner;
33 import com.sun.xml.internal.ws.api.pipe.Tube;
34 import com.sun.xml.internal.ws.api.pipe.TubeCloner;
36 /**
37 * Base class for {@link Tube} implementation.
38 *
39 * <p>
40 * This can be also used as a {@link Pipe}, and thus effectively
41 * making every {@link Tube} usable as a {@link Pipe}.
42 *
43 * @author Kohsuke Kawaguchi
44 */
45 public abstract class AbstractTubeImpl implements Tube, Pipe {
47 /**
48 * Default constructor.
49 */
50 protected AbstractTubeImpl() {
51 }
53 /**
54 * Copy constructor.
55 */
56 protected AbstractTubeImpl(AbstractTubeImpl that, TubeCloner cloner) {
57 cloner.add(that,this);
58 }
60 protected final NextAction doInvoke(Tube next, Packet packet) {
61 NextAction na = new NextAction();
62 na.invoke(next,packet);
63 return na;
64 }
66 protected final NextAction doInvokeAndForget(Tube next, Packet packet) {
67 NextAction na = new NextAction();
68 na.invokeAndForget(next,packet);
69 return na;
70 }
72 protected final NextAction doReturnWith(Packet response) {
73 NextAction na = new NextAction();
74 na.returnWith(response);
75 return na;
76 }
78 protected final NextAction doThrow(Packet response, Throwable t) {
79 NextAction na = new NextAction();
80 na.throwException(response, t);
81 return na;
82 }
84 @Deprecated
85 protected final NextAction doSuspend() {
86 NextAction na = new NextAction();
87 na.suspend();
88 return na;
89 }
91 protected final NextAction doSuspend(Runnable onExitRunnable) {
92 NextAction na = new NextAction();
93 na.suspend(onExitRunnable);
94 return na;
95 }
97 @Deprecated
98 protected final NextAction doSuspend(Tube next) {
99 NextAction na = new NextAction();
100 na.suspend(next);
101 return na;
102 }
104 protected final NextAction doSuspend(Tube next, Runnable onExitRunnable) {
105 NextAction na = new NextAction();
106 na.suspend(next, onExitRunnable);
107 return na;
108 }
110 protected final NextAction doThrow(Throwable t) {
111 NextAction na = new NextAction();
112 na.throwException(t);
113 return na;
114 }
116 /**
117 * "Dual stack" compatibility mechanism.
118 * Allows {@link Tube} to be invoked from a {@link Pipe}.
119 */
120 public Packet process(Packet p) {
121 return Fiber.current().runSync(this,p);
122 }
124 /**
125 * Needs to be implemented by the derived class, but we can't make it abstract
126 * without upsetting javac.
127 */
128 public final AbstractTubeImpl copy(PipeCloner cloner) {
129 return copy((TubeCloner)cloner);
130 }
132 public abstract AbstractTubeImpl copy(TubeCloner cloner);
133 }