FilesExpand file tree

master

/

Capability.java

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

155 lines (131 loc) · 4.62 KB

master

/

Capability.java

Copy path

Top

File metadata and controls

• Code
• Blame

155 lines (131 loc) · 4.62 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

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

/*

* 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.Logger.Level;

import feign.Request.Options;

import feign.codec.Decoder;

import feign.codec.Encoder;

import feign.codec.ErrorDecoder;

import java.lang.reflect.InvocationTargetException;

import java.util.Arrays;

import java.util.List;

/**

* Capabilities expose core feign artifacts to implementations so parts of core can be customized

* around the time the client being built.

*

* <p>For instance, capabilities take the {@link Client}, make changes to it and feed the modified

* version back to feign.

*

* @see Metrics5Capability

*/

public interface Capability {

static Object enrich(

Object componentToEnrich, Class<?> capabilityToEnrich, List<Capability> capabilities) {

return capabilities.stream()

// invoke each individual capability and feed the result to the next one.

// This is equivalent to:

// Capability cap1 = ...;

// Capability cap2 = ...;

// Capability cap2 = ...;

// Contract contract = ...;

// Contract contract1 = cap1.enrich(contract);

// Contract contract2 = cap2.enrich(contract1);

// Contract contract3 = cap3.enrich(contract2);

// or in a more compact version

// Contract enrichedContract = cap3.enrich(cap2.enrich(cap1.enrich(contract)));

.reduce(

componentToEnrich,

(target, capability) -> invoke(target, capability, capabilityToEnrich),

(component, enrichedComponent) -> enrichedComponent);

}

static Object invoke(Object target, Capability capability, Class<?> capabilityToEnrich) {

return Arrays.stream(capability.getClass().getMethods())

.filter(method -> method.getName().equals("enrich"))

.filter(method -> method.getReturnType().isAssignableFrom(capabilityToEnrich))

.findFirst()

.map(

method -> {

try {

return method.invoke(capability, target);

} catch (IllegalAccessException

| IllegalArgumentException

| InvocationTargetException e) {

throw new RuntimeException("Unable to enrich " + target, e);

}

})

.orElse(target);

}

default Client enrich(Client client) {

return client;

}

default AsyncClient<Object> enrich(AsyncClient<Object> client) {

return client;

}

default Retryer enrich(Retryer retryer) {

return retryer;

}

default RequestInterceptor enrich(RequestInterceptor requestInterceptor) {

return requestInterceptor;

}

default ResponseInterceptor enrich(ResponseInterceptor responseInterceptor) {

return responseInterceptor;

}

default ResponseInterceptor.Chain enrich(ResponseInterceptor.Chain chain) {

return chain;

}

default Logger enrich(Logger logger) {

return logger;

}

default Level enrich(Level level) {

return level;

}

default Contract enrich(Contract contract) {

return contract;

}

default Options enrich(Options options) {

return options;

}

default Encoder enrich(Encoder encoder) {

return encoder;

}

default Decoder enrich(Decoder decoder) {

return decoder;

}

default ErrorDecoder enrich(ErrorDecoder decoder) {

return decoder;

}

default InvocationHandlerFactory enrich(InvocationHandlerFactory invocationHandlerFactory) {

return invocationHandlerFactory;

}

default QueryMapEncoder enrich(QueryMapEncoder queryMapEncoder) {

return queryMapEncoder;

}

default AsyncResponseHandler enrich(AsyncResponseHandler asyncResponseHandler) {

return asyncResponseHandler;

}

default <C> AsyncContextSupplier<C> enrich(AsyncContextSupplier<C> asyncContextSupplier) {

return asyncContextSupplier;

}

default MethodInfoResolver enrich(MethodInfoResolver methodInfoResolver) {

return methodInfoResolver;

}

default RequestInterceptors enrich(RequestInterceptors requestInterceptors) {

return requestInterceptors;

}

default ResponseInterceptors enrich(ResponseInterceptors responseInterceptors) {

return responseInterceptors;

}

}