View Javadoc

1   /**
2    *
3    * Copyright (C) 2011 Cloud Conscious, LLC. <info@cloudconscious.com>
4    *
5    * ====================================================================
6    * Licensed under the Apache License, Version 2.0 (the "License");
7    * you may not use this file except in compliance with the License.
8    * You may obtain a copy of the License at
9    *
10   * http://www.apache.org/licenses/LICENSE-2.0
11   *
12   * Unless required by applicable law or agreed to in writing, software
13   * distributed under the License is distributed on an "AS IS" BASIS,
14   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15   * See the License for the specific language governing permissions and
16   * limitations under the License.
17   * ====================================================================
18   */
19  package org.jclouds.http;
20  
21  import java.util.concurrent.Future;
22  
23  /**
24   * Capable of invoking http commands.
25   * 
26   * @author Adrian Cole
27   */
28  public interface HttpCommandExecutorService {
29  
30     /**
31      * Asks the command to build a request relevant for an endpoint that produces responses of
32      * generic type {@code HttpResponse}. and invokes it on the endpoint, returning a future
33      * 
34      * @param command
35      *           that generates requests
36      * @return {@link Future} containing the response from the {@code endpoint}
37      */
38     Future<HttpResponse> submit(HttpCommand command);
39  }