Package org.glassfish.jersey.server.model

Class RuntimeResource

  • All Implemented Interfaces:
    ResourceModelComponent
    public class RuntimeResource
extends Object
implements ResourceModelComponent
    Runtime resource is a group of resources with the same path regular expression. Runtime resource is constructed from resources creating the resource model.

    Runtime resource can have child runtime resources which are groups of child resources of all resources constructing this runtime resource.

    The following example shows how Runtime resource structure is built from Resource model: 

     @Path("{foo}")
 public class TemplateResourceFoo {
     @GET
     @Path("child")
     public String getFoo() {...}

     @Path("{x}")
     @GET
     public String getX() {...}

     @Path("{y}")
     @POST
     public String postY(String entity) {...}
 }

 @Path("{bar}")
 public class TemplateResourceBar {
     @Path("{z}")
     @PUT
     public String putZ(String entity) {...}
 }
    Will be represented by RuntimeResources:
    line RuntimeResource regex Grouped Resources (paths) Parent RuntimeResource (line)
    1 "/([^/]+?)" Resource("{foo}"), Resource("{bar}") no parent
    2 "child" Child Resource("child") 1
    3 "/([^/]+?)" Child Resource("{x}"), Child Resource("{y}"), Child Resource("{z}") 1
    Author:
    Miroslav Fuksa

    • Field Detail

      • COMPARATOR

        public static final Comparator<RuntimeResource> COMPARATOR
        Comparator of RuntimeResources based on rules respecting resource matching algorithm.

    • Method Detail

      • getChildRuntimeResources

        public List<RuntimeResource> getChildRuntimeResources()
        Get child runtime resources of this resource.
        Returns:
        List of child runtime resource.

      • getRegex

        public String getRegex()
        Get regular expression of path pattern of this runtime resource.
        Returns:
        Matching regular expression.

      • getResourceMethods

        public List<ResourceMethod> getResourceMethods()
        Get resource methods (excluding resource locators) of all resources of this runtime resource.
        Returns:
        List of resource methods.

      • getResourceLocators

        public List<ResourceMethod> getResourceLocators()
        Get resource locators of all resources of this runtime resource.

        Note that valid RuntimeResource should have only one resource locator. This method is used for validation purposes.

        Returns:
        List of resource locators.

      • getResourceLocator

        public ResourceMethod getResourceLocator()
        Return the resource locator of this resource.
        Returns:
        Resource locator of this runtime resource.

      • getParent

        public RuntimeResource getParent()
        Get parent of this runtime resource.
        Returns:
        Parent runtime resource if this runtime resource is a child resource, null otherwise.

      • getPathPattern

        public PathPattern getPathPattern()
        Get path pattern for matching purposes.
        Returns:
        Path pattern.

      • getFullPathRegex

        public String getFullPathRegex()
        Get full regular expression of this runtime resource prefixed by regular expression of parent if present.
        Returns:
        Full resource regular expression.

      • getParentResources

        public List<Resource> getParentResources()
        Return parent resources of resources from this runtime resource. The returned list is ordered so that the position of the parent resource in the returned list is the same as position of its child resource in list returned by getResources(). Simply said the order of lists returned from getParentResources() and getResources() from parent-child point of view is the same. If the resource has no parent then the element null is in the list.
        Returns:
        Parent resource list with resources if this runtime resource is child resource or null elements if this runtime resource is the parent resource.

      • getResources

        public List<Resource> getResources()
        Get resources creating this runtime resource.
        Returns:
        List of resources with same path regular expression which this resource is based on.