org.metawidget.android.widget.Stub Maven / Gradle / Ivy
// Metawidget (licensed under LGPL)
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
package org.metawidget.android.widget;
import java.util.Map;
import org.metawidget.util.CollectionUtils;
import org.metawidget.util.simple.StringUtils;
import android.content.Context;
import android.util.AttributeSet;
import android.widget.LinearLayout;
/**
* Stub for Android environments.
*
* Stubs are used to 'stub out' what Metawidget would normally create - either to suppress widget
* creation entirely or to create child widgets with a different tag. They differ from Facets in
* that Facets are simply 'decorations' (such as button bars) to be recognized and arranged at the
* discretion of the Layout.
*
* This class supports setting additional metadata attributes (such as 'label') either
* programmatically (setAttribute) or through the Android XML. For the latter, the XML
* attribute name must begin with the prefix attrib, with the following letter
* uppercased (ie. attribLabel).
*
* Note: this class extends LinearLayout rather than FrameLayout, because
* FrameLayout would always need to have another Layout embedded
* within it, whereas LinearLayout is occasionally useful directly.
*
* @author Richard Kennard
*/
public class Stub
extends LinearLayout {
//
// Private statics
//
private static final String ATTRIBUTE_PREFIX = "attrib";
//
// Private members
//
private Map mAttributes;
//
// Constructor
//
public Stub( Context context ) {
super( context );
}
public Stub( Context context, AttributeSet attributes ) {
super( context, attributes );
setTag( attributes.getAttributeValue( null, "tag" ) );
// For each attribute...
for ( int loop = 0, length = attributes.getAttributeCount(); loop < length; loop++ ) {
// ...that looks like a stub attribute...
String name = attributes.getAttributeName( loop );
if ( !name.startsWith( ATTRIBUTE_PREFIX ) ) {
continue;
}
name = name.substring( ATTRIBUTE_PREFIX.length() );
if ( !Character.isUpperCase( name.charAt( 0 ) ) ) {
continue;
}
// ...remember it
String value = attributes.getAttributeValue( loop );
setAttribute( StringUtils.decapitalize( name ), value );
}
}
//
// Public methods
//
public void setAttribute( String name, String value ) {
if ( mAttributes == null ) {
mAttributes = CollectionUtils.newHashMap();
}
mAttributes.put( name, value );
}
public Map getAttributes() {
return mAttributes;
}
}