Difference between revisions of "API:EPrints/DataObj/UploadProgress"

From EPrints Documentation
Jump to: navigation, search
 
Line 75: Line 75:
  
 
The number of bytes of the file being uploaded that have already been received.
 
The number of bytes of the file being uploaded that have already been received.
 +
 +
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 +
<!-- Edit below this comment -->
 +
 +
 +
<!-- Pod2Wiki= -->
 +
</div>
 +
<!-- Pod2Wiki=head_references_and_related_objects -->
 +
==REFERENCES AND RELATED OBJECTS==
 +
None.
 +
 +
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 +
<!-- Edit below this comment -->
 +
 +
 +
<!-- Pod2Wiki= -->
 +
</div>
 +
<!-- Pod2Wiki=head_instance_variables -->
 +
==INSTANCE VARIABLES==
 +
See [[API:EPrints/DataObj#INSTANCE_VARIABLES|EPrints::DataObj]].
  
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>

Latest revision as of 18:47, 10 January 2022

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::DataObj::UploadProgress - uploads-in-progress state

User Comments


DESCRIPTION

This is an internal class, which inherits from EPrints::DataObj. It is just for managing the progress of files being uploaded to EPrints.

User Comments


CORE METADATA FIELDS

User Comments


progressid (text)

The unique identifier for an upload progress. This is a 32-character hexadecimal string.

User Comments


expires (int)

The time (in seconds since the start of the last epoch) when this upload progress will expire if it is not completed.

User Comments


size (bigint)

The total size in bytes of the file being uploaded.

User Comments


size (bigint)

The number of bytes of the file being uploaded that have already been received.

User Comments


REFERENCES AND RELATED OBJECTS

None.

User Comments


INSTANCE VARIABLES

See EPrints::DataObj.

User Comments


METHODS

User Comments


Constructor Methods

User Comments


new_from_request

$progress = EPrints::DataObj::UploadProgress->new_from_request( $session )

Creates and returns a new upload progress data object based on the current request.

Returns undef if no file upload is pointed to by this request.

User Comments


Class Methods

User Comments


get_system_field_info

$fields = EPrints::DataObj::UploadProgress->get_system_field_info

Returns an array describing the system metadata of the upload progress dataset.

User Comments


get_dataset_id

$dataset = EPrints::DataObj::UploadProgress->get_dataset_id

Returns the id of the EPrints::DataSet object to which this record belongs.

User Comments


remove_expired

$progress = EPrints::DataObj::UploadProgress->remove_expired( $session )

Remove all upload progress data objects where expired is earlier than the current time.

User Comments


get_defaults

$defaults = EPrints::DataObj::UploadProgress->get_defaults( $session, $data )

Returns default values for this object based on the starting $data.

Sets expires to one week from now.

User Comments


Object Methods

User Comments


update_cb

$progress->update_cb( $filename, $buffer, $bytes_read, $progress )

Updates callback for use with CGI. Limits database writes to a minimum of 1 second between updates of the received field to the value provided by $bytes_read.

User Comments


SEE ALSO

EPrints::DataObj and EPrints::DataSet.

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