Java 类retrofit.http.GET 实例源码

/**
 * Returns the most popular movies. Popularity is calculated using the rating percentage and the number of ratings.
 *
 * @param page Number of page of results to be returned. If {@code null} defaults to 1.
 * @param limit Number of results to return per page. If {@code null} defaults to 10.
 */
@GET("/movies/popular")
List<Movie> popular(
        @Query("page") Integer page,
        @Query("limit") Integer limit,
        @EncodedQuery("extended") Extended extended
);

/**
 * ID lookups are helpful if you have an external ID and want to get the trakt ID and info. This method will search
 * for movies, shows, episodes, people, users, and lists.
 *
 * @param idType Set to any of {@link com.uwetrottmann.trakt.v2.enums.IdType}.
 * @param id ID that matches with the type.
 */
@GET("/search")
List<SearchResult> idLookup(
        @EncodedQuery("id_type") IdType idType,
        @EncodedQuery("id") String id,
        @Query("page") Integer page,
        @Query("limit") Integer limit
);

@GET("/v1.0/me/mailfolders/{folderid}/messages")
Response getMessages(
  @Path("folderid") String folderId,
  @Query("$orderby") String orderBy,
  @Query("$select") String select,
  @Query("$filter") String filter,
  @Query("$top") Integer maxResults
);

/**
 * Queries will search fields like the title and description.
 *
 * @param query Searches titles and descriptions.
 * @param type (optional) Narrow down search by element type.
 */
@GET("/search")
List<SearchResult> textQuery(
        @Query("query") String query,
        @Query("type") Type type,
        @Query("page") Integer page,
        @Query("limit") Integer limit
);

/**
 * Returns all movies being watched right now. Movies with the most users are returned first.
 *
 * @param page Number of page of results to be returned. If {@code null} defaults to 1.
 * @param limit Number of results to return per page. If {@code null} defaults to 10.
 */
@GET("/movies/trending")
List<TrendingMovie> trending(
        @Query("page") Integer page,
        @Query("limit") Integer limit,
        @EncodedQuery("extended") Extended extended
);

/**
 * Returns all shows being watched right now. Shows with the most users are returned first.
 *
 * @param page Number of page of results to be returned. If {@code null} defaults to 1.
 * @param limit Number of results to return per page. If {@code null} defaults to 10.
 */
@GET("/shows/trending")
List<TrendingShow> trending(
        @Query("page") Integer page,
        @Query("limit") Integer limit,
        @EncodedQuery("extended") Extended extended
);

/**
 * Returns all top level comments for an episode. Most recent comments returned first.
 *
 * @param showId trakt ID, trakt slug, or IMDB ID. Example: "game-of-thrones".
 * @param season Season number.
 * @param episode Episode number.
 */
@GET("/shows/{id}/seasons/{season}/episodes/{episode}/comments")
List<Comment> comments(
        @Path("id") String showId,
        @Path("season") int season,
        @Path("episode") int episode,
        @Query("page") Integer page,
        @Query("limit") Integer limit,
        @EncodedQuery("extended") Extended extended
);

/**
 * <b>OAuth Optional</b>
 *
 * <p> Get all items on a custom list. Items can be movies, shows, seasons, episodes, or people.
 */
@GET("/users/{username}/lists/{id}/items")
List<ListEntry> listItems(
        @Path("username") String username,
        @Path("id") String id,
        @EncodedQuery("extended") Extended extended
) throws OAuthUnauthorizedException;

/**
 * Returns the most popular shows. Popularity is calculated using the rating percentage and the number of ratings.
 *
 * @param page Number of page of results to be returned. If {@code null} defaults to 1.
 * @param limit Number of results to return per page. If {@code null} defaults to 10.
 */
@GET("/shows/popular")
List<Show> popular(
        @Query("page") Integer page,
        @Query("limit") Integer limit,
        @EncodedQuery("extended") Extended extended
);

@GET("/list")
void getFeed(Callback<List<Photo>> callback);

@GET("/topstories.json")
Observable<List<Integer>> getTopStories();

@GET("/beststories.json")
Observable<List<Integer>> getBestStories();

@GET("/showstories.json")
Observable<List<Integer>> getShowStories();

@GET("/item/{id}.json")
Observable<Item> getItem(@Path("id") int id);

