/* * JBoss, Home of Professional Open Source. * Copyright 2014, Red Hat, Inc., and individual contributors * as indicated by the @author tags. See the copyright.txt file in the * distribution for a full listing of individual contributors. * * This is free software; you can redistribute it and/or modify it * under the terms of the GNU Lesser General Public License as * published by the Free Software Foundation; either version 2.1 of * the License, or (at your option) any later version. * * This software 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this software; if not, write to the Free * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA * 02110-1301 USA, or see the FSF site: http://www.fsf.org. */ package org.jboss.as.controller.capability.registry; import java.util.Collections; import java.util.HashSet; import java.util.LinkedHashMap; import java.util.Map; import java.util.Set; import org.jboss.as.controller.PathAddress; /** * Encapsulates the registration information for a requirement for a capability. * * @author Brian Stansberry (c) 2014 Red Hat Inc. */ public class RequirementRegistration { private final Map<PathAddress, RegistrationPoint> registrationPoints = new LinkedHashMap<>(); private final String requiredName; private final CapabilityId dependentId; public RequirementRegistration(String requiredName, String dependentName, CapabilityScope dependentContext) { this(requiredName, new CapabilityId(dependentName, dependentContext)); } protected RequirementRegistration(String requiredName, CapabilityId dependentId) { this.requiredName = requiredName; this.dependentId = dependentId; } /** * Creates a new requirement registration. * * @param requiredName the name of the required capability * @param dependentName the name of the capability that requires {@code requiredName} * @param dependentContext context in which the dependent capability exists * @param registrationPoint point in the configuration model that triggered the requirement */ protected RequirementRegistration(String requiredName, String dependentName, CapabilityScope dependentContext, RegistrationPoint registrationPoint) { this(requiredName, dependentName, dependentContext); this.registrationPoints.put(registrationPoint.getAddress(), registrationPoint); } /** * Copy constructor. * * @param toCopy the registration to copy. */ public RequirementRegistration(RuntimeRequirementRegistration toCopy) { this(toCopy.getRequiredName(), toCopy.getDependentId()); this.registrationPoints.putAll(((RequirementRegistration)toCopy).registrationPoints); } public String getRequiredName() { return requiredName; } public String getDependentName() { return dependentId.getName(); } public CapabilityScope getDependentContext() { return dependentId.getScope(); } public CapabilityId getDependentId() { return dependentId; } @Override public final boolean equals(Object o) { if (this == o) { return true; } if (o == null || !getClass().isAssignableFrom(o.getClass())) { return false; } RequirementRegistration that = (RequirementRegistration) o; return dependentId.equals(that.dependentId) && requiredName.equals(that.requiredName); } @Override public final int hashCode() { int result = requiredName.hashCode(); result = 31 * result + dependentId.hashCode(); return result; } /** * Gets the registration point that been associated with the registration for the longest period. * * @return the initial registration point, or {@code null} if there are no longer any registration points */ public synchronized RegistrationPoint getOldestRegistrationPoint() { return registrationPoints.size() == 0 ? null : registrationPoints.values().iterator().next(); } /** * Get all registration points associated with this registration. * * @return all registration points. Will not be {@code null} but may be empty */ public synchronized Set<RegistrationPoint> getRegistrationPoints() { return Collections.unmodifiableSet(new HashSet<>(registrationPoints.values())); } public synchronized boolean addRegistrationPoint(RegistrationPoint toAdd) { PathAddress addedAddress = toAdd.getAddress(); if (registrationPoints.containsKey(addedAddress)) { return false; } registrationPoints.put(addedAddress, toAdd); return true; } public synchronized boolean removeRegistrationPoint(RegistrationPoint toAdd) { PathAddress addedAddress = toAdd.getAddress(); if (!registrationPoints.containsKey(addedAddress)) { return false; } registrationPoints.remove(addedAddress); return true; } public synchronized int getRegistrationPointCount() { return registrationPoints.size(); } }