javax.ws.rs.core

Class CacheControl

Inhoudsopgave

  • public class CacheControl
extends Object
    An abstraction for the value of a HTTP Cache-Control response header.
    Since:
    1.0
    Author:
    Paul Sandoz, Marc Hadley
    See Also:
    HTTP/1.1 section 14.9

    • Constructor Detail

      • CacheControl

        public CacheControl()
        Create a new instance of CacheControl. The new instance will have the following default settings:
        • private = false
        • noCache = false
        • noStore = false
        • noTransform = true
        • mustRevalidate = false
        • proxyRevalidate = false
        • An empty list of private fields
        • An empty list of no-cache fields
        • An empty map of cache extensions

    • Method Detail

      • valueOf

        public static CacheControl valueOf(String value)
        Creates a new instance of CacheControl by parsing the supplied string.
        Parameters:
        value - the cache control string
        Returns:
        the newly created CacheControl
        Throws:
        IllegalArgumentException - if the supplied string cannot be parsed or is null

      • isMustRevalidate

        public boolean isMustRevalidate()
        Corresponds to the must-revalidate cache control directive.
        Returns:
        true if the must-revalidate cache control directive will be included in the response, false otherwise.
        See Also:
        HTTP/1.1 section 14.9.4

      • setMustRevalidate

        public void setMustRevalidate(boolean mustRevalidate)
        Corresponds to the must-revalidate cache control directive.
        Parameters:
        mustRevalidate - true if the must-revalidate cache control directive should be included in the response, false otherwise.
        See Also:
        HTTP/1.1 section 14.9.4

      • isProxyRevalidate

        public boolean isProxyRevalidate()
        Corresponds to the proxy-revalidate cache control directive.
        Returns:
        true if the proxy-revalidate cache control directive will be included in the response, false otherwise.
        See Also:
        HTTP/1.1 section 14.9.4

      • setProxyRevalidate

        public void setProxyRevalidate(boolean proxyRevalidate)
        Corresponds to the must-revalidate cache control directive.
        Parameters:
        proxyRevalidate - true if the proxy-revalidate cache control directive should be included in the response, false otherwise.
        See Also:
        HTTP/1.1 section 14.9.4

      • getMaxAge

        public int getMaxAge()
        Corresponds to the max-age cache control directive.
        Returns:
        the value of the max-age cache control directive, -1 if the directive is disabled.
        See Also:
        HTTP/1.1 section 14.9.3

      • setMaxAge

        public void setMaxAge(int maxAge)
        Corresponds to the max-age cache control directive.
        Parameters:
        maxAge - the value of the max-age cache control directive, a value of -1 will disable the directive.
        See Also:
        HTTP/1.1 section 14.9.3

      • getSMaxAge

        public int getSMaxAge()
        Corresponds to the s-maxage cache control directive.
        Returns:
        the value of the s-maxage cache control directive, -1 if the directive is disabled.
        See Also:
        HTTP/1.1 section 14.9.3

      • setSMaxAge

        public void setSMaxAge(int sMaxAge)
        Corresponds to the s-maxage cache control directive.
        Parameters:
        sMaxAge - the value of the s-maxage cache control directive, a value of -1 will disable the directive.
        See Also:
        HTTP/1.1 section 14.9.3

      • getNoCacheFields

        public List<String> getNoCacheFields()
        Corresponds to the value of the no-cache cache control directive.
        Returns:
        a mutable list of field-names that will form the value of the no-cache cache control directive. An empty list results in a bare no-cache directive.
        See Also:
        isNoCache(), setNoCache(boolean), HTTP/1.1 section 14.9.1

      • setNoCache

        public void setNoCache(boolean noCache)
        Corresponds to the no-cache cache control directive.
        Parameters:
        noCache - true if the no-cache cache control directive should be included in the response, false otherwise.
        See Also:
        getNoCacheFields(), HTTP/1.1 section 14.9.1

      • isNoCache

        public boolean isNoCache()
        Corresponds to the no-cache cache control directive.
        Returns:
        true if the no-cache cache control directive will be included in the response, false otherwise.
        See Also:
        getNoCacheFields(), HTTP/1.1 section 14.9.1

      • isPrivate

        public boolean isPrivate()
        Corresponds to the private cache control directive.
        Returns:
        true if the private cache control directive will be included in the response, false otherwise.
        See Also:
        getPrivateFields(), HTTP/1.1 section 14.9.1

      • getPrivateFields

        public List<String> getPrivateFields()
        Corresponds to the value of the private cache control directive.
        Returns:
        a mutable list of field-names that will form the value of the private cache control directive. An empty list results in a bare no-cache directive.
        See Also:
        isPrivate(), setPrivate(boolean), HTTP/1.1 section 14.9.1

      • setPrivate

        public void setPrivate(boolean flag)
        Corresponds to the private cache control directive.
        Parameters:
        flag - true if the private cache control directive should be included in the response, false otherwise.
        See Also:
        getPrivateFields(), HTTP/1.1 section 14.9.1

      • isNoTransform

        public boolean isNoTransform()
        Corresponds to the no-transform cache control directive.
        Returns:
        true if the no-transform cache control directive will be included in the response, false otherwise.
        See Also:
        HTTP/1.1 section 14.9.5

      • setNoTransform

        public void setNoTransform(boolean noTransform)
        Corresponds to the no-transform cache control directive.
        Parameters:
        noTransform - true if the no-transform cache control directive should be included in the response, false otherwise.
        See Also:
        HTTP/1.1 section 14.9.5

      • isNoStore

        public boolean isNoStore()
        Corresponds to the no-store cache control directive.
        Returns:
        true if the no-store cache control directive will be included in the response, false otherwise.
        See Also:
        HTTP/1.1 section 14.9.2

      • setNoStore

        public void setNoStore(boolean noStore)
        Corresponds to the no-store cache control directive.
        Parameters:
        noStore - true if the no-store cache control directive should be included in the response, false otherwise.
        See Also:
        HTTP/1.1 section 14.9.2

      • getCacheExtension

        public Map<String,String> getCacheExtension()
        Corresponds to a set of extension cache control directives.
        Returns:
        a mutable map of cache control extension names and their values. If a key has a null value, it will appear as a bare directive. If a key has a value that contains no whitespace then the directive will appear as a simple name=value pair. If a key has a value that contains whitespace then the directive will appear as a quoted name="value" pair.
        See Also:
        HTTP/1.1 section 14.9.6

      • toString

        public String toString()
        Convert the cache control to a string suitable for use as the value of the corresponding HTTP header.
        Overrides:
        toString in class Object
        Returns:
        a stringified cache control

      • hashCode

        public int hashCode()
        Generate hash code from cache control properties.
        Overrides:
        hashCode in class Object
        Returns:
        the hashCode

      • equals

        public boolean equals(Object obj)
        Compares object argument to this cache control to see if they are the same considering all property values.
        Overrides:
        equals in class Object
        Parameters:
        obj - the object to compare to
        Returns:
        true if the two cache controls are the same, false otherwise.

Nederlandse vertaling

U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.

Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.

Bij voorbaat dank.

Document heeft de 11/06/2005 gemaakt, de laatste keer de 18/08/2025 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-javaee-rf-javax/ws/rs/core/cachecontrol.html

De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.

Referenties

  1. Bekijk - html-document Taal van het document:fr Manuel PHP : https://docs.oracle.com

Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur van deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.