/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.
*
* $Header:$
*/
package org.apache.beehive.controls.runtime.generator;
import java.util.Collection;
import java.util.HashMap;
import java.util.Iterator;
import com.sun.mirror.declaration.FieldDeclaration;
import com.sun.mirror.declaration.TypeDeclaration;
import com.sun.mirror.declaration.TypeParameterDeclaration;
import com.sun.mirror.type.DeclaredType;
import com.sun.mirror.type.ReferenceType;
import com.sun.mirror.type.TypeMirror;
/**
* The AptEventField class represents a field type that is also an event source
*/
abstract public class AptEventField extends AptField
{
public AptEventField(FieldDeclaration fieldDecl)
{
super(fieldDecl);
}
/**
* Inits the ControlInterface associated with this event field. The public interface
* for controls and contextual services, and their associated events can be modeled in the
* same way. Subclasses will override this to assign an appropriate interface.
*/
abstract protected AptControlInterface initControlInterface();
/**
* Computes the binding from any formal type parameters declared on the control interface
* to bound types on the field declaration.
*/
private void initTypeParameterBindings()
{
//
// Get an iterator to both the declared type arguments and the original type
// declaration on the associated control interface
//
DeclaredType fieldType = (DeclaredType)_fieldDecl.getType();
Iterator<TypeMirror> paramBoundIter = fieldType.getActualTypeArguments().iterator();
TypeDeclaration intfDecl = (TypeDeclaration)_controlIntf.getTypeDeclaration();
Iterator<TypeParameterDeclaration> paramDeclIter =
intfDecl.getFormalTypeParameters().iterator();
//
// Iterate through them in parallel, creating a mapping from the original formal
// type parameter name to the actual bound type. In parallel, also build up a
// representation of the bound type declaration.
//
// NOTE: If no type binding is done on the field declaration, then loop below
// will not execute and no mappings/empty bound decl will be the result.
//
StringBuffer sb = new StringBuffer();
boolean isFirst = true;
while (paramBoundIter.hasNext())
{
TypeMirror paramBound = paramBoundIter.next();
TypeParameterDeclaration paramDecl = paramDeclIter.next();
//
// Save a mapping from the formal type name to the bound mirror type
//
_typeBindingMap.put(paramDecl.getSimpleName(), paramBound);
if (isFirst)
{
sb.append("<");
isFirst = false;
}
else
sb.append(", ");
sb.append(paramBound);
}
if (!isFirst)
sb.append(">");
_boundParameterDecl = sb.toString();
}
/**
* Returns the ControlInterface associated with this event field
*/
public AptControlInterface getControlInterface()
{
if (_controlIntf == null)
{
_controlIntf = initControlInterface();
if (_controlIntf != null)
initTypeParameterBindings();
}
return _controlIntf;
}
/**
* Gets the EventAdaptor for a particular EventSet
*/
public EventAdaptor getEventAdaptor(AptEventSet eventSet)
{
return _eventAdaptors.get(eventSet);
}
/**
* Adds a EventAdaptor for a particular EventSet
*/
public void addEventAdaptor(AptEventSet eventSet, EventAdaptor eventAdaptor)
{
assert !_eventAdaptors.containsKey(eventSet);
_eventAdaptors.put(eventSet, eventAdaptor);
}
/**
* Returns all EventAdaptors for this EventField
*/
public Collection<EventAdaptor> getEventAdaptors()
{
return _eventAdaptors.values();
}
/**
* Returns the bound parameter declaration for this event field
*/
public String getBoundParameters()
{
return _boundParameterDecl;
}
/**
* Returns the formal type binding map (from name to bound type) for the event field
*/
public HashMap<String, TypeMirror> getTypeBindingMap()
{
return _typeBindingMap;
}
HashMap<AptEventSet, EventAdaptor> _eventAdaptors =
new HashMap<AptEventSet, EventAdaptor>();
String _boundParameterDecl;
HashMap<String,TypeMirror> _typeBindingMap = new HashMap<String,TypeMirror>();
private AptControlInterface _controlIntf;
}