org.apache.sling.feature.scanner.PackageInfo Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of org.apache.sling.feature.analyser Show documentation
A feature describes an OSGi system
The newest version!
/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you 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 org.apache.sling.feature.scanner;

import java.util.Collections;
import java.util.HashSet;
import java.util.Set;

import org.osgi.framework.Version;
import org.osgi.framework.VersionRange;

/**
 * A package info object contains information about a package, its name, its
 * version and the uses constraints. For example, it is used to return
 * the information about bundle exports and imports.
 *
 * A package info object is immutable.
 */
public class PackageInfo implements Comparable {

    private final boolean optional;
    private final String name;
    private final String version;
    private final Set uses;

    /**
     * Constructor for a package info
     * @param name package name
     * @param version package version
     * @param optional is the package optional
     */
    public PackageInfo(final String name, final String version, final boolean optional) {
        this(name, version, optional, null);
    }

    /**
     * Constructor for a package info
     * @param name package name
     * @param version package version
     * @param optional is the package optional
     * @param uses Optional uses constraints
     */
    public PackageInfo(final String name, final String version, final boolean optional, Set uses) {
        this.name = name;
        this.version = version;
        this.optional = optional;
        this.uses = uses == null ? Collections.emptySet() : Collections.unmodifiableSet(new HashSet<>(uses));
    }

    /**
     * The package name
     * @return The package name
     */
    public String getName() {
        return name;
    }

    /**
     * Return the package version
     * @return The package version or {code null}
     */
    public String getVersion() {
        return version;
    }

    /**
     * Return whether the package is optional
     * @return {@code true} if it is optional
     */
    public boolean isOptional() {
        return optional;
    }

    /**
     * Return the package version as a {@link Version} object.
     * If this package info is used to return info about an import
     * package statement, don't use this method but rather use
     * {@link #getPackageVersionRange()}
     * @return The version or {@code null}
     * @throws IllegalArgumentException If the version is not well formed.
     */
    public Version getPackageVersion() {
        if (this.version == null) return null;

        return new Version(this.version);
    }

    /**
     * Return the version as a version range
     * If this package info is used to return info about an export
     * package statement, don't use this method but rather use
     * {@link #getPackageVersion()}
     * @return The version range or {@code null}
     * @throws IllegalArgumentException If the range is not well formed.
     */
    public VersionRange getPackageVersionRange() {
        if (this.version == null) return null;

        return new VersionRange(this.version);
    }

    /**
     * Return the uses constraints
     * @return Optional uses constraints, might be empty
     */
    public Set getUses() {
        return uses;
    }

    @Override
    public String toString() {
        return "Package " + name + ";version=" + version + (this.optional ? " (optional)" : "");
    }

    @Override
    public int compareTo(final PackageInfo o) {
        int result = this.name.compareTo(o.name);
        if (result == 0) {
            result = this.version.compareTo(o.version);
        }
        return result;
    }

    @Override
    public int hashCode() {
        final int prime = 31;
        int result = 1;
        result = prime * result + ((name == null) ? 0 : name.hashCode());
        result = prime * result + (optional ? 1231 : 1237);
        result = prime * result + ((version == null) ? 0 : version.hashCode());
        return result;
    }

    @Override
    public boolean equals(Object obj) {
        if (this == obj) return true;
        if (obj == null) return false;
        if (getClass() != obj.getClass()) return false;
        PackageInfo other = (PackageInfo) obj;
        if (name == null) {
            if (other.name != null) return false;
        } else if (!name.equals(other.name)) return false;
        if (optional != other.optional) return false;
        if (version == null) {
            if (other.version != null) return false;
        } else if (!version.equals(other.version)) return false;
        return true;
    }
}