@GET("/users")
public void getUsers(Callback<List<User>> callback);

@GET("/jokes/random/10")
Observable<Response> getItems(@Query("firstName") String firstName, @Query("lastName") String lastName);

@GET("/jokes/{id}")
Observable<ItemResponse> getItem(@Query("firstName") String firstName, @Query("lastName") String lastName, @Path("id") int id);

@GET("/jokes/random/10")
Observable<Response> getItems(@Query("firstName") String firstName, @Query("lastName") String lastName);

@GET("/jokes/random/10")
Observable<Response> getItems(@Query("firstName") String firstName, @Query("lastName") String lastName);

@GET("/jokes/random/10")
Observable<Response> getItems(@Query("firstName") String firstName, @Query("lastName") String lastName);

@GET(Constants.GOOGLE_API_BASE_URL + "/drive/v3/files")
Call<DriveSearchResult> searchFiles(@Header("Authorization") String authorization, @Query("q") String searchQuery);

@GET("/people/{id}/movies")
Credits movieCredits(
        @Path("id") String personId
);

@GET(COMPANY_URI+"?fields=id,name,domains,external_id,custom_fields")    
Call<ApiResponse<Company>> getCompanies(@Query("per_page") int perPage,
        @Query("page") int page);

@GET(CASES_URI + "/search")
Call<ApiResponse<Case>> searchCasesById(@Query("since_id") int since_id, @Query("per_page") int perPage,
    @Query("page") int page, @Query("sort_field") String sortField,
    @Query("sort_direction") SortDirection sortDirection, @Query("embed") Embed embed,
    @Query("fields") Fields fields);

/**
 * Returns a single movie's details.
 *
 * @param movieId trakt ID, trakt slug, or IMDB ID. Example: "tron-legacy-2010".
 */
@GET("/movies/{id}")
Movie summary(
        @Path("id") String movieId,
        @EncodedQuery("extended") Extended extended
);

/**
 * Returns a single person's details.
 *
 * @param personId trakt ID, trakt slug, or IMDB ID Example: bryan-cranston.
 */
@GET("/people/{id}")
Person summary(
        @Path("id") String personId,
        @Query("extended") Extended extended
);

@GET("/{id_station}")
void getStationInfo(@Path("id_station") String idStation, Callback<StationResponse> callback);

@GET("/v1.0/me")
Response getCurrentUser();

@GET("/v1.0/me/mailfolders/{folderid}")
Response getFolder(
  @Path("folderid") String folderId
);

@Headers("Cache-Control: public")
@GET(BASE_PARAMETERS_ALBUM)
void getAlbumInfo(@Query("artist") String artist, @Query("album") String album, Callback<AlbumInfo> callback);

@Headers("Cache-Control: public")
@GET(BASE_PARAMETERS_ARTIST)
void getArtistInfo(@Query("artist") String artist, Callback<ArtistInfo> callback);

@GET("/v1/devices/{deviceID}/{variable}")
ReadObjectVariableResponse getVariable(@Path("deviceID") String deviceID,
                                       @Path("variable") String variable);

@GET("/v1/devices/{deviceID}/{variable}")
ReadStringVariableResponse getStringVariable(@Path("deviceID") String deviceID,
                                             @Path("variable") String variable);

@GET(USER_GET_CONTACTS_ACCEPTED_SVC)
Collection<MobileClient> getContactsAccepted(@Path(USER_ID) long userId);

@GET(USER_GET_CONTACTS_PENDING_SVC)
public Collection<MobileClient> getContactsPending(@Path(USER_ID) long userId);

@GET(SUB_ALERTS_SVC)
Collection<GlucoseAlert> getAlertsByUser(
        @Path(SUBSCRIBER_ID) long subId,
        @Query(PUBLISHER_ID) long pubId,
        HttpServletResponse response);

@GET(USER_GET_CONTACTS_ACCEPTED_SVC)
public Collection<MobileClient> getContactsAccepted(@Path(USER_ID) long userId);

@GET(USER_GET_CONTACTS_PENDING_SVC)
public Collection<MobileClient> getContactsPending(@Path(USER_ID) long userId);

@GET(RULE_SVC_PATH)
Collection<Rule> getRuleList();

@GET("/1kpjf")
void listEvents(Callback<List<Event>> eventsCallback);