View Javadoc

1   /*
2    * Copyright 2005 the original author or authors.
3    *
4    * Licensed under the Apache License, Version 2.0 (the "License");
5    * you may not use this file except in compliance with the License.
6    * You may obtain a copy of the License at
7    *
8    *      http://www.apache.org/licenses/LICENSE-2.0
9    *
10   * Unless required by applicable law or agreed to in writing, software
11   * distributed under the License is distributed on an "AS IS" BASIS,
12   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13   * See the License for the specific language governing permissions and
14   * limitations under the License.
15   */
16  
17  package org.springframework.ws.server.endpoint;
18  
19  import org.springframework.ws.context.MessageContext;
20  
21  /**
22   * Defines the basic contract for Web Services interested in the entire message payload.
23   * <p/>
24   * <p>The main entrypoint is {@link #invoke(MessageContext)}, which gets invoked with the message context. This context
25   * contains the {@link MessageContext#getRequest() request}, and can be used to create a response.
26   *
27   * @author Arjen Poutsma
28   * @see org.springframework.ws.server.endpoint.PayloadEndpoint
29   * @since 1.0.0
30   */
31  public interface MessageEndpoint {
32  
33      /**
34       * Invokes an operation.
35       * <p/>
36       * <p>The given <code>messageContext</code> can be used to create a response.
37       *
38       * @param messageContext the message context
39       * @throws Exception if an exception occurs
40       */
41      void invoke(MessageContext messageContext) throws Exception;
42  }