/**
* Handle POST requests.
*/
public function postAction()
{
$bootstrap = Zend_Registry::get('bootstrap');
// To avoid race conditions when saving the file record, the default job
// dispatcher must be synchronous. Otherwise the data added by the api
// adapter may be overwritten by the asynchronous job process.
$defaultDispatcher = $bootstrap->config->jobs->dispatcher->default;
if ('Omeka_Job_Dispatcher_Adapter_Synchronous' != $defaultDispatcher) {
throw new Omeka_Controller_Exception_Api('Invalid request. The default job dispatcher must be synchronous.', 500);
}
// Check for valid file.
if (!isset($_FILES[self::FILE_NAME]['name']) || is_array($_FILES[self::FILE_NAME]['name'])) {
throw new Omeka_Controller_Exception_Api('Invalid request. Exactly one file must be uploaded per request.', 400);
}
// Check for valid JSON data.
if (!isset($_POST[self::DATA_NAME])) {
throw new Omeka_Controller_Exception_Api('Invalid request. Missing JSON data.', 400);
}
$data = json_decode($_POST[self::DATA_NAME]);
if (!$data instanceof stdClass) {
throw new Omeka_Controller_Exception_Api('Invalid request. Request body must be a JSON object.', 400);
}
$db = $bootstrap->getResource('Db');
// Check for valid item.
if (!isset($data->item->id) && !is_object($data->item->id)) {
throw new Omeka_Controller_Exception_Api('Invalid item. File must belong to an existing item.', 400);
}
$item = $db->getTable('Item')->find($data->item->id);
if (!$item) {
throw new Omeka_Controller_Exception_Api('Invalid item. File must belong to an existing item.', 400);
}
// The user must have permission to edit the owner item.
$this->_validateUser($item, 'edit');
$builder = new Builder_Item($db);
$builder->setRecord($item);
$files = $builder->addFiles('Upload', self::FILE_NAME);
$record = $this->_helper->db->getTable('File')->find($files[0]->id);
// Set the POST data to the record using the record adapter.
$this->_getRecordAdapter('File')->setPostData($record, $data);
if (!$record->save(false)) {
throw new Omeka_Controller_Exception_Api('Error when saving record.', 400, $record->getErrors()->get());
}
$data = $this->_getRepresentation($this->_getRecordAdapter('File'), $this->_helper->db->getTable('File')->find($record->id), 'files');
$this->getResponse()->setHttpResponseCode(201);
$this->getResponse()->setHeader('Location', $data['url']);
$this->_helper->jsonApi($data);
}
/**
* Add files to an item.
*
* @package Omeka\Function\Db\Item
* @uses Builder_Item::addFiles()
* @param Item|integer $item Item record or ID of item to add files to
* @param string|Omeka_File_Ingest_AbstractIngest $transferStrategy Strategy
* to use when ingesting the file. The strings 'Url', 'Filesystem' and 'Upload'
* correspond to those built-in strategies. Alternatively a strategy object
* can be passed.
* @param array $files Information about the file(s) to ingest. See addFiles()
* for details
* @param array $options Array of options to
* modify the behavior of the ingest. Available options include:
* - 'ignore_invalid_files': boolean, false by default. Whether or not to
* throw exceptions when a file is not valid.
* - 'ignoreNoFile': (for Upload only) boolean, false by default. Whether to
* ignore validation errors that occur when an uploaded file is missing, like
* when a file input is left empty on a form.
* @return array The added File records.
*/
function insert_files_for_item($item, $transferStrategy, $files, $options = array())
{
$builder = new Builder_Item(get_db());
$builder->setRecord($item);
return $builder->addFiles($transferStrategy, $files, $options);
}
