/*****************************************************************************
*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*
****************************************************************************/
package org.apache.padaf.preflight.helpers;
import java.awt.color.ICC_Profile;
import java.io.IOException;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import org.apache.padaf.preflight.DocumentHandler;
import org.apache.padaf.preflight.ValidationException;
import org.apache.padaf.preflight.ValidatorConfig;
import org.apache.padaf.preflight.ValidationResult.ValidationError;
import org.apache.padaf.preflight.actions.AbstractActionManager;
import org.apache.padaf.preflight.graphics.ICCProfileWrapper;
import org.apache.padaf.preflight.utils.COSUtils;
import org.apache.pdfbox.cos.COSArray;
import org.apache.pdfbox.cos.COSBase;
import org.apache.pdfbox.cos.COSDictionary;
import org.apache.pdfbox.cos.COSDocument;
import org.apache.pdfbox.cos.COSName;
import org.apache.pdfbox.cos.COSObject;
import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDDocumentCatalog;
import org.apache.pdfbox.pdmodel.PDDocumentNameDictionary;
import org.apache.pdfbox.pdmodel.PDEmbeddedFilesNameTreeNode;
import org.apache.pdfbox.pdmodel.common.PDStream;
import org.apache.pdfbox.persistence.util.COSObjectKey;
import org.apache.pdfbox.util.StringUtil;
/**
* This helper validates the PDF file catalog
*/
public class CatalogValidationHelper extends AbstractValidationHelper {
protected List<String> listICC = new ArrayList<String>();
public CatalogValidationHelper(ValidatorConfig cfg)
throws ValidationException {
super(cfg);
listICC.add(ICC_Characterization_Data_Registry_FOGRA43);
listICC.add(ICC_Characterization_Data_Registry_CGATS_TR_006);
listICC.add(ICC_Characterization_Data_Registry_CGATS_TR006);
listICC.add(ICC_Characterization_Data_Registry_FOGRA39);
listICC.add(ICC_Characterization_Data_Registry_JC200103);
listICC.add(ICC_Characterization_Data_Registry_FOGRA27);
listICC.add(ICC_Characterization_Data_Registry_EUROSB104);
listICC.add(ICC_Characterization_Data_Registry_FOGRA45);
listICC.add(ICC_Characterization_Data_Registry_FOGRA46);
listICC.add(ICC_Characterization_Data_Registry_FOGRA41);
listICC.add(ICC_Characterization_Data_Registry_CGATS_TR_001);
listICC.add(ICC_Characterization_Data_Registry_CGATS_TR_003);
listICC.add(ICC_Characterization_Data_Registry_CGATS_TR_005);
listICC.add(ICC_Characterization_Data_Registry_CGATS_TR001);
listICC.add(ICC_Characterization_Data_Registry_CGATS_TR003);
listICC.add(ICC_Characterization_Data_Registry_CGATS_TR005);
listICC.add(ICC_Characterization_Data_Registry_FOGRA28);
listICC.add(ICC_Characterization_Data_Registry_JCW2003);
listICC.add(ICC_Characterization_Data_Registry_EUROSB204);
listICC.add(ICC_Characterization_Data_Registry_FOGRA47);
listICC.add(ICC_Characterization_Data_Registry_FOGRA44);
listICC.add(ICC_Characterization_Data_Registry_FOGRA29);
listICC.add(ICC_Characterization_Data_Registry_JC200104);
listICC.add(ICC_Characterization_Data_Registry_FOGRA40);
listICC.add(ICC_Characterization_Data_Registry_FOGRA30);
listICC.add(ICC_Characterization_Data_Registry_FOGRA42);
listICC.add(ICC_Characterization_Data_Registry_IFRA26);
listICC.add(ICC_Characterization_Data_Registry_JCN2002);
listICC.add(ICC_Characterization_Data_Registry_CGATS_TR_002);
listICC.add(ICC_Characterization_Data_Registry_CGATS_TR002);
listICC.add(ICC_Characterization_Data_Registry_FOGRA33);
listICC.add(ICC_Characterization_Data_Registry_FOGRA37);
listICC.add(ICC_Characterization_Data_Registry_FOGRA31);
listICC.add(ICC_Characterization_Data_Registry_FOGRA35);
listICC.add(ICC_Characterization_Data_Registry_FOGRA32);
listICC.add(ICC_Characterization_Data_Registry_FOGRA34);
listICC.add(ICC_Characterization_Data_Registry_FOGRA36);
listICC.add(ICC_Characterization_Data_Registry_FOGRA38);
listICC.add(ICC_Characterization_Data_Registry_sRGB);
listICC.add(ICC_Characterization_Data_Registry_sRGB_IEC);
listICC.add(ICC_Characterization_Data_Registry_Adobe);
listICC.add(ICC_Characterization_Data_Registry_bg_sRGB);
listICC.add(ICC_Characterization_Data_Registry_sYCC);
listICC.add(ICC_Characterization_Data_Registry_scRGB);
listICC.add(ICC_Characterization_Data_Registry_scRGB_nl);
listICC.add(ICC_Characterization_Data_Registry_scYCC_nl);
listICC.add(ICC_Characterization_Data_Registry_ROMM);
listICC.add(ICC_Characterization_Data_Registry_RIMM);
listICC.add(ICC_Characterization_Data_Registry_ERIMM);
listICC.add(ICC_Characterization_Data_Registry_eciRGB);
listICC.add(ICC_Characterization_Data_Registry_opRGB);
}
protected boolean isStandardICCCharacterization(String name) {
for (String iccStandard : listICC) {
if (iccStandard.contains(name)) { // TODO check with an equal instead of contains?
return true;
}
}
return false;
}
/*
* (non-Javadoc)
*
* @see
* net.awl.edoc.pdfa.validation.helpers.AbstractValidationHelper#innerValidate
* (net.awl.edoc.pdfa.validation.DocumentHandler)
*/
@Override
public List<ValidationError> innerValidate(DocumentHandler handler)
throws ValidationException {
List<ValidationError> result = new ArrayList<ValidationError>(0);
PDDocument pdfbox = handler.getDocument();
PDDocumentCatalog catalog = pdfbox.getDocumentCatalog();
if (catalog != null) {
validateActions(handler, catalog, result);
validateLang(handler, catalog, result);
validateNames(handler, catalog, result);
validateOCProperties(handler, catalog, result);
} else {
throw new ValidationException(
"There are no Catalog entry in the Document.");
}
// ---- Check OutputIntent to know the ICC Profile
result.addAll(validateOutputIntent(handler));
return result;
}
/**
* This method validates if OpenAction entry contains forbidden action type.
* It checks too if an Additional Action is present.
*
* @param handler
* @param catalog
* @param result
* @throws ValidationException
*/
protected void validateActions(DocumentHandler handler,
PDDocumentCatalog catalog, List<ValidationError> result)
throws ValidationException {
// ---- get OpenAction and Additional Action if these entries are present
List<AbstractActionManager> lActions = this.actionFact.getActions(catalog
.getCOSDictionary(), handler.getDocument().getDocument());
for (AbstractActionManager action : lActions) {
if (!action.valid(result)) {
return;
}
}
}
/**
* The Lang element is optional but it is recommended. This method check the
* Syntax of the Lang if this entry is present.
*
* @param handler
* @param catalog
* @param result
* @throws ValidationException
*/
protected void validateLang(DocumentHandler handler,
PDDocumentCatalog catalog, List<ValidationError> result)
throws ValidationException {
String lang = catalog.getLanguage();
if (lang != null && !"".equals(lang) && !lang.matches("[A-Za-z]{1,8}(-[A-Za-z]{1,8})*")) {
result.add(new ValidationError(ERROR_SYNTAX_LANG_NOT_RFC1766));
}
}
/**
* A Catalog shall not contain the EmbeddedFiles entry.
*
* @param handler
* @param catalog
* @param result
* @throws ValidationException
*/
protected void validateNames(DocumentHandler handler,
PDDocumentCatalog catalog, List<ValidationError> result)
throws ValidationException {
PDDocumentNameDictionary names = catalog.getNames();
if (names != null) {
PDEmbeddedFilesNameTreeNode efs = names.getEmbeddedFiles();
if (efs != null) {
result.add(new ValidationError(
ERROR_SYNTAX_TRAILER_CATALOG_EMBEDDEDFILES,"EmbeddedFile entry is present in the Names dictionary"));
}
}
}
/**
* A Catalog shall not contain the OCPProperties (Optional Content Properties)
* entry.
*
* @param handler
* @param catalog
* @param result
* @throws ValidationException
*/
protected void validateOCProperties(DocumentHandler handler,
PDDocumentCatalog catalog, List<ValidationError> result)
throws ValidationException {
COSBase ocp = catalog.getCOSDictionary().getItem(
COSName.getPDFName(DOCUMENT_DICTIONARY_KEY_OPTIONAL_CONTENTS));
if (ocp != null) {
result
.add(new ValidationError(ERROR_SYNTAX_TRAILER_CATALOG_OCPROPERTIES, "A Catalog shall not contain the OCPProperties entry."));
}
}
/**
* This method checks the content of each OutputIntent. The S entry must
* contain GTS_PDFA1. The DestOuputProfile must contain a valid ICC Profile
* Stream.
*
* If there are more than one OutputIntent, they have to use the same ICC
* Profile.
*
* This method returns a list of ValidationError. It is empty if no errors
* have been found.
*
* @param handler
* @return
* @throws ValidationException
*/
public List<ValidationError> validateOutputIntent(DocumentHandler handler)
throws ValidationException {
List<ValidationError> result = new ArrayList<ValidationError>(0);
PDDocument pdDocument = handler.getDocument();
PDDocumentCatalog catalog = pdDocument.getDocumentCatalog();
COSDocument cDoc = pdDocument.getDocument();
COSBase cBase = catalog.getCOSDictionary().getItem(COSName.getPDFName(DOCUMENT_DICTIONARY_KEY_OUTPUT_INTENTS));
COSArray outputIntents = COSUtils.getAsArray(cBase, cDoc);
Map<COSObjectKey, Boolean> tmpDestOutputProfile = new HashMap<COSObjectKey, Boolean>();
for (int i = 0; outputIntents != null && i < outputIntents.size(); ++i) {
COSDictionary dictionary = COSUtils.getAsDictionary(outputIntents.get(i), cDoc);
if (dictionary == null) {
result.add(new ValidationError(
ERROR_GRAPHIC_OUTPUT_INTENT_INVALID_ENTRY,
"OutputIntent object is null or isn't a dictionary"));
} else {
// ---- S entry is mandatory and must be equals to GTS_PDFA1
String sValue = dictionary.getNameAsString(COSName.getPDFName(OUTPUT_INTENT_DICTIONARY_KEY_S));
if (!OUTPUT_INTENT_DICTIONARY_VALUE_GTS_PDFA1.equals(sValue)) {
result.add(new ValidationError(ERROR_GRAPHIC_OUTPUT_INTENT_S_VALUE_INVALID,
"The S entry of the OutputIntent isn't GTS_PDFA1"));
continue;
}
// ---- OutputConditionIdentifier is a mandatory field
String outputConditionIdentifier = dictionary
.getString(COSName.getPDFName(OUTPUT_INTENT_DICTIONARY_KEY_OUTPUT_CONDITION_IDENTIFIER));
if (outputConditionIdentifier == null) {// empty string is autorized (it may be an application specific value)
result.add(new ValidationError(ERROR_GRAPHIC_OUTPUT_INTENT_INVALID_ENTRY,
"The OutputIntentCondition is missing"));
continue;
}
// ---- If OutputConditionIdentifier is "Custom" or a non Standard ICC Characterization :
// ---- DestOutputProfile and Info are mandatory
// ---- DestOutputProfile must be a ICC Profile
// ---- Because of PDF/A conforming file needs to specify the color characteristics, the DestOutputProfile
// ---- is checked even if the OutputConditionIdentifier isn't "Custom"
COSBase dop = dictionary.getItem(COSName.getPDFName(OUTPUT_INTENT_DICTIONARY_KEY_DEST_OUTPUT_PROFILE));
ValidationError valer = validateICCProfile(dop, cDoc, tmpDestOutputProfile, handler);
if (valer != null) {
result.add(valer);
continue;
}
// TODO [LAZY] When Lazy mode will be added, this block should be uncommented to set result as warning.
// if (!isStandardICCCharacterization(outputConditionIdentifier)) {
// String info = dictionary.getString(COSName.getPDFName(OUTPUT_INTENT_DICTIONARY_KEY_INFO));
// if (info == null || "".equals(info)) {
// result.add(new ValidationError(ERROR_GRAPHIC_OUTPUT_INTENT_INVALID_ENTRY,
// "The Info entry of a OutputIntent dictionary is missing"));
// continue;
// }
// }
}
}
return result;
}
/**
* This method checks the destOutputProfile which must be a valid ICCProfile.
*
* If an other ICCProfile exists in the mapDestOutputProfile, a
* ValdiationError (ERROR_GRAPHIC_OUTPUT_INTENT_ICC_PROFILE_MULTIPLE) is
* returned because of only one profile is authorized. If the ICCProfile
* already exist in the mapDestOutputProfile, the method returns null. If the
* destOutputProfile contains an invalid ICCProfile, a ValidationError
* (ERROR_GRAPHIC_OUTPUT_INTENT_ICC_PROFILE_INVALID) is returned If the
* destOutputProfile is an empty stream, a
* ValidationError(ERROR_GRAPHIC_OUTPUT_INTENT_INVALID_ENTRY) is returned.
*
* If the destOutputFile is valid, mapDestOutputProfile is updated, the
* ICCProfile is added to the document handler and null is returned.
*
* @param destOutputProfile
* @param cDoc
* @param tmpDestOutputProfile
* @param handler
* @return
* @throws ValidationException
*/
protected ValidationError validateICCProfile(COSBase destOutputProfile,
COSDocument cDoc, Map<COSObjectKey, Boolean> mapDestOutputProfile,
DocumentHandler handler) throws ValidationException {
try {
if (destOutputProfile == null) {
// return new ValidationError(ERROR_GRAPHIC_OUTPUT_INTENT_INVALID_ENTRY, "OutputIntent object uses a NULL Object");
return null;
}
// ---- destOutputProfile should be an instance of COSObject because of
// this is a object reference
if (destOutputProfile instanceof COSObject) {
if (mapDestOutputProfile.containsKey(new COSObjectKey(
(COSObject) destOutputProfile))) {
// ---- the profile is already checked. continue
return null;
} else if (!mapDestOutputProfile.isEmpty()) {
// ---- A DestOutputProfile exits but it isn't the same, error
return new ValidationError(
ERROR_GRAPHIC_OUTPUT_INTENT_ICC_PROFILE_MULTIPLE, "More than one ICCProfile is defined");
}
// else the profile will be kept in the tmpDestOutputProfile if it is valid
}
PDStream stream = PDStream.createFromCOS(COSUtils.getAsStream(
destOutputProfile, cDoc));
if (stream == null) {
return new ValidationError(ERROR_GRAPHIC_OUTPUT_INTENT_INVALID_ENTRY,
"OutputIntent object uses a NULL Object");
}
ICC_Profile iccp = ICC_Profile.getInstance(stream.getByteArray());
// check the ICC Profile version (6.2.2)
if (iccp.getMajorVersion() == 2) {
if (iccp.getMinorVersion() > 0x40) {
// TODO on lazy mode this error should be a warning?
// in PDF 1.4, max version is 02h.40h (meaning V 3.5)
// see the ICCProfile specification (ICC.1:1998-09)page 13 - §6.1.3 :
// The current profile version number is "2.4.0" (encoded as 02400000h"
return new ValidationError(
ERROR_GRAPHIC_OUTPUT_INTENT_ICC_PROFILE_TOO_RECENT, "Invalid version of the ICCProfile");
} // else OK
} else if (iccp.getMajorVersion() > 2) {
// TODO on lazy mode this error should be a warning?
// in PDF 1.4, max version is 02h.40h (meaning V 3.5)
// see the ICCProfile specification (ICC.1:1998-09)page 13 - §6.1.3 :
// The current profile version number is "2.4.0" (encoded as 02400000h"
return new ValidationError(
ERROR_GRAPHIC_OUTPUT_INTENT_ICC_PROFILE_TOO_RECENT, "Invalid version of the ICCProfile");
} // else seems less than 2, so correct
if (handler.getIccProfileWrapper() == null) {
handler.setIccProfileWrapper(new ICCProfileWrapper(iccp));
}
// ---- keep reference to avoid multiple profile definition
mapDestOutputProfile.put(new COSObjectKey((COSObject) destOutputProfile),
true);
} catch (IllegalArgumentException e) {
// ---- this is not a ICC_Profile
return new ValidationError(
ERROR_GRAPHIC_OUTPUT_INTENT_ICC_PROFILE_INVALID, "DestOutputProfile isn't a ICCProfile");
} catch (IOException e) {
throw new ValidationException("Unable to parse the ICC Profile", e);
}
return null;
}
}