001    /** 
002     * 
003     * Copyright 2004 Protique Ltd
004     * 
005     * Licensed under the Apache License, Version 2.0 (the "License"); 
006     * you may not use this file except in compliance with the License. 
007     * You may obtain a copy of the License at 
008     * 
009     * http://www.apache.org/licenses/LICENSE-2.0
010     * 
011     * Unless required by applicable law or agreed to in writing, software
012     * distributed under the License is distributed on an "AS IS" BASIS, 
013     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
014     * See the License for the specific language governing permissions and 
015     * limitations under the License. 
016     * 
017     **/
018    package org.codehaus.activesoap;
019    
020    import javax.xml.stream.XMLStreamReader;
021    import javax.xml.stream.XMLStreamWriter;
022    
023    /**
024     * A pluggable Strategy pattern for processing a fragment of XML which is
025     * typically a SOAP body element and its content or a single SOAP header element
026     * but can also be used for processing entire REST XML services as well.
027     *
028     * @version $Revision: 1.9 $
029     */
030    public interface Handler {
031    
032        /**
033         * Handles the processing of an XML message which is typically a SOAP body element
034         * or header element but could be an entire REST XML service.
035         *
036         * @param exchange is the message exchange which can be used to accesss message-specific attributes
037         * to communicate between different handlers in a loose coupled way or to access service specific details
038         * such as the SOAP roles and encodings etc.
039         *
040         */
041        public void invoke(MessageExchange exchange) throws Exception;
042    
043    }