com.alee.managers.style.XmlSkinExtension Maven / Gradle / Ivy

Go to download
/*
 * This file is part of WebLookAndFeel library.
 *
 * WebLookAndFeel library is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * WebLookAndFeel library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with WebLookAndFeel library.  If not, see .
 */

package com.alee.managers.style;

import com.alee.api.annotations.NotNull;
import com.alee.api.annotations.Nullable;
import com.alee.api.resource.Resource;
import com.alee.managers.icon.set.IconSet;
import com.alee.managers.style.data.SkinInfo;
import com.alee.managers.style.data.SkinInfoConverter;
import com.alee.utils.XmlUtils;
import com.alee.utils.xml.XStreamContext;

import javax.swing.*;
import java.util.List;

/**
 * Basic skin extension implementation.
 * Its data is stored in the same XML format used for skins.
 *
 * @author Mikle Garin
 * @see How to use StyleManager
 * @see StyleManager
 * @see SkinExtension
 */
public class XmlSkinExtension implements SkinExtension
{
    /**
     * {@link XmlSkinExtension} {@link Resource}.
     */
    @NotNull
    private final Resource resource;

    /**
     * {@link XmlSkinExtension} meta data.
     * It will never contain actual extension styles or includes.
     */
    @NotNull
    private final SkinInfo extensionInfo;

    /**
     * Constructs new {@link XmlSkinExtension}.
     *
     * @param resource extension {@link Resource}
     */
    public XmlSkinExtension ( @NotNull final Resource resource )
    {
        this.resource = resource;
        this.extensionInfo = getMetaData ();
    }

    @NotNull
    @Override
    public String getId ()
    {
        return extensionInfo.getId ();
    }

    @Nullable
    @Override
    public Icon getIcon ()
    {
        return extensionInfo.getIcon ();
    }

    @Nullable
    @Override
    public String getTitle ()
    {
        return extensionInfo.getTitle ();
    }

    @Nullable
    @Override
    public String getDescription ()
    {
        return extensionInfo.getDescription ();
    }

    @Nullable
    @Override
    public String getAuthor ()
    {
        return extensionInfo.getAuthor ();
    }

    @Override
    public boolean isSupported ( @NotNull final String skinId )
    {
        return extensionInfo.isSupported ( skinId );
    }

    @NotNull
    @Override
    public List getIconSets ()
    {
        return extensionInfo.getIconSets ();
    }

    /**
     * Returns extension with only meta data read.
     * We cannot read extension outside of some skin context, but we need some extension data before loading it.
     *
     * @return extension with only meta data read
     */
    @NotNull
    public SkinInfo getMetaData ()
    {
        return XmlUtils.fromXML ( resource, new XStreamContext ( SkinInfoConverter.META_DATA_ONLY_KEY, true ) );
    }

    /**
     * Returns full extension data for the specified skin.
     * It might vary depending on the skin we are reading this extension for, so we do not store it.
     *
     * @param skinClass skin canonical class name
     * @return full extension data for the specified skin
     */
    @NotNull
    public SkinInfo getData ( @NotNull final String skinClass )
    {
        return XmlUtils.fromXML ( resource, new XStreamContext ( SkinInfoConverter.SKIN_CLASS, skinClass ) );
    }

    @NotNull
    @Override
    public String toString ()
    {
        return extensionInfo.toString ();
    }
}