/* * Copyright 2000-2018 JetBrains s.r.o. * * 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 jetbrains.buildServer.server.rest.model; import com.intellij.openapi.diagnostic.Logger; import com.intellij.util.containers.SortedList; import java.util.*; import javax.xml.bind.annotation.XmlAttribute; import javax.xml.bind.annotation.XmlElement; import javax.xml.bind.annotation.XmlRootElement; import jetbrains.buildServer.ServiceLocator; import jetbrains.buildServer.server.rest.data.FilterUtil; import jetbrains.buildServer.server.rest.data.Locator; import jetbrains.buildServer.server.rest.data.ParameterCondition; import jetbrains.buildServer.server.rest.data.parameters.EntityWithModifiableParameters; import jetbrains.buildServer.server.rest.data.parameters.EntityWithParameters; import jetbrains.buildServer.server.rest.data.parameters.MapBackedEntityWithParameters; import jetbrains.buildServer.server.rest.errors.BadRequestException; import jetbrains.buildServer.server.rest.model.buildType.BuildType; import jetbrains.buildServer.server.rest.model.buildType.BuildTypeUtil; import jetbrains.buildServer.server.rest.util.BeanContext; import jetbrains.buildServer.server.rest.util.DefaultValueAware; import jetbrains.buildServer.server.rest.util.ValueWithDefault; import jetbrains.buildServer.serverSide.BuildTypeSettings; import jetbrains.buildServer.serverSide.Parameter; import jetbrains.buildServer.serverSide.SimpleParameter; import jetbrains.buildServer.util.CaseInsensitiveStringComparator; import org.jetbrains.annotations.Contract; import org.jetbrains.annotations.NotNull; import org.jetbrains.annotations.Nullable; /** * @author Yegor.Yarko * Date: 13.07.2009 */ @XmlRootElement(name = "properties") public class Properties implements DefaultValueAware { private static final Logger LOG = Logger.getInstance(Properties.class.getName()); protected static final String PROPERTY = "property"; @XmlAttribute public Integer count; @XmlAttribute(required = false) @Nullable public String href; @XmlElement(name = PROPERTY) public List properties; public Properties() { } //todo: review all null usages for href to include due URL public Properties(@Nullable final Map properties, @Nullable String href, @NotNull final Fields fields, @NotNull final BeanContext beanContext) { this(properties == null ? null : createEntity(properties, null), href, null, fields, beanContext); } /** * @param externalLocator locator to override the one from "fields" */ public Properties(@Nullable final EntityWithParameters parameters, @Nullable String href, @Nullable Locator externalLocator, @NotNull final Fields fields, @NotNull final BeanContext beanContext) { this (parameters, true, href, externalLocator, fields, beanContext); } /** * @param externalLocator locator to override the one from "fields" */ public Properties(@Nullable final EntityWithParameters parameters, boolean enforceSorting, @Nullable String href, @Nullable Locator externalLocator, @NotNull final Fields fields, @NotNull final BeanContext beanContext) { if (parameters == null) { this.count = null; this.properties = null; } else { if (fields.isIncluded(PROPERTY, false, true)) { final Fields propertyFields = fields.getNestedField(PROPERTY, Fields.NONE, Fields.LONG); // locator form "fields" is ignored is externalLocator is specified. This is used e.g. in BuildType#getSettings() Locator propertiesLocator = externalLocator != null ? externalLocator : (fields.getLocator() == null ? null : new Locator(fields.getLocator())); Collection parametersCollection = parameters.getParametersCollection(propertiesLocator); // pass locator here final ParameterCondition parameterCondition = ParameterCondition.create(propertiesLocator); // pass locator here and make sure it's used and supported dimensions are preserved if (externalLocator == null && propertiesLocator != null) propertiesLocator.checkLocatorFullyProcessed(); this.properties = enforceSorting ? getEmptyProperties() : new ArrayList<>(); for (Parameter parameter : parametersCollection) { Boolean inherited = parameters.isInherited(parameter.getName()); if (parameterCondition == null || parameterCondition.parameterMatches(parameter, inherited)) { this.properties.add(new Property(parameter, inherited, propertyFields, beanContext.getServiceLocator())); } } this.count = ValueWithDefault.decideIncludeByDefault(fields.isIncluded("count"), this.properties.size()); //count of the properties included } else { this.count = ValueWithDefault.decideIncludeByDefault(fields.isIncluded("count"), parameters.getParametersCollection(null).size()); //actual count when no properties are included } } this.href = href == null ? null : ValueWithDefault.decideDefault(fields.isIncluded("href"), beanContext.getApiUrlBuilder().transformRelativePath(href)); } @NotNull private static SortedList getEmptyProperties() { return new SortedList(new Comparator() { private final CaseInsensitiveStringComparator comp = new CaseInsensitiveStringComparator(); public int compare(final Property o1, final Property o2) { return comp.compare(o1.name, o2.name); } }); } @Nullable @Contract("null -> null; !null -> !null") public static List convertToSimpleParameters(@Nullable final Map parametersMap) { if (parametersMap == null ) return null; ArrayList result = new ArrayList<>(parametersMap.size()); for (Map.Entry source : parametersMap.entrySet()) { if (source.getValue() == null) continue; result.add(new SimpleParameter(source.getKey(), source.getValue())); } return result; // return parametersMap.entrySet().stream().filter(entry -> entry.getValue() != null).map(entry -> new SimpleParameter(entry.getKey(), entry.getValue())).collect(Collectors.toList()); } @NotNull public Map getMap() { return getMap(null); } @NotNull public Map getMap(final Boolean ownOnly) { if (properties == null) { return new HashMap(); } final HashMap result = new HashMap(properties.size()); for (Property property : properties) { boolean actualOwn = property.inherited == null || !property.inherited; if (FilterUtil.isIncludedByBooleanFilter(ownOnly, actualOwn)){ property.isValid();//todo check for unused type, inherited. result.put(property.name, property.value); } } return result; } public boolean isDefault() { return ValueWithDefault.isAllDefault(count, href, properties); } public boolean setTo(@NotNull final BuildTypeSettings buildType, @NotNull final ServiceLocator serviceLocator) { return setTo(BuildType.createEntity(buildType), serviceLocator); } public boolean setTo(@NotNull final EntityWithModifiableParameters holder, @NotNull final ServiceLocator serviceLocator) { Collection ownParameters = holder.getOwnParametersCollection(); Collection original = ownParameters != null ? ownParameters : holder.getParametersCollection(null); try { BuildTypeUtil.removeAllParameters(holder); if (properties != null) { for (Property entity : properties) { entity.addTo(holder, serviceLocator); } } return true; } catch (Exception e) { //restore all parameters if setting one has failed BuildTypeUtil.removeAllParameters(holder); for (Parameter p : original) { holder.addParameter(p); } throw new BadRequestException("Cannot set parameters: " + e.toString(), e); } } @Nullable private Set getNames(@Nullable final Collection parameters) { if (parameters == null) return null; final HashSet result = new HashSet<>(parameters.size()); for (Parameter parameter : parameters) { result.add(parameter.getName()); } return result; } public boolean isSimilar(final Properties that) { return that != null && (count == null || that.count == null || com.google.common.base.Objects.equal(count, that.count)) && (properties == null || that.properties == null || com.google.common.base.Objects.equal(properties, that.properties)); } @NotNull public static EntityWithParameters createEntity(@NotNull final Map params, @Nullable final Map ownParams) { return new MapBackedEntityWithParameters(params, ownParams); } }