[Summary view]

Differences Between: [Versions 311 and 401]

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