KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > jboss > axis > soap > MessageFactoryImpl


1 /*
2  * The Apache Software License, Version 1.1
3  *
4  *
5  * Copyright (c) 2002-2003 The Apache Software Foundation. All rights
6  * reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * 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 "Axis" 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. For more
52  * information on the Apache Software Foundation, please see
53  * <http://www.apache.org/>.
54  */
55 package org.jboss.axis.soap;
56
57 import org.jboss.axis.Message;
58 import org.jboss.axis.message.SOAPEnvelopeAxisImpl;
59
60 import javax.xml.soap.MimeHeaders JavaDoc;
61 import javax.xml.soap.SOAPException JavaDoc;
62 import javax.xml.soap.SOAPMessage JavaDoc;
63 import java.io.IOException JavaDoc;
64 import java.io.InputStream JavaDoc;
65
66 /**
67  * Message Factory implementation
68  *
69  * @author Davanum Srinivas (dims@yahoo.com)
70  */
71 public class MessageFactoryImpl extends javax.xml.soap.MessageFactory JavaDoc
72 {
73    /**
74     * Creates a new <CODE>SOAPMessage</CODE> object with the
75     * default <CODE>SOAPPart</CODE>, <CODE>SOAPEnvelope</CODE>,
76     * <CODE>SOAPBody</CODE>, and <CODE>SOAPHeader</CODE> objects.
77     * Profile-specific message factories can choose to
78     * prepopulate the <CODE>SOAPMessage</CODE> object with
79     * profile-specific headers.
80     * <p/>
81     * <P>Content can be added to this message's <CODE>
82     * SOAPPart</CODE> object, and the message can be sent "as is"
83     * when a message containing only a SOAP part is sufficient.
84     * Otherwise, the <CODE>SOAPMessage</CODE> object needs to
85     * create one or more <CODE>AttachmentPart</CODE> objects and
86     * add them to itself. Any content that is not in XML format
87     * must be in an <CODE>AttachmentPart</CODE> object.</P>
88     *
89     * @return a new <CODE>SOAPMessage</CODE> object
90     * @throws SOAPException if a SOAP error occurs
91     */
92    public SOAPMessage JavaDoc createMessage() throws SOAPException JavaDoc
93    {
94       SOAPEnvelopeAxisImpl env = new SOAPEnvelopeAxisImpl();
95       env.setSAAJEncodingCompliance(true);
96       Message message = new Message(env);
97       message.setMessageType(Message.REQUEST);
98       return message;
99    }
100
101    /**
102     * Internalizes the contents of the given <CODE>
103     * InputStream</CODE> object into a new <CODE>SOAPMessage</CODE>
104     * object and returns the <CODE>SOAPMessage</CODE> object.
105     *
106     * @param mimeheaders the transport-specific headers
107     * passed to the message in a transport-independent fashion
108     * for creation of the message
109     * @param inputstream the <CODE>InputStream</CODE> object
110     * that contains the data for a message
111     * @return a new <CODE>SOAPMessage</CODE> object containing the
112     * data from the given <CODE>InputStream</CODE> object
113     * @throws IOException if there is a
114     * problem in reading data from the input stream
115     * @throws SOAPException if the message is invalid
116     */
117    public SOAPMessage JavaDoc createMessage(MimeHeaders JavaDoc mimeheaders, InputStream JavaDoc inputstream)
118            throws IOException JavaDoc, SOAPException JavaDoc
119    {
120       Message message = new Message(inputstream, false, mimeheaders);
121       message.setMessageType(Message.REQUEST);
122       return message;
123    }
124 }
125
Popular Tags