Field Detail

• TITLE

  public static final java.lang.String TITLE

  Title link param from RFC 5988.

  See Also:

  Constant Field Values

• REL

  public static final java.lang.String REL

  Rel link param from RFC 5988.

  See Also:

  Constant Field Values

• TYPE

  public static final java.lang.String TYPE

  Type link param from RFC 5988.

  See Also:

  Constant Field Values

Constructor Detail

• Link

  public Link()

Method Detail

• getUri

  public abstract java.net.URI getUri()

  Returns the underlying URI associated with this link.

  Returns:

  underlying URI.

• getUriBuilder

  public abstract UriBuilder getUriBuilder()

  Convenience method that returns a UriBuilder initialized with this link's underlying URI.

  Returns:

  UriBuilder initialized using underlying URI.

• getRel

  public abstract java.lang.String getRel()

  Returns the value associated with the link rel param, or null if this param is not specified.

  Returns:

  relation types as string or null.

• getRels

  public abstract java.util.List<java.lang.String> getRels()

  Returns the value associated with the link rel param as a list of strings or the empty list if rel is not defined.

  Returns:

  relation types as list of strings or empty list.

• getTitle

  public abstract java.lang.String getTitle()

  Returns the value associated with the link title param, or null if this param is not specified.

  Returns:

  value of title parameter or null.

• getType

  public abstract java.lang.String getType()

  Returns the value associated with the link type param, or null if this param is not specified.

  Returns:

  value of type parameter or null.

• getParams

  public abstract java.util.Map<java.lang.String,java.lang.String> getParams()

  Returns an immutable map that includes all the link parameters defined on this link. If defined, this map will include entries for rel, title and type.

  Returns:

  immutable map of link parameters.

• toString

  public abstract java.lang.String toString()

  Returns a string representation as a link header (RFC 5988). All link params are serialized as link-param="value" where value is a quoted-string. For example, <http://foo.bar/employee/john>; title="employee"; rel="manager friend"

  Overrides:

  toString in class java.lang.Object

  Returns:

  string link header representation for this link.

• valueOf

  public static Link valueOf(java.lang.String value)

  Simple parser to convert link header string representations into a link.

   link ::= '<' uri 'gt;' (';' link-param)*
   link-param ::= name '=' quoted-string
   

  See RFC 5988 for more information.

  Parameters:

  value - String representation.

  Returns:

  newly parsed link.

  Throws:

  java.lang.IllegalArgumentException - if a syntax error is found.

  See Also:

  Link.Builder.link(java.lang.String)

• fromUri

  public static Link.Builder fromUri(java.net.URI uri)

  Create a new builder instance initialized from an existing URI.

  Parameters:

  uri - a URI that will be used to initialize the builder.

  Returns:

  a new builder.

  Throws:

  java.lang.IllegalArgumentException - if uri is null.

• fromUri

  public static Link.Builder fromUri(java.lang.String uri)

  Create a new builder instance initialized from an existing URI represented as a string.

  Parameters:

  uri - a URI that will be used to initialize the builder.

  Returns:

  a new builder.

  Throws:

  java.lang.IllegalArgumentException - if uri is null.

• fromUriBuilder

  public static Link.Builder fromUriBuilder(UriBuilder uriBuilder)

  Create a new builder instance initialized from a URI builder.

  Parameters:

  uriBuilder - instance of URI builder.

  Returns:

  a new builder.

• fromLink

  public static Link.Builder fromLink(Link link)

  Create a new builder instance initialized from another link.

  Parameters:

  link - other link used for initialization.

  Returns:

  a new builder.

• fromPath

  public static Link.Builder fromPath(java.lang.String path)

  Convenience method to build a link from a path. Equivalent to fromUriBuilder(UriBuilder.fromPath(path)).

  Parameters:

  path - a URI path that will be used to initialize the Link, may contain URI template parameters.

  Returns:

  a new Link.Builder.

  Throws:

  java.lang.IllegalArgumentException - if path is null.

• fromResource

  public static Link.Builder fromResource(java.lang.Class<?> resource)

  Convenience method to build a link from a resource. Equivalent to Link.fromUriBuilder({@link UriBuilder#fromResource UriBuilder.fromResource(resource)}). Note that the link URI passed to the Link.Builder instance returned by this method is relative. Should the link be built as absolute, a base URI has to be specified in the builder prior to building the new link instance. For example, on a server side a UriInfo.getBaseUri() may be typically used to define the base URI of a link created using this method.

  Parameters:

  resource - a root resource whose Path value will be used to initialize the builder.

  Returns:

  a new link builder instance.

  Throws:

  java.lang.IllegalArgumentException - if resource is not annotated with Path or resource is null.

  See Also:

  UriInfo.getBaseUri()

• fromMethod

  public static Link.Builder fromMethod(java.lang.Class<?> resource,
                                        java.lang.String method)

  Convenience method to build a link from a resource. Equivalent to Link.fromUriBuilder({@link UriBuilder#fromMethod(Class, String) UriBuilder.fromMethod(resource, method)}). Note that the link URI passed to the Link.Builder instance returned by this method is relative. Should the link be built as absolute, a base URI has to be specified in the builder prior to building the new link instance. For example, on a server side a UriInfo.getBaseUri() may be typically used to define the base URI of a link created using this method.

  Parameters:

  resource - the resource containing the method.

  method - the name of the method whose Path value will be used to obtain the path to append.

  Returns:

  the updated Link.Builder.

  Throws:

  java.lang.IllegalArgumentException - if resource or method is null, or there is more than or less than one variant of the method annotated with Path.

  See Also:

  UriInfo.getBaseUri()