[Summary view]

Differences Between: [Versions 310 and 401] [Versions 311 and 401] [Versions 39 and 401] [Versions 400 and 401]

   1  <?php
   2  /*
   3   * Copyright 2016-present MongoDB, Inc.
   4   *
   5   * Licensed under the Apache License, Version 2.0 (the "License");
   6   * you may not use this file except in compliance with the License.
   7   * You may obtain a copy of the License at
   8   *
   9   *   https://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  
  18  namespace MongoDB\GridFS\Exception;
  19  
  20  use MongoDB\Exception\RuntimeException;
  21  
  22  use function sprintf;
  23  
  24  class CorruptFileException extends RuntimeException
  25  {
  26      /**
  27       * Thrown when a chunk doesn't contain valid data.
  28       */
  29      public static function invalidChunkData(int $chunkIndex): self
  30      {
  31          return new static(sprintf('Invalid data found for index "%d"', $chunkIndex));
  32      }
  33  
  34      /**
  35       * Thrown when a chunk is not found for an expected index.
  36       *
  37       * @param integer $expectedIndex Expected index number
  38       * @return self
  39       */
  40      public static function missingChunk(int $expectedIndex)
  41      {
  42          return new static(sprintf('Chunk not found for index "%d"', $expectedIndex));
  43      }
  44  
  45      /**
  46       * Thrown when a chunk has an unexpected index number.
  47       *
  48       * @param integer $index         Actual index number (i.e. "n" field)
  49       * @param integer $expectedIndex Expected index number
  50       * @return self
  51       */
  52      public static function unexpectedIndex(int $index, int $expectedIndex)
  53      {
  54          return new static(sprintf('Expected chunk to have index "%d" but found "%d"', $expectedIndex, $index));
  55      }
  56  
  57      /**
  58       * Thrown when a chunk has an unexpected data size.
  59       *
  60       * @param integer $size         Actual size (i.e. "data" field length)
  61       * @param integer $expectedSize Expected size
  62       * @return self
  63       */
  64      public static function unexpectedSize(int $size, int $expectedSize)
  65      {
  66          return new static(sprintf('Expected chunk to have size "%d" but found "%d"', $expectedSize, $size));
  67      }
  68  }