com.izforge.izpack.installer.util.PanelHelper Maven / Gradle / Ivy
/*
* IzPack - Copyright 2001-2013 Julien Ponge, All Rights Reserved.
*
* http://izpack.org/
* http://izpack.codehaus.org/
*
* Copyright 2013 Tim Anderson
*
* Licensed 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 com.izforge.izpack.installer.util;
import java.util.logging.Level;
import java.util.logging.Logger;
import com.izforge.izpack.installer.automation.PanelAutomation;
import com.izforge.izpack.installer.console.ConsolePanel;
import com.izforge.izpack.installer.gui.IzPanel;
/**
* Helper routines for panels.
*
* @author Tim Anderson
*/
public class PanelHelper
{
/**
* The logger.
*/
private static final Logger logger = Logger.getLogger(PanelHelper.class.getName());
/**
* Returns the console implementation of an {@link IzPanel}.
*
* Console implementations must use the naming convention:
*
* {@code ConsolePanel}
*
* where {@code } is the IzPanel name, minus Panel.
*
* E.g for the panel {@code HelloPanel}, the console implementation must be named {@code HelloConsolePanel}.
*
* For backwards-compatibility, the sufixes Console and ConsoleHelper are also supported.
* Support for this will be removed when the {@link com.izforge.izpack.installer.console.PanelConsole} interface is
* removed.
*
* @param className the IzPanel class name
* @return the corresponding console implementation, or {@code null} if none is found
*/
public static Class getConsolePanel(String className)
{
return getConsolePanel(className, PanelHelper.class.getClassLoader());
}
/**
* Returns the console implementation of an {@link IzPanel}.
*
* Console implementations must use the naming convention:
*
* {@code ConsolePanel}
*
* where {@code } is the IzPanel name, minus Panel.
*
* E.g for the panel {@code HelloPanel}, the console implementation must be named {@code HelloConsolePanel}.
*
* For backwards-compatibility, the sufixes Console and ConsoleHelper are also supported.
* Support for this will be removed when the {@link com.izforge.izpack.installer.console.PanelConsole} interface is
* removed.
*
* @param className the IzPanel class name
* @param loader the class loader to use
* @return the corresponding console implementation, or {@code null} if none is found
*/
public static Class getConsolePanel(String className, ClassLoader loader)
{
Class result = getClass(className.replaceAll("Panel$", "ConsolePanel"), ConsolePanel.class,
loader);
if (result == null)
{
result = getPanelClass(ConsolePanel.class, className, loader, "Console", "ConsoleHelper");
}
return result;
}
/**
* Returns the automated implementation of an {@link IzPanel}.
*
* @param className the IzPanel class name
* @return the corresponding automated implementation, or {@code null} if none is found
*/
public static Class getAutomatedPanel(String className)
{
return getAutomatedPanel(className, PanelAutomation.class.getClassLoader());
}
/**
* Returns the automated implementation of an {@link IzPanel}.
*
* @param className the IzPanel class name
* @param loader the class loader to use
* @return the corresponding automated implementation, or {@code null} if none is found
*/
public static Class getAutomatedPanel(String className, ClassLoader loader)
{
return getPanelClass(PanelAutomation.class, className, loader, "Automation", "AutomationHelper");
}
/**
* Returns an alternate implementation of an {@link IzPanel} given its name, and possible suffixes.
*
* @param superType the super-type of the alternate implementation
* @param className the IzPanel class name
* @param loader the class loader
* @param suffixes the possible suffixes
* @return the corresponding implementation, or {@code null} if none is found
*/
private static Class getPanelClass(Class superType, String className, ClassLoader loader,
String... suffixes)
{
Class result = null;
for (String suffix : suffixes)
{
result = getClass(className + suffix, superType, loader);
if (result != null)
{
break;
}
}
return result;
}
/**
* Returns a class for the specified class name.
*
* @param name the class name
* @param loader the class loader to use to load the class
* @return the corresponding class, or {@code null} if it cannot be found or does not implement the super-type.
*/
@SuppressWarnings("unchecked")
private static Class getClass(String name, Class superType, ClassLoader loader)
{
Class result = null;
try
{
Class type = loader.loadClass(name);
if (!superType.isAssignableFrom(type))
{
logger.warning(name + " does not implement " + superType.getName() + ", ignoring");
}
else
{
result = (Class) type;
}
}
catch (Throwable exception)
{
// ignore
logger.log(Level.FINE, "No " + superType.getSimpleName() + " + found for class " + name + ": "
+ exception.toString(), exception);
}
return result;
}
}