FilesExpand file tree

master

/

Target.java

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

206 lines (177 loc) · 5.51 KB

master

/

Target.java

Copy path

Top

File metadata and controls

• Code
• Blame

206 lines (177 loc) · 5.51 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

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

/*

* 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 static feign.Util.checkNotNull;

import static feign.Util.emptyToNull;

/**

* <br>

* <br>

* <b>relationship to JAXRS 2.0</b><br>

* <br>

* Similar to {@code javax.ws.rs.client.WebTarget}, as it produces requests. However, {@link

* RequestTemplate} is a closer match to {@code WebTarget}.

*

* @param <T> type of the interface this target applies to.

*/

public interface Target<T> {

/* The type of the interface this target applies to. ex. {@code Route53}. */

Class<T> type();

/* configuration key associated with this target. For example, {@code route53}. */

String name();

/* base HTTP URL of the target. For example, {@code https://api/v2}. */

String url();

/**

* Targets a template to this target, adding the {@link #url() base url} and any target-specific

* headers or query parameters. <br>

* <br>

* For example: <br>

*

* <pre>

* public Request apply(RequestTemplate input) {

* input.insert(0, url());

* input.replaceHeader(&quot;X-Auth&quot;, currentToken);

* return input.asRequest();

* }

* </pre>

*

* <br>

* <br>

* <br>

* <b>relationship to JAXRS 2.0</b><br>

* <br>

* This call is similar to {@code javax.ws.rs.client.WebTarget.request()}, except that we expect

* transient, but necessary decoration to be applied on invocation.

*/

public Request apply(RequestTemplate input);

public static class HardCodedTarget<T> implements Target<T> {

private final Class<T> type;

private final String name;

private final String url;

public HardCodedTarget(Class<T> type, String url) {

this(type, url, url);

}

public HardCodedTarget(Class<T> type, String name, String url) {

this.type = checkNotNull(type, "type");

this.name = checkNotNull(emptyToNull(name), "name");

this.url = checkNotNull(emptyToNull(url), "url");

}

@Override

public Class<T> type() {

return type;

}

@Override

public String name() {

return name;

}

@Override

public String url() {

return url;

}

/* no authentication or other special activity. just insert the url. */

@Override

public Request apply(RequestTemplate input) {

if (input.url().indexOf("http") != 0) {

input.target(url());

}

return input.request();

}

@Override

public boolean equals(Object obj) {

if (obj instanceof HardCodedTarget) {

HardCodedTarget<?> other = (HardCodedTarget) obj;

return type.equals(other.type) && name.equals(other.name) && url.equals(other.url);

}

return false;

}

@Override

public int hashCode() {

int result = 17;

result = 31 * result + type.hashCode();

result = 31 * result + name.hashCode();

result = 31 * result + url.hashCode();

return result;

}

@Override

public String toString() {

if (name.equals(url)) {

return "HardCodedTarget(type=" + type.getSimpleName() + ", url=" + url + ")";

}

return "HardCodedTarget(type="

+ type.getSimpleName()

+ ", name="

+ name

+ ", url="

+ url

+ ")";

}

}

public static final class EmptyTarget<T> implements Target<T> {

private final Class<T> type;

private final String name;

EmptyTarget(Class<T> type, String name) {

this.type = checkNotNull(type, "type");

this.name = checkNotNull(emptyToNull(name), "name");

}

public static <T> EmptyTarget<T> create(Class<T> type) {

return new EmptyTarget<T>(type, "empty:" + type.getSimpleName());

}

public static <T> EmptyTarget<T> create(Class<T> type, String name) {

return new EmptyTarget<T>(type, name);

}

@Override

public Class<T> type() {

return type;

}

@Override

public String name() {

return name;

}

@Override

public String url() {

throw new UnsupportedOperationException("Empty targets don't have URLs");

}

@Override

public Request apply(RequestTemplate input) {

if (input.url().indexOf("http") != 0) {

throw new UnsupportedOperationException(

"Request with non-absolute URL not supported with empty target");

}

return input.request();

}

@Override

public boolean equals(Object obj) {

if (obj instanceof EmptyTarget) {

EmptyTarget<?> other = (EmptyTarget) obj;

return type.equals(other.type) && name.equals(other.name);

}

return false;

}

@Override

public int hashCode() {

int result = 17;

result = 31 * result + type.hashCode();

result = 31 * result + name.hashCode();

return result;

}

@Override

public String toString() {

if (name.equals("empty:" + type.getSimpleName())) {

return "EmptyTarget(type=" + type.getSimpleName() + ")";

}

return "EmptyTarget(type=" + type.getSimpleName() + ", name=" + name + ")";

}

}

}