01: /* ====================================================================
02: The Jicarilla Software License
03:
04: Copyright (c) 2003 Leo Simons.
05: All rights reserved.
06:
07: Permission is hereby granted, free of charge, to any person obtaining
08: a copy of this software and associated documentation files (the
09: "Software"), to deal in the Software without restriction, including
10: without limitation the rights to use, copy, modify, merge, publish,
11: distribute, sublicense, and/or sell copies of the Software, and to
12: permit persons to whom the Software is furnished to do so, subject to
13: the following conditions:
14:
15: The above copyright notice and this permission notice shall be
16: included in all copies or substantial portions of the Software.
17:
18: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
19: EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20: MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
21: IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
22: CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23: TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24: SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25: ==================================================================== */
26: package org.jicarilla.plumbing;
27:
28: import EDU.oswego.cs.dl.util.concurrent.Takable;
29: import org.jicarilla.plumbing.Source;
30: import org.jicarilla.lang.Assert;
31:
32: /**
33: * A basic {@link Source} implementation backed by a {@link Takable}.
34: *
35: * @author <a href="lsimons at jicarilla dot org">Leo Simons</a>
36: * @version $Id: SimpleSource.java,v 1.2 2004/03/23 13:37:58 lsimons Exp $
37: */
38: public class SimpleSource implements Source {
39: /** the backing {@link Takable}. */
40: protected final Takable m_t;
41:
42: /**
43: * Create a new instance backed by the provided <code>Takable</code>.
44: *
45: * @param t the takable to use as the backing implementation
46: */
47: public SimpleSource(final Takable t) {
48: Assert.assertNotNull(t);
49: m_t = t;
50: }
51:
52: /**
53: * See {@link org.jicarilla.plumbing.Stage#take()}.
54: *
55: * @return the message retrieved
56: * @throws InterruptedException if the current thread has been
57: * {@link java.lang.Thread#interrupt()}ed
58: */
59: public Object take() throws InterruptedException {
60: return m_t.take();
61: }
62:
63: /**
64: * See {@link org.jicarilla.plumbing.Stage#poll(long)}.
65: *
66: * @param l how long to try and fetch before giving up
67: * @return the message retrieved, or null if none was retrieved within
68: * the specified time interval
69: * @throws InterruptedException if the current thread has been
70: * {@link java.lang.Thread#interrupt()}ed
71: */
72: public Object poll(final long l) throws InterruptedException {
73: return m_t.poll(l);
74: }
75: }
|