|
37 | 37 |
|
38 | 38 | /** |
39 | 39 | * Builds a request to an http target. Not thread safe. |
40 | | - * <p/> |
41 | | - * <h4>relationship to JAXRS 2.0</h4> |
42 | | - * <p/> |
| 40 | + * <br> |
| 41 | + * <br><br><b>relationship to JAXRS 2.0</b><br> |
| 42 | + * <br> |
43 | 43 | * A combination of {@code javax.ws.rs.client.WebTarget} and |
44 | 44 | * {@code javax.ws.rs.client.Invocation.Builder}, ensuring you can modify any |
45 | 45 | * part of the request. However, this object is mutable, so needs to be guarded |
@@ -74,20 +74,20 @@ public RequestTemplate(RequestTemplate toCopy) { |
74 | 74 | /** |
75 | 75 | * Targets a template to this target, adding the {@link #url() base url} and |
76 | 76 | * any authentication headers. |
77 | | - * <p/> |
78 | | - * <p/> |
| 77 | + * <br> |
| 78 | + * <br> |
79 | 79 | * For example: |
80 | | - * <p/> |
| 80 | + * <br> |
81 | 81 | * <pre> |
82 | 82 | * public Request apply(RequestTemplate input) { |
83 | 83 | * input.insert(0, url()); |
84 | 84 | * input.replaceHeader("X-Auth", currentToken); |
85 | 85 | * return input.asRequest(); |
86 | 86 | * } |
87 | 87 | * </pre> |
88 | | - * <p/> |
89 | | - * <h4>relationship to JAXRS 2.0</h4> |
90 | | - * <p/> |
| 88 | + * <br> |
| 89 | + * <br><br><b>relationship to JAXRS 2.0</b><br> |
| 90 | + * <br> |
91 | 91 | * This call is similar to |
92 | 92 | * {@code javax.ws.rs.client.WebTarget.resolveTemplates(templateValues, true)} |
93 | 93 | * , except that the template values apply to any part of the request, not |
@@ -151,7 +151,7 @@ private static String urlEncode(Object arg) { |
151 | 151 | /** |
152 | 152 | * Expands a {@code template}, such as {@code username}, using the {@code variables} supplied. Any unresolved |
153 | 153 | * parameters will remain. |
154 | | - * <p/> |
| 154 | + * <br> |
155 | 155 | * Note that if you'd like curly braces literally in the {@code template}, |
156 | 156 | * urlencode them first. |
157 | 157 | * |
@@ -227,16 +227,16 @@ public String url() { |
227 | 227 | /** |
228 | 228 | * Replaces queries with the specified {@code configKey} with url decoded |
229 | 229 | * {@code values} supplied. |
230 | | - * <p/> |
| 230 | + * <br> |
231 | 231 | * When the {@code value} is {@code null}, all queries with the {@code configKey} |
232 | 232 | * are removed. |
233 | | - * <p/> |
234 | | - * <h4>relationship to JAXRS 2.0</h4> |
235 | | - * <p/> |
| 233 | + * <br> |
| 234 | + * <br><br><b>relationship to JAXRS 2.0</b><br> |
| 235 | + * <br> |
236 | 236 | * Like {@code WebTarget.query}, except the values can be templatized. |
237 | | - * <p/> |
| 237 | + * <br> |
238 | 238 | * ex. |
239 | | - * <p/> |
| 239 | + * <br> |
240 | 240 | * <pre> |
241 | 241 | * template.query("Signature", "{signature}"); |
242 | 242 | * </pre> |
@@ -274,13 +274,13 @@ private String encodeIfNotVariable(String in) { |
274 | 274 | /** |
275 | 275 | * Replaces all existing queries with the newly supplied url decoded |
276 | 276 | * queries. |
277 | | - * <p/> |
278 | | - * <h4>relationship to JAXRS 2.0</h4> |
279 | | - * <p/> |
| 277 | + * <br> |
| 278 | + * <br><br><b>relationship to JAXRS 2.0</b><br> |
| 279 | + * <br> |
280 | 280 | * Like {@code WebTarget.queries}, except the values can be templatized. |
281 | | - * <p/> |
| 281 | + * <br> |
282 | 282 | * ex. |
283 | | - * <p/> |
| 283 | + * <br> |
284 | 284 | * <pre> |
285 | 285 | * template.queries(ImmutableMultimap.of("Signature", "{signature}")); |
286 | 286 | * </pre> |
@@ -323,17 +323,17 @@ public Map<String, Collection<String>> queries() { |
323 | 323 | /** |
324 | 324 | * Replaces headers with the specified {@code configKey} with the |
325 | 325 | * {@code values} supplied. |
326 | | - * <p/> |
| 326 | + * <br> |
327 | 327 | * When the {@code value} is {@code null}, all headers with the {@code configKey} |
328 | 328 | * are removed. |
329 | | - * <p/> |
330 | | - * <h4>relationship to JAXRS 2.0</h4> |
331 | | - * <p/> |
| 329 | + * <br> |
| 330 | + * <br><br><b>relationship to JAXRS 2.0</b><br> |
| 331 | + * <br> |
332 | 332 | * Like {@code WebTarget.queries} and {@code javax.ws.rs.client.Invocation.Builder.header}, |
333 | 333 | * except the values can be templatized. |
334 | | - * <p/> |
| 334 | + * <br> |
335 | 335 | * ex. |
336 | | - * <p/> |
| 336 | + * <br> |
337 | 337 | * <pre> |
338 | 338 | * template.query("X-Application-Version", "{version}"); |
339 | 339 | * </pre> |
@@ -364,14 +364,14 @@ public RequestTemplate header(String configKey, Iterable<String> values) { |
364 | 364 |
|
365 | 365 | /** |
366 | 366 | * Replaces all existing headers with the newly supplied headers. |
367 | | - * <p/> |
368 | | - * <h4>relationship to JAXRS 2.0</h4> |
369 | | - * <p/> |
| 367 | + * <br> |
| 368 | + * <br><br><b>relationship to JAXRS 2.0</b><br> |
| 369 | + * <br> |
370 | 370 | * Like {@code Invocation.Builder.headers(MultivaluedMap)}, except the |
371 | 371 | * values can be templatized. |
372 | | - * <p/> |
| 372 | + * <br> |
373 | 373 | * ex. |
374 | | - * <p/> |
| 374 | + * <br> |
375 | 375 | * <pre> |
376 | 376 | * template.headers(ImmutableMultimap.of("X-Application-Version", "{version}")); |
377 | 377 | * </pre> |
@@ -399,7 +399,7 @@ public Map<String, Collection<String>> headers() { |
399 | 399 |
|
400 | 400 | /** |
401 | 401 | * replaces the {@link feign.Util#CONTENT_LENGTH} header. |
402 | | - * <p/> |
| 402 | + * <br> |
403 | 403 | * Usually populated by {@link feign.codec.BodyEncoder} or {@link feign.codec.FormEncoder} |
404 | 404 | * |
405 | 405 | * @see Request#body() |
|
0 commit comments