FileUploadSizeException.java

  1. /*
  2.  * Licensed to the Apache Software Foundation (ASF) under one or more
  3.  * contributor license agreements.  See the NOTICE file distributed with
  4.  * this work for additional information regarding copyright ownership.
  5.  * The ASF licenses this file to You under the Apache License, Version 2.0
  6.  * (the "License"); you may not use this file except in compliance with
  7.  * the License.  You may obtain a copy of the License at
  8.  *
  9.  *      http://www.apache.org/licenses/LICENSE-2.0
  10.  *
  11.  * Unless required by applicable law or agreed to in writing, software
  12.  * distributed under the License is distributed on an "AS IS" BASIS,
  13.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14.  * See the License for the specific language governing permissions and
  15.  * limitations under the License.
  16.  */
  17. package org.apache.commons.fileupload2.core;

  18. /**
  19.  * Signals that a requests permitted size is exceeded.
  20.  */
  21. public class FileUploadSizeException extends FileUploadException {

  22.     /**
  23.      * Serial version UID, being used, if serialized.
  24.      */
  25.     private static final long serialVersionUID = 2;

  26.     /**
  27.      * The actual size of the request.
  28.      */
  29.     private final long actual;

  30.     /**
  31.      * The maximum permitted size of the request.
  32.      */
  33.     private final long permitted;

  34.     /**
  35.      * Constructs an instance.
  36.      *
  37.      * @param message   The detail message (which is saved for later retrieval by the {@link #getMessage()} method)
  38.      * @param permitted The requests size limit.
  39.      * @param actual    The actual values for the request.
  40.      */
  41.     public FileUploadSizeException(final String message, final long permitted, final long actual) {
  42.         super(message);
  43.         this.permitted = permitted;
  44.         this.actual = actual;
  45.     }

  46.     /**
  47.      * Gets the actual size of the request.
  48.      *
  49.      * @return The actual size of the request.
  50.      */
  51.     public long getActualSize() {
  52.         return actual;
  53.     }

  54.     /**
  55.      * Gets the limit size of the request.
  56.      *
  57.      * @return The limit size of the request.
  58.      */
  59.     public long getPermitted() {
  60.         return permitted;
  61.     }

  62. }