01: /*
02: * The Apache Software License, Version 1.1
03: *
04: *
05: * Copyright (c) 2002 The Apache Software Foundation. All rights
06: * reserved.
07: *
08: * Redistribution and use in source and binary forms, with or without
09: * modification, are permitted provided that the following conditions
10: * are met:
11: *
12: * 1. Redistributions of source code must retain the above copyright
13: * notice, this list of conditions and the following disclaimer.
14: *
15: * 2. Redistributions in binary form must reproduce the above copyright
16: * notice, this list of conditions and the following disclaimer in
17: * the documentation and/or other materials provided with the
18: * distribution.
19: *
20: * 3. The end-user documentation included with the redistribution,
21: * if any, must include the following acknowledgment:
22: * "This product includes software developed by the
23: * Apache Software Foundation (http://www.apache.org/)."
24: * Alternately, this acknowledgment may appear in the software itself,
25: * if and wherever such third-party acknowledgments normally appear.
26: *
27: * 4. The names "WSIF" and "Apache Software Foundation" must
28: * not be used to endorse or promote products derived from this
29: * software without prior written permission. For written
30: * permission, please contact apache@apache.org.
31: *
32: * 5. Products derived from this software may not be called "Apache",
33: * nor may "Apache" appear in their name, without prior written
34: * permission of the Apache Software Foundation.
35: *
36: * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
37: * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
38: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
39: * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
40: * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
41: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
42: * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
43: * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
44: * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
45: * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
46: * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
47: * SUCH DAMAGE.
48: * ====================================================================
49: *
50: * This software consists of voluntary contributions made by many
51: * individuals on behalf of the Apache Software Foundation and was
52: * originally based on software copyright (c) 2001, 2002, International
53: * Business Machines, Inc., http://www.apache.org. For more
54: * information on the Apache Software Foundation, please see
55: * <http://www.apache.org/>.
56: */
57:
58: package org.apache.wsif.providers.jca;
59:
60: /**
61: * An interface extending WSIF Format Handler with the Connector Architecture's specific
62: * methods from the Streamable interface and a setter for the InteractionSpec field which
63: * can be used by a resource adapter, when it is required, to support unmarshalling.
64: *
65: * @author John Green
66: * @author Michael Beisiegel
67: * @author Piotr Przybylski <piotrp@ca.ibm.com>
68: */
69: public interface WSIFFormatHandler_JCA extends
70: org.apache.wsif.format.WSIFFormatHandler {
71:
72: /**
73: * Read data contents from the input stream.
74: */
75: public void read(java.io.InputStream inputStream)
76: throws java.io.IOException;
77:
78: /**
79: * Writes the contents of the data to the output stream.
80: * @param outputStream
81: * @throws IOException
82: */
83: public void write(java.io.OutputStream outputStream)
84: throws java.io.IOException;
85:
86: /**
87: * Sets the interactionSpec on the format handler. This should be set by the
88: * resource adapter when the interactionSpec contains information
89: * that is required to unmarshall returned data.
90: * @param interactionSpec
91: */
92: public void setInteractionSpec(
93: javax.resource.cci.InteractionSpec interactionSpec);
94: }
|