diff --git a/console/src/main/java/lcsb/mapviewer/run/ReactomeComparison.java b/console/src/main/java/lcsb/mapviewer/run/ReactomeComparison.java index c3d47ed67fbfe4f63e54a0664bb3284c0da8ef29..48ae8ea11c997118b0a19a59d57a93894fd682b6 100644 --- a/console/src/main/java/lcsb/mapviewer/run/ReactomeComparison.java +++ b/console/src/main/java/lcsb/mapviewer/run/ReactomeComparison.java @@ -241,10 +241,11 @@ public class ReactomeComparison { * * @param result * result to be printed - * @throws IOException * @throws AnnotatorException + * thrown when there is a problem accessing external annotation + * service */ - private void printResult(MatchResult result) throws IOException, AnnotatorException { + private void printResult(MatchResult result) throws AnnotatorException { String color = "#000000"; String status = ""; String error = ""; @@ -316,6 +317,9 @@ public class ReactomeComparison { * @throws IOException * thrown whene there are problems accessing reactome reaction * @throws ComparatorException + * thrown when there is a problem with comparison {@link Reaction} + * with Reactome object + * */ private MatchResult checkReaction(String id) throws IOException, ComparatorException { return checkReaction(model.getReactionByReactionId(id)); @@ -330,6 +334,8 @@ public class ReactomeComparison { * @throws IOException * thrown whene there are problems accessing reactome reaction * @throws ComparatorException + * thrown when there is a problem with comparison {@link Reaction} + * with Reactome object */ private MatchResult checkReaction(Reaction reaction) throws IOException, ComparatorException { String stableIdentifier = rcu.getReactomeIdentifierForReaction(reaction); diff --git a/console/src/main/java/lcsb/mapviewer/run/VibineSnippet.java b/console/src/main/java/lcsb/mapviewer/run/VibineSnippet.java index 04da1a646be703f3eee923b28fafaa2bb2f732ee..dd2aee96856c4f43a290997a283325e017ec5d61 100644 --- a/console/src/main/java/lcsb/mapviewer/run/VibineSnippet.java +++ b/console/src/main/java/lcsb/mapviewer/run/VibineSnippet.java @@ -96,7 +96,8 @@ public class VibineSnippet { logger.debug("Reaction with id: " + reactionId); logger.debug("Reaction has " + reaction.getReactionNodes().size() + " members."); for (ReactionNode node : reaction.getReactionNodes()) { - logger.debug(node.getClass().getSimpleName() + "; points to " + node.getElement().getClass().getSimpleName() + "[" + node.getElement().getElementId() + "]"); + logger.debug( + node.getClass().getSimpleName() + "; points to " + node.getElement().getClass().getSimpleName() + "[" + node.getElement().getElementId() + "]"); } logger.debug("-------------------------------"); } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/CellDesignerElementCollection.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/CellDesignerElementCollection.java index 4f9f4c5a47b62a17fc4fc2df12e8c66aa91f0e4f..b5c6af04154c775763ebbfdfede835fa08c11d0b 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/CellDesignerElementCollection.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/CellDesignerElementCollection.java @@ -5,40 +5,82 @@ import java.util.List; import java.util.Map; import lcsb.mapviewer.common.exception.InvalidArgumentException; -import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerCompartment; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement; import lcsb.mapviewer.model.map.species.Element; import lcsb.mapviewer.model.map.species.Species; +/** + * This ctructure containes informationa about {@link CellDesignerElement + * celldesigner elements} parsed from the file. The information about this + * elements is used in different places in the parsing process. + */ public class CellDesignerElementCollection { + /** + * Element by element identifier (it's cell deigner identifier). + */ private Map<String, CellDesignerElement<?>> elementById = new HashMap<>(); + /** + * Returns element by given identifier. + * + * @param speciesId + * element identifie r + * @return element by given identifier + * + * @param <T> + * type of returned object + */ @SuppressWarnings("unchecked") - public <T extends CellDesignerElement<?>> T getSpeciesBySpeciesId(String speciesId) { + public <T extends CellDesignerElement<?>> T getElementByElementId(String speciesId) { return (T) elementById.get(speciesId); } - public CellDesignerCompartment getCompartmentByCompartmentId(String compartmentId) { - return (CellDesignerCompartment) elementById.get(compartmentId); - } - - public String getElementId(Element alias) { + /** + * Returns element identifier that should be used for model element when + * creating cell designer xml file. + * + * @param modelElement + * model element for which we want to obtain identifier + * @return identifier of cell designer element that will be exported + */ + public String getElementId(Element modelElement) { // TODO // silly implementation for now (if CD won't crash than we can keep it) - return "s_id_" + alias.getElementId(); + return "s_id_" + modelElement.getElementId(); } + /** + * Adds cell designer structures. + * + * @param elements + * list of objects to add + */ public void addElements(List<? extends CellDesignerElement<?>> elements) { for (CellDesignerElement<?> element : elements) { addElement(element); } } + /** + * Adds cell designer object. + * + * @param element + * object to add + */ public void addElement(CellDesignerElement<?> element) { addElement(element, element.getElementId()); } + /** + * Adds celldesigner element with custom id (instead the one obtained from + * celldesigner structure). + * + * @param element + * element to be add + * @param id + * id that should be used for identifing element + */ private void addElement(CellDesignerElement<?> element, String id) { if (elementById.get(id) != null) { throw new InvalidArgumentException( @@ -47,9 +89,18 @@ public class CellDesignerElementCollection { elementById.put(id, element); } - public void addAlias(Species alias, CellDesignerElement<?> element) { - addElement(element, getElementId(alias)); - if (getSpeciesBySpeciesId(element.getElementId()) == null) { + /** + * Adds celldesigner structure in a way that it would be accessed via + * identifier for model structure. Method used only for unit test. + * + * @param modelElement + * model element that will create identifier + * @param element + * element to be added + */ + public void addModelElement(Species modelElement, CellDesignerElement<?> element) { + addElement(element, getElementId(modelElement)); + if (getElementByElementId(element.getElementId()) == null) { addElement(element); } } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/CellDesignerXmlParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/CellDesignerXmlParser.java index 1975e3d6dad8b9195f16f18baedde645818f3c99..45dfe52fb0bfb0aba3c7bc6fa5311a9f8b9b1762 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/CellDesignerXmlParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/CellDesignerXmlParser.java @@ -34,6 +34,7 @@ import lcsb.mapviewer.converter.model.celldesigner.reaction.UnknownReactionClass import lcsb.mapviewer.converter.model.celldesigner.species.InternalModelSpeciesData; import lcsb.mapviewer.converter.model.celldesigner.species.SpeciesCollectionXmlParser; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerCompartment; +import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerSpecies; import lcsb.mapviewer.model.graphics.PolylineData; import lcsb.mapviewer.model.map.InconsistentModelException; @@ -99,6 +100,9 @@ public class CellDesignerXmlParser extends XmlParser implements IConverter { */ private AliasCollectionXmlParser aliasCollectionParser; + /** + * Annotation parser. + */ private RestAnnotationParser rap = new RestAnnotationParser(); @Override @@ -348,6 +352,9 @@ public class CellDesignerXmlParser extends XmlParser implements IConverter { * @param modelData * object conmtaining infoirmation about species during CellDesigner * parsing + * @param elements + * collection of {@link CellDesignerElement cell designer elements} + * parsed from xml * @param annotationNode * xml node to parse * @throws InvalidXmlSchemaException @@ -603,6 +610,9 @@ public class CellDesignerXmlParser extends XmlParser implements IConverter { * * @param model * model to transform + * @param elements + * collection of {@link CellDesignerElement cell designer elements} + * parsed from xml * @return annotation xml string for the model */ private String annotationToXml(Model model, CellDesignerElementCollection elements) { diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/alias/AliasCollectionXmlParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/alias/AliasCollectionXmlParser.java index 3ced232187f410ba236fb3bda7aad6568b7d922e..b77092450215e249adde684c5fc4fdddca6d48e4 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/alias/AliasCollectionXmlParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/alias/AliasCollectionXmlParser.java @@ -12,6 +12,7 @@ import lcsb.mapviewer.common.XmlParser; import lcsb.mapviewer.common.exception.InvalidXmlSchemaException; import lcsb.mapviewer.converter.model.celldesigner.CellDesignerElementCollection; import lcsb.mapviewer.converter.model.celldesigner.annotation.RestAnnotationParser; +import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement; import lcsb.mapviewer.model.map.compartment.Compartment; import lcsb.mapviewer.model.map.compartment.PathwayCompartment; import lcsb.mapviewer.model.map.model.Model; @@ -49,6 +50,9 @@ public class AliasCollectionXmlParser extends XmlParser { */ private CompartmentAliasXmlParser compartmentAliasParser = null; + /** + * Annotation parser. + */ private RestAnnotationParser rap = new RestAnnotationParser(); /** @@ -59,6 +63,9 @@ public class AliasCollectionXmlParser extends XmlParser { * * @param model * map model for which parsing is performed + * @param elements + * collection of {@link CellDesignerElement cell designer elements} + * parsed from xml */ public AliasCollectionXmlParser(CellDesignerElementCollection elements, Model model) { speciesAliasParser = new SpeciesAliasXmlParser(elements, model); @@ -185,6 +192,12 @@ public class AliasCollectionXmlParser extends XmlParser { return result; } + /** + * Assing compartment parents for list of compartments. + * + * @param compartments + * compartments that are looking for parents + */ private void assignParents(List<Compartment> compartments) { Compartment nullParent = new Compartment("null"); nullParent.setWidth(Double.MAX_VALUE); diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/alias/CompartmentAliasXmlParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/alias/CompartmentAliasXmlParser.java index 54198db2f0808b363153e93cb18a173b794382ca..71c0aa5f0cadf4ba184ed3089c73b36e3c086cf1 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/alias/CompartmentAliasXmlParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/alias/CompartmentAliasXmlParser.java @@ -8,6 +8,7 @@ import lcsb.mapviewer.common.exception.InvalidXmlSchemaException; import lcsb.mapviewer.common.exception.NotImplementedException; import lcsb.mapviewer.converter.model.celldesigner.CellDesignerElementCollection; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerCompartment; +import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement; import lcsb.mapviewer.model.map.compartment.BottomSquareCompartment; import lcsb.mapviewer.model.map.compartment.Compartment; import lcsb.mapviewer.model.map.compartment.LeftSquareCompartment; @@ -29,18 +30,25 @@ public class CompartmentAliasXmlParser extends AbstractAliasXmlParser<Compartmen * Default class logger. */ @SuppressWarnings("unused") - private Logger logger = Logger.getLogger(CompartmentAliasXmlParser.class.getName()); + private Logger logger = Logger.getLogger(CompartmentAliasXmlParser.class.getName()); /** * Model for which we are parsing aliases. */ - private Model model = null; + private Model model = null; + /** + * Collection of {@link CellDesignerElement cell designer elements} parsed + * from xml. + */ private CellDesignerElementCollection elements; /** * Default constructor. * + * @param elements + * collection of {@link CellDesignerElement cell designer elements} + * parsed from xml * @param model * model for which this parser will be used */ @@ -53,7 +61,7 @@ public class CompartmentAliasXmlParser extends AbstractAliasXmlParser<Compartmen Compartment parseXmlAlias(Node aliasNode) throws InvalidXmlSchemaException { String compartmentId = getNodeAttr("compartment", aliasNode); - CellDesignerCompartment compartment = elements.getCompartmentByCompartmentId(compartmentId); + CellDesignerCompartment compartment = elements.getElementByElementId(compartmentId); if (compartment == null) { throw new InvalidXmlSchemaException("Compartment does not exist in a model: " + compartmentId); } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/alias/ComplexAliasXmlParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/alias/ComplexAliasXmlParser.java index 3babcfd20a73978d05cfa89aedcd485baf37e200..e3b9b91842dbc729ff6d86f03c08d8842e57f2a0 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/alias/ComplexAliasXmlParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/alias/ComplexAliasXmlParser.java @@ -12,6 +12,7 @@ import lcsb.mapviewer.common.exception.InvalidXmlSchemaException; import lcsb.mapviewer.common.exception.NotImplementedException; import lcsb.mapviewer.converter.model.celldesigner.CellDesignerElementCollection; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerComplexSpecies; +import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement; import lcsb.mapviewer.converter.model.celldesigner.structure.fields.View; import lcsb.mapviewer.model.map.compartment.Compartment; import lcsb.mapviewer.model.map.compartment.PathwayCompartment; @@ -34,14 +35,14 @@ public class ComplexAliasXmlParser extends AbstractAliasXmlParser<Complex> { * Default class logger. */ @SuppressWarnings("unused") - private Logger logger = Logger.getLogger(ComplexAliasXmlParser.class.getName()); + private Logger logger = Logger.getLogger(ComplexAliasXmlParser.class.getName()); /** * Because of the CellDesigner xml model we have to store information about * all processed Complexes. This infomrmation later on is used for connecting * complexes in hierarchical view. */ - private Map<String, Complex> complexAliasesMapById = new HashMap<String, Complex>(); + private Map<String, Complex> complexAliasesMapById = new HashMap<String, Complex>(); /** * Because of the CellDesigner xml model we have to store information about @@ -49,20 +50,27 @@ public class ComplexAliasXmlParser extends AbstractAliasXmlParser<Complex> { * complexes in hierarchical view. We cannot do it immediatelly because some * complexes doesn't exist yet. */ - private Map<String, String> parents = new HashMap<String, String>(); + private Map<String, String> parents = new HashMap<String, String>(); /** * Model for which we are parsing aliases. */ - private Model model = null; + private Model model = null; - private CellDesignerElementCollection elements; + /** + * Collection of {@link CellDesignerElement cell designer elements} parsed + * from xml. + */ + private CellDesignerElementCollection elements; /** * Default constructor with model object for which we parse data. * * @param model * model for which we parse elements + * @param elements + * collection of {@link CellDesignerElement cell designer elements} + * parsed from xml */ public ComplexAliasXmlParser(CellDesignerElementCollection elements, Model model) { this.model = model; @@ -75,7 +83,7 @@ public class ComplexAliasXmlParser extends AbstractAliasXmlParser<Complex> { String aliasId = getNodeAttr("id", aliasNode); String speciesId = getNodeAttr("species", aliasNode); - CellDesignerComplexSpecies species = (CellDesignerComplexSpecies) elements.getSpeciesBySpeciesId(speciesId); + CellDesignerComplexSpecies species = (CellDesignerComplexSpecies) elements.getElementByElementId(speciesId); if (species == null) { throw new InvalidXmlSchemaException("No species with id=\"" + speciesId + "\" for complex alias \"" + aliasId + "\""); } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/alias/SpeciesAliasXmlParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/alias/SpeciesAliasXmlParser.java index a1bfb93987ef4421c1e1c866d48f4f5507424b45..b936673c9f4bd248161c1f01d89ba707635922c7 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/alias/SpeciesAliasXmlParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/alias/SpeciesAliasXmlParser.java @@ -8,6 +8,7 @@ import lcsb.mapviewer.common.exception.InvalidXmlSchemaException; import lcsb.mapviewer.common.exception.NotImplementedException; import lcsb.mapviewer.converter.model.celldesigner.CellDesignerElementCollection; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerComplexSpecies; +import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerSpecies; import lcsb.mapviewer.converter.model.celldesigner.structure.fields.View; import lcsb.mapviewer.model.map.compartment.Compartment; @@ -30,8 +31,15 @@ public class SpeciesAliasXmlParser extends AbstractAliasXmlParser<Species> { */ private Logger logger = Logger.getLogger(SpeciesAliasXmlParser.class.getName()); + /** + * Collection of {@link CellDesignerElement cell designer elements} parsed + * from xml. + */ private CellDesignerElementCollection elements; + /** + * Model for which we parse elements. + */ private Model model; /** @@ -39,9 +47,12 @@ public class SpeciesAliasXmlParser extends AbstractAliasXmlParser<Species> { * * @param model * model for which we parse elements + * @param elements + * collection of {@link CellDesignerElement cell designer elements} + * parsed from xml */ - public SpeciesAliasXmlParser(CellDesignerElementCollection elementCollection, Model model) { - this.elements = elementCollection; + public SpeciesAliasXmlParser(CellDesignerElementCollection elements, Model model) { + this.elements = elements; this.model = model; } @@ -50,7 +61,7 @@ public class SpeciesAliasXmlParser extends AbstractAliasXmlParser<Species> { String speciesId = getNodeAttr("species", aliasNode); String aliasId = getNodeAttr("id", aliasNode); - CellDesignerSpecies<?> species = elements.getSpeciesBySpeciesId(speciesId); + CellDesignerSpecies<?> species = elements.getElementByElementId(speciesId); if (species == null) { throw new InvalidXmlSchemaException("Unknown species for alias (speciesId: " + speciesId + ")"); } @@ -111,22 +122,22 @@ public class SpeciesAliasXmlParser extends AbstractAliasXmlParser<Species> { result.setState(state); String compartmentAliasId = getNodeAttr("compartmentAlias", aliasNode); if (!compartmentAliasId.isEmpty()) { - Compartment ca = model.getElementByElementId(compartmentAliasId); - if (ca == null) { + Compartment compartment = model.getElementByElementId(compartmentAliasId); + if (compartment == null) { throw new InvalidXmlSchemaException("CompartmentAlias does not exist: " + compartmentAliasId); } else { - result.setCompartment(ca); - ca.addElement(result); + result.setCompartment(compartment); + compartment.addElement(result); } } String complexAliasId = getNodeAttr("complexSpeciesAlias", aliasNode); if (!complexAliasId.isEmpty()) { - Complex alias = (Complex) model.getElementByElementId(complexAliasId); - if (alias == null) { + Complex complex = model.getElementByElementId(complexAliasId); + if (complex == null) { throw new InvalidXmlSchemaException("ComplexAlias does not exist: " + complexAliasId + ", current: " + result.getElementId()); } else { - result.setComplex(alias); - alias.addSpecies(result); + result.setComplex(complex); + complex.addSpecies(result); } } return result; diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/annotation/RestAnnotationParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/annotation/RestAnnotationParser.java index b488c39c4a5059802cee63a87831871a26498a04..b46d75a00ff20d1f8623ba227e437b44f9d5ce6c 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/annotation/RestAnnotationParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/annotation/RestAnnotationParser.java @@ -669,7 +669,13 @@ public class RestAnnotationParser extends XmlParser { } } - public void processNotes(Element alias) { - processNotes(alias.getNotes(), alias); + /** + * Process notes and assign structural information from it. + * + * @param element + * object with notes to be processed + */ + public void processNotes(Element element) { + processNotes(element.getNotes(), element); } } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/compartment/CompartmentCollectionXmlParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/compartment/CompartmentCollectionXmlParser.java index fd8b7d2abfd85821f08cdd1205258adac4ac6cf2..06c84638d451d19fcb820257e5b90ee4f8898e45 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/compartment/CompartmentCollectionXmlParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/compartment/CompartmentCollectionXmlParser.java @@ -13,6 +13,7 @@ import lcsb.mapviewer.common.XmlParser; import lcsb.mapviewer.common.exception.InvalidXmlSchemaException; import lcsb.mapviewer.converter.model.celldesigner.CellDesignerElementCollection; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerCompartment; +import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement; import lcsb.mapviewer.model.map.compartment.Compartment; /** @@ -36,6 +37,10 @@ public class CompartmentCollectionXmlParser extends XmlParser { /** * Default constructor. + * + * @param elements + * collection of {@link CellDesignerElement cell designer elements} + * parsed from xml */ public CompartmentCollectionXmlParser(CellDesignerElementCollection elements) { compartmentParser = new CompartmentXmlParser(elements); diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/compartment/CompartmentXmlParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/compartment/CompartmentXmlParser.java index cb86a60609cc4c0d316c01522f82ef561f16579e..958a8826f2eecf48d49f99306c56e9b239505531 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/compartment/CompartmentXmlParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/compartment/CompartmentXmlParser.java @@ -10,6 +10,7 @@ import lcsb.mapviewer.converter.model.celldesigner.CellDesignerElementCollection import lcsb.mapviewer.converter.model.celldesigner.annotation.XmlAnnotationParser; import lcsb.mapviewer.converter.model.celldesigner.species.AbstractElementXmlParser; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerCompartment; +import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement; import lcsb.mapviewer.model.map.compartment.Compartment; /** @@ -31,8 +32,19 @@ public class CompartmentXmlParser extends AbstractElementXmlParser<CellDesignerC */ private XmlAnnotationParser xmlAnnotationParser = new XmlAnnotationParser(); + /** + * Collection of {@link CellDesignerElement cell designer elements} parsed + * from xml. + */ private CellDesignerElementCollection elements; + /** + * Default constructor. + * + * @param elements + * collection of {@link CellDesignerElement cell designer elements} + * parsed from xml + */ public CompartmentXmlParser(CellDesignerElementCollection elements) { this.elements = elements; } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/geometry/CellDesignerAliasConverter.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/geometry/CellDesignerAliasConverter.java index fe8993bbdd2881905f695646a65c08dd21685594..22f483ac41c6e4a7fef5bd3717928fe252456210 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/geometry/CellDesignerAliasConverter.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/geometry/CellDesignerAliasConverter.java @@ -49,14 +49,14 @@ public class CellDesignerAliasConverter implements ICellDesignerAliasConverter<E */ private static Map<Class<? extends Element>, ICellDesignerAliasConverter<?>> elementConverters; + /** + * Class helping with transforming objectcs into meaningfull identifiers. + */ private static ElementUtils eu = new ElementUtils(); static { elementConverters = new HashMap<>(); - // at the beginning lets add all implemented aliases - - // for alias reference addElementConverter(GenericProtein.class, new ProteinCellDesignerAliasConverter()); addElementConverter(TruncatedProtein.class, new ProteinCellDesignerAliasConverter()); addElementConverter(ReceptorProtein.class, new ProteinCellDesignerAliasConverter()); diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/geometry/ProteinCellDesignerAliasConverter.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/geometry/ProteinCellDesignerAliasConverter.java index 5c76ba89b6816ce0cdf4f9e16797e8271d6b8a47..4a698ada1dcaa6fe1773fa8f40c985962581c62e 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/geometry/ProteinCellDesignerAliasConverter.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/geometry/ProteinCellDesignerAliasConverter.java @@ -10,7 +10,6 @@ import java.util.ArrayList; import org.apache.log4j.Logger; -import lcsb.mapviewer.common.exception.InvalidArgumentException; import lcsb.mapviewer.common.exception.NotImplementedException; import lcsb.mapviewer.converter.model.celldesigner.geometry.helper.CellDesignerAnchor; import lcsb.mapviewer.model.map.species.Element; @@ -40,7 +39,10 @@ public class ProteinCellDesignerAliasConverter extends AbstractCellDesignerAlias */ private static final int GENERIC_PROTEIN_RECTANGLE_CORNER_ARC_SIZE = 10; - private ElementUtils eu = new ElementUtils(); + /** + * Helps in providing human readable identifiers of elements for logging. + */ + private ElementUtils eu = new ElementUtils(); @Override public Point2D getPointCoordinates(Protein alias, CellDesignerAnchor anchor) { diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionCollectionXmlParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionCollectionXmlParser.java index 0bcaec942f83829e131b47e3763876ec8489a5c2..d66747545fab41d4eacab3da784a40fc817d7e3a 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionCollectionXmlParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionCollectionXmlParser.java @@ -12,6 +12,7 @@ import lcsb.mapviewer.common.XmlParser; import lcsb.mapviewer.common.exception.InvalidXmlSchemaException; import lcsb.mapviewer.converter.model.celldesigner.CellDesignerElementCollection; import lcsb.mapviewer.converter.model.celldesigner.CellDesignerParserException; +import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement; import lcsb.mapviewer.model.map.model.Model; import lcsb.mapviewer.model.map.reaction.Reaction; @@ -43,6 +44,9 @@ public class ReactionCollectionXmlParser extends XmlParser { * Default constructor. Model is required because some nodes require access to * other parts of the model. * + * @param elements + * collection of {@link CellDesignerElement cell designer elements} + * parsed from xml * @param model * model that is parsed/transformed into xml */ diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionFromXml.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionFromXml.java index afd11e0ff5b63acd90636e4d70fd9dcfea8b9ae8..2d08d24f64846953bab15a541fa10c2a492a4107 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionFromXml.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionFromXml.java @@ -17,7 +17,6 @@ import org.w3c.dom.NodeList; import lcsb.mapviewer.common.XmlParser; import lcsb.mapviewer.common.exception.InvalidArgumentException; import lcsb.mapviewer.common.exception.InvalidXmlSchemaException; -import lcsb.mapviewer.converter.model.celldesigner.CellDesignerElementCollection; import lcsb.mapviewer.converter.model.celldesigner.annotation.RestAnnotationParser; import lcsb.mapviewer.converter.model.celldesigner.annotation.XmlAnnotationParser; import lcsb.mapviewer.converter.model.celldesigner.geometry.CellDesignerAliasConverter; @@ -133,12 +132,6 @@ public class ReactionFromXml extends XmlParser { */ private CellDesignerPointTransformation pointTransformation = new CellDesignerPointTransformation(); - private CellDesignerElementCollection elements; - - public ReactionFromXml(CellDesignerElementCollection elements) { - this.elements = elements; - } - /** * Returns {@link Reaction} object from CellDesigner xml node. * @@ -279,7 +272,7 @@ public class ReactionFromXml extends XmlParser { Node reactantNode = reactantsNodes.item(z); if (reactantNode.getNodeType() == Node.ELEMENT_NODE) { if (reactantNode.getNodeName().equalsIgnoreCase("celldesigner:baseReactant")) { - parseBaseReactant(result, reactantNode, model, elements); + parseBaseReactant(result, reactantNode, model); } else { throw new ReactionParserException("Unknown element of celldesigner:baseReactants: " + node.getNodeName(), result); } @@ -291,7 +284,7 @@ public class ReactionFromXml extends XmlParser { Node reactantNode = reactantsNodes.item(z); if (reactantNode.getNodeType() == Node.ELEMENT_NODE) { if (reactantNode.getNodeName().equalsIgnoreCase("celldesigner:baseProduct")) { - parseBaseProduct(model, result, reactantNode, elements); + parseBaseProduct(model, result, reactantNode); } else { throw new ReactionParserException("Unknown element of celldesigner:baseProducts: " + node.getNodeName(), result); } @@ -349,10 +342,10 @@ public class ReactionFromXml extends XmlParser { throw new ReactionParserException("Problem with parsing lines. Unknown reaction: " + type + "; " + result.getClass().getName(), result); } if (reactantsLinkNode != null) { - parseReactantLinks(result, reactantsLinkNode, model, elements); + parseReactantLinks(result, reactantsLinkNode, model); } if (productsLinkNode != null) { - parseProductLinks(result, productsLinkNode, model, elements); + parseProductLinks(result, productsLinkNode, model); } // create operators @@ -361,7 +354,7 @@ public class ReactionFromXml extends XmlParser { // now try to create modifiers (we must have set fixed layout data for the // core of the reaction) if (modifiersLinkNode != null) { - parseReactionModification(result, modifiersLinkNode, model, elements); + parseReactionModification(result, modifiersLinkNode, model); } for (int i = 0; i < result.getModifiers().size(); i++) { Modifier modifier = result.getModifiers().get(i); @@ -1100,13 +1093,13 @@ public class ReactionFromXml extends XmlParser { * thrown when xml node contains data that is not supported by xml * schema */ - private void parseReactantLinks(Reaction result, Node rootNode, Model model, CellDesignerElementCollection elements) throws ReactionParserException { + private void parseReactantLinks(Reaction result, Node rootNode, Model model) throws ReactionParserException { NodeList list = rootNode.getChildNodes(); for (int i = 0; i < list.getLength(); i++) { Node node = list.item(i); if (node.getNodeType() == Node.ELEMENT_NODE) { if (node.getNodeName().equalsIgnoreCase("celldesigner:reactantLink")) { - Reactant newReactant = getReactantLink(node, model, result, elements); + Reactant newReactant = getReactantLink(node, model, result); result.addReactant(newReactant); } else { throw new ReactionParserException("Unknown element of celldesigner:listOfReactantLinks: " + node.getNodeName(), result); @@ -1131,7 +1124,7 @@ public class ReactionFromXml extends XmlParser { * thrown when xml node contains data that is not supported by xml * schema */ - private Reactant getReactantLink(Node rootNode, Model model, Reaction reaction, CellDesignerElementCollection elements) throws ReactionParserException { + private Reactant getReactantLink(Node rootNode, Model model, Reaction reaction) throws ReactionParserException { String aliasId = getNodeAttr("alias", rootNode); Species al = (Species) model.getElementByElementId(aliasId); if (al == null) { @@ -1199,13 +1192,13 @@ public class ReactionFromXml extends XmlParser { * thrown when xml node contains data that is not supported by xml * schema */ - private void parseProductLinks(Reaction result, Node rootNode, Model model, CellDesignerElementCollection elements) throws ReactionParserException { + private void parseProductLinks(Reaction result, Node rootNode, Model model) throws ReactionParserException { NodeList list = rootNode.getChildNodes(); for (int i = 0; i < list.getLength(); i++) { Node node = list.item(i); if (node.getNodeType() == Node.ELEMENT_NODE) { if (node.getNodeName().equalsIgnoreCase("celldesigner:productLink")) { - Product link = getProductLink(node, model, result, elements); + Product link = getProductLink(node, model, result); result.addProduct(link); } else { throw new ReactionParserException("Unknown element of celldesigner:listOfProductLinks: " + node.getNodeName(), result); @@ -1230,7 +1223,7 @@ public class ReactionFromXml extends XmlParser { * thrown when xml node contains data that is not supported by xml * schema */ - private Product getProductLink(Node rootNode, Model model, Reaction reaction, CellDesignerElementCollection elements) throws ReactionParserException { + private Product getProductLink(Node rootNode, Model model, Reaction reaction) throws ReactionParserException { String aliasId = getNodeAttr("alias", rootNode); Species al = (Species) model.getElementByElementId(aliasId); if (al == null) { @@ -1332,13 +1325,13 @@ public class ReactionFromXml extends XmlParser { * thrown when xml node contains data that is not supported by xml * schema */ - private void parseReactionModification(Reaction result, Node rootNode, Model model, CellDesignerElementCollection elements) throws ReactionParserException { + private void parseReactionModification(Reaction result, Node rootNode, Model model) throws ReactionParserException { NodeList nodes = rootNode.getChildNodes(); for (int x = 0; x < nodes.getLength(); x++) { Node node = nodes.item(x); if (node.getNodeType() == Node.ELEMENT_NODE) { if (node.getNodeName().equalsIgnoreCase("celldesigner:modification")) { - parseModificationReaction(result, node, model, elements); + parseModificationReaction(result, node, model); } else { throw new ReactionParserException("Unknown element of celldesigner:listOfModification: " + node.getNodeName(), result); } @@ -1358,8 +1351,7 @@ public class ReactionFromXml extends XmlParser { * @throws ReactionParserException * thrown when node cannot be parsed properly */ - private void parseModificationReaction(Reaction reaction, Node rootNode, Model model, CellDesignerElementCollection elements) - throws ReactionParserException { + private void parseModificationReaction(Reaction reaction, Node rootNode, Model model) throws ReactionParserException { ModifierTypeUtils modifierTypeUtils = new ModifierTypeUtils(); String type = getNodeAttr("type", rootNode); String modificationType = getNodeAttr("modificationType", rootNode); @@ -1569,7 +1561,7 @@ public class ReactionFromXml extends XmlParser { * thrown when xml node contains data that is not supported by xml * schema */ - private void parseBaseReactant(Reaction result, Node reactantNode, Model model, CellDesignerElementCollection elements) throws ReactionParserException { + private void parseBaseReactant(Reaction result, Node reactantNode, Model model) throws ReactionParserException { String aliasId = getNodeAttr("alias", reactantNode); Species alias = (Species) model.getElementByElementId(aliasId); if (alias == null) { @@ -1605,7 +1597,7 @@ public class ReactionFromXml extends XmlParser { * thrown when xml node contains data that is not supported by xml * schema */ - private void parseBaseProduct(Model model, Reaction result, Node reactantNode, CellDesignerElementCollection elements) throws ReactionParserException { + private void parseBaseProduct(Model model, Reaction result, Node reactantNode) throws ReactionParserException { String aliasId = getNodeAttr("alias", reactantNode); Species alias = (Species) model.getElementByElementId(aliasId); if (alias == null) { diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionToXml.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionToXml.java index 1305ccd3c2f1f03bce720cabdc69f5050716e7f0..33c5670e93a1f6be9667d1b700d93742044a0822 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionToXml.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionToXml.java @@ -21,6 +21,7 @@ import lcsb.mapviewer.converter.model.celldesigner.geometry.CellDesignerAliasCon import lcsb.mapviewer.converter.model.celldesigner.geometry.helper.CellDesignerAnchor; import lcsb.mapviewer.converter.model.celldesigner.geometry.helper.CellDesignerLineTransformation; import lcsb.mapviewer.converter.model.celldesigner.geometry.helper.CellDesignerPointTransformation; +import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement; import lcsb.mapviewer.converter.model.celldesigner.types.ModifierType; import lcsb.mapviewer.converter.model.celldesigner.types.ModifierTypeUtils; import lcsb.mapviewer.converter.model.celldesigner.types.OperatorType; @@ -36,7 +37,6 @@ import lcsb.mapviewer.model.map.reaction.type.SimpleReactionInterface; import lcsb.mapviewer.model.map.reaction.type.TwoProductReactionInterface; import lcsb.mapviewer.model.map.reaction.type.TwoReactantReactionInterface; import lcsb.mapviewer.model.map.species.Element; -import lcsb.mapviewer.model.map.species.Complex; import lcsb.mapviewer.model.map.species.Species; import lcsb.mapviewer.modelutils.map.ElementUtils; @@ -66,10 +66,25 @@ public class ReactionToXml extends XmlParser { */ private CellDesignerLineTransformation lineTransformation = new CellDesignerLineTransformation(); + /** + * Collection of {@link CellDesignerElement cell designer elements} parsed + * from xml. + */ private CellDesignerElementCollection elements; + /** + * Helps in providing human readable identifiers of elements for logging. + */ private ElementUtils eu = new ElementUtils(); + /** + * Default constructor. Model is required because some nodes require access to + * other parts of the model. + * + * @param elements + * collection of {@link CellDesignerElement cell designer elements} + * parsed from xml + */ public ReactionToXml(CellDesignerElementCollection elements) { this.elements = elements; } @@ -328,7 +343,8 @@ public class ReactionToXml extends XmlParser { */ private String getLinkTargetXmlString(Modifier modifier) { StringBuilder sb = new StringBuilder(); - sb.append("<celldesigner:linkTarget species=\"" + elements.getElementId(modifier.getElement()) + "\" alias=\"" + modifier.getElement().getElementId() + "\">\n"); + sb.append( + "<celldesigner:linkTarget species=\"" + elements.getElementId(modifier.getElement()) + "\" alias=\"" + modifier.getElement().getElementId() + "\">\n"); sb.append(getAnchorXml(modifier.getElement(), modifier.getLine().getBeginPoint())); sb.append("</celldesigner:linkTarget>\n"); @@ -387,7 +403,7 @@ public class ReactionToXml extends XmlParser { } parents.add(species); } - + sb.append("<speciesReference species=\"" + elements.getElementId(species) + "\">\n"); sb.append("<annotation>\n"); sb.append("<celldesigner:extension>\n"); diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionXmlParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionXmlParser.java index 92ca7c65bc850f82712b6cd46ec73f73c0375dfc..3b5c8191763a4dcf35fc8b0be4c2a0a918af26b9 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionXmlParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionXmlParser.java @@ -5,6 +5,7 @@ import org.w3c.dom.Node; import lcsb.mapviewer.common.XmlParser; import lcsb.mapviewer.common.exception.InvalidXmlSchemaException; import lcsb.mapviewer.converter.model.celldesigner.CellDesignerElementCollection; +import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement; import lcsb.mapviewer.model.map.model.Model; import lcsb.mapviewer.model.map.reaction.Reaction; @@ -27,9 +28,17 @@ public class ReactionXmlParser extends XmlParser { */ private ReactionFromXml reactionFromXml; + /** + * Default constructor. Model is required because some nodes require access to + * other parts of the model. + * + * @param elements + * collection of {@link CellDesignerElement cell designer elements} + * parsed from xml + */ public ReactionXmlParser(CellDesignerElementCollection elements) { reactionToXml = new ReactionToXml(elements); - reactionFromXml = new ReactionFromXml(elements); + reactionFromXml = new ReactionFromXml(); } /** diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/AbstractElementXmlParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/AbstractElementXmlParser.java index 5d6268512ac181094ada756fa641f1e72fb38409..4c8449fd5e790233a81bd3c2f9387b6ba600964a 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/AbstractElementXmlParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/AbstractElementXmlParser.java @@ -3,6 +3,11 @@ package lcsb.mapviewer.converter.model.celldesigner.species; import java.util.ArrayList; import java.util.List; +import org.apache.log4j.Logger; +import org.w3c.dom.Document; +import org.w3c.dom.Node; +import org.w3c.dom.NodeList; + import lcsb.mapviewer.common.Pair; import lcsb.mapviewer.common.XmlParser; import lcsb.mapviewer.common.exception.InvalidXmlSchemaException; @@ -11,18 +16,15 @@ import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement import lcsb.mapviewer.model.map.InconsistentModelException; import lcsb.mapviewer.model.map.species.Element; -import org.apache.log4j.Logger; -import org.w3c.dom.Document; -import org.w3c.dom.Node; -import org.w3c.dom.NodeList; - /** * Abstract class with the interface to parse element in CellDesigner file. * * @author Piotr Gawron * * @param <T> - * type of the object to parse + * type of the celldesigner object to parse + * @param <S> + * type of the model object to be obtained */ public abstract class AbstractElementXmlParser<T extends CellDesignerElement<?>, S extends Element> extends XmlParser { @@ -30,13 +32,13 @@ public abstract class AbstractElementXmlParser<T extends CellDesignerElement<?>, * Default class logger. */ @SuppressWarnings("unused") - private Logger logger = Logger.getLogger(AbstractElementXmlParser.class.getName()); + private Logger logger = Logger.getLogger(AbstractElementXmlParser.class.getName()); /** * List of special strings in CellDesigner that should be translated into some * UTF characters. */ - private List<Pair<String, String>> encodedStrings = new ArrayList<Pair<String, String>>(); + private List<Pair<String, String>> encodedStrings = new ArrayList<Pair<String, String>>(); /** * Parser of the notes that allows to extract additional structurized data for diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/AntisenseRnaXmlParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/AntisenseRnaXmlParser.java index eed59742b21683d29f5ee8ef14eb945090c1bc57..1213df96ac1b3cb495499cfb166636eb1a3ee052 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/AntisenseRnaXmlParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/AntisenseRnaXmlParser.java @@ -9,6 +9,7 @@ import lcsb.mapviewer.common.exception.InvalidXmlSchemaException; import lcsb.mapviewer.converter.model.celldesigner.CellDesignerElementCollection; import lcsb.mapviewer.converter.model.celldesigner.annotation.RestAnnotationParser; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerAntisenseRna; +import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement; import lcsb.mapviewer.converter.model.celldesigner.structure.fields.CellDesignerAntisenseRnaRegion; import lcsb.mapviewer.model.map.species.AntisenseRna; import lcsb.mapviewer.model.map.species.field.AntisenseRnaRegion; @@ -26,10 +27,21 @@ public class AntisenseRnaXmlParser extends AbstractElementXmlParser<CellDesigner * Default class logger. */ @SuppressWarnings("unused") - private Logger logger = Logger.getLogger(AntisenseRnaXmlParser.class.getName()); + private Logger logger = Logger.getLogger(AntisenseRnaXmlParser.class.getName()); + /** + * List of {@link CellDesignerElement celldesigner elements} obtained during + * parsing process. + */ private CellDesignerElementCollection elements; + /** + * Default constructor. + * + * @param elements + * list of {@link CellDesignerElement celldesigner elements} obtained + * during parsing process + */ public AntisenseRnaXmlParser(CellDesignerElementCollection elements) { this.elements = elements; } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/GeneXmlParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/GeneXmlParser.java index 273be9a25862d99f8c3951dad61c48f67494fe1a..3813032e290fcb0a5a8632fe27ec6c362aba596e 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/GeneXmlParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/GeneXmlParser.java @@ -8,6 +8,7 @@ import lcsb.mapviewer.common.Pair; import lcsb.mapviewer.common.exception.InvalidXmlSchemaException; import lcsb.mapviewer.converter.model.celldesigner.CellDesignerElementCollection; import lcsb.mapviewer.converter.model.celldesigner.annotation.RestAnnotationParser; +import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerGene; import lcsb.mapviewer.converter.model.celldesigner.structure.fields.CellDesignerModificationResidue; import lcsb.mapviewer.model.map.species.Gene; @@ -27,8 +28,20 @@ public class GeneXmlParser extends AbstractElementXmlParser<CellDesignerGene, Ge @SuppressWarnings("unused") private Logger logger = Logger.getLogger(GeneXmlParser.class.getName()); + /** + * Collection of {@link CellDesignerElement cell designer elements} parsed + * from xml. + */ private CellDesignerElementCollection elements; + /** + * Default constructor. Model is required because some nodes require access to + * other parts of the model. + * + * @param elements + * collection of {@link CellDesignerElement cell designer elements} + * parsed from xml + */ public GeneXmlParser(CellDesignerElementCollection elements) { this.elements = elements; } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/ProteinMapping.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/ProteinMapping.java index 80d6eb5b25efe3158b1ee828dc850146b5f9782e..09ed6d94052da4ee93b97fa0478881480e130601 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/ProteinMapping.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/ProteinMapping.java @@ -46,23 +46,32 @@ public enum ProteinMapping { /** * CellDesigner xml node type. */ - private String cellDesignerString; + private String cellDesignerString; /** - * Class that should be used to represent cell designer node. + * Model class that should be used to represent cell designer node. */ - private Class<? extends Protein> clazz; + private Class<? extends Protein> clazz; + /** + * Default class logger. + */ @SuppressWarnings("unused") - private static Logger logger = Logger.getLogger(ProteinMapping.class); + private static Logger logger = Logger.getLogger(ProteinMapping.class); - private Class<? extends CellDesignerProtein<?>> cellDesignerClazz; + /** + * {@link CellDesignerProtein Celldesigner structure} used to represent the + * node. + */ + private Class<? extends CellDesignerProtein<?>> cellDesignerClazz; /** * Default constructor. * * @param cellDesignerClazz * {@link #clazz} + * @param modelClazz + * {@link #clazz class} in model corresponding to celldesigner object * @param cellDesignerString * {@link #cellDesignerString} */ @@ -88,6 +97,11 @@ public enum ProteinMapping { return clazz; } + /** + * Returns celldesigner class type that represents xml node. + * + * @return celldesigner class type that represents xml node + */ public Class<? extends CellDesignerProtein<?>> getCellDesignerClazz() { return cellDesignerClazz; } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/ProteinXmlParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/ProteinXmlParser.java index 7d41df9d79cd0275b5897b32a7360d87c049a27a..68cd9af32aa18bae5cbbf1832c54febe80d4fef1 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/ProteinXmlParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/ProteinXmlParser.java @@ -8,6 +8,7 @@ import lcsb.mapviewer.common.Pair; import lcsb.mapviewer.common.exception.InvalidArgumentException; import lcsb.mapviewer.common.exception.InvalidXmlSchemaException; import lcsb.mapviewer.converter.model.celldesigner.CellDesignerElementCollection; +import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerProtein; import lcsb.mapviewer.converter.model.celldesigner.structure.fields.CellDesignerModificationResidue; import lcsb.mapviewer.model.map.species.Protein; @@ -29,8 +30,20 @@ public class ProteinXmlParser extends AbstractElementXmlParser<CellDesignerProte @SuppressWarnings("unused") private Logger logger = Logger.getLogger(ProteinXmlParser.class.getName()); + /** + * Collection of {@link CellDesignerElement cell designer elements} parsed + * from xml. + */ private CellDesignerElementCollection elements; + /** + * Default constructor. Model is required because some nodes require access to + * other parts of the model. + * + * @param elements + * collection of {@link CellDesignerElement cell designer elements} + * parsed from xml + */ public ProteinXmlParser(CellDesignerElementCollection elements) { this.elements = elements; } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/RnaXmlParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/RnaXmlParser.java index 04783c194b808929c8fc182ae390bd0f7e4e16ce..2febc38cc9615cff4420b7e0665521d27fe14817 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/RnaXmlParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/RnaXmlParser.java @@ -8,6 +8,7 @@ import lcsb.mapviewer.common.Pair; import lcsb.mapviewer.common.exception.InvalidXmlSchemaException; import lcsb.mapviewer.converter.model.celldesigner.CellDesignerElementCollection; import lcsb.mapviewer.converter.model.celldesigner.annotation.RestAnnotationParser; +import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerRna; import lcsb.mapviewer.converter.model.celldesigner.structure.fields.CellDesignerRnaRegion; import lcsb.mapviewer.model.map.species.Rna; @@ -27,8 +28,20 @@ public class RnaXmlParser extends AbstractElementXmlParser<CellDesignerRna, Rna> @SuppressWarnings("unused") private Logger logger = Logger.getLogger(RnaXmlParser.class.getName()); + /** + * Collection of {@link CellDesignerElement cell designer elements} parsed + * from xml. + */ private CellDesignerElementCollection elements; + /** + * Default constructor. Model is required because some nodes require access to + * other parts of the model. + * + * @param elements + * collection of {@link CellDesignerElement cell designer elements} + * parsed from xml + */ public RnaXmlParser(CellDesignerElementCollection elements) { this.elements = elements; } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/SpeciesCollectionXmlParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/SpeciesCollectionXmlParser.java index 4f278118cc57d64e5e27dc59a9f675df04f9cdb3..50039742220137b42fc037bf8807605b338d1779 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/SpeciesCollectionXmlParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/SpeciesCollectionXmlParser.java @@ -102,11 +102,19 @@ public class SpeciesCollectionXmlParser extends XmlParser { } }; + /** + * Collection of {@link CellDesignerElement cell designer elements} parsed + * from xml. + */ private CellDesignerElementCollection elements; /** * Default constructor. Model is required because some CellDesigner nodes * require access to other parts of the model. + * + * @param elements + * collection of {@link CellDesignerElement cell designer elements} + * parsed from xml */ public SpeciesCollectionXmlParser(CellDesignerElementCollection elements) { sbmlSpeciesParser = new SpeciesSbmlParser(elements); diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/SpeciesMapping.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/SpeciesMapping.java index 35b6c49eb19fd0cfedea8774b34f6236da05ac5c..933c6486fdc3e66dc3257f5053bbf07cd8be08d9 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/SpeciesMapping.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/SpeciesMapping.java @@ -92,29 +92,45 @@ public enum SpeciesMapping { /** * CellDesigner xml node type. */ - private String cellDesignerString; + private String cellDesignerString; /** * Class that should be used to represent cell designer node. */ - private Class<? extends CellDesignerSpecies> cellDesignerClazz; + private Class<? extends CellDesignerSpecies<?>> cellDesignerClazz; - private Class<? extends Element> modelClazz; + /** + * Model class that represent the species. + */ + private Class<? extends Element> modelClazz; /** * Default constructor. * * @param cellDesignerClazz * {@link #clazz} + * @param modelClazz + * {@link #clazz class} in model corresponding to celldesigner object * @param cellDesignerString * {@link #cellDesignerString} */ - SpeciesMapping(Class<? extends CellDesignerSpecies> cellDesignerClazz, Class<? extends Element> modelClazz, String cellDesignerString) { + SpeciesMapping(Class<?> cellDesignerClazz, Class<? extends Element> modelClazz, String cellDesignerString) { this.cellDesignerString = cellDesignerString; - this.cellDesignerClazz = cellDesignerClazz; + this.setCellDesignerClazz(cellDesignerClazz); this.modelClazz = modelClazz; } + /** + * Sets new cellDesignerClazz value. + * + * @param cellDesignerClazz2 + * new cellDesignerClazz value + */ + @SuppressWarnings("unchecked") + private void setCellDesignerClazz(Class<?> cellDesignerClazz2) { + cellDesignerClazz = (Class<? extends CellDesignerSpecies<?>>) cellDesignerClazz2; + } + /** * @return the cellDesignerString * @see #cellDesignerString @@ -127,10 +143,15 @@ public enum SpeciesMapping { * @return the clazz * @see #clazz */ - public Class<? extends CellDesignerSpecies> getCellDesignerClazz() { + public Class<? extends CellDesignerSpecies<?>> getCellDesignerClazz() { return cellDesignerClazz; } + /** + * Returns model class that represent the species. + * + * @return model class that represent the species + */ public Class<? extends Element> getModelClazz() { return modelClazz; } @@ -144,7 +165,7 @@ public enum SpeciesMapping { * @return new instance of {@link CellDesignerSpecies} specific for this * {@link SpeciesMapping}. */ - public CellDesignerSpecies createSpecies(CellDesignerSpecies result) { + public CellDesignerSpecies<?> createSpecies(CellDesignerSpecies<?> result) { try { return cellDesignerClazz.getConstructor(result.getClass()).newInstance(result); } catch (Exception e) { diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/SpeciesSbmlParser.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/SpeciesSbmlParser.java index 7033c094dd4fe52b3be1b2e1d1521e6862d648db..964eb33e9ae2fecbadc778429f110f563db1520d 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/SpeciesSbmlParser.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/species/SpeciesSbmlParser.java @@ -14,6 +14,7 @@ import lcsb.mapviewer.converter.model.celldesigner.annotation.XmlAnnotationParse import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerAntisenseRna; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerCompartment; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerComplexSpecies; +import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerElement; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerGene; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerProtein; import lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerRna; @@ -47,11 +48,19 @@ public class SpeciesSbmlParser extends AbstractElementXmlParser<CellDesignerSpec @SuppressWarnings("unused") private Logger logger = Logger.getLogger(SpeciesSbmlParser.class.getName()); + /** + * Collection of {@link CellDesignerElement cell designer elements} parsed + * from xml. + */ private CellDesignerElementCollection elements; /** * Default constructor. Model is required because some nodes require access to * other parts of the model. + * + * @param elements + * collection of {@link CellDesignerElement cell designer elements} + * parsed from xml */ public SpeciesSbmlParser(CellDesignerElementCollection elements) { this.elements = elements; @@ -146,7 +155,7 @@ public class SpeciesSbmlParser extends AbstractElementXmlParser<CellDesignerSpec species.setCharge(getNodeAttr("charge", spieciesNode)); species.setOnlySubstanceUnits(getNodeAttr("hasOnlySubstanceUnits", spieciesNode)); - CellDesignerCompartment compartment = elements.getCompartmentByCompartmentId(getNodeAttr("compartment", spieciesNode)); + CellDesignerCompartment compartment = elements.getElementByElementId(getNodeAttr("compartment", spieciesNode)); if (compartment != null) { species.setParent(compartment); } @@ -305,7 +314,7 @@ public class SpeciesSbmlParser extends AbstractElementXmlParser<CellDesignerSpec */ public Pair<String, CellDesignerSpecies<?>> parseSpeciesIdentity(Node rootNode) throws InvalidXmlSchemaException { NodeList nodes = rootNode.getChildNodes(); - CellDesignerSpecies<?> result = new CellDesignerSpecies(); + CellDesignerSpecies<?> result = new CellDesignerSpecies<Species>(); Node classNode = getNode("celldesigner:class", nodes); if (classNode == null) { throw new InvalidXmlSchemaException("Species node in Sbml model doesn't contain node \"celldesigner:class\"."); diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerAntisenseRna.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerAntisenseRna.java index 3a1c835cffe721d71f06ecadf69229d8c7cbb50a..e3456b1c883be2e35b467ce847c334b709a798fa 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerAntisenseRna.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerAntisenseRna.java @@ -140,7 +140,7 @@ public class CellDesignerAntisenseRna extends CellDesignerSpecies<AntisenseRna> @Override public AntisenseRna createModelElement(String aliasId) { AntisenseRna result = new AntisenseRna(aliasId); - super.setAliasFields(result); + super.setModelObjectFields(result); for (CellDesignerAntisenseRnaRegion region : regions) { result.addRegion(region.createAntisenseRegionAlias()); } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerChemical.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerChemical.java index 141a50971cfeb1fd959c40abeeaf289f520ed4a2..dab97cf4b61564dee8bb3d7fede88ccc318a6e3f 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerChemical.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerChemical.java @@ -115,8 +115,8 @@ public abstract class CellDesignerChemical<T extends Chemical> extends CellDesig } @Override - protected void setAliasFields(T result) { - super.setAliasFields(result); + protected void setModelObjectFields(T result) { + super.setModelObjectFields(result); result.setInChI(inChI); result.setInChIKey(inChIKey); result.setSmiles(smiles); diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerCompartment.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerCompartment.java index 3c7bbe5ae3c80b165b177d432d3c83cd5afba39e..59a7f110ce2f147fa7a7d18a028dbe7343c796a6 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerCompartment.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerCompartment.java @@ -141,7 +141,7 @@ public class CellDesignerCompartment extends CellDesignerElement<Compartment> im @Override public Compartment createModelElement(String aliasId) { Compartment result = new Compartment(aliasId); - super.setAliasFields(result); + super.setModelObjectFields(result); if (elements.size() > 0) { throw new NotImplementedException(); } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerComplexSpecies.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerComplexSpecies.java index 1b4d7d6de12ab9ce5bc25ae29705d308dad15962..89f996caa824ef013a845b574a9ebac0507f34e3 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerComplexSpecies.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerComplexSpecies.java @@ -157,7 +157,7 @@ public class CellDesignerComplexSpecies extends CellDesignerSpecies<Complex> { @Override public Complex createModelElement(String aliasId) { Complex result = new Complex(aliasId); - super.setAliasFields(result); + super.setModelObjectFields(result); if (elements.size() > 0) { throw new NotImplementedException(); diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerDegraded.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerDegraded.java index 76a0fe4aef1f136b6b0d11fb04b0c5f1faea745e..7ef30e6d43cb853a7ce86bfe7525630c67c95859 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerDegraded.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerDegraded.java @@ -44,7 +44,7 @@ public class CellDesignerDegraded extends CellDesignerSpecies<Degraded> { @Override public Degraded createModelElement(String aliasId) { Degraded result = new Degraded(aliasId); - super.setAliasFields(result); + super.setModelObjectFields(result); return result; } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerDrug.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerDrug.java index 3bc6b963079e9074df8e44ee5233ef3b0c3170c9..df5daabb489c0210bb5a56fa55f173ad9835df29 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerDrug.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerDrug.java @@ -44,7 +44,7 @@ public class CellDesignerDrug extends CellDesignerSpecies<Drug> { @Override public Drug createModelElement(String aliasId) { Drug result = new Drug(aliasId); - super.setAliasFields(result); + super.setModelObjectFields(result); return result; } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerElement.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerElement.java index f87b166e5ac16abf9f16652407ddb5c77629621f..c686ccb3cfb6655961373683a969c831c1d19f5b 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerElement.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerElement.java @@ -127,14 +127,31 @@ public abstract class CellDesignerElement<T extends Element> implements Serializ this.notes = ""; } + /** + * Adds set of {@link MiriamData} to the object. + * + * @param miriamData + * objects to be added + */ public void addMiriamData(Collection<MiriamData> miriamData) { for (MiriamData md : miriamData) { addMiriamData(md); } } + /** + * Returns identifier of the species. + * + * @return identifier of the species + */ public abstract String getElementId(); + /** + * Adds {@link MiriamData} to the element. + * + * @param md + * object to be added + */ public void addMiriamData(MiriamData md) { if (this.miriamData.contains(md)) { logger.warn("Miriam data (" + md.getDataType() + ": " + md.getResource() + ") for " + getElementId() + " already exists. Ignoring..."); @@ -144,6 +161,12 @@ public abstract class CellDesignerElement<T extends Element> implements Serializ } + /** + * Sets notes about the object. + * + * @param notes + * new notes + */ public void setNotes(String notes) { if (notes != null) { if (notes.contains("</html>")) { @@ -178,14 +201,30 @@ public abstract class CellDesignerElement<T extends Element> implements Serializ } + /** + * Returns notes about the object. + * + * @return notes about the object + */ public String getNotes() { return notes; } + /** + * Returns the symbol of the element. + * + * @return the symbol of the element + */ public String getSymbol() { return symbol; } + /** + * Sets symbol of the element. + * + * @param symbol + * new symbol + */ public void setSymbol(String symbol) { this.symbol = symbol; } @@ -207,6 +246,12 @@ public abstract class CellDesignerElement<T extends Element> implements Serializ this.fullName = fullName; } + /** + * Returns the name of the object. + * + * @return name of the object + * + */ public String getName() { return name; } @@ -220,10 +265,21 @@ public abstract class CellDesignerElement<T extends Element> implements Serializ this.name = name; } + /** + * Get list of synonyms. + * + * @return list of synonyms + */ public List<String> getSynonyms() { return synonyms; } + /** + * Sets list of synonyms to the element. + * + * @param synonyms + * new list + */ public void setSynonyms(List<String> synonyms) { this.synonyms = synonyms; } @@ -279,22 +335,49 @@ public abstract class CellDesignerElement<T extends Element> implements Serializ this.complex = complex; } + /** + * Returns list of {@link MiriamData annotations} for the object. + * + * @return list of {@link MiriamData annotations} for the object + */ public Set<MiriamData> getMiriamData() { return miriamData; } + /** + * Returns the abbreviation. + * + * @return the abbreviation + */ public String getAbbreviation() { return abbreviation; } + /** + * Sets abbreviation. + * + * @param abbreviation + * new abbreviation + */ public void setAbbreviation(String abbreviation) { this.abbreviation = abbreviation; } + /** + * Returns the formula. + * + * @return the formula + */ public String getFormula() { return formula; } + /** + * Sets formula. + * + * @param formula + * new formula + */ public void setFormula(String formula) { this.formula = formula; } @@ -319,15 +402,39 @@ public abstract class CellDesignerElement<T extends Element> implements Serializ this.formerSymbols.add(formerSymbol); } + /** + * Sets element identifier. + * + * @param elementId + * element identifier + */ public abstract void setElementId(String elementId); + /** + * Creates model object from this celldesigner structure. + * + * @return model object from this celldesigner structure + */ public T createModelElement() { return createModelElement(null); } + /** + * Creates model object from this celldesigner structure. + * + * @param modelElementId + * identifier of new model object + * @return model object from this celldesigner structure + */ public abstract T createModelElement(String modelElementId); - protected void setAliasFields(T result) { + /** + * Sets values from this cell designer structure into model object. + * + * @param result + * object to which values should be assigned + */ + protected void setModelObjectFields(T result) { result.setNotes(notes); result.setSymbol(symbol); result.setFullName(fullName); diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerGene.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerGene.java index e053a853f13bd7969721a1e6880c6479d26493a5..efc960c93ecf0b71b58863567529b7646be24847 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerGene.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerGene.java @@ -107,7 +107,7 @@ public class CellDesignerGene extends CellDesignerSpecies<Gene> { @Override public Gene createModelElement(String aliasId) { Gene result = new Gene(aliasId); - super.setAliasFields(result); + super.setModelObjectFields(result); for (CellDesignerModificationResidue mr : modificationResidues) { result.addModificationResidue(mr.createModificationResidueAlias()); } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerGenericProtein.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerGenericProtein.java index 4d12d9905728b15c50324f1783a1a3a623d5a2d5..e26903d0bd2cdafc801a90f187c2c83f76763200 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerGenericProtein.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerGenericProtein.java @@ -33,6 +33,12 @@ public class CellDesignerGenericProtein extends CellDesignerProtein<GenericProte super(species); } + /** + * Deafult constructor. + * + * @param id + * identifier of the protein + */ public CellDesignerGenericProtein(String id) { setElementId(id); } @@ -46,9 +52,10 @@ public class CellDesignerGenericProtein extends CellDesignerProtein<GenericProte } } + @Override public GenericProtein createModelElement(String aliasId) { GenericProtein result = new GenericProtein(aliasId); - super.setAliasFields(result); + super.setModelObjectFields(result); return result; } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerIon.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerIon.java index 7a828e6790800e75b25a37e1027b7cdb1431f4b0..31eb0cf621a5d2d86a08bdfd244facf0ad683196 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerIon.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerIon.java @@ -45,7 +45,7 @@ public class CellDesignerIon extends CellDesignerChemical<Ion> { @Override public Ion createModelElement(String aliasId) { Ion result = new Ion(aliasId); - super.setAliasFields(result); + super.setModelObjectFields(result); return result; } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerIonChannelProtein.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerIonChannelProtein.java index 8a7fbc97a8b0550392419d1db4b1f0fe3a20d80a..2a1da5d74367f703c0f807563f54cecbf41257a4 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerIonChannelProtein.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerIonChannelProtein.java @@ -45,7 +45,7 @@ public class CellDesignerIonChannelProtein extends CellDesignerProtein<IonChanne @Override public IonChannelProtein createModelElement(String aliasId) { IonChannelProtein result = new IonChannelProtein(aliasId); - super.setAliasFields(result); + super.setModelObjectFields(result); return result; } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerPhenotype.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerPhenotype.java index a27e5fe6bd0b8dd7d4b838ca480b51303f6e10d6..8ee7a94bce41eaeff8e51f16f7d8527515d7d9a3 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerPhenotype.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerPhenotype.java @@ -45,7 +45,7 @@ public class CellDesignerPhenotype extends CellDesignerSpecies<Phenotype> { @Override public Phenotype createModelElement(String aliasId) { Phenotype result = new Phenotype(aliasId); - super.setAliasFields(result); + super.setModelObjectFields(result); return result; } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerProtein.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerProtein.java index 35f08309b1760c71125a3bc6444272ed4d172167..d94a1dc5381972c8515bccb8a85325e9e152da04 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerProtein.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerProtein.java @@ -142,8 +142,8 @@ public class CellDesignerProtein<T extends Protein> extends CellDesignerSpecies< } @Override - protected void setAliasFields(T result) { - super.setAliasFields(result); + protected void setModelObjectFields(T result) { + super.setModelObjectFields(result); result.setStructuralState(structuralState); for (CellDesignerModificationResidue mr : modificationResidues) { result.addModificationResidue(mr.createModificationResidueAlias()); diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerReceptorProtein.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerReceptorProtein.java index 0416953bc0b77633dd4aa5cb7fee8d323dc7d030..f838567d0bd56393a0182cd1f719bf885964e4b4 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerReceptorProtein.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerReceptorProtein.java @@ -45,7 +45,7 @@ public class CellDesignerReceptorProtein extends CellDesignerProtein<ReceptorPro @Override public ReceptorProtein createModelElement(String aliasId) { ReceptorProtein result = new ReceptorProtein(aliasId); - super.setAliasFields(result); + super.setModelObjectFields(result); return result; } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerRna.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerRna.java index e2b75d38162e3892bfb02eee228b0482dc58b4cc..a1d476c3f02c9681fed20b53cf0bbd62b8d869ef 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerRna.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerRna.java @@ -136,7 +136,7 @@ public class CellDesignerRna extends CellDesignerSpecies<Rna> { @Override public Rna createModelElement(String aliasId) { Rna result = new Rna(aliasId); - super.setAliasFields(result); + super.setModelObjectFields(result); for (CellDesignerRnaRegion region : regions) { result.addRegion(region.createRnaRegionAlias()); } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerSimpleMolecule.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerSimpleMolecule.java index ccc562159f2c62890f6a6b8181862c1e4e0b4534..cdbf286113a9c918eb1e5ec23bc803704981d5d0 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerSimpleMolecule.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerSimpleMolecule.java @@ -52,7 +52,7 @@ public class CellDesignerSimpleMolecule extends CellDesignerChemical<SimpleMolec @Override public SimpleMolecule createModelElement(String aliasId) { SimpleMolecule result = new SimpleMolecule(aliasId); - super.setAliasFields(result); + super.setModelObjectFields(result); return result; } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerSpecies.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerSpecies.java index 66acec7dce75536aaf67e1f0bdd9890bb6cd7a55..693bd4dba045f4266115b4df0dc547c8214edce7 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerSpecies.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerSpecies.java @@ -465,8 +465,8 @@ public class CellDesignerSpecies<T extends Species> extends CellDesignerElement< } @Override - protected void setAliasFields(T result) { - super.setAliasFields(result); + protected void setModelObjectFields(T result) { + super.setModelObjectFields(result); result.setInitialAmount(initialAmount); result.setCharge(charge); result.setInitialConcentration(initialConcentration); diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerTruncatedProtein.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerTruncatedProtein.java index e30481b3980abb53dd7fb9e1c80238604b268bfc..f3484fcbd4411a0fd35039fbed225d0734b787b1 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerTruncatedProtein.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerTruncatedProtein.java @@ -45,7 +45,7 @@ public class CellDesignerTruncatedProtein extends CellDesignerProtein<TruncatedP @Override public TruncatedProtein createModelElement(String aliasId) { TruncatedProtein result = new TruncatedProtein(aliasId); - super.setAliasFields(result); + super.setModelObjectFields(result); return result; } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerUnknown.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerUnknown.java index e2c47cc817db2604da542fde81cf3d211d150707..5253b209d0b27d201eceb86bd50f4e08d702d82c 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerUnknown.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/CellDesignerUnknown.java @@ -43,7 +43,7 @@ public class CellDesignerUnknown extends CellDesignerSpecies<Unknown> { @Override public Unknown createModelElement(String aliasId) { Unknown result = new Unknown(aliasId); - super.setAliasFields(result); + super.setModelObjectFields(result); return result; } diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/fields/CellDesignerAntisenseRnaRegion.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/fields/CellDesignerAntisenseRnaRegion.java index 4861bdbb14a68ee56775f4c709569486857b5efc..36decddc98a49f81ef86a92f4431a0349825d4c2 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/fields/CellDesignerAntisenseRnaRegion.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/fields/CellDesignerAntisenseRnaRegion.java @@ -25,40 +25,40 @@ public class CellDesignerAntisenseRnaRegion implements Serializable { /** * */ - private static final long serialVersionUID = 1L; + private static final long serialVersionUID = 1L; /** * Default size of the object (in graphical representation). */ - private static final double DEFAULT_SIZE = 0.1; + private static final double DEFAULT_SIZE = 0.1; /** * Default class logger. */ @SuppressWarnings("unused") - private static Logger logger = Logger.getLogger(CellDesignerAntisenseRnaRegion.class.getName()); + private static Logger logger = Logger.getLogger(CellDesignerAntisenseRnaRegion.class.getName()); /** * Unique identifier in the database. */ - private int id; + private int id; /** * String identifier of the element. Unique in the model. */ - private String idAntisenseRnaRegion = ""; + private String idAntisenseRnaRegion = ""; /** * Name of the region. */ - private String name = ""; + private String name = ""; /** * Defines a state of the region (for instance ubiquitinated etc). * * @see ModificationState */ - private ModificationState state = null; + private ModificationState state = null; /** * Type of the region in the rna. There are three possible values: @@ -68,22 +68,22 @@ public class CellDesignerAntisenseRnaRegion implements Serializable { * <li>Modification site.</li> * </ul> */ - private AntisenseRnaRegionType type; + private AntisenseRnaRegionType type; /** * Size of the region in the graphic representation. */ - private double size = DEFAULT_SIZE; + private double size = DEFAULT_SIZE; /** * Position on the species in graphic representation. */ - private Double pos; + private Double pos; /** * Defines a species where the region belongs to. */ - private CellDesignerAntisenseRna species; + private CellDesignerAntisenseRna species; /** * Default constructor. @@ -316,6 +316,11 @@ public class CellDesignerAntisenseRnaRegion implements Serializable { this.id = id; } + /** + * Creates model representation of {@link AntisenseRnaRegion}. + * + * @return {@link AntisenseRnaRegion} representing this object in a model + */ public AntisenseRnaRegion createAntisenseRegionAlias() { AntisenseRnaRegion result = new AntisenseRnaRegion(); result.setIdAntisenseRnaRegion(idAntisenseRnaRegion); diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/fields/CellDesignerModificationResidue.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/fields/CellDesignerModificationResidue.java index abd1d0416685a280dedb072074e1bbbad8fd028c..ba82b6567d1672bdee106fcb78030553b7ceaac8 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/fields/CellDesignerModificationResidue.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/fields/CellDesignerModificationResidue.java @@ -88,6 +88,12 @@ public class CellDesignerModificationResidue implements Serializable { this.state = mr.state; } + /** + * Constructor that creates object from model representation of modification. + * + * @param mr + * model represnation of {@link ModificationResidue} + */ public CellDesignerModificationResidue(ModificationResidue mr) { this.idModificationResidue = mr.getIdModificationResidue(); this.name = mr.getName(); @@ -297,6 +303,11 @@ public class CellDesignerModificationResidue implements Serializable { this.species = species; } + /** + * Creates model representation of {@link ModificationResidue}. + * + * @return {@link ModificationResidue} representing this object in a model + */ public ModificationResidue createModificationResidueAlias() { ModificationResidue result = new ModificationResidue(); diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/fields/CellDesignerRnaRegion.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/fields/CellDesignerRnaRegion.java index 926263ee13ef4af287e31b619714ff4e84f9a2d5..bbb44414758cd125082930ee1f9f62f290b94edd 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/fields/CellDesignerRnaRegion.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/fields/CellDesignerRnaRegion.java @@ -12,7 +12,8 @@ import lcsb.mapviewer.model.map.species.field.RnaRegion; /** * This structure contains information about rna region (rna fragment of * interest) for a specific - * {@link lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerRna Rna}. + * {@link lcsb.mapviewer.converter.model.celldesigner.structure.CellDesignerRna + * Rna}. * * @author Piotr Gawron * @@ -76,7 +77,7 @@ public class CellDesignerRnaRegion implements Serializable { /** * Defines a species where the region belongs to. */ - private CellDesignerRna species; + private CellDesignerRna species; /** * Default constructor. @@ -135,7 +136,8 @@ public class CellDesignerRnaRegion implements Serializable { * region. * * @param mr - * {@link CellDesignerRnaRegion} from which data will be used to update + * {@link CellDesignerRnaRegion} from which data will be used to + * update */ public void update(CellDesignerRnaRegion mr) { if (this.idRnaRegion != null && !this.idRnaRegion.equals("") && !this.idRnaRegion.equals(mr.getIdRnaRegion())) { @@ -280,6 +282,11 @@ public class CellDesignerRnaRegion implements Serializable { this.species = species; } + /** + * Creates model representation of {@link RnaRegion}. + * + * @return {@link RnaRegion} representing this object in a model + */ public RnaRegion createRnaRegionAlias() { RnaRegion result = new RnaRegion(); result.setIdRnaRegion(this.idRnaRegion); diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/fields/package-info.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/fields/package-info.java new file mode 100644 index 0000000000000000000000000000000000000000..aeacb0eda133269ffa24ea15b451f7ded862852d --- /dev/null +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/fields/package-info.java @@ -0,0 +1,5 @@ +/** + * This package contains internal CellDesigner structures describing some fields + * of the Species elements. + */ +package lcsb.mapviewer.converter.model.celldesigner.structure.fields; diff --git a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/package-info.java b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/package-info.java index 227adf6ee7b9cc32bbeaa6b981b6b2e6dbd90fe5..2248a314c6741f9748e9936d2bf76e002c568a2a 100644 --- a/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/package-info.java +++ b/converter-CellDesigner/src/main/java/lcsb/mapviewer/converter/model/celldesigner/structure/package-info.java @@ -1,7 +1,6 @@ -/** - * This package contains internal CellDesigner structures used in the xml to - * store some data. Structures from this package should be used only during - * convertion from/to CellDEsigner format. - */ -package lcsb.mapviewer.converter.model.celldesigner.structure; - +/** + * This package contains internal CellDesigner structures used in the xml to + * store some data. Structures from this package should be used only during + * convertion from/to CellDEsigner format. + */ +package lcsb.mapviewer.converter.model.celldesigner.structure; \ No newline at end of file diff --git a/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionFromXmlTest.java b/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionFromXmlTest.java index cc85c6f0e78271b8c71997230d171bc500191881..cb6b24155d85b63768cde78a311549c07a50a367 100644 --- a/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionFromXmlTest.java +++ b/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionFromXmlTest.java @@ -454,7 +454,7 @@ public class ReactionFromXmlTest extends CellDesignerTestFunctions { try { // test situation when createProperTypeReaction returns reaction of // unknown type - ReactionFromXml parser = new ReactionFromXml(elements) { + ReactionFromXml parser = new ReactionFromXml() { Reaction createProperTypeReaction(String type, Reaction result) throws UnknownReactionClassException { return result; } @@ -484,7 +484,7 @@ public class ReactionFromXmlTest extends CellDesignerTestFunctions { } } - ReactionFromXml parser = new ReactionFromXml(elements) { + ReactionFromXml parser = new ReactionFromXml() { Reaction createProperTypeReaction(String type, Reaction result) throws UnknownReactionClassException { return new NewReactionType(result); } @@ -506,7 +506,7 @@ public class ReactionFromXmlTest extends CellDesignerTestFunctions { // test situation when createOperatorsForTwoProductReaction encounter // reaction with two many base reactants - ReactionFromXml parser = new ReactionFromXml(elements) { + ReactionFromXml parser = new ReactionFromXml() { Reaction createProperTypeReaction(String type, Reaction result) throws UnknownReactionClassException { Reaction r = super.createProperTypeReaction(type, result); r.addReactant(new Reactant()); @@ -530,7 +530,7 @@ public class ReactionFromXmlTest extends CellDesignerTestFunctions { // test situation when createOperatorsForTwoProductReaction encounter // reaction with two many base products - ReactionFromXml parser = new ReactionFromXml(elements) { + ReactionFromXml parser = new ReactionFromXml() { Reaction createProperTypeReaction(String type, Reaction result) throws UnknownReactionClassException { Reaction r = super.createProperTypeReaction(type, result); r.addProduct(new Product()); @@ -562,7 +562,7 @@ public class ReactionFromXmlTest extends CellDesignerTestFunctions { } } - ReactionFromXml parser = new ReactionFromXml(elements) { + ReactionFromXml parser = new ReactionFromXml() { Reaction createProperTypeReaction(String type, Reaction result) throws UnknownReactionClassException { return new NewReactionType(result); } @@ -584,7 +584,7 @@ public class ReactionFromXmlTest extends CellDesignerTestFunctions { // test situation when createOperatorsForTwoReactantReaction encounter // reaction with two many base reactants - ReactionFromXml parser = new ReactionFromXml(elements) { + ReactionFromXml parser = new ReactionFromXml() { Reaction createProperTypeReaction(String type, Reaction result) throws UnknownReactionClassException { Reaction r = super.createProperTypeReaction(type, result); r.addReactant(new Reactant()); @@ -608,7 +608,7 @@ public class ReactionFromXmlTest extends CellDesignerTestFunctions { // test situation when createOperatorsForTwoReactantReaction encounter // reaction with two many base products - ReactionFromXml parser = new ReactionFromXml(elements) { + ReactionFromXml parser = new ReactionFromXml() { Reaction createProperTypeReaction(String type, Reaction result) throws UnknownReactionClassException { Reaction r = super.createProperTypeReaction(type, result); r.addProduct(new Product()); @@ -629,7 +629,7 @@ public class ReactionFromXmlTest extends CellDesignerTestFunctions { @Test public void testParseInvalidEditPointsString() throws Exception { try { - ReactionFromXml parser = new ReactionFromXml(elements); + ReactionFromXml parser = new ReactionFromXml(); parser.parseEditPointsString("1"); fail("Exception expected"); @@ -644,7 +644,7 @@ public class ReactionFromXmlTest extends CellDesignerTestFunctions { @Test public void testParseInvalidEditPointsString2() throws Exception { try { - ReactionFromXml parser = new ReactionFromXml(elements); + ReactionFromXml parser = new ReactionFromXml(); parser.parseEditPointsString("1,Infinity"); fail("Exception expected"); diff --git a/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionParserTests.java b/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionParserTests.java index b9b22b09e354dc56e86fc8ef05da06457ad4d53c..ff062411c0acd1cb89e20ffa79d4f063c59705e3 100644 --- a/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionParserTests.java +++ b/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/reaction/ReactionParserTests.java @@ -1551,7 +1551,7 @@ public class ReactionParserTests extends CellDesignerTestFunctions { sa1.setWidth(300.0); sa1.setHeight(400.0); model.addElement(sa1); - elements.addAlias(sa1, new CellDesignerGenericProtein("s1")); + elements.addModelElement(sa1, new CellDesignerGenericProtein("s1")); Species sa2 = new GenericProtein("sa2"); sa2.setX(1050.0); @@ -1559,7 +1559,7 @@ public class ReactionParserTests extends CellDesignerTestFunctions { sa2.setWidth(300.0); sa2.setHeight(450.0); model.addElement(sa2); - elements.addAlias(sa2, new CellDesignerGenericProtein("s2")); + elements.addModelElement(sa2, new CellDesignerGenericProtein("s2")); Species sa3 = new GenericProtein("sa3"); sa3.setX(600.0); @@ -1567,7 +1567,7 @@ public class ReactionParserTests extends CellDesignerTestFunctions { sa3.setWidth(300.0); sa3.setHeight(400.0); model.addElement(sa3); - elements.addAlias(sa3, new CellDesignerGenericProtein("s3")); + elements.addModelElement(sa3, new CellDesignerGenericProtein("s3")); Species sa4 = new GenericProtein("sa4"); sa4.setX(550.0); diff --git a/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/species/SpeciesMappingTest.java b/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/species/SpeciesMappingTest.java index c4a253098856018d5846816ee826b439d61602f2..2b76440dfc2b212ff4a10001562bac1ade80187f 100644 --- a/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/species/SpeciesMappingTest.java +++ b/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/species/SpeciesMappingTest.java @@ -51,7 +51,7 @@ public class SpeciesMappingTest { // mopdify one of the elements of SpeciesMapping so it will have invalid // implementation SpeciesMapping typeToModify = SpeciesMapping.ANTISENSE_RNA; - Class<? extends CellDesignerSpecies> clazz = typeToModify.getCellDesignerClazz(); + Class<? extends CellDesignerSpecies<?>> clazz = typeToModify.getCellDesignerClazz(); try { Field field = typeToModify.getClass().getDeclaredField("cellDesignerClazz"); diff --git a/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/structure/ElementTest.java b/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/structure/ElementTest.java index 6e000c3bcafb3af831fb2ceb967c282fe1cb9cc4..214e436b0aa4dd9bf87e50ac0081c78e0a93d6b8 100644 --- a/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/structure/ElementTest.java +++ b/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/structure/ElementTest.java @@ -18,8 +18,6 @@ import lcsb.mapviewer.common.exception.InvalidArgumentException; import lcsb.mapviewer.converter.model.celldesigner.CellDesignerTestFunctions; import lcsb.mapviewer.model.map.MiriamData; import lcsb.mapviewer.model.map.MiriamType; -import lcsb.mapviewer.model.map.model.Model; -import lcsb.mapviewer.model.map.model.ModelFullIndexed; public class ElementTest extends CellDesignerTestFunctions { Logger logger = Logger.getLogger(ElementTest.class); diff --git a/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/structure/ProteinTest.java b/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/structure/ProteinTest.java index 0ab3558eea0c50e343686212fe213a7dbffa29e4..8894d14ba9a3f1ef55304feb81f00affef9148a2 100644 --- a/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/structure/ProteinTest.java +++ b/converter-CellDesigner/src/test/java/lcsb/mapviewer/converter/model/celldesigner/structure/ProteinTest.java @@ -16,7 +16,6 @@ import org.mockito.Mockito; import lcsb.mapviewer.common.exception.NotImplementedException; import lcsb.mapviewer.converter.model.celldesigner.structure.fields.CellDesignerModificationResidue; import lcsb.mapviewer.model.map.species.GenericProtein; -import lcsb.mapviewer.model.map.species.Protein; public class ProteinTest { diff --git a/converter-SBGNML/src/main/java/lcsb/mapviewer/converter/model/sbgnml/SbgnmlXmlExporter.java b/converter-SBGNML/src/main/java/lcsb/mapviewer/converter/model/sbgnml/SbgnmlXmlExporter.java index f4664073978d6befb82847bd3014f59fec118336..c408b252ec46ad4dbd0e6197bca23debb212647c 100644 --- a/converter-SBGNML/src/main/java/lcsb/mapviewer/converter/model/sbgnml/SbgnmlXmlExporter.java +++ b/converter-SBGNML/src/main/java/lcsb/mapviewer/converter/model/sbgnml/SbgnmlXmlExporter.java @@ -80,6 +80,9 @@ import lcsb.mapviewer.modelutils.map.ElementUtils; */ public class SbgnmlXmlExporter { + /** + * Helps in providing human readable identifiers of elements for logging. + */ private ElementUtils eu = new ElementUtils(); /** diff --git a/converter-SBGNML/src/main/java/lcsb/mapviewer/converter/model/sbgnml/SbgnmlXmlParser.java b/converter-SBGNML/src/main/java/lcsb/mapviewer/converter/model/sbgnml/SbgnmlXmlParser.java index 913e639749cf5a4171f13e879a67fe6c81b1c28d..f5dbf5eb9b96740e642987e4913e189aeb92b807 100644 --- a/converter-SBGNML/src/main/java/lcsb/mapviewer/converter/model/sbgnml/SbgnmlXmlParser.java +++ b/converter-SBGNML/src/main/java/lcsb/mapviewer/converter/model/sbgnml/SbgnmlXmlParser.java @@ -60,7 +60,6 @@ import lcsb.mapviewer.model.map.reaction.type.ReducedPhysicalStimulationReaction import lcsb.mapviewer.model.map.reaction.type.ReducedTriggerReaction; import lcsb.mapviewer.model.map.reaction.type.StateTransitionReaction; import lcsb.mapviewer.model.map.reaction.type.UnknownTransitionReaction; -import lcsb.mapviewer.model.map.species.Element; import lcsb.mapviewer.model.map.species.Complex; import lcsb.mapviewer.model.map.species.Degraded; import lcsb.mapviewer.model.map.species.Gene; @@ -637,27 +636,27 @@ public class SbgnmlXmlParser { * @param model * model to be updated */ - private void parseAlias(Glyph g, Species newAlias, Model model) { - newAlias.setHeight(new Double(g.getBbox().getH())); - newAlias.setWidth(new Double(g.getBbox().getW())); - newAlias.setX(new Double(g.getBbox().getX())); - newAlias.setY(new Double(g.getBbox().getY())); + private void parseAlias(Glyph g, Species newSpecies, Model model) { + newSpecies.setHeight(new Double(g.getBbox().getH())); + newSpecies.setWidth(new Double(g.getBbox().getW())); + newSpecies.setX(new Double(g.getBbox().getX())); + newSpecies.setY(new Double(g.getBbox().getY())); if (g.getCompartmentRef() != null) { Glyph compartmentGlyph = (Glyph) g.getCompartmentRef(); Compartment compartmentAlias = model.getElementByElementId(compartmentGlyph.getId()); - newAlias.setCompartment(compartmentAlias); - compartmentAlias.addElement(newAlias); - } else if (newAlias.getComplex() == null) { + newSpecies.setCompartment(compartmentAlias); + compartmentAlias.addElement(newSpecies); + } else if (newSpecies.getComplex() == null) { // If the alias is in any compartment, assign it to that compartment for (Compartment compartmentAlias : model.getCompartments()) { - boolean dx1 = compartmentAlias.getX() + compartmentAlias.getWidth() - newAlias.getX() >= 0; - boolean dx2 = compartmentAlias.getX() - (newAlias.getX() + newAlias.getWidth()) <= 0; - boolean dy1 = compartmentAlias.getY() + compartmentAlias.getHeight() - newAlias.getY() >= 0; - boolean dy2 = compartmentAlias.getY() - (newAlias.getY() + newAlias.getHeight()) <= 0; + boolean dx1 = compartmentAlias.getX() + compartmentAlias.getWidth() - newSpecies.getX() >= 0; + boolean dx2 = compartmentAlias.getX() - (newSpecies.getX() + newSpecies.getWidth()) <= 0; + boolean dy1 = compartmentAlias.getY() + compartmentAlias.getHeight() - newSpecies.getY() >= 0; + boolean dy2 = compartmentAlias.getY() - (newSpecies.getY() + newSpecies.getHeight()) <= 0; if (dx1 && dx2 && dy1 && dy2) { - newAlias.setCompartment(compartmentAlias); - compartmentAlias.addElement(newAlias); + newSpecies.setCompartment(compartmentAlias); + compartmentAlias.addElement(newSpecies); } } } @@ -665,11 +664,11 @@ public class SbgnmlXmlParser { // Parse units of information for (Glyph child : g.getGlyph()) { if (GlyphClazz.fromClazz(child.getClazz()).equals(GlyphClazz.UNIT_OF_INFORMATION)) { - parseUnitOfInformation(child, newAlias); + parseUnitOfInformation(child, newSpecies); } } - model.addElement(newAlias); + model.addElement(newSpecies); } /** diff --git a/converter-graphics/src/main/java/lcsb/mapviewer/converter/graphics/species/ProteinConverter.java b/converter-graphics/src/main/java/lcsb/mapviewer/converter/graphics/species/ProteinConverter.java index 60d826079576c3520910e84811d00bdfe0a86e90..4940e5d439bfb89945ccdecee6ba3fb5ad8f49df 100644 --- a/converter-graphics/src/main/java/lcsb/mapviewer/converter/graphics/species/ProteinConverter.java +++ b/converter-graphics/src/main/java/lcsb/mapviewer/converter/graphics/species/ProteinConverter.java @@ -58,6 +58,9 @@ public class ProteinConverter extends SpeciesConverter<Protein> { */ private static Logger logger = Logger.getLogger(ProteinConverter.class.getName()); + /** + * Helps in providing human readable identifiers of elements for logging. + */ private ElementUtils eu = new ElementUtils(); /** diff --git a/pathvisio/src/main/java/lcsb/mapviewer/wikipathway/XML/ModelToGPML.java b/pathvisio/src/main/java/lcsb/mapviewer/wikipathway/XML/ModelToGPML.java index b63e8970efd216abb5a64b5debcd45a3f5fe26b6..83355856444bdb59b0bf7e60f3623c537831ca1c 100644 --- a/pathvisio/src/main/java/lcsb/mapviewer/wikipathway/XML/ModelToGPML.java +++ b/pathvisio/src/main/java/lcsb/mapviewer/wikipathway/XML/ModelToGPML.java @@ -21,11 +21,11 @@ import lcsb.mapviewer.model.map.reaction.Product; import lcsb.mapviewer.model.map.reaction.Reactant; import lcsb.mapviewer.model.map.reaction.Reaction; import lcsb.mapviewer.model.map.reaction.ReactionNode; -import lcsb.mapviewer.model.map.species.Element; import lcsb.mapviewer.model.map.species.AntisenseRna; import lcsb.mapviewer.model.map.species.Complex; import lcsb.mapviewer.model.map.species.Degraded; import lcsb.mapviewer.model.map.species.Drug; +import lcsb.mapviewer.model.map.species.Element; import lcsb.mapviewer.model.map.species.Gene; import lcsb.mapviewer.model.map.species.Ion; import lcsb.mapviewer.model.map.species.Phenotype; @@ -364,7 +364,8 @@ public class ModelToGPML { interaction.append(" <Point X=\"" + ps.getX() + "\" Y=\"" + ps.getY() + "\" GraphRef=\"" + anchId + "\"/>\n"); } else if (p2d.equals(pe)) { interaction.append( - " <Point X=\"" + pe.getX() + "\" Y=\"" + pe.getY() + "\" GraphRef=\"" + rn.getElement().getElementId() + "\" ArrowHead=\"mim-conversion\"/>\n"); + " <Point X=\"" + pe.getX() + "\" Y=\"" + pe.getY() + "\" GraphRef=\"" + rn.getElement().getElementId() + + "\" ArrowHead=\"mim-conversion\"/>\n"); } else { interaction.append(" <Point X=\"" + p2d.getX() + "\" Y=\"" + p2d.getY() + "\"/>\n"); } diff --git a/reactome/src/main/java/lcsb/mapviewer/reactome/utils/DataFormatter.java b/reactome/src/main/java/lcsb/mapviewer/reactome/utils/DataFormatter.java index 6bd52eb98f8c5a4c0556cdfcb77ad7a1fa67d3d4..a21596815a7af72d5e5b80ac68eec6bee8461762 100644 --- a/reactome/src/main/java/lcsb/mapviewer/reactome/utils/DataFormatter.java +++ b/reactome/src/main/java/lcsb/mapviewer/reactome/utils/DataFormatter.java @@ -1,6 +1,5 @@ package lcsb.mapviewer.reactome.utils; -import java.io.IOException; import java.util.HashSet; import java.util.List; import java.util.Set; @@ -11,8 +10,8 @@ import org.springframework.beans.factory.annotation.Autowired; import lcsb.mapviewer.annotation.services.MiriamConnector; import lcsb.mapviewer.annotation.services.annotators.AnnotatorException; import lcsb.mapviewer.model.map.MiriamData; -import lcsb.mapviewer.model.map.species.Element; import lcsb.mapviewer.model.map.species.Complex; +import lcsb.mapviewer.model.map.species.Element; import lcsb.mapviewer.reactome.model.ReactomeCatalystActivity; import lcsb.mapviewer.reactome.model.ReactomeDatabaseObject; import lcsb.mapviewer.reactome.model.ReactomePhysicalEntity; @@ -51,10 +50,11 @@ public class DataFormatter { * @param list * Species to transform * @return human readable String representation of the linput Species list - * @throws IOException * @throws AnnotatorException + * thrown when there is a problem accessing external annotation + * service */ - private String speciesListToString(List<Element> list) throws IOException, AnnotatorException { + private String speciesListToString(List<Element> list) throws AnnotatorException { String result = ""; for (Element species : list) { if (!result.equals("")) { @@ -108,10 +108,11 @@ public class DataFormatter { * @param result * MatchResult to process. * @return human readable String representing invalid local inputs - * @throws IOException * @throws AnnotatorException + * thrown when there is a problem accessing external annotation + * service */ - public String getInvalidLocalInputString(MatchResult result) throws IOException, AnnotatorException { + public String getInvalidLocalInputString(MatchResult result) throws AnnotatorException { return speciesListToString(result.getInvalidLocalInput()); } @@ -121,10 +122,11 @@ public class DataFormatter { * @param result * MatchResult to process. * @return human readable String representing invalid local output - * @throws IOException * @throws AnnotatorException + * thrown when there is a problem accessing external annotation + * service */ - public String getInvalidLocalOutputString(MatchResult result) throws IOException, AnnotatorException { + public String getInvalidLocalOutputString(MatchResult result) throws AnnotatorException { return speciesListToString(result.getInvalidLocalOutput()); } @@ -134,10 +136,11 @@ public class DataFormatter { * @param result * MatchResult to process. * @return human readable String representing invalid local modifiers - * @throws IOException * @throws AnnotatorException + * thrown when there is a problem accessing external annotation + * service */ - public String getInvalidLocalModifierString(MatchResult result) throws IOException, AnnotatorException { + public String getInvalidLocalModifierString(MatchResult result) throws AnnotatorException { return speciesListToString(result.getInvalidLocalModifier()); } diff --git a/reactome/src/main/java/lcsb/mapviewer/reactome/utils/ElementUtil.java b/reactome/src/main/java/lcsb/mapviewer/reactome/utils/ElementUtil.java index e0d388081f08d78c2f9c9fcbd28e9379df5534d1..f8bb0ad229124dd544d300037d99778d8c4263fe 100644 --- a/reactome/src/main/java/lcsb/mapviewer/reactome/utils/ElementUtil.java +++ b/reactome/src/main/java/lcsb/mapviewer/reactome/utils/ElementUtil.java @@ -26,6 +26,13 @@ import lcsb.mapviewer.modelutils.map.ElementUtils; */ public class ElementUtil { + /** + * Returns human readable id of the element from paramter. + * + * @param element + * element to be identified + * @return human readable id of the element from paramter + */ public String getElementTag(AnnotatedObject element) { return new ElementUtils().getElementTag(element); } diff --git a/reactome/src/main/java/lcsb/mapviewer/reactome/utils/ReactionComparator.java b/reactome/src/main/java/lcsb/mapviewer/reactome/utils/ReactionComparator.java index c6e710375c882574489ef1f2b1e25ad9209611b0..2075c95384af374854e41020db3c5804fe326398 100644 --- a/reactome/src/main/java/lcsb/mapviewer/reactome/utils/ReactionComparator.java +++ b/reactome/src/main/java/lcsb/mapviewer/reactome/utils/ReactionComparator.java @@ -52,6 +52,9 @@ public class ReactionComparator { * @return resul of reaction comparison. For more details see: * {@link MatchResult} * @throws ComparatorException + * thrown when there is a problem with comparison {@link Reaction} + * with Reactome object + * */ public MatchResult compareReactions(Reaction reaction, ReactomeReactionlikeEvent reactomeReaction) throws ComparatorException { MatchResult result = new MatchResult(); diff --git a/reactome/src/main/java/lcsb/mapviewer/reactome/utils/ReactomeQueryUtil.java b/reactome/src/main/java/lcsb/mapviewer/reactome/utils/ReactomeQueryUtil.java index 2a7c77ff9065027a44c47b5b63ed3f3451b784ec..e73db35d17601f3e32b4b1cba9f838c53166f31d 100644 --- a/reactome/src/main/java/lcsb/mapviewer/reactome/utils/ReactomeQueryUtil.java +++ b/reactome/src/main/java/lcsb/mapviewer/reactome/utils/ReactomeQueryUtil.java @@ -3,6 +3,7 @@ package lcsb.mapviewer.reactome.utils; import java.io.IOException; import java.util.ArrayList; import java.util.Collection; +import java.util.Collections; import java.util.HashMap; import java.util.HashSet; import java.util.List; @@ -23,9 +24,9 @@ import lcsb.mapviewer.model.map.MiriamRelationType; import lcsb.mapviewer.model.map.MiriamType; import lcsb.mapviewer.model.map.reaction.Reaction; import lcsb.mapviewer.model.map.reaction.ReactionNode; -import lcsb.mapviewer.model.map.species.Element; import lcsb.mapviewer.model.map.species.Chemical; import lcsb.mapviewer.model.map.species.Complex; +import lcsb.mapviewer.model.map.species.Element; import lcsb.mapviewer.model.map.species.Phenotype; import lcsb.mapviewer.model.map.species.Protein; import lcsb.mapviewer.model.map.species.Species; @@ -84,6 +85,13 @@ public class ReactomeQueryUtil { @Autowired private ChebiAnnotator chebiBackend; + /** + * Provides human readable id of element. + * + * @param element + * element for which we want id string. + * @return human readable id of element + */ public String getElementTag(AnnotatedObject element) { return new ElementUtils().getElementTag(element); } @@ -535,13 +543,13 @@ public class ReactomeQueryUtil { * @param complex * object for which identifiers are looked for * @return set of known identifiers - * @throws IOException + * + * @throws AnnotatorException * thrown when there is a problem accessing external annotation * service - * @throws AnnotatorException */ - public Set<MiriamData> getIdsForComplex(Complex complex) throws IOException, AnnotatorException { - Set<MiriamData> result = new HashSet<MiriamData>(); + public Set<MiriamData> getIdsForComplex(Complex complex) throws AnnotatorException { + Set<MiriamData> result = new HashSet<>(); for (Species species : complex.getAllSimpleChildren()) { result.addAll(getIdsForSpecies(species)); } @@ -554,17 +562,16 @@ public class ReactomeQueryUtil { * @param species * object for which identifiers are looked for * @return set of known identifiers - * @throws IOException + * @throws AnnotatorException * thrown when there is a problem accessing external annotation * service - * @throws AnnotatorException */ - public Set<MiriamData> getIdsForSpecies(Element species) throws IOException, AnnotatorException { + public Set<MiriamData> getIdsForSpecies(Element species) throws AnnotatorException { Set<MiriamData> result = new HashSet<>(); if (species instanceof Protein) { result.addAll(elementUtil.getMiriamByType(species, MiriamType.UNIPROT, true)); } else if (species instanceof Phenotype) { - return null; + return Collections.emptySet(); } else if (species instanceof Chemical) { result.addAll(elementUtil.getMiriamByType(species, MiriamType.CHEBI, true)); } else { diff --git a/reactome/src/main/java/lcsb/mapviewer/reactome/utils/comparators/ANodeComparator.java b/reactome/src/main/java/lcsb/mapviewer/reactome/utils/comparators/ANodeComparator.java index 6e8618289768bc3e6babd3916e9d55362f5b7982..a7bf80f52d8a5a4cae417dc6464164a3f0304eeb 100644 --- a/reactome/src/main/java/lcsb/mapviewer/reactome/utils/comparators/ANodeComparator.java +++ b/reactome/src/main/java/lcsb/mapviewer/reactome/utils/comparators/ANodeComparator.java @@ -35,32 +35,32 @@ public abstract class ANodeComparator<T extends Element, U extends ReactomeDatab /** * Default class logger. */ - private static Logger logger = Logger.getLogger(ANodeComparator.class); + private static Logger logger = Logger.getLogger(ANodeComparator.class); /** * Service used for annotation of proteins (and finding annotation of * proteins). */ @Autowired - private HgncAnnotator hgncAnnotator; + private HgncAnnotator hgncAnnotator; /** * Util object used for processing elements. */ @Autowired - private ElementUtil elementUtil; + private ElementUtil elementUtil; /** * Service accessing chebi database. */ @Autowired - private ChebiAnnotator chebiBackend; + private ChebiAnnotator chebiBackend; /** * This object allows to query reactome database for missing elements. */ @Autowired - private ReactomeQueryUtil rcu; + private ReactomeQueryUtil rcu; /** * Comparator that allows to compare everything with everything else. @@ -71,13 +71,13 @@ public abstract class ANodeComparator<T extends Element, U extends ReactomeDatab * Type of the object in internal representation for which the comparator is * designed for. */ - private Class<T> speciesClass; + private Class<T> speciesClass; /** * Type of the object in reactome representation for which the comparator is * designed for. */ - private Class<U> reactomeSpeciesClass; + private Class<U> reactomeSpeciesClass; /** * Default constructor. @@ -232,6 +232,13 @@ public abstract class ANodeComparator<T extends Element, U extends ReactomeDatab this.hgncAnnotator = hgncAnnotator; } + /** + * Returns short string description identifing element. + * + * @param element + * element to be transformed into string id + * @return short string description identifing element + */ public String getElementTag(AnnotatedObject element) { return new ElementUtils().getElementTag(element); }