org.mycore.datamodel.metadata.MCRMetaIFS Maven / Gradle / Ivy
/*
* This file is part of *** M y C o R e ***
* See http://www.mycore.de/ for details.
*
* MyCoRe is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* MyCoRe 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with MyCoRe. If not, see .
*/
package org.mycore.datamodel.metadata;
import java.util.Objects;
import java.util.Optional;
import org.jdom2.Element;
import org.mycore.common.MCRException;
import com.google.gson.JsonObject;
/**
* This class implements all method for handling the IFS metadata. The
* MCRMetaIFS class present all informations to store and retrieve derivates to
* the IFS.
*
* <tag class="MCRMetaIFS" >
* <subtag sourcepath="..." maindoc="..." ifsid="..." />
* </tag>
*
* @author Jens Kupferschmidt
* @version $Revision$ $Date$
*/
public final class MCRMetaIFS extends MCRMetaDefault {
// MCRMetaIFS data
private String sourcePath;
private String maindoc;
/**
* This is the constructor.
* The language element was set to en . All other data was set to
* empty.
*/
public MCRMetaIFS() {
super();
sourcePath = "";
maindoc = "";
}
/**
* This is the constructor.
* The language element was set to en . The subtag element was set to
* the value of subtag. If the
* value of subtag is null or empty an exception was throwed.
* The type element was set empty.
* The sourcepath must be NOT null or empty.
* @param subtag the name of the subtag
* @param sourcePath the sourcepath attribute
* @exception MCRException if the subtag value, the set_classid value or
* the set_categid are null, empty, too long or not a MCRObjectID
*/
public MCRMetaIFS(String subtag, String sourcePath) throws MCRException {
super(subtag, null, null, 0);
setSourcePath(sourcePath);
maindoc = "";
}
/**
* The method return the derivate source path.
*
* @return the sourcepath
*/
public String getSourcePath() {
return sourcePath;
}
/**
* The method return the derivate main document name.
*
* @return the main document name.
*/
public String getMainDoc() {
return maindoc;
}
/**
* The method return the derivate IFS ID.
*
* @return the IFS ID.
* @deprecated will always return empty String
*/
@Deprecated
public String getIFSID() {
return "";
}
/**
* This method set the value of derivate source path.
*
* @param sourcePath
* the derivate source path
*/
public void setSourcePath(String sourcePath) {
this.sourcePath = sourcePath;
}
/**
* This method set the value of derivate main document.
*
* @param mainDoc
* the derivate main document name
*/
public void setMainDoc(String mainDoc) {
if (mainDoc == null) {
maindoc = "";
} else {
maindoc = mainDoc.startsWith("/") ? mainDoc.substring(1) : mainDoc;
}
}
/**
* This method set the value of derivate IFS ID.
*
* @param ifsId
* the derivate IFS ID
* @deprecated out of use
*/
@Deprecated
public void setIFSID(String ifsId) {
}
/**
* This method read the XML input stream part from a DOM part for the
* metadata of the document.
*
* @param element
* a relevant JDOM element for the metadata
* @exception MCRException
* if the set_sourcepath value is null or empty
*/
@Override
public void setFromDOM(Element element) throws MCRException {
super.setFromDOM(element);
setSourcePath(element.getAttributeValue("sourcepath"));
setMainDoc(element.getAttributeValue("maindoc"));
}
/**
* This method create a XML stream for all data in this class, defined by
* the MyCoRe XML MCRMetaIFS definition for the given subtag.
*
* @exception MCRException
* if the content of this class is not valid
* @return a JDOM Element with the XML MCRClassification part
*/
@Override
public Element createXML() throws MCRException {
Element elm = super.createXML();
if (sourcePath != null) {
elm.setAttribute("sourcepath", sourcePath);
}
elm.setAttribute("maindoc", maindoc);
return elm;
}
/**
* Creates the JSON representation. Extends the {@link MCRMetaDefault#createJSON()} method
* with the following data.
*
*
* {
* sourcepath: "...",
* maindoc: "image.tif",
* ifsid: "ve3s8a3j00xsfk8z"
* }
*
*
*/
@Override
public JsonObject createJSON() {
JsonObject obj = super.createJSON();
if (sourcePath != null) {
obj.addProperty("sourcepath", sourcePath);
}
obj.addProperty("maindoc", maindoc);
return obj;
}
/**
* Validates this MCRMetaIFS. This method throws an exception if:
*
* - the subtag is not null or empty
* - the lang value was supported
* - the inherited value is lower than zero
* - the trimmed sourcepath is null empty
*
*
* @throws MCRException the MCRMetaIFS is invalid
*/
public void validate() throws MCRException {
super.validate();
if (sourcePath == null) {
return;
}
sourcePath = Optional.of(sourcePath)
.map(String::trim)
.orElseThrow(() -> new MCRException(getSubTag() + ": sourcepath is empty"));
}
@Override
public MCRMetaIFS clone() {
MCRMetaIFS clone = (MCRMetaIFS) super.clone();
clone.maindoc = this.maindoc;
clone.sourcePath = this.sourcePath;
return clone;
}
@Override
public boolean equals(Object obj) {
if (!super.equals(obj)) {
return false;
}
final MCRMetaIFS other = (MCRMetaIFS) obj;
return Objects.equals(sourcePath, other.sourcePath) && Objects.equals(maindoc, other.maindoc);
}
}