This file is indexed.

/usr/include/Wt/WFileResource is in libwt-dev 3.3.3+dfsg-4.1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
// This may look like C code, but it's really -*- C++ -*-
/*
 * Copyright (C) 2008 Emweb bvba, Kessel-Lo, Belgium.
 *
 * See the LICENSE file for terms of use.
 */
#ifndef WFILE_RESOURCE_H_
#define WFILE_RESOURCE_H_

#include <Wt/WStreamResource>

namespace Wt {

/*! \class WFileResource Wt/WFileResource Wt/WFileResource
 *  \brief A resource which streams the data from a local file.
 *
 * To update the resource, either use setFileName() to point it to a
 * new file, or emit the WResource::dataChanged() signal when only the
 * file contents has changed, but not the filename.
 *
 * The resource makes use of continuations to transmit data piecewise,
 * without blocking a thread or requiring the entire file to be read
 * in memory. The size of the buffer can be changed using
 * setBufferSize().
 *
 * \if cpp
 * Usage examples:
 * \code
 * Wt::WFileResource *csvFile = new Wt::WFileResource("text/csv", "/opt/files/afile.csv");
 * csvFile->suggestFileName("data.csv");
 * Wt::WAnchor *anchor = new Wt::WAnchor(csvFile, "CSV data");
 *
 * Wt::WFileResource *imageFile = new Wt::WFileResource("image/png", "/opt/files/image.png");
 * imageFile->suggestFileName("data.png");
 * Wt::WImage *image = new Wt::WImage(imageFile, "PNG version");
 * \endcode
 * \endif
 *
 * \sa WStreamResource, WMemoryResource
 */
class WT_API WFileResource : public WStreamResource
{
public:
  /*! \brief Default constructor.
   *
   * You need to set a file name (and mime type) for the resource
   * using setFileName() and setMimeType().
   */
  WFileResource(WObject *parent = 0);

  /*! \brief Creates a new resource for a file.
   *
   * The mime type defaults to "text/plain".
   */
  WFileResource(const std::string& fileName, WObject *parent = 0);

  /*! \brief Creates a new resource with given mime-type for a file.
   */
  WFileResource(const std::string& mimeType, const std::string& fileName,
		WObject *parent = 0);

  /*! \brief Destructor.
   *
   * It is up to the user to make sure that the resource is no longer
   * in use (by e.g. a WImage).
   */
  ~WFileResource();

  /*! \brief Sets a (different) filename.
   *
   * Set the location of the file on the local filesystem which must be
   * streamed for this resource.
   */
  void setFileName(const std::string& fileName);

  /*! \brief Returns the filename.
   */
  const std::string& fileName() const { return fileName_; }

  /*! \brief Handles a request.
   *
   * You may want to specialize this function to compute the file on the fly.
   * However, you need to take into account the fact that the WFileResource
   * implementation may use continuations to split the download in smaller
   * chunks. Your implementation should thus look like:
   *
   * \if cpp
   * \code
   * void handleRequest(const Http::Request& request,
   *                    Http::Response& response) {
   *   if (!request.continuation()) {
   *     ... prepare data
   *     setFileName(myTmpFile);
   *   }
   *
   *   WFileResource::handleRequest(request, response);
   * }
   * \endcode
   * \endif
   */
  virtual void handleRequest(const Http::Request& request,
			     Http::Response& response);

private:
  std::string fileName_;
};

}

#endif // WFILE_RESOURCE_H_