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.deployment.spi; 23 24 import java.beans.PropertyChangeListener; 25 26 import javax.enterprise.deploy.model.DDBean; 27 import javax.enterprise.deploy.model.XpathEvent; 28 import javax.enterprise.deploy.spi.DConfigBean; 29 import javax.enterprise.deploy.spi.exceptions.BeanNotFoundException; 30 import javax.enterprise.deploy.spi.exceptions.ConfigurationException; 31 32 /** 33 * The DConfigBean is a deployment configuration bean (DConfigBean) that is associated 34 * with one or more deployment descriptor beans, (DDBean). 35 * A DConfigBean represents a logical grouping of deployment configuration data to be presented to the Deployer. 36 * A DConfigBean provides zero or more XPaths that identifies the XML information it requires. 37 * A DConfigBean may contain other DConfigBeans and regular JavaBeans. 38 * The top most DConfigBean is a DConfigBeanRoot object which represents a single XML instance document. 39 * 40 * @author thomas.diesler@jboss.org 41 * @version $Revision: 38480 $ 42 */ 43 public class DConfigBeanImpl implements DConfigBean 44 { 45 /** 46 * Get the XML text for this configuration 47 * 48 * @return the xml text 49 */ 50 public DDBean getDDBean() 51 { 52 return null; //[todo] implement method 53 } 54 55 /** 56 * Get the xpaths this deployment descriptor requires 57 * 58 * @return the xpaths 59 */ 60 public String[] getXpaths() 61 { 62 return new String[0]; //[todo] implement method 63 } 64 65 /** 66 * Return the JavaBean containing server specific deployment information 67 * 68 * @param bean the xml data to be evaluated 69 * @return the server specific configuration 70 * @throws javax.enterprise.deploy.spi.exceptions.ConfigurationException 71 * for errors generating the configuring bean 72 */ 73 public DConfigBean getDConfigBean(DDBean bean) throws ConfigurationException 74 { 75 return null; //[todo] implement method 76 } 77 78 /** 79 * Remove a child 80 * 81 * @param bean the child 82 * @throws javax.enterprise.deploy.spi.exceptions.BeanNotFoundException 83 * when the bean is not found 84 */ 85 public void removeDConfigBean(DConfigBean bean) throws BeanNotFoundException 86 { 87 //[todo] implement method 88 } 89 90 /** 91 * A notification that the DDBean provided has changed and that this bean or 92 * child needs re-evaluating 93 * 94 * @param event the event 95 */ 96 public void notifyDDChange(XpathEvent event) 97 { 98 //[todo] implement method 99 } 100 101 /** 102 * Add a property change listener 103 * 104 * @param listener the listener 105 */ 106 public void addPropertyChangeListener(PropertyChangeListener listener) 107 { 108 //[todo] implement method 109 } 110 111 /** 112 * Remove a property change listener 113 * 114 * @param listener the listener 115 */ 116 public void removePropertyChangeListener(PropertyChangeListener listener) 117 { 118 //[todo] implement method 119 } 120 } 121