Class BodyHandler

  • All Implemented Interfaces:
    Handler<RoutingContext>

    public class BodyHandler
    extends Object
    implements Handler<RoutingContext>
    A handler which gathers the entire request body and sets it on the .

    It also handles HTTP file uploads and can be used to limit body sizes.

    NOTE: This class has been automatically generated from the original non RX-ified interface using Vert.x codegen.

    • Field Detail

      • __TYPE_ARG

        public static final io.vertx.lang.rx.TypeArg<BodyHandler> __TYPE_ARG
      • DEFAULT_BODY_LIMIT

        public static final long DEFAULT_BODY_LIMIT
        Default max size for a request body in bytes = 10485760, i.e. 10 megabytes
        See Also:
        Constant Field Values
      • DEFAULT_UPLOADS_DIRECTORY

        public static final String DEFAULT_UPLOADS_DIRECTORY
        Default uploads directory on server for file uploads
        See Also:
        Constant Field Values
      • DEFAULT_MERGE_FORM_ATTRIBUTES

        public static final boolean DEFAULT_MERGE_FORM_ATTRIBUTES
        Default value of whether form attributes should be merged into request params
        See Also:
        Constant Field Values
      • DEFAULT_DELETE_UPLOADED_FILES_ON_END

        public static final boolean DEFAULT_DELETE_UPLOADED_FILES_ON_END
        Default value of whether uploaded files should be removed after handling the request
        See Also:
        Constant Field Values
      • DEFAULT_PREALLOCATE_BODY_BUFFER

        public static final boolean DEFAULT_PREALLOCATE_BODY_BUFFER
        Default value of whether to pre-allocate the body buffer size according to the content-length HTTP request header
        See Also:
        Constant Field Values
    • Constructor Detail

      • BodyHandler

        public BodyHandler​(BodyHandler delegate)
      • BodyHandler

        public BodyHandler​(Object delegate)
    • Method Detail

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class Object
      • create

        public static BodyHandler create()
        Create a body handler with defaults.
        Returns:
        the body handler
      • create

        public static BodyHandler create​(boolean handleFileUploads)
        Create a body handler setting if it should handle file uploads.
        Parameters:
        handleFileUploads - true if files upload should be handled
        Returns:
        the body handler
      • create

        public static BodyHandler create​(String uploadDirectory)
        Create a body handler and use the given upload directory.
        Parameters:
        uploadDirectory - the uploads directory
        Returns:
        the body handler
      • setHandleFileUploads

        public BodyHandler setHandleFileUploads​(boolean handleFileUploads)
        Set whether file uploads will be handled.
        Parameters:
        handleFileUploads - true if they should be handled
        Returns:
        reference to this for fluency
      • setBodyLimit

        public BodyHandler setBodyLimit​(long bodyLimit)
        Set the maximum body size in bytes, -1 means no limit.
        Parameters:
        bodyLimit - the max size in bytes
        Returns:
        reference to this for fluency
      • setUploadsDirectory

        public BodyHandler setUploadsDirectory​(String uploadsDirectory)
        Set the uploads directory to use.
        Parameters:
        uploadsDirectory - the uploads directory
        Returns:
        reference to this for fluency
      • setMergeFormAttributes

        public BodyHandler setMergeFormAttributes​(boolean mergeFormAttributes)
        Set whether form attributes will be added to the request parameters.
        Parameters:
        mergeFormAttributes - true if they should be merged
        Returns:
        reference to this for fluency
      • setDeleteUploadedFilesOnEnd

        public BodyHandler setDeleteUploadedFilesOnEnd​(boolean deleteUploadedFilesOnEnd)
        Set whether uploaded files should be removed after handling the request.
        Parameters:
        deleteUploadedFilesOnEnd - true if uploaded files should be removed after handling the request
        Returns:
        reference to this for fluency
      • setPreallocateBodyBuffer

        public BodyHandler setPreallocateBodyBuffer​(boolean isPreallocateBodyBuffer)
        Pre-allocate the body buffer according to the value parsed from content-length header. The buffer is capped at 64KB
        Parameters:
        isPreallocateBodyBuffer - true if body buffer is pre-allocated according to the size read from content-length Header. {code false} if body buffer is pre-allocated to 1KB, and is resized dynamically
        Returns:
        reference to this for fluency