/**
* Initialize {@link FormEntryController} with {@link FormDef} from binary or from XML. If given
* an instance, it will be used to fill the {@link FormDef}.
*/
@Override
protected Integer doInBackground(Void... nothing) {
FormController formController = MjivitaPlus.getInstance().getFormController();
// validation failed, pass specific failure
int validateStatus = formController.validateAnswers(mMarkCompleted);
if (validateStatus != FormEntryController.ANSWER_OK) {
return validateStatus;
}
if (mMarkCompleted) {
formController.postProcessInstance();
}
MjivitaPlus.getInstance()
.getActivityLogger()
.logInstanceAction(this, "save", Boolean.toString(mMarkCompleted));
boolean saveOutcome = exportData(mMarkCompleted);
// attempt to remove any scratch file
File shadowInstance = savepointFile(formController.getInstancePath());
if (shadowInstance.exists()) {
shadowInstance.delete();
}
if (saveOutcome) {
return mSave ? SAVED_AND_EXIT : SAVED;
}
return SAVE_ERROR;
}
/**
* Blocking write of the instance data to a temp file. Used to safeguard data during intent
* launches for, e.g., taking photos.
*
* @param tempPath
* @return
*/
public static String blockingExportTempData() {
FormController formController = MjivitaPlus.getInstance().getFormController();
long start = System.currentTimeMillis();
File temp = savepointFile(formController.getInstancePath());
ByteArrayPayload payload;
try {
payload = formController.getFilledInFormXml();
// write out xml
if (exportXmlFile(payload, temp.getAbsolutePath())) {
return temp.getAbsolutePath();
}
return null;
} catch (IOException e) {
Log.e(t, "Error creating serialized payload");
e.printStackTrace();
return null;
} finally {
long end = System.currentTimeMillis();
Log.i(t, "Savepoint ms: " + Long.toString(end - start));
}
}
/**
* Write's the data to the sdcard, and updates the instances content provider. In theory we don't
* have to write to disk, and this is where you'd add other methods.
*
* @param markCompleted
* @return
*/
private boolean exportData(boolean markCompleted) {
FormController formController = MjivitaPlus.getInstance().getFormController();
ByteArrayPayload payload;
try {
payload = formController.getFilledInFormXml();
// write out xml
String instancePath = formController.getInstancePath().getAbsolutePath();
exportXmlFile(payload, instancePath);
} catch (IOException e) {
Log.e(t, "Error creating serialized payload");
e.printStackTrace();
return false;
}
// update the mUri. We have exported the reloadable instance, so update status...
// Since we saved a reloadable instance, it is flagged as re-openable so that if any error
// occurs during the packaging of the data for the server fails (e.g., encryption),
// we can still reopen the filled-out form and re-save it at a later time.
updateInstanceDatabase(true, true);
if (markCompleted) {
// now see if the packaging of the data for the server would make it
// non-reopenable (e.g., encryption or send an SMS or other fraction of the form).
boolean canEditAfterCompleted = formController.isSubmissionEntireForm();
boolean isEncrypted = false;
// build a submission.xml to hold the data being submitted
// and (if appropriate) encrypt the files on the side
// pay attention to the ref attribute of the submission profile...
try {
payload = formController.getSubmissionXml();
} catch (IOException e) {
Log.e(t, "Error creating serialized payload");
e.printStackTrace();
return false;
}
File instanceXml = formController.getInstancePath();
File submissionXml = new File(instanceXml.getParentFile(), "submission.xml");
// write out submission.xml -- the data to actually submit to aggregate
exportXmlFile(payload, submissionXml.getAbsolutePath());
// see if the form is encrypted and we can encrypt it...
EncryptedFormInformation formInfo =
EncryptionUtils.getEncryptedFormInformation(mUri, formController.getSubmissionMetadata());
if (formInfo != null) {
// if we are encrypting, the form cannot be reopened afterward
canEditAfterCompleted = false;
// and encrypt the submission (this is a one-way operation)...
if (!EncryptionUtils.generateEncryptedSubmission(instanceXml, submissionXml, formInfo)) {
return false;
}
isEncrypted = true;
}
// At this point, we have:
// 1. the saved original instanceXml,
// 2. all the plaintext attachments
// 2. the submission.xml that is the completed xml (whether encrypting or not)
// 3. all the encrypted attachments if encrypting (isEncrypted = true).
//
// NEXT:
// 1. Update the instance database (with status complete).
// 2. Overwrite the instanceXml with the submission.xml
// and remove the plaintext attachments if encrypting
updateInstanceDatabase(false, canEditAfterCompleted);
if (!canEditAfterCompleted) {
// AT THIS POINT, there is no going back. We are committed
// to returning "success" (true) whether or not we can
// rename "submission.xml" to instanceXml and whether or
// not we can delete the plaintext media files.
//
// Handle the fall-out for a failed "submission.xml" rename
// in the InstanceUploader task. Leftover plaintext media
// files are handled during form deletion.
// delete the restore Xml file.
if (!instanceXml.delete()) {
Log.e(
t,
"Error deleting "
+ instanceXml.getAbsolutePath()
+ " prior to renaming submission.xml");
return true;
}
// rename the submission.xml to be the instanceXml
if (!submissionXml.renameTo(instanceXml)) {
Log.e(t, "Error renaming submission.xml to " + instanceXml.getAbsolutePath());
return true;
}
} else {
// try to delete the submissionXml file, since it is
// identical to the existing instanceXml file
// (we don't need to delete and rename anything).
if (!submissionXml.delete()) {
Log.w(
t,
"Error deleting " + submissionXml.getAbsolutePath() + " (instance is re-openable)");
}
}
// if encrypted, delete all plaintext files
// (anything not named instanceXml or anything not ending in .enc)
if (isEncrypted) {
if (!EncryptionUtils.deletePlaintextFiles(instanceXml)) {
Log.e(t, "Error deleting plaintext files for " + instanceXml.getAbsolutePath());
}
}
}
return true;
}
private void updateInstanceDatabase(boolean incomplete, boolean canEditAfterCompleted) {
FormController formController = MjivitaPlus.getInstance().getFormController();
// Update the instance database...
ContentValues values = new ContentValues();
if (mInstanceName != null) {
values.put(InstanceColumns.DISPLAY_NAME, mInstanceName);
}
if (incomplete || !mMarkCompleted) {
values.put(InstanceColumns.STATUS, InstanceProviderAPI.STATUS_INCOMPLETE);
} else {
values.put(InstanceColumns.STATUS, InstanceProviderAPI.STATUS_COMPLETE);
}
// update this whether or not the status is complete...
values.put(InstanceColumns.CAN_EDIT_WHEN_COMPLETE, Boolean.toString(canEditAfterCompleted));
// If FormEntryActivity was started with an Instance, just update that instance
if (MjivitaPlus.getInstance().getContentResolver().getType(mUri)
== InstanceColumns.CONTENT_ITEM_TYPE) {
int updated = MjivitaPlus.getInstance().getContentResolver().update(mUri, values, null, null);
if (updated > 1) {
Log.w(t, "Updated more than one entry, that's not good: " + mUri.toString());
} else if (updated == 1) {
Log.i(t, "Instance successfully updated");
} else {
Log.e(t, "Instance doesn't exist but we have its Uri!! " + mUri.toString());
}
} else if (MjivitaPlus.getInstance().getContentResolver().getType(mUri)
== FormsColumns.CONTENT_ITEM_TYPE) {
// If FormEntryActivity was started with a form, then it's likely the first time we're
// saving.
// However, it could be a not-first time saving if the user has been using the manual
// 'save data' option from the menu. So try to update first, then make a new one if that
// fails.
String instancePath = formController.getInstancePath().getAbsolutePath();
String where = InstanceColumns.INSTANCE_FILE_PATH + "=?";
String[] whereArgs = {instancePath};
int updated =
MjivitaPlus.getInstance()
.getContentResolver()
.update(InstanceColumns.CONTENT_URI, values, where, whereArgs);
if (updated > 1) {
Log.w(t, "Updated more than one entry, that's not good: " + instancePath);
} else if (updated == 1) {
Log.i(t, "Instance found and successfully updated: " + instancePath);
// already existed and updated just fine
} else {
Log.i(t, "No instance found, creating");
// Entry didn't exist, so create it.
Cursor c = null;
try {
// retrieve the form definition...
c = MjivitaPlus.getInstance().getContentResolver().query(mUri, null, null, null, null);
c.moveToFirst();
String jrformid = c.getString(c.getColumnIndex(FormsColumns.JR_FORM_ID));
String jrversion = c.getString(c.getColumnIndex(FormsColumns.JR_VERSION));
String formname = c.getString(c.getColumnIndex(FormsColumns.DISPLAY_NAME));
String submissionUri = null;
if (!c.isNull(c.getColumnIndex(FormsColumns.SUBMISSION_URI))) {
submissionUri = c.getString(c.getColumnIndex(FormsColumns.SUBMISSION_URI));
}
// add missing fields into values
values.put(InstanceColumns.INSTANCE_FILE_PATH, instancePath);
values.put(InstanceColumns.SUBMISSION_URI, submissionUri);
if (mInstanceName != null) {
values.put(InstanceColumns.DISPLAY_NAME, mInstanceName);
} else {
values.put(InstanceColumns.DISPLAY_NAME, formname);
}
values.put(InstanceColumns.JR_FORM_ID, jrformid);
values.put(InstanceColumns.JR_VERSION, jrversion);
// also add schedule Id
DatabaseHelper dh = new DatabaseHelper(MjivitaPlus.getAppContext());
String scheduleId = dh.getIntoFromXmlFormInfo(DatabaseHelper.FORM_INFO_SCHEDULE_ID);
/* values.put(DatabaseHelper.FORM_INFO_SCHEDULE_ID, scheduleId);
Log.d("SaveToDiskTask", "scheduleId = " + scheduleId);
*/ } finally {
if (c != null) {
c.close();
}
}
mUri =
MjivitaPlus.getInstance()
.getContentResolver()
.insert(InstanceColumns.CONTENT_URI, values);
}
}
}