org.metawidget.statically.BaseStaticXmlWidget Maven / Gradle / Ivy
// Metawidget
//
// This file is dual licensed under both the LGPL
// (http://www.gnu.org/licenses/lgpl-2.1.html) and the EPL
// (http://www.eclipse.org/org/documents/epl-v10.php). As a
// recipient of Metawidget, you may choose to receive it under either
// the LGPL or the EPL.
//
// Commercial licenses are also available. See http://metawidget.org
// for details.
package org.metawidget.statically;
import java.io.IOException;
import java.io.Writer;
import java.util.Map;
import org.metawidget.statically.StaticUtils.IndentedWriter;
import org.metawidget.statically.StaticUtils.LeadingSpaceWriter;
import org.metawidget.util.CollectionUtils;
import org.metawidget.util.simple.StringUtils;
/**
* @author Richard Kennard
*/
public abstract class BaseStaticXmlWidget
extends BaseStaticWidget
implements StaticXmlWidget {
//
// Private members
//
private String mPrefix;
private String mTagName;
private String mNamespaceURI;
private Map mAttributes;
private String mTextContent;
private Map mAdditionalNamespaceURIs;
//
// Constructor
//
/**
* @param prefix
* the namespace prefix of this tag, or null if it is unspecified
* @param tagName
* the name of this tag
* @param namespaceURI
* the namespace URI for this tag, or null if it is unspecified
*/
protected BaseStaticXmlWidget( String prefix, String tagName, String namespaceURI ) {
mPrefix = prefix;
mTagName = tagName;
mNamespaceURI = namespaceURI;
}
//
// Public methods
//
/**
* Gets the namespace prefix of this tag, or null if it is unspecified
*/
public String getPrefix() {
return mPrefix;
}
/**
* Gets the namespace URI for this tag, or null if it is unspecified.
*/
public String getNamespaceURI() {
return mNamespaceURI;
}
public String getAttribute( String name ) {
if ( mAttributes == null ) {
return null;
}
return mAttributes.get( name );
}
public void putAttribute( String name, String value ) {
if ( mAttributes == null ) {
// (use TreeMap for consistent unit tests)
mAttributes = CollectionUtils.newTreeMap();
}
mAttributes.put( name, value );
}
public String getTextContent() {
return mTextContent;
}
public void setTextContent( String textContent ) {
mTextContent = textContent;
}
public Map getAdditionalNamespaceURIs() {
return mAdditionalNamespaceURIs;
}
public void putAdditionalNamespaceURI( String prefix, String uri ) {
if ( mAdditionalNamespaceURIs == null ) {
mAdditionalNamespaceURIs = CollectionUtils.newHashMap();
}
mAdditionalNamespaceURIs.put( prefix, uri );
}
@Override
public void write( Writer writer )
throws IOException {
if ( getChildren().isEmpty() ) {
writeStartTag( writer );
// Non-indented text content
if ( !isSelfClosing() ) {
if ( mTagName != null ) {
writer.append( ">" );
}
if ( mTextContent != null ) {
writer.append( mTextContent );
}
if ( writer instanceof IndentedWriter ) {
( (IndentedWriter) writer ).indent();
}
writeEndTag( writer );
} else {
if ( mTagName != null ) {
writer.append( "/>" );
}
if ( writer instanceof IndentedWriter ) {
writer.append( "\r\n" );
}
}
} else {
writeStartTag( writer );
if ( mTagName != null ) {
writer.append( ">" );
}
if ( writer instanceof IndentedWriter ) {
writer.append( "\r\n" );
( (IndentedWriter) writer ).indent();
}
super.write( writer );
// Indented text content
if ( getTextContent() != null && getTextContent().length() > 0 ) {
writer.append( mTextContent );
if ( writer instanceof IndentedWriter ) {
writer.append( "\r\n" );
}
}
writeEndTag( writer );
}
}
//
// Protected methods
//
/**
* Writes the attribute with the given name and value to the given writer.
*
* By default, does not write attributes whose value is null (does write empty values,
* which is important for <option value=""/>). Subclasses can override this
* method to suppress writing attributes for other reasons.
*
*/
protected void writeAttribute( Writer writer, String name, String value )
throws IOException {
if ( value == null ) {
return;
}
writer.append( name );
writer.append( "=\"" );
writer.append( value );
writer.append( "\"" );
}
/**
* Returns true if this widget is self closing (i.e. will be written as <foo/> rather than
* <foo></foo>).
*
* @return true if this widget is self closing.
*/
protected boolean isSelfClosing() {
return getTextContent() == null || getTextContent().length() == 0;
}
//
// Private methods
//
private void writeStartTag( Writer writer )
throws IOException {
if ( mTagName == null ) {
return;
}
writer.append( '<' );
if ( mPrefix != null ) {
writer.append( mPrefix );
writer.append( StringUtils.SEPARATOR_COLON_CHAR );
}
writer.append( mTagName );
if ( mAttributes != null ) {
for ( Map.Entry entry : mAttributes.entrySet() ) {
writeAttribute( new LeadingSpaceWriter( writer ), entry.getKey(), entry.getValue() );
}
}
}
private void writeEndTag( Writer writer )
throws IOException {
if ( mTagName == null ) {
return;
}
if ( writer instanceof IndentedWriter ) {
( (IndentedWriter) writer ).outdent();
}
writer.append( "" );
if ( writer instanceof IndentedWriter ) {
writer.append( "\r\n" );
}
}
}