com.netflix.eureka.resources
Class ApplicationsResource

java.lang.Object
  com.netflix.eureka.resources.ApplicationsResource

public class ApplicationsResource
extends java.lang.Object

A jersey resource that handles request related to all Applications.

Constructor Summary

ApplicationsResource()

Method Summary

ApplicationResource	getApplicationResource(java.lang.String version, java.lang.String appId) Gets information about a particular Application.
javax.ws.rs.core.Response	getContainerDifferential(java.lang.String version, java.lang.String acceptHeader, java.lang.String acceptEncoding, javax.ws.rs.core.UriInfo uriInfo, java.lang.String regionsStr) Get information about all delta changes in Applications.
javax.ws.rs.core.Response	getContainers(java.lang.String version, java.lang.String acceptHeader, java.lang.String acceptEncoding, javax.ws.rs.core.UriInfo uriInfo, java.lang.String regionsStr) Get information about all Applications.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ApplicationsResource

public ApplicationsResource()

Method Detail

getApplicationResource

public ApplicationResource getApplicationResource(java.lang.String version,
                                                  java.lang.String appId)

Gets information about a particular Application.

Parameters:

version - the version of the request.

appId - the unique application identifier (which is the name) of the application.

Returns:

information about a particular application.

getContainers

public javax.ws.rs.core.Response getContainers(java.lang.String version,
                                               @HeaderParam(value="Accept")
                                               java.lang.String acceptHeader,
                                               @HeaderParam(value="Accept-Encoding")
                                               java.lang.String acceptEncoding,
                                               @Context
                                               javax.ws.rs.core.UriInfo uriInfo,
                                               @Nullable
                                               java.lang.String regionsStr)

Get information about all Applications.

Parameters:

version - the version of the request.

acceptHeader - the accept header of the request to indicate whether to serve JSON or XML data.

acceptEncoding - the accept header of the request to indicate whether to serve compressed or uncompressed data.

uriInfo - the URI information of the request made.

regionsStr - A comma separated list of remote regions from which the instances will also be returned. The applications returned from the remote region can be limited to the applications returned by EurekaServerConfig.getRemoteRegionAppWhitelist(String)

Returns:

response containing information about all Applications from the InstanceRegistry.

getContainerDifferential

public javax.ws.rs.core.Response getContainerDifferential(java.lang.String version,
                                                          @HeaderParam(value="Accept")
                                                          java.lang.String acceptHeader,
                                                          @HeaderParam(value="Accept-Encoding")
                                                          java.lang.String acceptEncoding,
                                                          @Context
                                                          javax.ws.rs.core.UriInfo uriInfo,
                                                          @Nullable
                                                          java.lang.String regionsStr)

Get information about all delta changes in Applications.

The delta changes represent the registry information change for a period as configured by EurekaServerConfig.getRetentionTimeInMSInDeltaQueue(). The changes that can happen in a registry include Registrations,Cancels,Status Changes and Expirations. Normally the changes to the registry are infrequent and hence getting just the delta will be much more efficient than getting the complete registry.

Since the delta information is cached over a period of time, the requests may return the same data multiple times within the window configured by EurekaServerConfig.getRetentionTimeInMSInDeltaQueue().The clients are expected to handle this duplicate information.

Parameters:

version - the version of the request.

acceptHeader - the accept header of the request to indicate whether to serve JSON or XML data.

acceptEncoding - the accept header of the request to indicate whether to serve compressed or uncompressed data.

uriInfo - the URI information of the request made.

Returns:

response containing the delta information of the InstanceRegistry.z