• Home
• net.sf.javaprinciples.resource
• resource-handling-api
• 2.0.4
• source code
• ResourceIdentifierParser.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

net.sf.javaprinciples.resource.ResourceIdentifierParser Maven / Gradle / Ivy

package net.sf.javaprinciples.resource;

import javax.servlet.http.HttpServletRequest;

/**
 * Interface representing a method of parsing some form of URI into a ResourceIdentifier.
 * Currently this only supports parsing a String representation of a URI, however it is
 * possible that in future it might need to also support parsing a URI object. It's not
 * here now, 'cause YAGNI.
 *
 * @author rvl
 *
 */
public interface ResourceIdentifierParser
{
    /**
     * Parse the provided String version of a URI to produce a ResourceIdentifier.
     * @param request The request containing the URI attributes to parse.
     * @return A ResourceIdentifier containing the elements of the URI that identify
     *  the Resource.
     *  @throws ResourceParseException if there is any problem encountered parsing the URI.
     */
    ResourceIdentifier parse(HttpServletRequest request) throws ResourceParseException;
}