org.glassfish.jersey.message.internal
Class MatchingEntityTag

java.lang.Object
  javax.ws.rs.core.EntityTag
      org.glassfish.jersey.message.internal.MatchingEntityTag

public class MatchingEntityTag
extends javax.ws.rs.core.EntityTag

A matching entity tag.

Note that this type and it's super type cannot be used to create request header values for If-Match and If-None-Match of the form If-Match: * or If-None-Match: * as * is not a valid entity tag.

Author:

Paul Sandoz, Marek Potociar (marek.potociar at oracle.com)

Field Summary

static Set<MatchingEntityTag>

ANY_MATCH An empty set that corresponds to If-Match: * or If-None-Match: *.

Constructor Summary

MatchingEntityTag(String value)
Create new strongly validating entity tag.

MatchingEntityTag(String value, boolean weak)
Create new matching entity tag.

Method Summary

static MatchingEntityTag

valueOf(HttpHeaderReader reader) Create new matching entity tag out of provided header reader.

Methods inherited from class javax.ws.rs.core.EntityTag

equals, getValue, hashCode, isWeak, toString, valueOf

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

ANY_MATCH

public static final Set<MatchingEntityTag> ANY_MATCH

An empty set that corresponds to If-Match: * or If-None-Match: *.

Constructor Detail

MatchingEntityTag

public MatchingEntityTag(String value)

Create new strongly validating entity tag.

Parameters:

value - ETag header value.

MatchingEntityTag

public MatchingEntityTag(String value,
                         boolean weak)

Create new matching entity tag.

Parameters:

value - ETag header value.

weak - should be set to false, if strong validation is required, otherwise should be set to true.

Method Detail

valueOf

public static MatchingEntityTag valueOf(HttpHeaderReader reader)
                                 throws ParseException

Create new matching entity tag out of provided header reader.

Parameters:

reader - HTTP header content reader.

Returns:

a new matching entity tag.

Throws:

ParseException - in case the header could not be parsed.