forked from OpenFeign/feign
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathRequestLine.java
More file actions
56 lines (53 loc) · 1.5 KB
/
RequestLine.java
File metadata and controls
56 lines (53 loc) · 1.5 KB
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
package feign;
import java.lang.annotation.Retention;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
/**
* Expands the request-line supplied in the {@code value}, permitting path and query variables,
* or just the http method.
* <br>
* <pre>
* ...
* @RequestLine("POST /servers")
* ...
*
* @RequestLine("GET /servers/{serverId}?count={count}")
* void get(@Named("serverId") String serverId, @Named("count") int count);
* ...
*
* @RequestLine("GET")
* Response getNext(URI nextLink);
* ...
* </pre>
* HTTP version suffix is optional, but permitted. There are no guarantees this version will impact that
* sent by the client.
* <br>
* <pre>
* @RequestLine("POST /servers HTTP/1.1")
* ...
* </pre>
* <br>
* <strong>Note:</strong> Query params do not overwrite each other. All queries with the same name will
* be included in the request.
* <br><br><b>Relationship to JAXRS</b><br>
* <br>
* The following two forms are identical.
* <br>
* Feign:
* <pre>
* @RequestLine("GET /servers/{serverId}?count={count}")
* void get(@Named("serverId") String serverId, @Named("count") int count);
* ...
* </pre>
* <br>
* JAX-RS:
* <pre>
* @GET @Path("/servers/{serverId}")
* void get(@PathParam("serverId") String serverId, @QueryParam("count") int count);
* ...
* </pre>
*/
@java.lang.annotation.Target(METHOD) @Retention(RUNTIME)
public @interface RequestLine {
String value();
}