| /* |
| * 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. |
| */ |
| package org.apache.felix.ipojo.handler.wbp; |
| |
| import java.util.ArrayList; |
| import java.util.Dictionary; |
| import java.util.List; |
| |
| import org.apache.felix.ipojo.ConfigurationException; |
| import org.apache.felix.ipojo.PrimitiveHandler; |
| import org.apache.felix.ipojo.metadata.Element; |
| import org.osgi.framework.InvalidSyntaxException; |
| |
| /** |
| * White board pattern handler. |
| * This handler aims to automate white board patterns by invoking callback when needed. |
| * @author <a href="mailto:dev@felix.apache.org">Felix Project Team</a> |
| */ |
| public class WhiteBoardPatternHandler extends PrimitiveHandler { |
| |
| /** |
| * The handler namespace. |
| */ |
| public static final String NAMESPACE = "org.apache.felix.ipojo.whiteboard"; |
| |
| /** |
| * The white board pattern to manage. By default just one. |
| */ |
| private List m_managers = new ArrayList(1); |
| |
| /** |
| * Configure method. Parses the metadata to analyze white-board-pattern elements. |
| * @param elem the component type description |
| * @param dict the instance description |
| * @throws ConfigurationException if the description is not valid. |
| * @see org.apache.felix.ipojo.Handler#configure(org.apache.felix.ipojo.metadata.Element, java.util.Dictionary) |
| */ |
| public void configure(Element elem, Dictionary dict) throws ConfigurationException { |
| Element[] elems = elem.getElements("wbp", NAMESPACE); |
| for (int i = 0; i < elems.length; i++) { |
| String filter = elems[i].getAttribute("filter"); |
| String onArrival = elems[i].getAttribute("onArrival"); |
| String onDeparture = elems[i].getAttribute("onDeparture"); |
| String onModification = elems[i].getAttribute("onModification"); |
| |
| if (filter == null) { |
| throw new ConfigurationException("The white board pattern element requires a filter attribute"); |
| } |
| if (onArrival == null || onDeparture == null) { |
| throw new ConfigurationException("The white board pattern element requires the onArrival and onDeparture attributes"); |
| } |
| |
| try { |
| WhiteBoardManager wbm = new WhiteBoardManager(this, getInstanceManager().getContext().createFilter(filter), onArrival, onDeparture, onModification); |
| m_managers.add(wbm); |
| } catch (InvalidSyntaxException e) { |
| throw new ConfigurationException("The filter " + filter + " is invalid : " + e); |
| } |
| } |
| |
| } |
| |
| /** |
| * Start method. Starts managers. |
| * @see org.apache.felix.ipojo.Handler#start() |
| */ |
| public void start() { |
| for (int i = 0; i < m_managers.size(); i++) { |
| ((WhiteBoardManager) m_managers.get(i)).start(); |
| } |
| } |
| |
| /** |
| * Stop method. Stops managers. |
| * @see org.apache.felix.ipojo.Handler#stop() |
| */ |
| public void stop() { |
| for (int i = 0; i < m_managers.size(); i++) { |
| ((WhiteBoardManager) m_managers.get(i)).stop(); |
| } |
| } |
| |
| } |