API:EPrints/Apache/Storage

From EPrints Documentation
Jump to: navigation, search

EPrints 3 Reference: Directory Structure - Metadata Fields - Repository Configuration - XML Config Files - XML Export Format - EPrints data structure - Core API - Data Objects


API: Core API

Latest Source Code (3.4, 3.3) | Revision Log | Before editing this page please read Pod2Wiki


NAME

EPrints::Apache::Storage - deliver file objects via mod_perl.

User Comments


DESCRIPTION

This mod_perl handle supports the delivery of the content of EPrints::DataObj::File objects.

User Comments


Defined HTTP Headers

These headers will be set by this module, where possible.

User Comments


Content-Disposition

The string "inline; filename=FILENAME" where FILENAME is the filename value of the file object.

If the download CGI parameter is true disposition is changed from inline to attachment, which will present a download dialog box in sane browsers.

User Comments


Content-Length

The filesize value of the file object.

User Comments


Content-MD5

The MD5 of the file content in base-64 encoding if the hash value is set and hash_type is MD5.

User Comments


Content-Type

The mime_type value of the file object, or application/octet-stream if not set.

User Comments


ETag

The hash value of the file object, if set.

User Comments


Expires

The current time + 365 days, if the mtime value is set.

User Comments


Last-Modified

The mtime of the file object, if set.

User Comments


Accept-Ranges

Sets Accept-Ranges to bytes.

User Comments


Recognised HTTP Headers

The following headers are recognised by this module.

User Comments


If-Modified-Since

If greater than or equal to the mtime value of the file object returns 304 Not Modified.

User Comments


If-None-Match

If differs from the hash value of the file object returns 304 Not Modified.

User Comments


METHODS

User Comments


handler

$rc = EPrints::Apache::Storage::handler( $r )

Handler for serving document files and thumbnails.

User Comments


COPYRIGHT

© Copyright 2023 University of Southampton.

EPrints 3.4 is supplied by EPrints Services.

http://www.eprints.org/eprints-3.4/

LICENSE

This file is part of EPrints 3.4 http://www.eprints.org/.

EPrints 3.4 and this file are released under the terms of the GNU Lesser General Public License version 3 as published by the Free Software Foundation unless otherwise stated.

EPrints 3.4 is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with EPrints 3.4. If not, see http://www.gnu.org/licenses/.

User Comments