FilesExpand file tree

master

/

AsyncClient.java

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

79 lines (69 loc) · 2.67 KB

master

/

AsyncClient.java

Copy path

Top

File metadata and controls

• Code
• Blame

79 lines (69 loc) · 2.67 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

/*

* Copyright © 2012 The Feign Authors (feign@commonhaus.dev)

*

* Licensed under the Apache License, Version 2.0 (the "License");

* you may not use this file except in compliance with the License.

* You may obtain a copy of the License at

*

* http://www.apache.org/licenses/LICENSE-2.0

*

* Unless required by applicable law or agreed to in writing, software

* distributed under the License is distributed on an "AS IS" BASIS,

* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

* See the License for the specific language governing permissions and

* limitations under the License.

*/

package feign;

import feign.Request.Options;

import java.util.Optional;

import java.util.concurrent.CompletableFuture;

import java.util.concurrent.ExecutorService;

/** Submits HTTP {@link Request requests} asynchronously, with an optional context. */

@Experimental

public interface AsyncClient<C> {

/**

* Executes the request asynchronously. Calling {@link CompletableFuture#cancel(boolean)} on the

* result may cause the execution to be cancelled / aborted, but this is not guaranteed.

*

* @param request safe to replay

* @param options options to apply to this request

* @param requestContext - the optional context, for example for storing session cookies. The

* client should update this appropriately based on the received response before completing

* the result.

* @return a {@link CompletableFuture} to be completed with the response, or completed

* exceptionally otherwise, for example with an {@link java.io.IOException} on a network error

* connecting to {@link Request#url()}.

*/

CompletableFuture<Response> execute(Request request, Options options, Optional<C> requestContext);

/**

* @deprecated use {@link DefaultAsyncClient} instead.

*/

@Deprecated

class Default<C> extends DefaultAsyncClient<C> {

public Default(Client client, ExecutorService executorService) {

super(client, executorService);

}

}

/**

* A synchronous implementation of {@link AsyncClient}

*

* @param <C> - unused context; synchronous clients handle context internally

*/

class Pseudo<C> implements AsyncClient<C> {

private final Client client;

public Pseudo(Client client) {

this.client = client;

}

@Override

public CompletableFuture<Response> execute(

Request request, Options options, Optional<C> requestContext) {

final CompletableFuture<Response> result = new CompletableFuture<>();

try {

result.complete(client.execute(request, options));

} catch (final Exception e) {

result.completeExceptionally(e);

}

return result;

}

}

}