Package org.eclipse.jetty.util.ajax

Class AsyncJSON.Factory

  • Enclosing class:
    AsyncJSON
    public static class AsyncJSON.Factory
extends java.lang.Object

    The factory that creates AsyncJSON instances.

    The factory can be configured with custom JSON.Convertors, and with cached strings that will not be allocated if they can be looked up from the cache.

    • Constructor Detail

      • Factory

        public Factory()

    • Method Detail

      • getArrayConverter

        public java.util.function.Function<java.util.List<?>,​java.lang.Object> getArrayConverter()
        Returns:
        the function to customize the Java representation of JSON arrays
        See Also:
        setArrayConverter(Function)

      • setArrayConverter

        public void setArrayConverter​(java.util.function.Function<java.util.List<?>,​java.lang.Object> arrayConverter)

        Sets the function to convert JSON arrays from their default Java representation, a List<Object>, to another Java data structure such as an Object[].

        Parameters:
        arrayConverter - the function to customize the Java representation of JSON arrays
        See Also:
        getArrayConverter()

      • isDetailedParseException

        public boolean isDetailedParseException()
        Returns:
        whether a parse failure should report the whole JSON string or just the last chunk

      • setDetailedParseException

        public void setDetailedParseException​(boolean detailedParseException)
        Parameters:
        detailedParseException - whether a parse failure should report the whole JSON string or just the last chunk

      • cache

        public boolean cache​(java.lang.String value)
        Parameters:
        value - the string to cache
        Returns:
        whether the value can be cached

      • cached

        protected java.lang.String cached​(java.nio.ByteBuffer buffer)

        Attempts to return a cached string from the buffer bytes.

        In case of a cache hit, the string is returned and the buffer position updated.

        In case of cache miss, null is returned and the buffer position is left unaltered.

        Parameters:
        buffer - the buffer to lookup the string from
        Returns:
        a cached string or null

      • newAsyncJSON

        public AsyncJSON newAsyncJSON()
        Returns:
        a new parser instance

      • putConvertor

        public void putConvertor​(java.lang.String className,
                         JSON.Convertor convertor)

        Associates the given JSON.Convertor to the given class name.

        Parameters:
        className - the domain class name such as com.acme.Person
        convertor - the JSON.Convertor that converts Map to domain objects

      • removeConvertor

        public JSON.Convertor removeConvertor​(java.lang.String className)

        Removes the JSON.Convertor associated with the given class name.

        Parameters:
        className - the class name associated with the JSON.Convertor
        Returns:
        the JSON.Convertor associated with the class name, or null

      • getConvertor

        public JSON.Convertor getConvertor​(java.lang.String className)

        Returns the JSON.Convertor associated with the given class name, if any.

        Parameters:
        className - the class name associated with the JSON.Convertor
        Returns:
        the JSON.Convertor associated with the class name, or null