[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 MongoDB\BSON\fromPHP;
  23  use function MongoDB\BSON\toJSON;
  24  use function sprintf;
  25  
  26  class FileNotFoundException extends RuntimeException
  27  {
  28      /**
  29       * Thrown when a file cannot be found by its filename and revision.
  30       *
  31       * @param string  $filename  Filename
  32       * @param integer $revision  Revision
  33       * @param string  $namespace Namespace for the files collection
  34       * @return self
  35       */
  36      public static function byFilenameAndRevision(string $filename, int $revision, string $namespace)
  37      {
  38          return new static(sprintf('File with name "%s" and revision "%d" not found in "%s"', $filename, $revision, $namespace));
  39      }
  40  
  41      /**
  42       * Thrown when a file cannot be found by its ID.
  43       *
  44       * @param mixed  $id        File ID
  45       * @param string $namespace Namespace for the files collection
  46       * @return self
  47       */
  48      public static function byId($id, string $namespace)
  49      {
  50          $json = toJSON(fromPHP(['_id' => $id]));
  51  
  52          return new static(sprintf('File "%s" not found in "%s"', $json, $namespace));
  53      }
  54  }