All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.phloc.schematron.pure.model.PSP Maven / Gradle / Ivy

The newest version!
/**
 * Copyright (C) 2014 phloc systems
 * http://www.phloc.com
 * office[at]phloc[dot]com
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *         http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.phloc.schematron.pure.model;

import java.util.ArrayList;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;

import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import javax.annotation.concurrent.NotThreadSafe;

import com.phloc.commons.ValueEnforcer;
import com.phloc.commons.annotations.Nonempty;
import com.phloc.commons.annotations.ReturnsMutableCopy;
import com.phloc.commons.collections.ContainerHelper;
import com.phloc.commons.log.InMemoryLogger;
import com.phloc.commons.microdom.IMicroElement;
import com.phloc.commons.microdom.impl.MicroElement;
import com.phloc.commons.string.StringHelper;
import com.phloc.commons.string.ToStringGenerator;
import com.phloc.schematron.CSchematron;
import com.phloc.schematron.CSchematronXML;

/**
 * A single Schematron p-element.
* A paragraph of natural language text containing maintainer and user * information about the parent element. The schema can nominate paragraphs that * should be rendered in a distinct way, keyed with the class attribute.
* An implementation is not required to make use of this element. * * @author Philip Helger */ @NotThreadSafe public class PSP implements IPSElement, IPSOptionalElement, IPSHasForeignElements, IPSHasMixedContent, IPSHasID { private String m_sID; private String m_sClass; private String m_sIcon; private final List m_aContent = new ArrayList (); private Map m_aForeignAttrs; private List m_aForeignElements; public PSP () {} public boolean isValid (@Nonnull final InMemoryLogger aLogger) { for (final Object aContent : m_aContent) if (aContent instanceof IPSElement) if (!((IPSElement) aContent).isValid (aLogger)) return false; return true; } public boolean isMinimal () { return false; } public void addForeignElement (@Nonnull final IMicroElement aForeignElement) { ValueEnforcer.notNull (aForeignElement, "ForeignElement"); if (aForeignElement.hasParent ()) throw new IllegalArgumentException ("ForeignElement already has a parent!"); if (m_aForeignElements == null) m_aForeignElements = new ArrayList (); m_aForeignElements.add (aForeignElement); } public void addForeignElements (@Nonnull final List aForeignElements) { ValueEnforcer.notNull (aForeignElements, "ForeignElements"); for (final IMicroElement aForeignElement : aForeignElements) addForeignElement (aForeignElement); } public boolean hasForeignElements () { return m_aForeignElements != null && !m_aForeignElements.isEmpty (); } @Nonnull @ReturnsMutableCopy public List getAllForeignElements () { return ContainerHelper.newList (m_aForeignElements); } public void addForeignAttribute (@Nonnull final String sAttrName, @Nonnull final String sAttrValue) { ValueEnforcer.notNull (sAttrName, "AttrName"); ValueEnforcer.notNull (sAttrValue, "AttrValue"); if (m_aForeignAttrs == null) m_aForeignAttrs = new LinkedHashMap (); m_aForeignAttrs.put (sAttrName, sAttrValue); } public void addForeignAttributes (@Nonnull final Map aForeignAttrs) { ValueEnforcer.notNull (aForeignAttrs, "ForeignAttrs"); for (final Map.Entry aEntry : aForeignAttrs.entrySet ()) addForeignAttribute (aEntry.getKey (), aEntry.getValue ()); } public boolean hasForeignAttributes () { return m_aForeignAttrs != null && !m_aForeignAttrs.isEmpty (); } @Nonnull @ReturnsMutableCopy public Map getAllForeignAttributes () { return ContainerHelper.newOrderedMap (m_aForeignAttrs); } public void setID (@Nullable final String sID) { m_sID = sID; } public boolean hasID () { return m_sID != null; } @Nullable public String getID () { return m_sID; } public void setClazz (@Nullable final String sClass) { m_sClass = sClass; } @Nullable public String getClazz () { return m_sClass; } public void setIcon (@Nullable final String sIcon) { m_sIcon = sIcon; } @Nullable public String getIcon () { return m_sIcon; } public void addText (@Nonnull @Nonempty final String sText) { ValueEnforcer.notEmpty (sText, "Text"); m_aContent.add (sText); } public boolean hasAnyText () { for (final Object aElement : m_aContent) if (aElement instanceof String) return true; return false; } @Nonnull @ReturnsMutableCopy public List getAllTexts () { final List ret = new ArrayList (); for (final Object aElement : m_aContent) if (aElement instanceof String) ret.add ((String) aElement); return ret; } @Nullable public String getText () { return StringHelper.getImploded ("", m_aContent); } public void addDir (@Nonnull final PSDir aDir) { ValueEnforcer.notNull (aDir, "Dir"); m_aContent.add (aDir); } @Nonnull @ReturnsMutableCopy public List getAllDirs () { final List ret = new ArrayList (); for (final Object aElement : m_aContent) if (aElement instanceof PSDir) ret.add ((PSDir) aElement); return ret; } public void addEmph (@Nonnull final PSEmph aEmph) { if (aEmph == null) throw new NullPointerException ("Emph"); m_aContent.add (aEmph); } @Nonnull @ReturnsMutableCopy public List getAllEmphs () { final List ret = new ArrayList (); for (final Object aElement : m_aContent) if (aElement instanceof PSEmph) ret.add ((PSEmph) aElement); return ret; } public void addSpan (@Nonnull final PSSpan aSpan) { ValueEnforcer.notNull (aSpan, "Span"); m_aContent.add (aSpan); } @Nonnull @ReturnsMutableCopy public List getAllSpans () { final List ret = new ArrayList (); for (final Object aElement : m_aContent) if (aElement instanceof PSSpan) ret.add ((PSSpan) aElement); return ret; } /** * @return A list of {@link String}, {@link PSDir}, {@link PSEmph} and * {@link PSSpan} elements. */ @Nonnull @ReturnsMutableCopy public List getAllContentElements () { return ContainerHelper.newList (m_aContent); } @Nonnull public IMicroElement getAsMicroElement () { final IMicroElement ret = new MicroElement (CSchematron.NAMESPACE_SCHEMATRON, CSchematronXML.ELEMENT_P); ret.setAttribute (CSchematronXML.ATTR_ID, m_sID); ret.setAttribute (CSchematronXML.ATTR_CLASS, m_sClass); ret.setAttribute (CSchematronXML.ATTR_ICON, m_sIcon); if (m_aForeignElements != null) for (final IMicroElement aForeignElement : m_aForeignElements) ret.appendChild (aForeignElement.getClone ()); for (final Object aContent : m_aContent) if (aContent instanceof String) ret.appendText ((String) aContent); else ret.appendChild (((IPSElement) aContent).getAsMicroElement ()); if (m_aForeignAttrs != null) for (final Map.Entry aEntry : m_aForeignAttrs.entrySet ()) ret.setAttribute (aEntry.getKey (), aEntry.getValue ()); return ret; } @Override public String toString () { return new ToStringGenerator (this).appendIfNotNull ("id", m_sID) .appendIfNotNull ("class", m_sClass) .appendIfNotNull ("icon", m_sIcon) .append ("content", m_aContent) .appendIfNotNull ("foreignAttrs", m_aForeignAttrs) .appendIfNotNull ("foreignElements", m_aForeignElements) .toString (); } }