001/*
002 *  Copyright 2021 Anyware Services
003 *
004 *  Licensed under the Apache License, Version 2.0 (the "License");
005 *  you may not use this file except in compliance with the License.
006 *  You may obtain a copy of the License at
007 *
008 *      http://www.apache.org/licenses/LICENSE-2.0
009 *
010 *  Unless required by applicable law or agreed to in writing, software
011 *  distributed under the License is distributed on an "AS IS" BASIS,
012 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013 *  See the License for the specific language governing permissions and
014 *  limitations under the License.
015 */
016package org.ametys.core.mbean;
017
018import javax.management.Attribute;
019import javax.management.AttributeList;
020import javax.management.AttributeNotFoundException;
021import javax.management.DynamicMBean;
022import javax.management.InvalidAttributeValueException;
023import javax.management.MBeanAttributeInfo;
024import javax.management.MBeanConstructorInfo;
025import javax.management.MBeanException;
026import javax.management.MBeanInfo;
027import javax.management.MBeanNotificationInfo;
028import javax.management.MBeanOperationInfo;
029import javax.management.ReflectionException;
030import javax.management.RuntimeOperationsException;
031
032import org.ametys.runtime.plugin.component.AbstractLogEnabled;
033
034/**
035 * Abstract class for Ametys Dynamic MBean.
036 */
037public abstract class AbstractAmetysDynamicMBean extends AbstractLogEnabled implements DynamicMBean
038{
039    /** The MBean metadata */
040    protected MBeanInfo _mBeanInfo;
041    
042    /**
043     * AbstractAmetysDynamicMBean basic constructor.
044     * Generate the MBean info.
045     */
046    public AbstractAmetysDynamicMBean()
047    {
048        buildDynamicMBeanInfo();
049    }
050
051    @Override
052    public Object getAttribute(String attributeName) throws AttributeNotFoundException
053    {
054     // Check attribute_name to avoid NullPointerException later on
055        if (attributeName == null)
056        {
057            throw new RuntimeOperationsException(
058                new IllegalArgumentException("Attribute name cannot be null"), 
059                "Cannot invoke a getter of " + this.getClass().getName() + " with null attribute name");
060        }
061
062        Object attribute = _getAttribute(attributeName);
063
064        // If attribute_name has not been recognized
065        if (attribute == null)
066        {
067            throw new AttributeNotFoundException("Cannot find " + attributeName + " attribute in " + this.getClass().getName());
068        }
069        return attribute;
070    }
071
072    /** 
073     * Get the value of the attribute.
074     * This method should assume that attributeName is not null.
075     * And return null if the name is not recognized
076     * @param attributeName the name of the attribute
077     * @return the value of the attribute
078     */
079    protected abstract Object _getAttribute(String attributeName);
080
081    @Override
082    public AttributeList getAttributes(String[] attributeNames)
083    {
084     // Check attributeNames to avoid NullPointerException later on
085        if (attributeNames == null)
086        {
087            throw new RuntimeOperationsException(
088                new IllegalArgumentException(
089                    "attributeNames[] cannot be null"),
090                "Cannot invoke a getter of " + this.getClass().getName());
091        }
092        AttributeList resultList = new AttributeList();
093        
094        // if attributeNames is empty, return an empty result list
095        if (attributeNames.length == 0)
096        {
097            return resultList;
098        }
099        
100        // build the result attribute list
101        for (int i = 0; i < attributeNames.length; i++)
102        {
103            try
104            {
105                Object value = getAttribute(attributeNames[i]);     
106                resultList.add(new Attribute(attributeNames[i], value));
107            }
108            catch (Exception e)
109            {
110                getLogger().error("Failed to get attribute {}", attributeNames[i], e);
111            }
112        }
113        return resultList;
114    }
115    
116    @Override
117    public Object invoke(String actionName, Object[] params, String[] signature) throws MBeanException, ReflectionException
118    {
119        // we don't implement any method to invoke so no need
120        throw new UnsupportedOperationException("No invoke method defined for this MBean.");
121    }
122
123    @Override
124    public void setAttribute(Attribute attribute) throws AttributeNotFoundException, InvalidAttributeValueException, MBeanException, ReflectionException
125    {
126        // we don't need to set any attribute
127        throw new UnsupportedOperationException("Method to set attribute is not defined for this MBean.");
128    }
129
130    @Override
131    public AttributeList setAttributes(AttributeList attributes)
132    {
133        // we don't need to set any attribute
134        throw new UnsupportedOperationException("Method to set attributes is not defined for this MBean.");
135    }
136    
137    @Override
138    public MBeanInfo getMBeanInfo()
139    {
140        return _mBeanInfo;
141    }
142
143    
144    private void buildDynamicMBeanInfo()
145    {
146        _mBeanInfo = new MBeanInfo(getMBeanName(),
147                                   getMBeanDescription(),
148                                   getMBeanAttributes(),
149                                   getMBeanConstructorInfo(),
150                                   getMBeanOperationInfo(),
151                                   getMBeanNotificationInfo());
152    }
153
154    /**
155     * Get the human readable name of the MBean.
156     * This name will be exposed.
157     * @return the name
158     */
159    protected abstract String getMBeanName();
160
161    /**
162     * Get the description of the MBean
163     * @return the description
164     */
165    protected abstract String getMBeanDescription();
166
167    /**
168     * Get the definition of the attributes exposed by the MBean.
169     * @return the attributes information
170     */
171    protected abstract MBeanAttributeInfo[] getMBeanAttributes();
172
173    /**
174     * Get the definition of the constructors exposed by the MBean.
175     * @return the constructors information
176     */
177    protected MBeanConstructorInfo[] getMBeanConstructorInfo()
178    {
179        // We usually don't set any constructor
180        return new MBeanConstructorInfo[0];
181    }
182
183    /**
184     * Get the definition of the operation methods exposed by the MBean
185     * @return the operations information
186     */
187    protected MBeanOperationInfo[] getMBeanOperationInfo()
188    {
189        // We usually don't set any operation
190        return new MBeanOperationInfo[0];
191    }
192
193    /**
194     * Get the definition of the notification exposed by the MBean
195     * @return the notification information
196     */
197    protected MBeanNotificationInfo[] getMBeanNotificationInfo()
198    {
199        // We usually don't set any notification
200        return new MBeanNotificationInfo[0];
201    }
202}