View Javadoc

1   /*
2    * Copyright 2005-2010 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.test.support.matcher;
18  
19  import java.io.IOException;
20  
21  import org.springframework.ws.WebServiceMessage;
22  import org.springframework.ws.soap.SoapMessage;
23  
24  import static org.springframework.ws.test.support.AssertionErrors.assertTrue;
25  
26  /**
27   * Abstract base class for SOAP-specific [email protected] WebServiceMessageMatcher} implementations.
28   * <p/>
29   * Asserts that the message given to [email protected] #match(WebServiceMessage)} is a [email protected] SoapMessage}, and invokes [email protected]
30   * #match(SoapMessage)} with it if so.
31   *
32   * @author Arjen Poutsma
33   * @since 2.0
34   */
35  public abstract class AbstractSoapMessageMatcher implements WebServiceMessageMatcher {
36  
37      public final void match(WebServiceMessage message) throws IOException, AssertionError {
38          assertTrue("Message is not a SOAP message", message instanceof SoapMessage);
39          match((SoapMessage) message);
40      }
41  
42      /**
43       * Abstract template method that gets invoked from [email protected] #match(WebServiceMessage)} if the given message is a
44       * [email protected] SoapMessage}.
45       *
46       * @param soapMessage the soap message
47       * @throws IOException    in case of I/O errors
48       * @throws AssertionError if expectations are not met
49       */
50      protected abstract void match(SoapMessage soapMessage) throws IOException, AssertionError;
51  }