1 /* 2 * JBoss, Home of Professional Open Source 3 * Copyright 2005, JBoss Inc., and individual contributors as indicated 4 * by the @authors tag. See the copyright.txt in the distribution for a 5 * full listing of individual contributors. 6 * 7 * This is free software; you can redistribute it and/or modify it 8 * under the terms of the GNU Lesser General Public License as 9 * published by the Free Software Foundation; either version 2.1 of 10 * the License, or (at your option) any later version. 11 * 12 * This software is distributed in the hope that it will be useful, 13 * but WITHOUT ANY WARRANTY; without even the implied warranty of 14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 15 * Lesser General Public License for more details. 16 * 17 * You should have received a copy of the GNU Lesser General Public 18 * License along with this software; if not, write to the Free 19 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 20 * 02110-1301 USA, or see the FSF site: http://www.fsf.org. 21 */ 22 package org.jboss.system; 23 24 import javax.management.NotificationFilter; 25 26 import org.w3c.dom.Element; 27 28 /** 29 * Abstracts NotificationFilter creation based on an arbritrary 30 * xml element fragment. Used by ListenerServiceMBeanSupport 31 * to enable NotificationFilterFactory plugins. 32 * 33 * @see ListenerServiceMBeanSupport 34 * 35 * @author <a HREF="mailto:dimitris@jboss.org">Dimitris Andreadis</a> 36 * @version $Revision: 57108 $ 37 **/ 38 public interface NotificationFilterFactory 39 { 40 /** 41 * Create a notification filter implementation and initialize 42 * it, using the passed xml element fragment. 43 * 44 * @param filterConfig the xml fragment to use for configuring the filter 45 * @return an initialized NotificationFilter 46 * @throws Exception in case the xml fragment cannot be parsed properly 47 */ 48 public NotificationFilter createNotificationFilter(Element filterConfig) 49 throws Exception; 50 } 51